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

שם המשאב של המקום הזה, בפורמט places/{placeId}. אפשר להשתמש בו כדי לחפש את המקום.

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

קבוצה של תגי סוג לתוצאה הזו. לדוגמה, "political" ו-"administrative_area".

הרשימה המלאה של הערכים האפשריים מופיעה בטבלה א' ובטבלה ב' בכתובת 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

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

הערכים האלה נלקחים מהטבלה של סוגי הכתובות וסוגי הרכיבים של הכתובות שמשמשת את Places API: https://developers.google.com/maps/documentation/places/web-service/place-types#address-types

languageCode

string

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