Method: places.get

אפשר לקבל את הפרטים של מקום מסוים על סמך שם המשאב שלו, שהוא מחרוזת בפורמט places/{placeId}.

בקשת HTTP

GET https://places.googleapis.com/v1/{name=places/*}

כתובת ה-URL כתובה בתחביר של gRPC Transcoding.

פרמטרים של נתיב

פרמטרים
name

string

חובה. שם המשאב של המקום, בפורמט places/{placeId}.

פרמטרים של שאילתה

פרמטרים
languageCode

string

אופציונלי. פרטי המקום יוצגו בשפה המועדפת אם היא זמינה.

רשימת השפות הנתמכות הנוכחית: https://developers.google.com/maps/faq#languagesupport.
regionCode

string

אופציונלי. קוד המדינה או האזור של Unicode ‏ (CLDR) של המיקום שממנו מגיעה הבקשה. הפרמטר הזה משמש להצגת פרטי המקום, כמו שם המקום הספציפי לאזור, אם הוא זמין. הפרמטר יכול להשפיע על התוצאות בהתאם לדין החל. מידע נוסף זמין בכתובת https://www.unicode.org/cldr/charts/latest/supplemental/territory_language_information.html.

שימו לב: בשלב הזה אין תמיכה בקודים אזוריים בני 3 ספרות.
sessionToken

string

אופציונלי. מחרוזת שמזהה סשן של השלמה אוטומטית למטרות חיוב. הערך חייב להיות מחרוזת base64 בטוחה לכתובת URL ולשם קובץ, באורך של עד 36 תווים ב-ASCII. אחרת, מוחזרת שגיאת INVALID_ARGUMENT.

הסשן מתחיל כשהמשתמש מתחיל להקליד שאילתה, ומסתיים כשהוא בוחר מקום ומתבצעת קריאה ל-Place Details או ל-Address Validation. בכל סשן יכולות להיות כמה שאילתות, ואחריהן בקשה אחת של Place Details או Address Validation. האישורים שמשמשים לכל בקשה בסשן חייבים להשתייך לאותו פרויקט במסוף Google Cloud. אחרי שסשן מסתיים, האסימון כבר לא תקף. האפליקציה צריכה ליצור אסימון חדש לכל סשן. אם לא מציינים את הפרמטר sessionToken או אם משתמשים מחדש בטוקן סשן, הסשן יחויב כאילו לא סופק טוקן סשן (כל בקשה תחויב בנפרד).

מומלץ לפעול לפי ההנחיות הבאות:

  • מומלץ להשתמש באסימוני סשן לכל הקריאות להשלמה אוטומטית למקומות.
  • צריך ליצור טוקן חדש לכל סשן. מומלץ להשתמש ב-UUID בגרסה 4.
  • חשוב לוודא שפרטי הכניסה שמשמשים לכל הבקשות של השלמה אוטומטית למקומות, Place Details ו-Address Validation בסשן מסוים שייכים לאותו פרויקט ב-מסוף Cloud.
  • חשוב להעביר אסימון סשן ייחודי לכל סשן חדש. אם משתמשים באותו טוקן ליותר מסשן אחד, כל בקשה תחויב בנפרד.

גוף הבקשה

גוף הבקשה צריך להיות ריק.

גוף התשובה

אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכיל מופע של Place.

היקפי הרשאות

נדרש אחד מהיקפי ההרשאות הבאים של OAuth:

  • https://www.googleapis.com/auth/maps-platform.places.details
  • https://www.googleapis.com/auth/maps-platform.places
  • https://www.googleapis.com/auth/cloud-platform