GeocodeResult

תוצאה של גיאו-קוד מכילה מידע גיאוגרפי על מקום.

ייצוג ב-JSON 
{
  "place": string,
  "placeId": string,
  "location": {
    object (LatLng)
  },
  "granularity": enum (GeocodeResult.Granularity),
  "viewport": {
    object (Viewport)
  },
  "bounds": {
    object (Viewport)
  },
  "formattedAddress": string,
  "postalAddress": {
    object (PostalAddress)
  },
  "addressComponents": [
    {
      object (GeocodeResult.AddressComponent)
    }
  ],
  "postalCodeLocalities": [
    {
      object (LocalizedText)
    }
  ],
  "types": [
    string
  ],
  "plusCode": {
    object (PlusCode)
  }
}
שדות
place

string

נדרשת פעולה ממשתמשי גרסה v4alpha/v4beta: בקרוב השדה הזה יעודכן מהפורמט הישן '//places.googleapis.com/places/{placeID}” לפורמט החדש 'places/{placeId}". חשוב לוודא שהאפליקציה יכולה לטפל בשני הפורמטים במהלך תקופת המעבר. הפורמט הישן צפוי לצאת משימוש באופן מלא עד סוף מאי 2026.

מזהה המקום שמוגדר במלואו של התוצאה הזו. בפורמט ‎//places.googleapis.com/places/{placeID}‎. פרטים נוספים זמינים בכתובת https://developers.google.com/maps/documentation/places/web-service/place-id.
placeId

string

המזהה הייחודי של מקום.
location

object (LatLng)

הקואורדינטות של הכתובת הזו.
granularity

enum (GeocodeResult.Granularity)

רמת הפירוט של המיקום.
viewport

object (Viewport)

אזור תצוגה שמתאים להצגת תוצאת הקידוד הגיאוגרפי.
bounds

object (Viewport)

תיבה תוחמת של הכתובת.
formattedAddress

string

הכתובת בפורמט של שורה אחת.
postalAddress

object (PostalAddress)

הכתובת בפורמט של כתובת למשלוח דואר.
addressComponents[]

object (GeocodeResult.AddressComponent)

רכיבים שחוזרים על עצמם בכל רמת יישוב.
postalCodeLocalities[]

object (LocalizedText)

רשימה מלאה של היישובים שכלולים במיקוד.

השדה הזה מאוכלס רק אם התוצאה היא מסוג postal_code (מיקוד).
types[]

string

קבוצה של תגי סוג לתוצאה הזו. לדוגמה, 'פוליטי' ו'אזור אדמיניסטרטיבי'.

רשימה מלאה של הערכים האפשריים מופיעה בטבלה A ובטבלה B בכתובת https://developers.google.com/maps/documentation/places/web-service/place-types.
plusCode

object (PlusCode)

‫Plus Code של המיקום בגיאו-קידוד הזה.

GeocodeResult.AddressComponent

הרכיבים המובנים שמרכיבים את הכתובת המעוצבת, אם המידע הזה זמין.

ייצוג ב-JSON 
{
  "longText": string,
  "shortText": string,
  "types": [
    string
  ],
  "languageCode": string
}
שדות
longText

string

התיאור המלא של רכיב הכתובת או השם שלו. לדוגמה, רכיב כתובת של המדינה אוסטרליה יכול להיות עם שם ארוך 'אוסטרליה'.
shortText

string

שם טקסטואלי מקוצר של רכיב הכתובת, אם יש כזה. לדוגמה, רכיב כתובת של אוסטרליה יכול להיות עם שם מקוצר של 'AU'.
types[]

string

מערך שמציין את הסוגים של רכיב הכתובת.

פרטים נוספים זמינים בכתובת https://developers.google.com/maps/documentation/geocoding/requests-geocoding#Types.
languageCode

string

השפה שמשמשת לעיצוב הרכיב הזה, בסימון CLDR.