Package google.maps.geocode.v4beta

Индекс

GeocodeService

Сервис для выполнения геокодирования.

Геокод Адрес

rpc GeocodeAddress( GeocodeAddressRequest ) returns ( GeocodeAddressResponse )

Этот метод выполняет геокодирование адреса, сопоставляя его с координатами LatLng. Он также предоставляет структурированную информацию об адресе.

Области авторизации

Требуется одна из следующих областей OAuth:

  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/maps-platform.geocode
  • https://www.googleapis.com/auth/maps-platform.geocode.address
ГеокодированиеМестоположение

rpc GeocodeLocation( GeocodeLocationRequest ) returns ( GeocodeLocationResponse )

Этот метод выполняет геокодирование местоположения, сопоставляя координаты LatLng с адресом. Он также предоставляет структурированную информацию об адресе.

Области авторизации

Требуется одна из следующих областей OAuth:

  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/maps-platform.geocode
  • https://www.googleapis.com/auth/maps-platform.geocode.location
GeocodePlace

rpc GeocodePlace( GeocodePlaceRequest ) returns ( GeocodeResult )

Этот метод выполняет поиск геокода с использованием идентификатора места.

Области авторизации

Требуется одна из следующих областей OAuth:

  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/maps-platform.geocode
  • https://www.googleapis.com/auth/maps-platform.geocode.place

GeocodeAddressRequest

Запрос сообщения для GeocodeService.GeocodeAddress.

Поля
location_bias

GeocodeAddressRequest.LocationBias

Необязательно. Регион поиска. Это местоположение служит смещением, то есть результаты могут быть возвращены в указанном районе.

language_code

string

Необязательно. Язык, на котором должны быть возвращены результаты.

region_code

string

Необязательный. Код региона. Код региона, указанный как двухсимвольное значение ccTLD («домен верхнего уровня»). Параметр влияет на результаты поиска в соответствии с действующим законодательством. Этот параметр также влияет на результаты поиска, но не ограничивает их полностью.

Поле объединения address_input . Адрес для геокодирования address_input может быть только одним из следующих:
address_query

string

Неструктурированный адрес для геокодирования.

address

PostalAddress

Структурированный адрес для геокодирования в формате почтового адреса.

МестоположениеBias

Регион поиска. Это местоположение служит своего рода смещением, что означает, что результаты могут быть возвращены в указанном районе.

Поля
type поля объединения. Типы смещения местоположения. type может быть только одним из следующих:
rectangle

Viewport

Прямоугольный блок, определяемый северо-восточным и юго-западным углами. rectangle.high() должен быть северо-восточной точкой области просмотра прямоугольника. rectangle.low() должен быть юго-западной точкой области просмотра прямоугольника. rectangle.low().latitude() не может быть больше, чемrect.high rectangle.high().latitude() . Это приведет к пустому диапазону широт. Ширина области просмотра прямоугольника не может превышать 180 градусов.

GeocodeAddressResponse

Ответное сообщение для GeocodeService.GeocodeAddress .

Поля
results[]

GeocodeResult

Результат геокодирования.

GeocodeLocationRequest

Запрос сообщения для GeocodeService.GeocodeLocation.

Поля
language_code

string

Необязательно. Язык, на котором должны быть возвращены результаты.

region_code

string

Необязательный. Код региона. Код региона, указанный как двухсимвольное значение ccTLD («домен верхнего уровня»). Параметр влияет на результаты в соответствии с действующим законодательством.

types[]

string

Необязательно. Набор тегов типа для ограничения результатов. Результаты, не соответствующие ни одному из указанных типов, удаляются.

Полный список возможных значений см. в таблице A и таблице B по адресу https://developers.google.com/maps/documentation/places/web-service/place-types .

granularity[]

GeocodeResult.Granularity

Необязательно. Фильтр по одному или нескольким перечислениям с гранулярностью местоположения.

Поле объединения location_input . Местоположение для геокодирования. location_input может быть только одним из следующих:
location_query

