photosearcher
1.0.0
Photosearcherの目標は、Flickr APIにアクセスするための繰り返し可能な方法論を提供することです。詳細については、パッケージWebサイトをご覧ください。機能の詳細と例については、パッケージビネットをご覧ください。
このパッケージを作成して、研究の質問に答えるための再現可能なコードを促進するのに役立ちました。 PLOSジャーナルだけでも、Flickrがキーワードに180を超える記事があります。 PLOSジャーナルでFlickrの使用の概要については、ここをクリックしてください。 Flickrを使用した記事は、生物学と生命科学、コンピューターと情報科学、医学と健康科学、政治など、幅広い研究分野の幅広いジャーナルに掲載されています。
このパッケージは、Flickr API使用条件に従って使用する必要があります。
GithubからPhotoearcherのリリースバージョンをインストールできます。
devtools :: install_github( " nfox29/photosearcher " )パッケージには、Flickr開発ページから有効なAPIキーが必要です。パッケージから関数を初めて呼び出すときは、APIキーを作成して入力するように求められます。 APIキーは、作業ディレクトリのPhotosearcher_key.sysdataとして保存され、すべての機能に使用されます。
パッケージは現在、詳細については、Flickr APIを使用して画像とそのメタデータを検索する機能（ photo_searchメソッドを参照）を使用して画像とそのメタデータを検索する機能に焦点を当てています。これらの写真は、画像を.jpegファイルとして保存するdownload_images関数を使用してダウンロードできます。
また、パッケージを使用すると、ユーザーは特定の場所（ location_tags ）のトップタグを見つけることができ、特定のタグ（ related_tags ）に最も一般的に関連付けられているタグを見つけることができます。 Flickr Webサイトは、すべての通話方法に完全なAPIドキュメントを提供しています。
この例では、英国とアイルランドで2010年から2019年の間にテキストまたはキーワードロッククライミングでラベル付けされたすべての画像でメタデータを検索する方法を示します。
library( photosearcher )
rock_climbing <- photo_search(
mindate_taken = " 2010-01-01 " ,
maxdate_taken = " 2018-01-01 " ,
text = " rock climbing " ,
bbox = " -12.875977,49.210420,2.636719,59.977005 " ,
has_geo = TRUE
) has_geo == TRUEの場合、緯度と経度の情報を持つ画像に関するメタデータのみが取得されます。
これらは、ユーザーの好みで他のパッケージを使用してプロットできます。以下の例では、これらをsfオブジェクトに変換し、 ggplot2を使用してプロットします。
library( sf )
rock_climbing <- st_as_sf( rock_climbing , coords = c( " longitude " , " latitude " ))
library( ggplot2 )
ggplot() +
geom_polygon( data = map_data( " world " , region = c( " Ireland " , " UK " )),
aes( x = long , y = lat , group = group ),
fill = " lightgrey " ) +
geom_sf( data = rock_climbing ) +
theme_bw()このパッケージには、インターネット接続とFlickr APIへの接続が必要です。これは絶えず利用できない場合があります。
まだ報告されている問題ではないAPIへの接続に関連付けられていないバグを発見した場合は、再現可能な例を提供する新しい問題を開いてください。
