Package google.maps.geocode.v4alpha

Содержание

DestinationService

Сервис для получения целевых страниц.

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

SearchDestinations

rpc SearchDestinations(SearchDestinationsRequest) returns (SearchDestinationsResponse)

Этот метод выполняет поиск целевых страниц и возвращает их список.

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

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

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

GeocodeService

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

GeocodeAddress

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
GeocodeLocation

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

Место назначения

Целевой сервис. в том числе основное место, связанные места, входы и точки навигации.

Поля
primary

PlaceView

Основное место, определяемое параметром primary_query в запросе.
containing_places[]

PlaceView

Менее точные места, в которых находится основное место. Например, жилой комплекс, в котором находится это здание.
sub_destinations[]

PlaceView

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

Примечание. По сравнению с SubDestination, возвращаемым Places API, этот список дополнительных пунктов назначения более полный, и каждый из них содержит больше информации.
landmarks[]

Landmark

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

Entrance

Входы в это место.
navigation_points[]

NavigationPoint

Точки навигации для этого пункта назначения.
parking_options

Destination.ParkingOptions

Варианты парковки в этом пункте назначения.
arrival_summary

Destination.ArrivalSummary

Сводка о прибытии в пункт назначения, созданная ИИ.

ArrivalSummary

Сводка о прибытии в пункт назначения, созданная ИИ.

Поля
text

LocalizedText

Краткое описание прибытия в пункт назначения.
flag_content_url

string

Ссылка, по которой пользователи могут сообщить о проблеме с кратким пересказом.
disclosure_text

LocalizedText

Только для вывода. Содержит текст раскрытия информации для сводки о прибытии.

ParkingOptions

Информация о парковках в пункте назначения.

Поля
availability

Destination.ParkingOptions.Availability

Доступность парковки в этом месте.
parking_facilities[]

Destination.ParkingOptions.ParkingFacility

Парковка в пункте назначения.
onsite_parking

bool

На территории отеля есть парковка.
free_parking_lot

bool

Есть бесплатная парковка.
paid_parking_lot

bool

Есть платные парковки.
free_street_parking

bool

Есть бесплатная уличная парковка.
paid_street_parking

bool

Есть платная уличная парковка.
valet_parking

bool

Есть услуги парковщика.
free_garage_parking

bool

Есть бесплатная крытая стоянка.
paid_garage_parking

bool

Есть платная крытая парковка.

Доступность

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

В будущем могут быть добавлены новые значения.

Перечисления
AVAILABILITY_UNSPECIFIED Информация о наличии парковки недоступна.
PLENTY Парковочных мест достаточно.
SOMEWHAT_DIFFICULT Парковку найти непросто.
DIFFICULT Найти место для парковки очень сложно.

ParkingFacility

Отдельный вариант парковки (например, конкретный гараж или стоянка), связанный с пунктом назначения. В нем содержится подробная информация об определенной парковке, а в родительском сообщении ParkingOptions – сводные данные обо всех доступных парковках.

Поля
place

PlaceView

Представление места для этой парковки.
onsite

bool

Расположена ли парковка на территории основного пункта назначения. Если это поле не заполнено, статус неизвестен.
popular

bool

Популярна ли эта парковка среди посетителей, направляющихся к основному пункту назначения. Если это поле не заполнено, статус популярности неизвестен.
straight_line_distance_meters

double

Расстояние по прямой в метрах от основного пункта назначения до этой парковки.

Вход

Вход – это пара координат широты и долготы, определяющая местоположение точки входа и выхода для места.

Поля
display_name

LocalizedText

Понятное название, например "Выход B", "Южный вход", "Вход с 5-й авеню".
location

LatLng

Местоположение входа.
tags[]

Entrance.Tag

Список тегов, описывающих вход.
place

string

Объект, на котором физически расположен вход, в формате places/{place_id}.
street_view_thumbnail

StreetViewThumbnail

Значок Просмотра улиц, на котором показан вход. Изображение можно запросить из Street View Static API. Подробнее: https://developers.google.com/maps/documentation/streetview/request-streetview.
street_view_annotation