string

Местоположение в формате строки «lat,lng». Например, «64.7611872,-18.4705364».

location

LatLng

Расположение в структурированном формате.

GeocodeLocationResponse

Ответное сообщение для GeocodeService.GeocodeLocation .

Поля
results[]

GeocodeResult

Результат геокодирования.

plus_code

PlusCode

Плюс код местоположения в запросе.

GeocodePlaceRequest

Запрос сообщения для GeocodeService.GeocodePlace.

Поля
place

string

Обязательно. Идентификатор места для геокодирования в формате places/{place}.

language_code

string

Необязательно. Язык, на котором должны быть возвращены результаты.

region_code

string

Необязательный. Код региона. Код региона, указанный как двухсимвольное значение ccTLD («домен верхнего уровня»). Параметр влияет на результаты в соответствии с действующим законодательством.

GeocodeResult

Результат геокодирования содержит географическую информацию о месте.

Поля
place

string

Полный идентификатор места для этого результата. В формате "//places.googleapis.com/places/{placeID}". Подробнее см. https://developers.google.com/maps/documentation/places/web-service/place-id .

place_id

string

Идентификатор места для этого результата.

location

LatLng

Широта этого адреса.

granularity

GeocodeResult.Granularity

Детализация местоположения.

viewport

Viewport

Область просмотра, подходящая для отображения результата геокодирования.

bounds

Viewport

Ограничивающая рамка для адреса.

formatted_address

string

Адрес в формате одной строки.

postal_address

PostalAddress

Адрес в формате почтового адреса.

address_components[]

GeocodeResult.AddressComponent

Повторяющиеся компоненты для каждого уровня местности.

postal_code_localities[]

LocalizedText

Полный список населенных пунктов, содержащихся в почтовом индексе.

Заполняется только в том случае, если результат имеет тип «почтовый_код».

types[]

string

Набор тегов типа для этого результата. Например, «политический» и «административный_район».

Полный список возможных значений см. в таблице A и таблице B по адресу https://developers.google.com/maps/documentation/places/web-service/place-types .

plus_code

PlusCode

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

АдресКомпонент

Структурированные компоненты, формирующие форматированный адрес, если эта информация доступна.

Поля
long_text

string

Полное текстовое описание или название компонента адреса. Например, компонент адреса для страны Австралия может иметь длинное название «Австралия».

short_text

string

Сокращенное текстовое название компонента адреса, если доступно. Например, компонент адреса для страны Австралия может иметь сокращенное название «AU».

types[]

string

Массив, указывающий тип(ы) компонента адреса.

Более подробную информацию см. по адресу https://developers.google.com/maps/documentation/geocoding/requests-geocoding#Types .

language_code

string

Язык, используемый для форматирования этих компонентов, в нотации CLDR.

Зернистость

Детализация местоположения.

Перечисления
GRANULARITY_UNSPECIFIED Не использовать.
ROOFTOP Неинтерполированное местоположение фактического участка земли, соответствующего сопоставляемому адресу.
RANGE_INTERPOLATED Интерполировано из диапазона номеров улиц. Например, если мы знаем, что участок Амфитеатр-Парквей содержит номера 1600–1699, то число 1650 может располагаться посередине между его конечными точками.
GEOMETRIC_CENTER Геометрический центр объекта, для которого у нас есть полигональные данные.
APPROXIMATE Все остальное.

PlusCode

Плюс-код ( http://plus.codes ) — это ссылка на местоположение в двух форматах: глобальный код, определяющий прямоугольник размером 14x14 м (1/8000 градуса) или меньше, и составной код, заменяющий префикс на ссылку на местоположение.

Поля
global_code

string

Глобальный (полный) код места, например «9FWM33GV+HQ», представляющий область размером 1/8000 на 1/8000 градуса (~14 на 14 метров).

compound_code

string

Составной код места, например «33GV+HQ, Ramberg, Norway», содержащий суффикс глобального кода и заменяющий префикс форматированным именем ссылочной сущности.