Method: geocode.location.geocodeLocationQuery

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

בקשת HTTP

GET https://geocode.googleapis.com/v4beta/geocode/location/{locationQuery}

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

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

פרמטרים
המיקום שצריך להמיר לקואורדינטות. זו רשימה של שדות שמוציאים זה את זה. בתשובה יוגדר לכל היותר אחד מהשדות הבאים:
locationQuery

string

המיקום בפורמט של מחרוזת "lat,lng". לדוגמה, "64.7611872,-18.4705364".
סוף השדות שמוציאים זה את זה.

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

פרמטרים
languageCode

string

אופציונלי. השפה שצריך להחזיר בה את התוצאות.
regionCode

string

אופציונלי. קוד אזור. קוד האזור, שמוגדר כערך ccTLD (דומיין ברמה העליונה) באורך שני תווים. הפרמטר משפיע על התוצאות בהתאם לדין החל.
types[]

string

אופציונלי. קבוצה של תגי סוג להגבלת התוצאות. תוצאות שלא כוללות אף אחד מהסוגים שצוינו יוסרו.

הרשימה המלאה של הערכים האפשריים מופיעה בטבלה א' ובטבלה ב' בכתובת https://developers.google.com/maps/documentation/places/web-service/place-types.
granularity[]

enum (GeocodeResult.Granularity)

אופציונלי. מסנן של ערך enum אחד או יותר של רמת פירוט המיקום.
המיקום שצריך להמיר לקואורדינטות. זו רשימה של שדות שמוציאים זה את זה. בתשובה יוגדר לכל היותר אחד מהשדות הבאים:
location

object (LatLng)

המיקום בפורמט המובנה.
סוף השדות שמוציאים זה את זה.

גוף הבקשה

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

גוף התשובה

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

היקפי הרשאות

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

  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/maps-platform.geocode
  • https://www.googleapis.com/auth/maps-platform.geocode.location