photosearcher

PENELIPURAN PENELIPUAN

Tujuan peneliti adalah untuk memberikan metodologi berulang untuk mengakses Flickr API. Informasi lebih lanjut dapat ditemukan di situs web paket. Untuk informasi lebih lanjut dan contoh fungsi, periksa sketsa paket.

Kami telah menghasilkan paket ini untuk membantu memfasilitasi kode yang dapat direproduksi untuk menjawab pertanyaan penelitian. Dalam jurnal PLOS saja ada lebih dari 180 artikel dengan Flickr dalam kata kunci mereka. Klik di sini untuk ikhtisar penggunaan flickr di jurnal PLOS. Artikel yang menggunakan Flickr diterbitkan dalam berbagai jurnal untuk berbagai bidang penelitian termasuk ilmu biologi dan kehidupan, komputer dan ilmu informasi, kedokteran dan ilmu kesehatan dan politik.

Ketentuan Penggunaan

Paket ini harus digunakan sesuai dengan Ketentuan Penggunaan API Flickr.

Instalasi

Anda dapat menginstal versi photosearcher yang dirilis dari GitHub dengan:

 devtools :: install_github( " nfox29/photosearcher " )

Mendapatkan Kunci API

Paket membutuhkan kunci API yang valid dari halaman pengembangan Flickr. Pertama kali Anda memanggil fungsi dari paket, Anda akan diminta untuk membuat dan memasukkan kunci API Anda. Kunci API kemudian akan disimpan sebagai photosearcher_key.sysdata di direktori kerja Anda dan digunakan untuk semua fungsi.

Fungsi paket

Paket saat ini berfokus pada kemampuan untuk menggunakan API Flickr untuk mencari gambar dan metadata mereka melalui fungsi photo_search (lihat metode flickr.photos.search) untuk informasi lebih lanjut. Foto -foto ini dapat diunduh menggunakan fungsi download_images yang menyimpan gambar sebagai file .jpeg.

Paket ini juga memungkinkan pengguna untuk menemukan tag teratas untuk lokasi yang diberikan ( location_tags ) dan tag yang paling umum terkait dengan tag yang diberikan ( related_tags ). Situs web Flickr menawarkan dokumentasi API lengkap untuk semua metode panggilannya.

Mencari metadata foto

Dalam contoh ini, kami mendemonstrasikan cara mencari metadata pada semua gambar yang diberi label dengan teks atau kata kunci panjat tebing antara 2010 dan 2019 di Inggris dan Irlandia.

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
)  

Ketika has_geo == TRUE hanya metadata tentang gambar dengan lintang dan informasi bujur akan diambil.

Ini dapat diplot menggunakan paket lain dengan preferensi pengguna. Dalam contoh di bawah ini, kami mengonversi ini ke objek sf dan plot menggunakan 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()

Masalah dan bug

Paket ini membutuhkan koneksi internet serta koneksi ke Flickr API, yang mungkin tidak selalu tersedia.

Jika Anda menemukan bug yang tidak terkait dengan koneksi ke API yang belum menjadi masalah yang dilaporkan, buka masalah baru yang memberikan contoh yang dapat direproduksi.