Places API (New)

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

• משאב REST: v1.places
• משאב REST: v1.places.photos

שירות: places.googleapis.com

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

מסמך הגילוי

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

• https://places.googleapis.com/$discovery/rest?version=v1

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

נקודת קצה של שירות היא כתובת 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} מקבלים מדיה של תמונה עם מחרוזת הפניה לתמונות.