Содержание
DestinationService(интерфейс)GeocodeService(интерфейс)Destination(сообщение)Destination.ArrivalSummary(сообщение)Destination.ParkingOptions(сообщение)Destination.ParkingOptions.Availability(перечисление)Destination.ParkingOptions.ParkingFacility(сообщение)Entrance(сообщение)Entrance.Tag(перечисление)GeocodeAddressRequest(сообщение)GeocodeAddressRequest.LocationBias(сообщение)GeocodeAddressResponse(сообщение)GeocodeLocationRequest(сообщение)GeocodeLocationResponse(сообщение)GeocodePlaceRequest(сообщение)GeocodeResult(сообщение)GeocodeResult.AddressComponent(сообщение)GeocodeResult.Granularity(перечисление)ImageAnnotation(сообщение)ImageAnnotation.Coordinate(сообщение)Landmark(сообщение)Landmark.Tag(перечисление)NavigationPoint(сообщение)NavigationPoint.TravelMode(перечисление)NavigationPoint.Usage(перечисление)PlaceView(сообщение)PlaceView.AddressComponent(сообщение)PlaceView.StructureType(перечисление)PlusCode(сообщение)SearchDestinationsRequest(сообщение)SearchDestinationsRequest.AddressQuery(сообщение)SearchDestinationsRequest.LocationQuery(сообщение)SearchDestinationsRequest.LocationQuery.PlaceFilter(сообщение)SearchDestinationsRequest.LocationQuery.PlaceFilter.Addressability(перечисление)SearchDestinationsResponse(сообщение)StreetViewThumbnail(сообщение)
DestinationService
Сервис для получения целевых страниц.
Пункт назначения предоставляет иерархический контекст о месте, что позволяет, например, находить многоквартирные дома в более крупном жилом комплексе и наоборот. Он также предоставляет точки навигации, подходящие для таких сценариев использования, как совместное использование автомобилей или доставка.
| SearchDestinations |
|---|
|
Этот метод выполняет поиск целевых страниц и возвращает их список.
|
GeocodeService
Сервис для геокодирования.
| GeocodeAddress |
|---|
|
Этот метод выполняет геокодирование адреса, сопоставляя его с координатами LatLng. Он также предоставляет структурированную информацию об адресе.
|
| GeocodeLocation |
|---|
|
Этот метод выполняет геокодирование местоположения, сопоставляя координаты LatLng с адресом. Он также предоставляет структурированную информацию об адресе.
|
| GeocodePlace |
|---|
|
Этот метод выполняет геокодирование по идентификатору места.
|
Место назначения
Целевой сервис. Это включает основное место, связанные места, входы и точки навигации.
| Поля | |
|---|---|
primary |
Основное место, определяемое параметром |
containing_places[] |
Менее точные места, в которых находится основное место. Например, жилой комплекс, в котором находится это здание. |
sub_destinations[] |
Более точные подпункты назначения основного места. Например, помещения в здании. Примечание. По сравнению с SubDestination, возвращаемым Places API, этот список дополнительных пунктов назначения более полный, и каждый из них содержит больше информации. |
landmarks[] |
Ориентиры, которые можно использовать, чтобы сообщить, где находится пункт назначения, или помочь добраться до него. |
entrances[] |
Входы в это место. |
navigation_points[] |
Точки навигации для этого пункта назначения. |
parking_options |
Варианты парковки в этом пункте назначения. |
arrival_summary |
Сводка о прибытии в пункт назначения, созданная ИИ. |
ArrivalSummary
Сводка о прибытии в пункт назначения, созданная ИИ.
| Поля | |
|---|---|
text |
Краткое описание прибытия в пункт назначения. |
flag_content_url |
Ссылка, по которой пользователи могут сообщить о проблеме с кратким пересказом. |
disclosure_text |
Только для вывода. Содержит текст раскрытия информации для сводки о прибытии. |
ParkingOptions
Информация о парковках в пункте назначения.
| Поля | |
|---|---|
availability |
Доступность парковки в этом месте. |
parking_facilities[] |
Парковка в пункте назначения. |
onsite_parking |
На территории отеля есть парковка. |
free_parking_lot |
Есть бесплатная парковка. |
paid_parking_lot |
Есть платные парковки. |
free_street_parking |
Есть бесплатная уличная парковка. |
paid_street_parking |
Есть платная уличная парковка. |
valet_parking |
Есть услуги парковщика. |
free_garage_parking |
Есть бесплатная крытая стоянка. |
paid_garage_parking |
Есть платная крытая парковка. |
Доступность
Общая оценка того, насколько сложно найти парковку рядом с этим местом.
В будущем могут быть добавлены новые значения.
| Перечисления | |
|---|---|
AVAILABILITY_UNSPECIFIED |
Информация о наличии парковки недоступна. |
PLENTY |
Парковочных мест достаточно. |
SOMEWHAT_DIFFICULT |
Парковку найти непросто. |
DIFFICULT |
Найти место для парковки очень сложно. |
ParkingFacility
Отдельный вариант парковки (например, конкретный гараж или стоянка), связанный с пунктом назначения. В нем содержится подробная информация об определенной парковке, а в родительском сообщении ParkingOptions – сводные данные обо всех доступных парковках.
| Поля | |
|---|---|
place |
Представление места для этой парковки. |
onsite |
Расположена ли парковка на территории основного пункта назначения. Если это поле не заполнено, статус неизвестен. |
popular |
Популярна ли эта парковка среди посетителей, направляющихся к основному пункту назначения. Если это поле не заполнено, статус популярности неизвестен. |
straight_line_distance_meters |
Расстояние по прямой в метрах от основного пункта назначения до этой парковки. |
Вход
Вход – это пара координат широты и долготы, определяющая местоположение точки входа и выхода для места.
| Поля | |
|---|---|
display_name |
Понятное название, например "Выход B", "Южный вход", "Вход с 5-й авеню". |
location |
Местоположение входа. |
tags[] |
Список тегов, описывающих вход. |
place |
Объект, на котором физически расположен вход, в формате |
street_view_thumbnail |
Значок Просмотра улиц, на котором показан вход. Изображение можно запросить из Street View Static API. Подробнее: https://developers.google.com/maps/documentation/streetview/request-streetview. |
street_view_annotation |
Аннотация входа на |
Тег
Характеристики, описывающие вход.
| Перечисления | |
|---|---|
TAG_UNSPECIFIED |
Не используется. |
PREFERRED |
Вход, скорее всего, обеспечивает физический доступ к основному месту в возвращенном пункте назначения. У места может быть несколько предпочтительных входов. Если у входа нет такого тега, значит он находится в том же здании, что и основное место, но не обязательно ведет к нему. Например, если основное место – это ресторан в торговом центре, то входы со статусом PREFERRED будут вести в сам ресторан, а остальные – в другие части здания, например в другие рестораны. Если основное место – это здание, то входы Примечание. Вход, отмеченный как |
GeocodeAddressRequest
Сообщение запроса для GeocodeService.GeocodeAddress.
| Поля | |
|---|---|
location_bias |
Необязательное поле. Регион, в котором выполняется поиск. Это местоположение служит смещением, то есть результаты вокруг него будут предпочтительными. |
language_code |
Необязательное поле. Язык, на котором должны быть возвращены результаты. |
region_code |
Необязательное поле. Код региона. Код региона, указываемый как двухсимвольное значение национального домена верхнего уровня (ccTLD). Параметр влияет на результаты в соответствии с действующим законодательством. Этот параметр также влияет на результаты работы сервиса, но не ограничивает их полностью. |
Объединенное поле address_input. Адрес, для которого нужно выполнить геокодирование. address_input может иметь одно из следующих значений: |
|
address_query |
Адрес в произвольном формате, для которого нужно выполнить геокодирование. |
address |
Структурированный адрес для геокодирования в формате почтового адреса. |
LocationBias
Регион, в котором нужно выполнить поиск. Это местоположение служит смещением, то есть результаты вокруг него будут предпочтительными.
| Поля | |
|---|---|
Объединенное поле type. Типы предпочтительного местоположения. type может иметь одно из следующих значений: |
|
rectangle |
Прямоугольная область, заданная северо-восточным и юго-западным углами. |
GeocodeAddressResponse
Ответное сообщение для GeocodeService.GeocodeAddress.
| Поля | |
|---|---|
results[] |
Результат геокодирования. |
GeocodeLocationRequest
Сообщение запроса для GeocodeService.GeocodeLocation.
| Поля | |
|---|---|
language_code |
Необязательное поле. Язык, на котором должны быть возвращены результаты. |
region_code |
Необязательное поле. Код региона. Код региона, указываемый как двухсимвольное значение национального домена верхнего уровня (ccTLD). Параметр влияет на результаты в соответствии с действующим законодательством. |
types[] |
Необязательное поле. Набор тегов типов для ограничения результатов. Результаты, не соответствующие ни одному из указанных типов, удаляются. Полный список возможных значений приведен в таблицах A и B на странице https://developers.google.com/maps/documentation/places/web-service/place-types. |
granularity[] |
Необязательное поле. Фильтр, содержащий одно или несколько перечислений детализации местоположения. |
Объединенное поле location_input. Местоположение, для которого нужно выполнить геокодирование. location_input может иметь одно из следующих значений: |
|
location_query |
Местоположение в формате строки "lat,lng". Пример: "64.7611872,-18.4705364". |
location |
Местоположение в структурированном формате. |
GeocodeLocationResponse
Ответное сообщение для GeocodeService.GeocodeLocation.
| Поля | |
|---|---|
results[] |
Результат геокодирования. |
plus_code |
Код Plus Code местоположения в запросе. |
GeocodePlaceRequest
Сообщение запроса для GeocodeService.GeocodePlace.
| Поля | |
|---|---|
place |
Обязательно. Идентификатор места для геокодирования в формате places/{place}. |
language_code |
Необязательное поле. Язык, на котором должны быть возвращены результаты. |
region_code |
Необязательное поле. Код региона. Код региона, указываемый как двухсимвольное значение национального домена верхнего уровня (ccTLD). Параметр влияет на результаты в соответствии с действующим законодательством. |
GeocodeResult
Результат геокодирования содержит географическую информацию о месте.
| Поля | |
|---|---|
place |
Название ресурса места в формате |
place_id |
Уникальный идентификатор места. |
location |
Широта и долгота адреса. |
granularity |
Уровень детализации местоположения. |
viewport |
Область просмотра, подходящая для отображения результата геокодирования. |
bounds |
Ограничивающая рамка для адреса. |
formatted_address |
Адрес, отформатированный в одну строку. |
postal_address |
Адрес в формате почтового адреса. |
address_components[] |
Повторяющиеся компоненты для каждого уровня населенного пункта. |
postal_code_localities[] |
Полный список населенных пунктов, относящихся к почтовому индексу. Заполняется, только если результат имеет тип postal_code. |
types[] |
Набор тегов типа для этого результата. Например, "political" и "administrative_area". Полный список возможных значений приведен в таблицах A и B на странице https://developers.google.com/maps/documentation/places/web-service/place-types. |
plus_code |
Код Plus Code местоположения в этом геокоде. |
AddressComponent
Структурированные компоненты, из которых состоит отформатированный адрес (если эта информация доступна).
| Поля | |
|---|---|
long_text |
Полное текстовое описание или название компонента адреса. Например, компонент адреса для страны Австралия может содержать полное название "Australia". |
short_text |
Сокращенное текстовое название компонента адреса (если есть). Например, компонент адреса для Австралии может содержать сокращенное название "AU". |
types[] |
Массив, указывающий тип или типы компонента адреса. Эти значения взяты из таблицы типов адресов и их компонентов, которая используется в Places API: https://developers.google.com/maps/documentation/places/web-service/place-types#address-types. |
language_code |
Язык, используемый для форматирования этого компонента, в нотации CLDR. |
Уровень детализации
Уровень детализации местоположения.
| Перечисления | |
|---|---|
GRANULARITY_UNSPECIFIED |
Не используйте. |
ROOFTOP |
Неинтерполированное местоположение фактического участка земли, соответствующего найденному адресу. |
RANGE_INTERPOLATED |
Интерполировано из диапазона номеров домов. Например, если мы знаем, что на отрезке улицы Amphitheatre Pkwy находятся дома с номерами 1600–1699, то дом 1650 может быть расположен посередине между конечными точками. |
GEOMETRIC_CENTER |
Геометрический центр объекта, для которого у нас есть данные о многоугольнике. |
APPROXIMATE |
Все остальное. |
ImageAnnotation
Аннотация на уменьшенном изображении, например многоугольник, обозначающий вход.
| Поля | |
|---|---|
coordinates[] |
Список координат, образующих многоугольник на изображении. Координаты указываются против часовой стрелки. |
Координата
Пиксельные координаты точки на изображении. Начало координат (0,0) – это верхний левый угол верхнего левого пикселя изображения. Ось X направлена вправо, а ось Y – вниз.
| Поля | |
|---|---|
x_px |
Координата X. |
y_px |
Координата Y. |
Ориентир
Ориентиры помогают понять, где находится пункт назначения, и добраться до него.
| Поля | |
|---|---|
relational_description |
Человекочитаемое описание того, как пункт назначения связан с ориентиром. Например, "Рядом с Эмпайр-стейт-билдинг" или "Напротив Белого дома". |
tags[] |
Теги, описывающие, как ориентир может использоваться в контексте пункта назначения. |
straight_line_distance_meters |
Только для вывода. Расстояние по прямой от этого ориентира до пункта назначения в метрах. |
travel_distance_meters |
Только для вывода. Расстояние пешком от ориентира до пункта назначения в метрах. |
Объединенное поле landmark. Ориентир. landmark может иметь одно из следующих значений: |
|
place |
Место, которое представляет этот ориентир. |
Тег
Список всех возможных тегов, описывающих, как ориентир может использоваться в контексте пункта назначения.
Если в адресе есть теги ADDRESS и ARRIVAL, значит ориентир находится рядом с пунктом назначения и хорошо известен местным жителям.
| Перечисления | |
|---|---|
TAG_UNSPECIFIED |
Не используется. |
ADDRESS |
Местное известное место, которое можно использовать для определения приблизительного местоположения пункта назначения. Обычно в пределах нескольких сотен метров от пункта назначения. Они похожи на ориентиры, возвращаемые функцией дескрипторов адресов Geocoding API: https://developers.google.com/maps/documentation/geocoding/address-descriptors/requests-address-descriptors. |
ARRIVAL |
Место, которое можно использовать в качестве ориентира, чтобы добраться до пункта назначения. Полезно для навигации, когда вы находитесь близко к пункту назначения. Например, это может быть здание через дорогу от пункта назначения. Ориентир с этим тегом обычно находится ближе к пункту назначения, чем ориентиры с тегом ADDRESS. |
PlaceView
Представляет представление места в Places API. Кроме того, в нем содержится дополнительная информация о пунктах назначения, например тип структуры и многоугольник отображения.
В некоторых случаях ответ PlaceView с тем же идентификатором места может отличаться от того, что возвращает Places API для полей types и display_name.
| Поля | |
|---|---|
place |
Название ресурса места в формате |
place_id |
Уникальный идентификатор места. |
display_name |
Понятное человеку описание места. Пример: "Выход B", "Макдоналдс". |
primary_type |
Основной тип этого места. Список возможных значений приведен на странице https://developers.google.com/maps/documentation/places/web-service/place-types. Примечание. Это поле заполняется не всегда. В таких случаях используйте поле |
types[] |
Все типы, связанные с этим местом. Список возможных значений приведен на странице https://developers.google.com/maps/documentation/places/web-service/place-types. |
formatted_address |
Адрес в одну строку. |
postal_address |
Структурированный адрес. |
structure_type |
Тип структуры, соответствующий этому месту. |
location |
Местоположение этого места. Для мест с многоугольниками отображения это может быть хорошим местом для размещения маркера на карте. |
display_polygon |
Контур места в формате GeoJSON, использующий формат RFC 7946: https://datatracker.ietf.org/doc/html/rfc7946#section-3.1.6. Примечание. Формат RFC 7946 поддерживает MultiPolygon, поэтому один объект |
address_components[] |
Повторяющиеся компоненты для каждого уровня населенного пункта. |
AddressComponent
Структурированные компоненты, из которых состоит отформатированный адрес (если эта информация доступна).
| Поля | |
|---|---|
long_text |
Полное текстовое описание или название компонента адреса. Например, компонент адреса для страны Австралия может содержать полное название "Australia". |
short_text |
Сокращенное текстовое название компонента адреса (если есть). Например, компонент адреса для Австралии может содержать сокращенное название "AU". |
types[] |
Массив, указывающий тип или типы компонента адреса. Эти значения взяты из таблицы типов адресов и их компонентов, которая используется в Places API: https://developers.google.com/maps/documentation/places/web-service/place-types#address-types. |
language_code |
Язык, используемый для форматирования этого компонента, в нотации CLDR. |
StructureType
Тип строения, которое представляет это место.
| Перечисления | |
|---|---|
STRUCTURE_TYPE_UNSPECIFIED |
Не используется. |
POINT |
Точка на карте. |
SECTION |
Часть здания. |
BUILDING |
Здание. |
GROUNDS |
Большая территория, на которой обычно расположено несколько зданий, например университетский кампус, жилой комплекс или торговый центр. |
PlusCode
Код Plus Code (http://plus.codes) – это ссылка на местоположение в одном из двух форматов: глобальный код, определяющий прямоугольник размером 14 x 14 м (1/8000 градуса) или меньше, и составной код, в котором префикс заменен ссылкой на местоположение.
| Поля | |
|---|---|
global_code |
Глобальный (полный) код места, например "9FWM33GV+HQ", представляющий область размером 1/8000 на 1/8000 градуса (примерно 14 на 14 метров). |
compound_code |
Составной код места, например "33GV+HQ, Рамберг, Норвегия", содержащий суффикс глобального кода и заменяющий префикс отформатированным названием ссылочного объекта. |
SearchDestinationsRequest
Сообщение запроса для DestinationService.SearchDestinations.
| Поля | |
|---|---|
travel_modes[] |
Необязательное поле. Способы передвижения, для которых нужно отфильтровать точки навигации. Это влияет на поле |
language_code |
Необязательное поле. Язык, на котором должны быть возвращены результаты. |
region_code |
Необязательное поле. Код региона. Код региона, указываемый как двухсимвольное значение национального домена верхнего уровня (ccTLD). Параметр влияет на результаты в соответствии с действующим законодательством. Этот параметр также влияет на результаты работы сервиса, но не ограничивает их полностью. |
Объединенное поле Целевые страницы создаются на основе указанного основного запроса. Примечание. Поддерживаются только места и адреса, которые могут быть пунктом назначения. Например, в качестве основного запроса можно использовать место, представляющее дом или жилой комплекс, но нельзя использовать места, представляющие населенный пункт или административный район. Поле |
|
place |
Название ресурса места в формате |
address_query |
Почтовый адрес. |
location_query |
точное местоположение; |
AddressQuery
Почтовый адрес, который вы хотите найти. Указывайте адреса в соответствии с форматом, использующимся почтовой службой в конкретной стране.
| Поля | |
|---|---|
Объединенное поле kind. Запрос адреса. kind может иметь одно из следующих значений: |
|
address |
Почтовый адрес в формате почтового адреса. |
address_query |
Почтовый адрес, записанный в одну строку. |
LocationQuery
Запрос местоположения для определения ближайшего основного пункта назначения.
Примечание. Если запрос местоположения относится к зданию, в котором есть помещения, то в качестве основного места может быть возвращено помещение. В таких случаях поле containing_places будет содержать здание.
| Поля | |
|---|---|
place_filter |
Необязательное поле. Фильтры, которые нужно применить к кандидатам на целевые страницы. |
Объединенное поле kind. Запрос местоположения. kind может иметь одно из следующих значений: |
|
location |
Точное местоположение LatLng. |
PlaceFilter
Фильтры, которые нужно применить к целевым кандидатам.
| Поля | |
|---|---|
structure_type |
Необязательное поле. Если указано, то у всех пунктов назначения гарантированно будет основное место с этим типом структуры. Это может привести к фильтрации некоторых пунктов назначения или к уточнению/уточнению возвращенных пунктов назначения. Например, если указано Ещё одно применение этого поля – упрощение извлечения многоугольников, представляющих здания. Например, если указано |
addressability |
Необязательное поле. Если указано, возвращаются только целевые сегменты, соответствующие критериям доступности. |
Адресуемость
Определяет параметры фильтрации по доступности. В будущем могут быть добавлены новые значения.
| Перечисления | |
|---|---|
ADDRESSABILITY_UNSPECIFIED |
Если значение не указано, сервис выберет подходящее значение по умолчанию. |
ANY |
Адресуемость не является критерием фильтрации. Целевые страницы возвращаются независимо от их доступности. |
PRIMARY |
Все возвращенные пункты назначения будут иметь основное место с адресом или названием на уровне улицы. |
WEAK |
Все возвращенные пункты назначения будут иметь либо основное место, либо дополнительный пункт назначения с адресом или названием на уровне улицы. |
SearchDestinationsResponse
Ответ для DestinationService.SearchDestinations.
| Поля | |
|---|---|
destinations[] |
Список пунктов назначения. Сервис возвращает один результат, если по основному запросу можно однозначно определить основной пункт назначения. В противном случае сервис может вернуть несколько результатов для уточнения или не вернуть ни одного. |
StreetViewThumbnail
Параметры для представления значка Google Просмотра улиц. Эти параметры можно использовать для запроса изображения Просмотра улиц из Street View Static API. Подробнее: https://developers.google.com/maps/documentation/streetview/request-streetview.
| Поля | |
|---|---|
pano |
Идентификатор панорамы. |
width_px |
Ширина значка в пикселях. Примечание. При запросе аннотаций вместе со значком эти значения высоты и ширины должны использоваться в запросе Street View API, чтобы координаты аннотации правильно совпадали с изображением. |
height_px |
Высота значка в пикселях. Примечание. При запросе аннотаций вместе со значком эти значения высоты и ширины должны использоваться в запросе Street View API, чтобы координаты аннотации правильно совпадали с изображением. |
heading_degree |
Горизонтальная ориентация камеры в градусах. Диапазон: [0, 360). 0 означает север, а 90 – восток. |
pitch_degree |
Вертикальная ориентация камеры в градусах. Диапазон: [-90, 90]. 0 – горизонт, +90 – строго вверх, -90 – строго вниз. |
fov_degree |
Горизонтальная зона обзора в градусах. Диапазон: (0, 180]. Управляет уровнем масштабирования. Чем меньше поле зрения, тем больше увеличение. |