Method: geocode.address.geocodeAddressQuery

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

בקשת HTTP

GET https://geocode.googleapis.com/v4beta/geocode/address/{addressQuery}

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

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

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

string

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

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

פרמטרים
locationBias

object (GeocodeAddressRequest.LocationBias)

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

languageCode

string

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

regionCode

string

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

פרמטר של איחוד address_input. הכתובת להמרה לקואורדינטות. הערך address_input יכול להיות רק אחד מהבאים:
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