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 )

Плюс код местоположения в этом геокоде.

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.