photosearcher

Photosearcher

Photosearcher的目的是提供一种可重复的方法来访问Flickr API。更多信息可以在包装网站上找到。有关功能的更多信息和示例，请查看软件包小插图。

我们制作了此软件包，以帮助促进可再现的代码以回答研究问题。仅在PLOS期刊上，其关键词中就有180多种文章。单击此处以获取在PLOS期刊中使用Flickr的概述。使用Flickr的文章在广泛的期刊上发表，以针对各种研究领域，包括生物学和生命科学，计算机和信息科学，医学与健康科学与政治。

使用条款

该软件包应按照Flickr API的使用条款使用。

安装

您可以从GitHub安装发布的Photosearcher版本：

 devtools :: install_github( " nfox29/photosearcher " )

获取API键

该软件包需要从FLICKR开发页面上的有效API键。第一次从软件包调用函数时，将提示您创建并输入API密钥。然后，API密钥将在您的工作目录中保存为Photoearcher_key.sysdata，并用于所有函数。

软件包功能

该软件包当前重点介绍使用Flickr API通过photo_search函数搜索图像及其元数据的能力（请参阅Flickr.photos.search方法）。这些照片可以使用download_images函数下载，从而将图像保存为.jpeg文件。

该软件包还允许用户找到给定位置（ location_tags ）的顶部标签，并且标签与给定标签最常关联（ related_tags ）。 Flickr网站为其所有呼叫方法提供完整的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连接无关的错误，请打开一个新的问题，提供可重现的示例。