Method: geocode.location.geocodeLocation

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

בקשת HTTP

GET https://geocode.googleapis.com/v4beta/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)

אופציונלי. מסנן של ספירה אחת או יותר של רמת פירוט של מיקום.
פרמטר של איחוד 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