photosearcher

Photosearcher

O objetivo do Photosearcher é fornecer uma metodologia repetível para acessar a API do Flickr. Mais informações podem ser encontradas no site do pacote. Para obter mais informações e exemplos das funções, consulte a vinheta do pacote.

Produzimos este pacote para ajudar a facilitar o código reproduzível para responder a perguntas de pesquisa. Somente nos periódicos do PLOS, existem mais de 180 artigos com o Flickr em suas palavras -chave. Clique aqui para obter uma visão geral do uso do Flickr nos periódicos do PLOS. Os artigos que usam o Flickr são publicados em uma ampla gama de periódicos para uma ampla gama de campos de pesquisa, incluindo biologia e ciências da vida, ciências da computação e informação, ciências da medicina e saúde e política.

Termos de uso

Este pacote deve ser usado dentro dos termos de uso da API do Flickr.

Instalação

Você pode instalar a versão liberada do Photosearcher do GitHub com:

 devtools :: install_github( " nfox29/photosearcher " )

Obtendo uma chave de API

O pacote requer uma chave de API válida na página de desenvolvimento do Flickr. Na primeira vez em que você chama uma função do pacote, você será solicitado a criar e inserir sua tecla API. A chave da API será salva como photosearcher_key.sysdata no seu diretório de trabalho e é usada para todas as funções.

Funções de pacote

Atualmente, o pacote se concentra na capacidade de usar a API do Flickr para pesquisar imagens e seus metadados através da função photo_search (consulte o método do Flickr.photos.search) para obter mais informações. Essas fotografias podem ser baixadas usando a função download_images , que salva as imagens como um arquivo .jpeg.

O pacote também permite que os usuários encontrem as principais tags para um determinado local ( location_tags ) e as tags mais comumente associadas a uma determinada tag ( related_tags ). O site da Flickr oferece documentação completa da API para todos os seus métodos de chamada.

Procurando por metadados fotográficos

Neste exemplo, demonstramos como procurar metadados em todas as imagens rotuladas com o texto ou palavras -chave escalando entre 2010 e 2019 no Reino Unido e na Irlanda.

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
)  

Quando has_geo == TRUE Somente metadados sobre imagens com informações de latitude e longitude serão recuperadas.

Estes podem ser plotados usando outros pacotes na preferência do usuário. No exemplo abaixo, convertemos -os em um objeto sf e plotagem usando 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()

Questões e bugs

Este pacote requer uma conexão com a Internet, bem como uma conexão com a API do Flickr, que pode não estar disponível constantemente.

Se você descobrir um bug não associado à conexão com a API que ainda não é um problema relatado, abra um novo problema, fornecendo um exemplo reproduzível.