ImageAnnotation

Аннотация входа на street_view_thumbnail, возвращенная выше.

Тег

Характеристики, описывающие вход.

Перечисления
TAG_UNSPECIFIED Не используется.
PREFERRED

Вход, скорее всего, обеспечивает физический доступ к основному месту в возвращенном пункте назначения. У места может быть несколько предпочтительных входов. Если у входа нет такого тега, значит он находится в том же здании, что и основное место, но не обязательно ведет к нему.

Например, если основное место – это ресторан в торговом центре, то входы со статусом PREFERRED будут вести в сам ресторан, а остальные – в другие части здания, например в другие рестораны.

Если основное место – это здание, то входы PREFERRED будут вести в его главную часть. Например, в торговом центре входы PREFERRED будут вести в главное фойе, а вход, ведущий только в магазин сбоку здания, не будет входом PREFERRED.

Примечание. Вход, отмеченный как PREFERRED, может не вести к основному месту, а вход, не отмеченный как PREFERRED, может вести к основному месту.

GeocodeAddressRequest

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

Поля
location_bias

GeocodeAddressRequest.LocationBias

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

string

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

string

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

GeocodeAddressRequest.Effort

Необязательное поле. Уровень усилий, запрошенный клиентом.
Объединенное поле address_input. Адрес, для которого нужно выполнить геокодирование. address_input может иметь одно из следующих значений:
address_query

string

Адрес в произвольном формате, для которого нужно выполнить геокодирование.
address

PostalAddress

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

Частота использования

Уровень усилий, выделенных на геокодирование адреса.

Перечисления
EFFORT_UNSPECIFIED Значение по умолчанию.
LOW Оптимизирована для максимально быстрого ответа. Не выполняет расширенный поиск и не устраняет неоднозначность для сложных адресов.
MEDIUM Баланс между скоростью и точностью. Большинство запросов возвращаются со стандартной низкой задержкой. Для неоднозначных или сложных адресов сервис применяет дополнительную обработку, чтобы повысить точность, с ограниченной задержкой, которая может занять до нескольких секунд. Рекомендуется для интерактивных рабочих процессов, в которых пользователи могут подождать некоторое время.
HIGH Максимально повышает точность распознавания сложных, неформальных или основанных на ориентирах адресов. Время ответа может быть значительно больше. Рекомендуется для фоновых, пакетных или логистических рабочих процессов.

LocationBias

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

Поля
Объединенное поле type. Типы предпочтительного местоположения. type может иметь одно из следующих значений:
rectangle

Viewport

Прямоугольная область, заданная северо-восточным и юго-западным углами. rectangle.high() – северо-восточная точка прямоугольной области просмотра. rectangle.low() – юго-западная точка прямоугольной области просмотра. Значение в поле "rectangle.low().latitude()" не может быть больше, чем в поле "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

Код Plus Code местоположения в запросе.

GeocodePlaceRequest

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

Поля
place

string

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

string

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

string

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

GeocodeResult

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

Поля
place

string

Название ресурса места в формате places/{placeId}. Используется для поиска места.
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

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

Заполняется, только если результат имеет тип postal_code.
types[]

string

Набор тегов типа для этого результата. Например, "political" и "administrative_area".

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

PlusCode

Код Plus Code местоположения в этом геокоде.

AddressComponent

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

Поля
long_text

string

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

string

Сокращенное текстовое название компонента адреса (если есть). Например, компонент адреса для Австралии может содержать сокращенное название "AU".
types[]

string

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

Эти значения взяты из таблицы типов адресов и их компонентов, которая используется в Places API: https://developers.google.com/maps/documentation/places/web-service/place-types#address-types.
language_code

string

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

Уровень детализации

Уровень детализации местоположения.

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

ImageAnnotation

Аннотация на уменьшенном изображении, например многоугольник, обозначающий вход.

Поля
coordinates[]

ImageAnnotation.Coordinate

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

