ה-Places API מאפשר למפתחים לגשת למגוון של נקודות קצה לחיפוש ולאחזור של מקום מסוים.
שירות: places.googleapis.com
כדי לקרוא לשירות הזה, מומלץ להשתמש בספריות הלקוח ש-Google מספקת. אם האפליקציה שלכם צריכה להשתמש בספריות משלכם כדי לקרוא לשירות הזה, השתמשו במידע הבא כשתשלחו את בקשות ה-API.
מסמך הגילוי
מסמך Discovery הוא מפרט קריא למחשבים לתיאור ולשימוש בממשקי API ל-REST. הוא משמש לבניית ספריות לקוח, יישומי פלאגין בסביבת פיתוח משולבת (IDE) וכלים אחרים שיוצרים אינטראקציה עם Google APIs. שירות אחד יכול לספק כמה מסמכי גילוי. השירות הזה מספק את מסמך הגילוי הבא:
נקודת קצה בשירות
נקודת קצה של שירות היא כתובת URL בסיסית שמציינת את כתובת הרשת של שירות API. לשירות אחד יכולות להיות כמה נקודות קצה (endpoints) של שירות. לשירות הזה יש את נקודת הקצה הבאה של השירות, וכל מזהי ה-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} מקבלים מדיה של תמונה עם מחרוזת הפניה לתמונות. |