השיטה הזו מבצעת קידוד גיאוגרפי של מיקום, שממפה LatLng לכתובת. הוא גם מספק מידע מובנה על הכתובת.
בקשת HTTP
GET https://geocode.googleapis.com/v4beta/geocode/location/{locationQuery}
כתובת ה-URL משתמשת בתחביר של gRPC Transcoding.
פרמטרים של נתיב
פרמטרים | |
---|---|
פרמטר של איחוד location_input . המיקום להמרה לקואורדינטות. הערך location_input יכול להיות רק אחד מהבאים: |
|
locationQuery |
המיקום בפורמט של מחרוזת 'lat,lng'. לדוגמה, "64.7611872,-18.4705364". |
פרמטרים של שאילתה
פרמטרים | |
---|---|
languageCode |
אופציונלי. השפה שבה התוצאות צריכות להיות מוצגות. |
regionCode |
אופציונלי. קוד אזור. קוד האזור, שמוגדר כערך של שני תווים של ccTLD (דומיין ברמה העליונה). הפרמטר משפיע על התוצאות בהתאם לדין החל. |
types[] |
אופציונלי. קבוצה של תגי סוג להגבלת התוצאות. תוצאות שלא כוללות אף אחד מהסוגים שצוינו יוסרו. רשימה מלאה של הערכים האפשריים מופיעה בטבלה א' ובטבלה ב' בכתובת https://developers.google.com/maps/documentation/places/web-service/place-types. |
granularity[] |
אופציונלי. מסנן של ספירה אחת או יותר של רמת פירוט של מיקום. |
פרמטר של איחוד location_input . המיקום להמרה לקואורדינטות. הערך location_input יכול להיות רק אחד מהבאים: |
|
location |
המיקום בפורמט המובנה. |
גוף הבקשה
גוף הבקשה צריך להיות ריק.
גוף התשובה
אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכיל מופע של 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