Places API (New)

Places API מאפשר למפתחים לגשת למגוון נקודות קצה לחיפוש ולאחזור של מקום.

שירות: places.googleapis.com

כדי להתקשר לשירות הזה, מומלץ להשתמש בספריות הלקוח ש-Google מספקת. אם האפליקציה שלכם צריכה להשתמש בספריות משלכם כדי לקרוא לשירות הזה, צריך להשתמש במידע הבא כששולחים את בקשות ה-API.

מסמך Discovery

מסמך Discovery הוא מפרט שקריא למכונות, שמתאר ממשקי API ל-REST ומאפשר שימוש בהם. הוא משמש ליצירת ספריות לקוח, יישומי פלאגין ל-IDE וכלים אחרים שמקיימים אינטראקציה עם Google APIs. שירות אחד יכול לספק כמה מסמכי Discovery. השירות הזה מספק את מסמך הגילוי הבא:

נקודת קצה של שירות

נקודת קצה (endpoint) של שירות היא כתובת URL בסיסית שמציינת את כתובת הרשת של שירות API. לשירות אחד יכולות להיות כמה נקודות קצה של שירות. לשירות הזה יש את נקודת הקצה הבאה, וכל מזהי ה-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}
אחזור מדיה של תמונה באמצעות מחרוזת הפניה לתמונה.