Method: geocode.address.geocodeAddress

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

בקשת HTTP

GET https://geocode.googleapis.com/v4beta/geocode/address

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

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

פרמטרים
locationBias

object (LocationBias)

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

languageCode

string

אופציונלי. השפה שבה התוצאות יוצגו.

regionCode

string

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

פרמטר האיחוד address_input. הכתובת שרוצים להמיר לקואורדינטות. הערך של address_input יכול להיות רק אחת מהאפשרויות הבאות:
addressQuery

string

הכתובת ללא מבנה שרוצים להמיר לקואורדינטות.

address

object (PostalAddress)

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

גוף הבקשה

גוף הבקשה חייב להיות ריק.

גוף התשובה

אם הפעולה מצליחה, גוף התגובה מכיל מופע של 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