Method: geocode.location.geocodeLocation

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

בקשת HTTP

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

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

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

פרמטרים
languageCode

string

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

regionCode

string

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

types[]

string

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

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

granularity[]

enum (GeocodeResult.Granularity)

אופציונלי. מסנן של ספירות (enum) של רמת פירוט של מיקום אחת או יותר.

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