الهدف من Photosearcher هو توفير منهجية قابلة للتكرار للوصول إلى واجهة برمجة تطبيقات Flickr. يمكن العثور على مزيد من المعلومات على موقع الحزمة. لمزيد من المعلومات وأمثلة على الوظائف ، تحقق من المقالة المقالة القصيرة.
لقد أنتجنا هذه الحزمة للمساعدة في تسهيل التعليمات البرمجية القابلة للتكرار للإجابة على أسئلة البحث. في المجلات PLOS وحدها ، يوجد أكثر من 180 مقالة مع Flickr في كلماتها الرئيسية. انقر هنا للحصول على نظرة عامة على استخدام Flickr في مجلات PLOS. يتم نشر المقالات التي تستخدم Flickr في مجموعة واسعة من المجلات لمجموعة واسعة من مجالات البحث بما في ذلك علم الأحياء وعلوم الحياة ، وعلوم الكمبيوتر والمعلومات ، والطب والعلوم الصحية والسياسة.
يجب استخدام هذه الحزمة في إطار شروط الاستخدام Flickr API.
يمكنك تثبيت الإصدار الذي تم إصداره من PhotoResearcher من GitHub مع:
devtools :: install_github( " nfox29/photosearcher " )
تتطلب الحزمة مفتاح API صالح من صفحة تطوير Flickr. في المرة الأولى التي تتصل فيها بوظيفة من الحزمة ، سيُطلب منك إنشاء مفتاح API وإدخاله. سيتم بعد ذلك حفظ مفتاح API كـ Photosearcher_key.sysdata في دليل العمل الخاص بك ويستخدم لجميع الوظائف.
تركز الحزمة حاليًا على القدرة على استخدام واجهة برمجة تطبيقات Flickr للبحث عن الصور وبيانات التعريف الخاصة بها من خلال وظيفة 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
)
عندما يتم استرجاع metadata 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 ، والذي قد لا يكون متاحًا باستمرار.
إذا اكتشفت وجود خطأ غير مرتبط بالاتصال بأجهزة واجهة برمجة التطبيقات التي ليست بالفعل مشكلة تم الإبلاغ عنها ، فالرجاء فتح مشكلة جديدة توفر مثالاً قابلاً للتكرار.