Координата

Пиксельные координаты точки на изображении. Начало координат (0,0) – это верхний левый угол верхнего левого пикселя изображения. Ось X направлена вправо, а ось Y – вниз.

Поля
x_px

float

Координата X.
y_px

float

Координата Y.

Ориентир

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

Поля
relational_description

LocalizedText

Человекочитаемое описание того, как пункт назначения связан с ориентиром. Например, "Рядом с Эмпайр-стейт-билдинг" или "Напротив Белого дома".
tags[]

Landmark.Tag

Теги, описывающие, как ориентир может использоваться в контексте пункта назначения.
straight_line_distance_meters

double

Только для вывода. Расстояние по прямой от этого ориентира до пункта назначения в метрах.
travel_distance_meters

double

Только для вывода. Расстояние пешком от ориентира до пункта назначения в метрах.
Объединенное поле landmark. ориентир; landmark может иметь одно из следующих значений:
place

PlaceView

Место, которое представляет этот ориентир.

Тег

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

Если в адресе есть теги ADDRESS и ARRIVAL, значит ориентир находится рядом с пунктом назначения и хорошо известен местным жителям.

Перечисления
TAG_UNSPECIFIED Не используется.
ADDRESS Местное известное место, которое можно использовать для определения приблизительного местоположения пункта назначения. Обычно в пределах нескольких сотен метров от пункта назначения. Они похожи на ориентиры, возвращаемые функцией дескрипторов адресов Geocoding API: https://developers.google.com/maps/documentation/geocoding/address-descriptors/requests-address-descriptors.
ARRIVAL Место, которое можно использовать в качестве ориентира, чтобы добраться до пункта назначения. Полезно для навигации, когда вы находитесь близко к пункту назначения. Например, это может быть здание через дорогу от пункта назначения. Ориентир с этим тегом обычно находится ближе к пункту назначения, чем ориентиры с тегом ADDRESS.

Точка навигации – это место рядом с дорогой, где может закончиться маршрут.

Поля
navigation_point_token

string

Только для вывода. Токен, который можно использовать для идентификации этой точки навигации.
display_name

LocalizedText

Отображаемое название этой точки навигации. Пример: "5-я авеню" или "Выход B".
location

LatLng

Точка рядом с сегментом дороги, где должна заканчиваться навигация. Точка намеренно немного смещена от осевой линии дороги, чтобы четко обозначить сторону дороги, на которой находится место.
travel_modes[]

NavigationPoint.TravelMode

Способы передвижения, подходящие для этой точки навигации.
usages[]

NavigationPoint.Usage

Список usages, поддерживаемых этой точкой навигации. Если поле пустое, это не обязательно означает, что использование ограничено. Все точки навигации можно использовать для общей навигации.
street_view_thumbnail

StreetViewThumbnail

Значок Просмотра улиц, на котором показана точка навигации (если доступно). Изображение можно запросить из Street View Static API. Подробнее: https://developers.google.com/maps/documentation/streetview/request-streetview.
entrance_annotation

ImageAnnotation

Аннотация входа, связанного с этой точкой навигации на street_view_thumbnail, возвращенном выше (если доступно).
altitude_meters

float

Высота точки навигации в метрах относительно эллипсоида WGS-84.

TravelMode

Способы передвижения, подходящие для этой точки навигации.

Перечисления
TRAVEL_MODE_UNSPECIFIED Не используется.
DRIVE Подходит для вождения.
WALK Подходит для пеших прогулок.

Использование

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

Перечисления
USAGE_UNSPECIFIED Не используется.
UNKNOWN Указывает, что тип использования неизвестен.
DROPOFF Подходит для высадки пассажиров. Например, место высадки пассажиров.
PICKUP Подходит для посадки пассажиров. Например, место посадки в такси.
PARKING Подходит для парковки. например на парковке.

PlaceView

Представляет представление места в Places API. Кроме того, в нем есть дополнительные сведения о пунктах назначения, например тип структуры и многоугольник отображения.

