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

مجموعه‌ای از برچسب‌های نوع برای این نتیجه. به عنوان مثال، "political" و "administrative_area".

برای لیست کامل مقادیر ممکن، به جدول A و جدول B در آدرس https://developers.google.com/maps/documentation/places/web-service/place-types مراجعه کنید.

plusCode

object ( PlusCode )

کد پلاس مکان در این کد جغرافیایی.

کامپوننت آدرس نتیجه کد جغرافیایی

اجزای ساختاریافته‌ای که آدرس قالب‌بندی‌شده را تشکیل می‌دهند، در صورتی که این اطلاعات در دسترس باشد.

نمایش JSON 
{
  "longText": string,
  "shortText": string,
  "types": [
    string
  ],
  "languageCode": string
}
فیلدها
longText

string

توضیحات کامل متنی یا نام کامپوننت آدرس. برای مثال، یک کامپوننت آدرس برای کشور استرالیا ممکن است نام طولانی "Australia" داشته باشد.

shortText

string

در صورت وجود، یک نام متنی مختصر برای مؤلفه آدرس. برای مثال، یک مؤلفه آدرس برای کشور استرالیا ممکن است نام کوتاه "AU" داشته باشد.

types[]

string

آرایه‌ای که نوع(های) مؤلفه آدرس را نشان می‌دهد.

برای جزئیات بیشتر به https://developers.google.com/maps/documentation/geocoding/requests-geocoding#Types مراجعه کنید.

languageCode

string

زبانی که برای قالب‌بندی این مؤلفه استفاده شده است، با نمادگذاری CLDR.