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