השיטה הזו מבצעת גיאוקוד של כתובת, שממפה כתובת ל-LatLng. הוא גם מספק מידע מובנה על הכתובת.
בקשת HTTP
GET https://geocode.googleapis.com/v4beta/geocode/address
כתובת ה-URL משתמשת בתחביר של Transcoding של gRPC.
פרמטרים של שאילתה
פרמטרים | |
---|---|
locationBias |
אופציונלי. האזור שבו רוצים לחפש. המיקום הזה משמש כנטייה, כלומר יכול להיות שיוצגו תוצאות בסביבת המיקום הנתון. |
languageCode |
אופציונלי. השפה שבה התוצאות יוצגו. |
regionCode |
אופציונלי. קוד האזור. קוד האזור, שמצוין כערך בן שתי אותיות של דומיין ברמה עליונה עם קוד מדינה (ccTLD). הפרמטר משפיע על התוצאות בהתאם לדין החל. הפרמטר הזה ישפיע גם על התוצאות מהשירות, אבל לא יגביל אותן באופן מלא. |
פרמטר האיחוד address_input . הכתובת שרוצים להמיר לקואורדינטות. הערך של address_input יכול להיות רק אחת מהאפשרויות הבאות: |
|
addressQuery |
הכתובת ללא מבנה שרוצים להמיר לקואורדינטות. |
address |
הכתובת המובנית שרוצים להמיר לקואורדינטות בפורמט של כתובת למשלוח דואר. |
גוף הבקשה
גוף הבקשה חייב להיות ריק.
גוף התשובה
אם הפעולה מצליחה, גוף התגובה מכיל מופע של GeocodeAddressResponse
.
היקפי הרשאה
נדרש אחד מהיקפי ההרשאות הבאים של OAuth:
https://www.googleapis.com/auth/cloud-platform
https://www.googleapis.com/auth/maps-platform.geocode
https://www.googleapis.com/auth/maps-platform.geocode.address