Places API (New)

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

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

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

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

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

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

نقطة نهاية الخدمة هي عنوان 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}
يمكنك الحصول على وسائط صور تحتوي على سلسلة مرجعية للصور.