Places API (New)

تتيح واجهة برمجة التطبيقات Places API للمطوّرين الوصول إلى مجموعة متنوعة من نقاط نهاية البحث والاسترجاع لمكان معيّن.

• مورد REST: ‏ v1.places
• مصدر RST: v1.place.photos

الخدمة: places.googleapis.com

للاتّصال بهذه الخدمة، ننصحك باستخدام مكتبات العملاء التي تقدّمها Google. إذا كان تطبيقك بحاجة إلى استخدام مكتباتك الخاصة للاتصال بهذه الخدمة، استخدِم المعلومات التالية عند إجراء طلبات واجهة برمجة التطبيقات.

المستند المرتبط بميزة "اقتراحات"

مستند الاكتشاف هو مواصفة قابلة للقراءة آليًا لوصف واجهات برمجة التطبيقات REST واستخدامها. ويتم استخدامه لإنشاء مكتبات العملاء ومكونات إضافية لبيئة تطوير البرامج المتكاملة وأدوات أخرى تتفاعل مع واجهات برمجة تطبيقات Google. قد توفّر خدمة واحدة عدّة مستندات اكتشاف. توفّر هذه الخدمة مستند الاكتشاف التالي:

• https://places.googleapis.com/$discovery/rest?version=v1

نقطة نهاية الخدمة

نقطة نهاية الخدمة هي عنوان URL أساسي يحدِّد عنوان الشبكة لخدمة واجهة برمجة التطبيقات. قد تتضمّن خدمة واحدة عدة نقاط نهاية للخدمات. تحتوي هذه الخدمة على نقطة نهاية الخدمة التالية، وترتبط كل معرّفات الموارد المنتظمة (URI) أدناه بنقطة نهاية الخدمة هذه:

• https://places.googleapis.com

مورد REST: ‏ v1.places

الطُرق
autocomplete	POST /v1/places:autocomplete تعرِض هذه الدالة توقّعات للمدخلات المحدّدة.
get	GET /v1/{name=places/*} يمكنك الحصول على تفاصيل مكان استنادًا إلى اسم المرجع، وهو سلسلة بتنسيق places/{place_id}.
searchNearby	POST /v1/places:searchNearby يمكنك البحث عن أماكن بالقرب من المواقع الجغرافية.
searchText	POST /v1/places:searchText بحث عن مكان استنادًا إلى طلب بحث نصي.

مورد REST: ‏ v1.places.photos

الطُرق
getMedia	GET /v1/{name=places/*/photos/*/media} يمكنك الحصول على وسائط صور تحتوي على سلسلة مرجعية للصور.