Method: geocode.location.geocodeLocation

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

בקשת HTTP

GET https://geocode.googleapis.com/v4/geocode/location

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

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

פרמטרים
languageCode

string

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

string

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

string

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

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

enum (GeocodeResult.Granularity)

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

string

המיקום בפורמט של מחרוזת "lat,lng". לדוגמה, "64.7611872,-18.4705364".
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