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

مجموعة من علامات النوع لهذه النتيجة على سبيل المثال، "سياسي" و "منطقة إدارية".

للاطّلاع على القائمة الكاملة بالقيم المحتملة، يُرجى الرجوع إلى الجدول "أ" والجدول "ب" على الرابط https://developers.google.com/maps/documentation/places/web-service/place-types.
plusCode

object (PlusCode)

رمز Plus Codes للموقع الجغرافي في هذا الرمز الجغرافي

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.