Method: geocode.location.geocodeLocationQuery

• בקשת HTTP
• פרמטרים של נתיב
• פרמטרים של שאילתות
• גוף הבקשה
• גוף התשובה
• היקפי הרשאה

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

בקשת HTTP

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

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

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

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