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