В некоторых случаях ответ PlaceView с тем же идентификатором места может отличаться от того, что возвращает Places API для полей types и display_name.

Поля
place

string

Название ресурса места в формате places/{placeId}. Используется для поиска места.
place_id

string

Уникальный идентификатор места.
display_name

LocalizedText

Понятное человеку описание места. Пример: "Выход B", "Макдоналдс".
primary_type

string

Основной тип этого места. Список возможных значений приведен на странице https://developers.google.com/maps/documentation/places/web-service/place-types.

Примечание. Это поле заполняется не всегда. В таких случаях используйте поле types.
types[]

string

Все типы, связанные с этим местом. Список возможных значений приведен на странице https://developers.google.com/maps/documentation/places/web-service/place-types.
formatted_address

string

Адрес в одну строку.
postal_address

PostalAddress

Структурированный адрес.
structure_type

PlaceView.StructureType

Тип структуры, соответствующий этому месту.
location

LatLng

Местоположение этого места. Для мест с многоугольниками отображения это может быть хорошим местом для размещения маркера на карте.
display_polygon

Struct

Контур места в формате GeoJSON, использующий формат RFC 7946: https://datatracker.ietf.org/doc/html/rfc7946#section-3.1.6.

Примечание. Формат RFC 7946 поддерживает MultiPolygon, поэтому один объект display_polygon может представлять несколько многоугольников.
address_components[]

PlaceView.AddressComponent

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

AddressComponent

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

Поля
long_text

string

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

string

Сокращенное текстовое название компонента адреса (если есть). Например, компонент адреса для Австралии может содержать сокращенное название "AU".
types[]

string

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

Эти значения взяты из таблицы типов адресов и их компонентов, которая используется в Places API: https://developers.google.com/maps/documentation/places/web-service/place-types#address-types.
language_code

string

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

StructureType

Тип строения, которое представляет это место.

Перечисления
STRUCTURE_TYPE_UNSPECIFIED Не используется.
POINT Точка на карте.
SECTION Часть здания.
BUILDING Здание.
GROUNDS Большая территория, на которой обычно расположено несколько зданий, например университетский кампус, жилой комплекс или торговый центр.

PlusCode

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

Поля
global_code

string

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

string

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

SearchDestinationsRequest

Сообщение запроса для DestinationService.SearchDestinations.

Поля
travel_modes[]

NavigationPoint.TravelMode

Необязательное поле. Способы передвижения, для которых нужно отфильтровать точки навигации. Это влияет на поле navigation_points, возвращаемое в ответе. Если значение не указано, возвращаются точки навигации для всех способов передвижения.
language_code

string

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

string

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

SearchDestinationsRequest.Effort

Необязательное поле. Уровень усилий, запрошенный клиентом.

Объединенное поле primary_query. Запрос для основного целевого сервиса. Это может быть место, полный адрес или координаты LatLng. Некоторые места и адреса с минимальной информацией не могут быть преобразованы в пункт назначения.

Целевые страницы создаются на основе указанного основного запроса.

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

string

Название ресурса места в формате places/{place_id}.
address_query

SearchDestinationsRequest.AddressQuery

Почтовый адрес.
location_query

SearchDestinationsRequest.LocationQuery

Точное местоположение.

AddressQuery

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

Поля
Объединенное поле kind. Запрос адреса. kind может иметь одно из следующих значений:
address

PostalAddress

Почтовый адрес в формате почтового адреса.
address_query

string

Почтовый адрес, записанный в одну строку.

Частота использования

Уровень усилий, выделенных на разрешение целевых страниц.

