تتيح Places API للمطوّرين الوصول إلى مجموعة متنوعة من نقاط النهاية الخاصة بالبحث والاسترجاع لمكان ما.
الخدمة: places.googleapis.com
لطلب هذه الخدمة، ننصحك بتحميل مكتبة "الأماكن" باستخدام Maps JavaScript API أو استخدام مكتبات العميل التي توفّرها Google. إذا كان تطبيقك يحتاج إلى استخدام مكتباتك الخاصة لطلب هذه الخدمة، استخدِم المعلومات التالية عند طلب بيانات من واجهة برمجة التطبيقات.
مستند الاستكشاف
مستند الاستكشاف هو عبارة عن مواصفات يمكن أن تقرأها الآلة لوصف REST API واستخدامها. وهو يُستخدم لإنشاء مكتبات العميل ومكوّنات IDE الإضافية وغيرها من الأدوات التي تتفاعل مع Google APIs. تجدر الإشارة إلى أنّ خدمة واحدة قد تقدّم أكثر من وثيقة استكشاف. توفّر هذه الخدمة مستند الاكتشاف التالي:
نقطة نهاية الخدمة
نقطة نهاية الخدمة هي الجزء الأساسي من عنوان 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} الحصول على وسائط صور باستخدام سلسلة مرجعية للصور |