Package google.maps.geocode.v4alpha

Индекс

DestinationService

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

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

ПоискНаправлений

rpc SearchDestinations( SearchDestinationsRequest ) returns ( SearchDestinationsResponse )

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

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

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

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

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

Пункт назначения. Сюда входят основное место, связанные с ним места, входы и навигационные точки.

Поля
primary

PlaceView

Основное место, указанное в запросе с помощью primary_query .

containing_places[]

PlaceView

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

sub_destinations[]

PlaceView

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

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

landmarks[]

Landmark

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

entrances[]

Entrance

Входы для этого пункта назначения.

navigation_points[]

NavigationPoint

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

Вход

Вход — это одна пара координат широты/долготы, которая определяет местоположение точки входа и выхода для какого-либо места.

Поля
location

LatLng

Расположение входа.

tags[]

Entrance.Tag

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

place

string

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

Ярлык

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

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

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

Например, если основным местом является ресторан в торговом центре, «ПРЕДПОЧТИТЕЛЬНЫМИ» входами будут те, которые, скорее всего, ведут в сам ресторан, в то время как другими возвращаемыми входами будут другие входы в здание, например, входы в другие рестораны в торговом центре.

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

Примечание: PREFERRED вход может не обеспечивать доступ к основному месту, а PREFERRED вход может обеспечивать доступ к основному месту.

Достопримечательность

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

Поля
tags[]

Landmark.Tag

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

landmark Юнион-филд. landmark может быть только одной из следующих:
place

PlaceView

Место, представляющее эту достопримечательность.

Ярлык

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

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

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

Навигационная точка — это место рядом с дорогой, где навигация может закончиться.

Поля
display_name

LocalizedText

Отображаемое название этой точки навигации. Например, «5th Ave» или «Gate B».

location

LatLng

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

travel_modes[]

NavigationPoint.TravelMode

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

usages[]

NavigationPoint.Usage

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

TravelMode

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

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

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

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

Перечисления
USAGE_UNSPECIFIED Не использовался.
UNKNOWN Неизвестный тип использования. Большинство точек навигации будут UNKNOWN , и это не обязательно означает, что их использование каким-либо образом ограничено. Эта навигация может быть пригодна для посадки и/или высадки.
DROPOFF Подходит для высадки пассажира. Например, для высадки пассажиров, пользующихся услугами совместных поездок.
PICKUP Подходит для посадки пассажира. Например, для посадки в такси.

МестоПросмотр

Представляет представление объекта Place в API Places. Также предоставляет дополнительную информацию, относящуюся к пунктам назначения, такую как тип структуры и отображаемый многоугольник.

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

Поля
place

string

Название ресурса этого места в формате places/{placeId} .

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 поддерживает MultiPolygons, поэтому один объект display_polygon может представлять несколько полигонов.

StructureType

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

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

SearchDestinationsRequest

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

Поля
travel_modes[]

NavigationPoint.TravelMode

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

language_code

string

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

region_code

string

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

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

Направления формируются на основе указанного основного запроса.

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

place

string

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

address_query

SearchDestinationsRequest.AddressQuery

Уличный адрес.

location_query

SearchDestinationsRequest.LocationQuery

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

АдресЗапрос

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

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

PostalAddress

Уличный адрес в формате почтового адреса.

address_query

string

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

LocationQuery

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

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

Поля
kind поля объединения. Запрос местоположения. kind может быть только одним из следующих:
location

LatLng

Точное местоположение по координатам LatLng.

ПоискНаправленияОтвет

Ответное сообщение для DestinationService.SearchDestinations.

Поля
destinations[]

Destination

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

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