ממשק Places API מאפשר למפתחים לגשת למגוון נקודות קצה לחיפוש ולאחזור של מקום.
שירות: places.googleapis.com
כדי לקרוא לשירות הזה, מומלץ לטעון את ספריית המקומות באמצעות Maps JavaScript API או להשתמש בספריות הלקוח ש-Google מספקת. אם האפליקציה צריכה להשתמש בספריות משלה כדי לקרוא לשירות הזה, צריך להשתמש במידע הבא כשמבצעים את בקשות ה-API.
מסמך Discovery
Discovery Document הוא מפרט שניתן לקריאה על ידי מכונה, שמתאר ומאפשר שימוש בממשקי API ל-REST. היא משמשת לבניית ספריות לקוח, תוספים ל-IDE וכלים אחרים שמתקשרים עם Google APIs. שירות אחד יכול לספק כמה מסמכי גילוי. השירות הזה מספק את מסמך הגילוי הבא:
נקודת קצה של שירות
נקודת קצה של שירות היא כתובת URL בסיסית שמציינת את כתובת הרשת של שירות API. יכול להיות שלשירות אחד יהיו כמה נקודות קצה של שירות. לשירות הזה יש נקודת קצה (endpoint) משלו, וכל כתובות ה-URI שבהמשך הן יחסיות לנקודת הקצה הזו:
https://places.googleapis.com
משאב REST: v1.places
| Methods | |
|---|---|
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
| Methods | |
|---|---|
getMedia |
GET /v1/{name=places/*/photos/*/media} קבלת מדיה של תמונה עם מחרוזת של הפניה לתמונה. |