Перечисления
EFFORT_UNSPECIFIED Значение по умолчанию.
LOW Оптимизирована для максимально быстрого ответа. Выполняет прямой поиск пункта назначения без расширенного обхода иерархии или сложного устранения неоднозначности места.
MEDIUM Баланс между скоростью и точностью. Большинство запросов возвращаются со стандартной низкой задержкой. Для неоднозначных запросов, сайтов с несколькими зданиями или сложных местоположений сервис применяет дополнительную обработку для разрешения пунктов назначения и иерархического контекста с ограниченной задержкой, которая может занять до нескольких секунд. Рекомендуется для интерактивных рабочих процессов, в которых пользователи могут подождать некоторое время.
HIGH Повышает точность и полноту определения пункта назначения для сложных, неформальных или обширных локаций (например, крупных кампусов или жилых комплексов). Время ответа может быть значительно больше. Рекомендуется для фоновых, пакетных, диспетчерских или логистических рабочих процессов предварительной маршрутизации.

LocationQuery

Запрос местоположения для определения ближайшего основного пункта назначения.

Примечание. Если запрос местоположения находится в здании, содержащем дополнительные помещения, возможно, что возвращенное основное место является дополнительным помещением. В таких случаях поле containing_places будет содержать здание.

Поля
place_filter

SearchDestinationsRequest.LocationQuery.PlaceFilter

Необязательное поле. Фильтры, которые нужно применить к целевым кандидатам.
Объединенное поле kind. Запрос местоположения. kind может иметь одно из следующих значений:
location

LatLng

Точное местоположение LatLng.

PlaceFilter

Фильтры, которые нужно применить к целевым кандидатам.

Поля
structure_type

PlaceView.StructureType

Необязательное поле. Если указано, то у всех пунктов назначения гарантированно будет основное место с этим типом структуры. Это может привести к фильтрации некоторых пунктов назначения или к уточнению/уточнению возвращенных пунктов назначения.

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

Ещё одно применение этого поля – упрощение извлечения многоугольников, представляющих здания. Например, если указано BUILDING, то многоугольник отображения основного места будет соответствовать зданию в указанном местоположении.
addressability

SearchDestinationsRequest.LocationQuery.PlaceFilter.Addressability

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

Адресуемость

Определяет параметры фильтрации по доступности. В будущем могут быть добавлены новые значения.

Перечисления
ADDRESSABILITY_UNSPECIFIED Если значение не указано, сервис выберет подходящее значение по умолчанию.
ANY Адресуемость не является критерием фильтрации. Целевые страницы возвращаются независимо от их доступности.
PRIMARY Все возвращенные пункты назначения будут иметь основное место с адресом на уровне улицы или названием.
WEAK Все возвращенные пункты назначения будут иметь либо основное место, либо дополнительный пункт назначения с адресом или названием на уровне улицы.

SearchDestinationsResponse

Ответ для DestinationService.SearchDestinations.

Поля
destinations[]

Destination

Список пунктов назначения.

Сервис возвращает один результат, если по основному запросу можно однозначно определить основной пункт назначения. В противном случае сервис может вернуть несколько результатов для уточнения или не вернуть ни одного.

StreetViewThumbnail

Параметры для представления значка Google Просмотра улиц. Эти параметры можно использовать для запроса изображения Просмотра улиц из Street View Static API. Подробнее: https://developers.google.com/maps/documentation/streetview/request-streetview.

Поля
pano

string

Идентификатор панорамы.
width_px

int32

Ширина значка в пикселях. Примечание. При запросе аннотаций вместе со значком эти значения высоты и ширины должны использоваться в запросе Street View API, чтобы координаты аннотации правильно совпадали с изображением.
height_px

int32

Высота значка в пикселях. Примечание. При запросе аннотаций вместе со значком эти значения высоты и ширины должны использоваться в запросе Street View API, чтобы координаты аннотации правильно совпадали с изображением.
heading_degree

float

Горизонтальная ориентация камеры в градусах. Диапазон: [0, 360). 0 означает север, а 90 – восток.
pitch_degree

float

Вертикальная ориентация камеры в градусах. Диапазон: [-90, 90]. 0 – горизонт, +90 – строго вверх, -90 – строго вниз.
fov_degree

float

Горизонтальная зона обзора в градусах. Диапазон: (0, 180]. Управляет уровнем масштабирования. Чем меньше поле зрения, тем больше увеличение.