Method: places.get

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

בקשת HTTP

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

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

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

פרמטרים
name

string

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

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

פרמטרים
languageCode

string

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

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

string

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

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

string

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

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

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

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

גוף הבקשה

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

גוף התשובה

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