Method: geocode.address.geocodeAddressQuery

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

בקשת HTTP

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

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

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

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

string

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

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

פרמטרים
locationBias

object (GeocodeAddressRequest.LocationBias)

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

string

אופציונלי. השפה שצריך להחזיר בה את התוצאות.
regionCode

string

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

enum (GeocodeAddressRequest.Effort)

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