Directions

Оптимизируйте свои подборки Сохраняйте и классифицируйте контент в соответствии со своими настройками.

класс DirectionsService

google.maps . DirectionsService класс google.maps . DirectionsService

Сервис для расчета направления между двумя или более местами.

При использовании v=beta к нему можно получить доступ, вызвав const {DirectionsService} = await google.map.importLibrary("routes") . См. Библиотеки в Maps JavaScript API .

DirectionsService
DirectionsService()
Параметры: Нет
Создает новый экземпляр DirectionsService , который отправляет запросы маршрутов на серверы Google.
route
route(request[, callback])
Параметры:
Возвращаемое значение: Promise < DirectionsResult >
Отправьте запрос на поиск маршрута.

Интерфейс DirectionsRequest

google.maps . DirectionsRequest Интерфейс google.maps . DirectionsRequest

Запрос направления, который будет отправлен в DirectionsService .

destination
Тип: string| LatLng | Place | LatLngLiteral
Место назначения. Это можно указать либо как строку для геокодирования, либо как LatLng , либо как Place . Необходимый.
origin
Тип: string| LatLng | Place | LatLngLiteral
Место происхождения. Это можно указать либо как строку для геокодирования, либо как LatLng , либо как Place . Необходимый.
travelMode
Тип: TravelMode
Запрошенный тип маршрутизации. Необходимый.
avoidFerries optional
Тип: boolean optional
Если задано значение true , служба Directions дает указание избегать паромов, где это возможно. По желанию.
avoidHighways optional
Тип: boolean optional
Если задано значение true , служба Directions указывает, что следует по возможности избегать автомагистралей. По желанию.
avoidTolls optional
Тип: boolean optional
Если задано значение true , служба Directions указывает, что по возможности следует избегать платных дорог. По желанию.
drivingOptions optional
Тип: DrivingOptions optional
Настройки, которые применяются только к запросам, для которых travelMode имеет значение DRIVING . Этот объект не повлияет на другие режимы движения.
language optional
Тип: string optional
Идентификатор языка для языка, на котором должны быть возвращены результаты, когда это возможно. См. список поддерживаемых языков .
optimizeWaypoints optional
Тип: boolean optional
Если установлено значение true , DirectionsService попытается изменить порядок предоставленных промежуточных путевых точек, чтобы минимизировать общую стоимость маршрута. Если путевые точки оптимизированы, проверьте DirectionsRoute.waypoint_order в ответе, чтобы определить новый порядок.
provideRouteAlternatives optional
Тип: boolean optional
Должны ли быть предоставлены альтернативные маршруты. По желанию.
region optional
Тип: string optional
Код региона, используемый в качестве смещения для запросов геокодирования. Код региона принимает двухсимвольное значение ccTLD («домен верхнего уровня») . Большинство кодов ccTLD идентичны кодам ISO 3166-1, за некоторыми заметными исключениями. Например, ccTLD Соединенного Королевства — «uk» ( .co.uk ), а его код ISO 3166-1 — «gb» (технически для субъекта «Соединенное Королевство Великобритании и Северной Ирландии»).
transitOptions optional
Тип: TransitOptions optional
Настройки, которые применяются только к запросам, в которых travelMode имеет значение TRANSIT. Этот объект не повлияет на другие режимы движения.
unitSystem optional
Тип: UnitSystem optional
По умолчанию: система единиц, используемая в стране происхождения.
Предпочтительная система единиц для использования при отображении расстояния.
waypoints optional
Тип: Array < DirectionsWaypoint > optional
Массив промежуточных путевых точек. Направления вычисляются от начала до места назначения посредством каждой путевой точки в этом массиве. См. в руководстве разработчика максимально допустимое количество путевых точек. Путевые точки не поддерживаются для маршрутов общественного транспорта. По желанию.

Константы состояния направления

google.maps . DirectionsStatus Константы google.maps . DirectionsStatus

Статус, возвращаемый DirectionsService по завершении вызова route() . Укажите их по значению или по имени константы. Например, 'OK' или google.maps.DirectionsStatus.OK .

При использовании v=beta к нему можно получить доступ, вызвав const {DirectionsStatus} = await google.map.importLibrary("routes") . См. Библиотеки в Maps JavaScript API .

INVALID_REQUEST Предоставленный DirectionsRequest недействителен.
MAX_WAYPOINTS_EXCEEDED В DirectionsWaypoint было указано слишком много DirectionsRequest . См. в руководстве разработчика максимально допустимое количество путевых точек.
NOT_FOUND По крайней мере один из пунктов отправления, назначения или путевых точек не может быть геокодирован.
OK Ответ содержит допустимый DirectionsResult .
OVER_QUERY_LIMIT Веб-страница превысила лимит запросов за слишком короткий период времени.
REQUEST_DENIED Веб-странице не разрешено использовать службу маршрутов.
UNKNOWN_ERROR Запрос направления не может быть обработан из-за ошибки сервера. Запрос может быть успешным, если вы попробуете еще раз.
ZERO_RESULTS Не удалось найти маршрут между пунктом отправления и пунктом назначения.

Интерфейс результатов направлений

google.maps . DirectionsResult Интерфейс google.maps . DirectionsResult

Ответ направления, полученный от сервера направлений. Вы можете визуализировать их с помощью DirectionsRenderer или проанализировать этот объект и отобразить его самостоятельно. Вы должны отображать предупреждения и информацию об авторских правах, как указано в Условиях использования платформы Google Maps . Обратите внимание, что хотя этот результат похож на JSON, он не является строго JSON, поскольку косвенно включает объекты LatLng .

routes
Тип: Array < DirectionsRoute >
Массив DirectionsRoute s, каждый из которых содержит информацию об участках и шагах, из которых он состоит. Будет только один маршрут, если DirectionsRequest не был сделан с provideRouteAlternatives , для которого задано значение true .
available_travel_modes optional
Тип: Array < TravelMode > optional
Содержит множество доступных режимов движения. Это поле возвращается, когда запрос указывает режим передвижения и не дает результатов. Массив содержит доступные способы передвижения в странах заданного набора путевых точек. Это поле не возвращается, если одна или несколько путевых точек являются «через путевые точки».
geocoded_waypoints optional
Тип: Array < DirectionsGeocodedWaypoint > optional
Массив DirectionsGeocodedWaypoint s, каждый из которых содержит информацию о геокодировании начала, пункта назначения и путевых точек.

Класс DirectionsRenderer

google.maps . DirectionsRenderer Класс google.maps . DirectionsRenderer

Отображает направления, полученные от DirectionsService .

Этот класс расширяет MVCObject .

При использовании v=beta к нему можно получить доступ, вызвав const {DirectionsRenderer} = await google.map.importLibrary("routes") . См. Библиотеки в Maps JavaScript API .

DirectionsRenderer
DirectionsRenderer([opts])
Параметры:
Создает визуализатор с заданными параметрами. Направления могут отображаться на карте (в виде визуальных наложений) или дополнительно на панели <div> (в виде текстовых инструкций).
getDirections
getDirections()
Параметры: Нет
Возвращаемое значение: DirectionsResult
Возвращает текущий набор направлений средства визуализации.
getMap
getMap()
Параметры: Нет
Возвращаемое значение: Map
Возвращает карту, на которой отображается DirectionsResult .
getPanel
getPanel()
Параметры: Нет
Возвращаемое значение: HTMLElement |null
Возвращает панель <div> , в которой отображается DirectionsResult .
getRouteIndex
getRouteIndex()
Параметры: Нет
Возвращаемое значение: number
Возвращает текущий (отсчитываемый от нуля) индекс маршрута, используемый этим объектом DirectionsRenderer .
setDirections
setDirections(directions)
Параметры:
Возвращаемое значение: нет
Настройте средство визуализации на использование результата DirectionsService . Установка допустимого набора направлений таким образом отобразит направления на назначенной карте и панели средства визуализации.
setMap
setMap(map)
Параметры:
Возвращаемое значение: нет
Этот метод указывает карту, на которой будут отображаться направления. Передайте null , чтобы удалить направления с карты.
setOptions
setOptions(options)
Параметры:
Возвращаемое значение: нет
Измените настройки параметров этого DirectionsRenderer после инициализации.
setPanel
setPanel(panel)
Параметры:
Возвращаемое значение: нет
Этот метод отображает направления в <div> . Передайте значение null , чтобы удалить содержимое с панели.
setRouteIndex
setRouteIndex(routeIndex)
Параметры:
  • routeIndex : number
Возвращаемое значение: нет
Задайте (отсчитываемый от нуля) индекс маршрута в объекте DirectionsResult для отображения. По умолчанию будет отображаться первый маршрут в массиве.
Унаследовано: addListener , bindTo , get , notify , set , setValues , unbind , unbindAll
directions_changed
function()
Аргументы: Нет
Это событие запускается, когда изменяются отображаемые направления, либо когда устанавливается новый DirectionsResult , либо когда пользователь завершает перетаскивание изменения пути направлений.

Интерфейс DirectionsRendererOptions

google.maps . DirectionsRendererOptions Интерфейс google.maps . DirectionsRendererOptions

Этот объект определяет свойства, которые можно задать для объекта DirectionsRenderer .

directions optional
Тип: DirectionsResult optional
Направления для отображения на карте и/или на панели <div> , полученные как объект DirectionsResult из DirectionsService .
draggable optional
Тип: boolean optional
Если задано значение true , пользователь может перетаскивать и изменять пути маршрутов, отображаемых этим DirectionsRenderer .
hideRouteList optional
Тип: boolean optional
По умолчанию: false
Это свойство указывает, должен ли модуль визуализации предоставлять выбираемый пользователем список маршрутов, отображаемых на панели маршрутов.
infoWindow optional
Тип: InfoWindow optional
InfoWindow в котором отображается текстовая информация при щелчке маркера. Существующее содержимое информационного окна будет перезаписано, а его положение перемещено. Если информационное окно не указано, DirectionsRenderer создаст и будет использовать собственное информационное окно. Это свойство будет игнорироваться, если для suppressInfoWindows задано значение true .
map optional
Тип: Map optional
Карта, на которой отображать направления.
markerOptions optional
Тип: MarkerOptions optional
Варианты маркеров. Все маркеры, отображаемые DirectionsRenderer , будут использовать эти параметры.
panel optional
Тип: HTMLElement optional
<div> , в котором отображаются шаги направления.
polylineOptions optional
Тип: PolylineOptions optional
Варианты полилиний. Все полилинии, отображаемые DirectionsRenderer , будут использовать эти параметры.
preserveViewport optional
Тип: boolean optional
По умолчанию: false
Если для этой опции установлено значение true или центр карты и масштаб никогда не устанавливались, входная карта центрируется и масштабируется до ограничивающей рамки этого набора направлений.
routeIndex optional
Тип: number optional
Индекс маршрута в объекте DirectionsResult . Значение по умолчанию — 0.
suppressBicyclingLayer optional
Тип: boolean optional
Подавить отрисовку BicyclingLayer , когда запрашиваются направления движения на велосипеде.
suppressInfoWindows optional
Тип: boolean optional
Подавить отображение информационных окон.
suppressMarkers optional
Тип: boolean optional
Подавить рендеринг маркеров.
suppressPolylines optional
Тип: boolean optional
Подавить визуализацию полилиний.

Интерфейс путевой точки

google.maps . DirectionsWaypoint точки

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

location optional
Тип: string| LatLng | LatLngLiteral | Place optional
Расположение путевой точки. Может быть адресной строкой, LatLng или Place . По желанию.
stopover optional
Тип: boolean optional
По умолчанию: true
Если true , указывает, что эта путевая точка является остановкой между пунктом отправления и пунктом назначения. Это приводит к разделению маршрута на две части. Значение false указывает на то, что маршрут должен проходить через эту путевую точку, но не должен быть разделен на две части. Это полезно, если вы хотите создать маршрут в ответ на перетаскивание пользователем путевых точек на карте.

Интерфейс DirectionsGeocodedWaypoint

google.maps . DirectionsGeocodedWaypoint Интерфейс google.maps . DirectionsGeocodedWaypoint

Единая геокодированная путевая точка.

partial_match optional
Тип: boolean optional
Не вернул ли геокодер точное совпадение с исходной путевой точкой, хотя он смог сопоставить часть запрошенного адреса.
place_id optional
Тип: string optional
Идентификатор места, связанный с путевой точкой. Идентификаторы мест однозначно идентифицируют место в базе данных Google Places и на Google Maps. Узнайте больше об идентификаторах мест в руководстве для разработчиков Places API.
types optional
Тип: Array <string> optional
Массив строк, обозначающих тип возвращенного геокодированного элемента. Список возможных строк см. в разделе « Типы адресных компонентов » Руководства разработчика.

Интерфейс Route

google.maps . DirectionsRoute

Одиночный маршрут, содержащий набор участков в DirectionsResult . Обратите внимание, что хотя этот объект похож на JSON, он не является строго JSON, поскольку прямо или косвенно включает в себя объекты LatLng .

bounds
Тип: LatLngBounds
Границы этого маршрута.
copyrights
Тип: string
Текст об авторских правах, который будет отображаться для этого маршрута.
legs
Тип: Array < DirectionsLeg >
Массив DirectionsLeg s, каждый из которых содержит информацию о шагах, из которых он состоит. Для каждой указанной промежуточной точки или пункта назначения будет один этап. Таким образом, маршрут без промежуточных путевых точек будет содержать один DirectionsLeg , а маршрут с одной промежуточной путевой точкой будет содержать два.
overview_path
Тип: Array < LatLng >
Массив LatLng , представляющий весь курс этого маршрута. Путь упрощен, чтобы его можно было использовать в контекстах, где требуется небольшое количество вершин (например, URL-адреса API статических карт).
overview_polyline
Тип: string
Закодированное полилинейное представление маршрута в обзоре_пути. Эта полилиния является приблизительным (сглаженным) путем результирующих направлений.
summary
Тип: string
Содержит краткое текстовое описание маршрута, подходящее для именования и устранения неоднозначности маршрута среди альтернатив.
warnings
Тип: Array <string>
Предупреждения, которые будут отображаться при отображении этих направлений.
waypoint_order
Тип: Array <number>
Если для параметра optimizeWaypoints установлено значение true , это поле будет содержать переупорядоченную перестановку входных путевых точек. Например, если ввод был:
Происхождение: Лос-Анджелес
Маршрутные точки: Даллас, Бангор, Феникс.
Пункт назначения: Нью-Йорк
и оптимизированный вывод был упорядочен следующим образом:
Происхождение: Лос-Анджелес
Маршрутные точки: Феникс, Даллас, Бангор
Пункт назначения: Нью-Йорк
то это поле будет Array , содержащим значения [2, 0, 1]. Обратите внимание, что нумерация путевых точек начинается с нуля.
Если для какой-либо из входных путевых точек stopover установлен в значение false , это поле будет пустым, так как для таких запросов оптимизация маршрута недоступна.
fare optional
Тип: TransitFare optional
Общая стоимость проезда за весь транзит. Применимо только к транзитным запросам.

Интерфейс DirectionsLeg

google.maps . DirectionsLeg Интерфейс google.maps . DirectionsLeg

Один этап, состоящий из набора шагов в DirectionsResult . Некоторые поля в ветке могут быть возвращены не для всех запросов. Обратите внимание, что хотя этот результат похож на JSON, он не является строго JSON, поскольку прямо или косвенно включает объекты LatLng .

end_address
Тип: string
Адрес пункта назначения этого этапа. Этот контент предназначен для чтения как есть. Не анализируйте программно отформатированный адрес.
end_location
Тип: LatLng
Служба DirectionsService вычисляет маршруты между местоположениями, используя ближайший вариант транспорта (обычно дорогу) в начальном и конечном местоположениях. end_location указывает фактический геокодированный пункт назначения, который может отличаться от end_location последнего шага, если, например, дорога не находится рядом с пунктом назначения этого участка.
start_address
Тип: string
Адрес происхождения этой ноги. Этот контент предназначен для чтения как есть. Не анализируйте программно отформатированный адрес.
start_location
Тип: LatLng
Служба DirectionsService вычисляет маршруты между местоположениями, используя ближайший вариант транспорта (обычно дорогу) в начальном и конечном местоположениях. start_location указывает фактическое геокодированное начало координат, которое может отличаться от start_location первого шага, если, например, дорога не находится рядом с началом этого участка.
steps
Тип: Array < DirectionsStep >
Массив DirectionsStep s, каждый из которых содержит информацию об отдельных шагах в этом отрезке.
traffic_speed_entry
Тип: Array <?>
Информация о скорости движения на участке.
via_waypoints
Тип: Array < LatLng >
Массив путевых точек без пересадок на этом участке, которые были указаны в исходном запросе.

Устарело в альтернативных маршрутах . Версия 3.27 будет последней версией API, которая добавляет дополнительные via_waypoints в альтернативные маршруты.

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

arrival_time optional
Тип: Time optional
Расчетное время прибытия на этот этап. Применимо только для ТРАНЗИТНЫХ запросов.
departure_time optional
Тип: Time optional
Расчетное время отправления для этого этапа. Применимо только для ТРАНЗИТНЫХ запросов.
distance optional
Тип: Distance optional
Общее расстояние, пройденное этим отрезком. Это свойство может быть неопределенным, так как расстояние может быть неизвестно.
duration optional
Тип: Duration optional
Общая продолжительность этого этапа. Это свойство может быть undefined , поскольку продолжительность может быть неизвестна.
duration_in_traffic optional
Тип: Duration optional
Общая продолжительность этого этапа с учетом условий трафика, указанных свойством trafficModel . Это свойство может быть undefined , поскольку продолжительность может быть неизвестна.

Интерфейс DirectionsStep

google.maps . DirectionsStep Интерфейс google.maps . DirectionsStep

Один DirectionsStep в DirectionsResult . Некоторые поля могут быть undefined . Обратите внимание, что хотя этот объект «похож на JSON», он не является строго JSON, так как напрямую включает объекты LatLng .

encoded_lat_lngs
Тип: string
Закодированное полилинейное представление шага. Это приблизительный (сглаженный) путь шага.
end_location
Тип: LatLng
Конечная точка этого шага.
end_point
Тип: LatLng
Конечная точка этого шага.
instructions
Тип: string
Инструкции для этого шага.
lat_lngs
Тип: Array < LatLng >
Последовательность LatLng , описывающая ход этого шага. Это приблизительный (сглаженный) путь шага.
maneuver
Тип: string
Содержит действие, которое нужно выполнить для текущего шага ( turn-left , merge , straight и т. д.). Значения могут быть изменены, и новые значения могут быть введены без предварительного уведомления.
path
Тип: Array < LatLng >
Последовательность LatLng , описывающая ход этого шага. Это приблизительный (сглаженный) путь шага.
start_location
Тип: LatLng
Начальное местоположение этого шага.
start_point
Тип: LatLng
Начальное местоположение этого шага.
travel_mode
Тип: TravelMode
Способ передвижения, используемый на этом этапе.
distance optional
Тип: Distance optional
Расстояние, преодолеваемое этим шагом. Это свойство может быть undefined , так как расстояние может быть неизвестно.
duration optional
Тип: Duration optional
Типичное время, необходимое для выполнения этого шага, в секундах и в текстовом виде. Это свойство может быть undefined , поскольку продолжительность может быть неизвестна.
polyline optional polyline optional
Тип: DirectionsPolyline optional
Содержит объект с одним свойством «точки», который содержит закодированное полилинейное представление шага. Эта полилиния является приблизительным (сглаженным) путем ступени.
steps optional
Тип: Array < DirectionsStep > optional
Подшаги этого шага. Указывается для нетранзитных участков транзитных маршрутов.
transit optional
Тип: TransitDetails optional
Подробная информация об этом шаге, относящаяся к транзиту. Это свойство будет неопределенным, если режим передвижения на этом шаге не будет TRANSIT .
transit_details optional
Тип: TransitDetails optional
Подробности, относящиеся к этому шагу, если выбран режим передвижения TRANSIT .

Интерфейс DirectionsPolyline

google.maps . DirectionsPolyline Интерфейс google.maps . DirectionsPolyline

Объект, содержащий свойство points для описания полилинии DirectionsStep .

points
Тип: string
Закодированная полилиния .

Место интерфейса

google.maps . Place интерфейса

Содержит информацию, необходимую для поиска, идентификации или описания места для DirectionsRequest или DistanceMatrixRequest . В этом контексте «место» означает предприятие, достопримечательность или географическое положение. Для получения информации о месте см. PlacesService .

location optional
Тип: LatLng | LatLngLiteral optional
LatLng объекта, описываемого этим местом.
placeId optional
Тип: string optional
Идентификатор места (например, предприятия или достопримечательности). Идентификатор места — это уникальный идентификатор места в базе данных Google Maps. Обратите внимание, что placeId является наиболее точным способом идентификации места. По возможности следует указывать placeId , а не query . Идентификатор места можно получить из любого запроса к Places API, например из TextSearch . Идентификаторы мест также можно получить из запросов к API геокодирования. Дополнительные сведения см. в обзоре идентификаторов мест .
query optional
Тип: string optional
Поисковый запрос, описывающий место (например, компанию или достопримечательность). Пример запроса: «Набережная, верхний уровень, международный пассажирский терминал 5, Хиксон-роуд, Рокс, Новый Южный Уэльс». По возможности следует указывать placeId , а не query . API не гарантирует точность преобразования строки запроса в место. Если указаны и placeId , и query , возникает ошибка.

Константы TravelMode

google.maps . TravelMode Константы google.maps . TravelMode

Допустимые режимы движения, которые можно указать в DirectionsRequest , а также режимы движения, возвращенные в DirectionsStep . Укажите их по значению или по имени константы. Например, 'BICYCLING' или google.maps.TravelMode.BICYCLING .

При использовании v=beta к нему можно получить доступ, вызвав const {TravelMode} = await google.map.importLibrary("routes") . См. Библиотеки в Maps JavaScript API .

BICYCLING Определяет запрос велосипедных маршрутов.
DRIVING Определяет запрос направления движения.
TRANSIT Определяет запрос маршрутов общественного транспорта.
WALKING Определяет запрос пеших маршрутов.

Интерфейс параметров вождения

google.maps . DrivingOptions

Настраивает DirectionsRequest , когда режим движения установлен на DRIVING .

departureTime
Тип: Date
Желаемое время отправления для маршрута в виде объекта Date . Объект Date измеряет время в миллисекундах с 1 января 1970 года. Это необходимо указать, чтобы DrivingOptions был действительным. Время отправления должно быть установлено на текущее время или некоторое время в будущем. Это не может быть в прошлом.
trafficModel optional
Тип: TrafficModel optional
Предпочтительное допущение для прогнозирования продолжительности трафика. Значение по умолчанию — BEST_GUESS .

Константы TrafficModel

google.maps . TrafficModel

Допущения, используемые при прогнозировании продолжительности трафика. Указывается как часть DirectionsRequest или DistanceMatrixRequest . Укажите их по значению или по имени константы. Например, 'bestguess' или google.maps.TrafficModel.BEST_GUESS .

При использовании v=beta к нему можно получить доступ, вызвав const {TrafficModel} = await google.map.importLibrary("routes") . См. Библиотеки в Maps JavaScript API .

BEST_GUESS Используйте исторические данные о трафике, чтобы лучше всего оценить время, проведенное в пробке.
OPTIMISTIC Используйте исторические данные о трафике, чтобы сделать оптимистическую оценку продолжительности трафика.
PESSIMISTIC Используйте исторические данные о трафике, чтобы сделать пессимистическую оценку продолжительности трафика.

Интерфейс TransitOptions

google.maps . TransitOptions Интерфейс google.maps . TransitOptions

Объект TransitOptions, который должен быть включен в запрос DirectionsRequest , когда для режима передвижения задано значение TRANSIT.

arrivalTime optional
Тип: Date optional
Желаемое время прибытия для маршрута в виде объекта Date. Объект Date измеряет время в миллисекундах с 1 января 1970 года. Если указано время прибытия, время отправления игнорируется.
departureTime optional
Тип: Date optional
Желаемое время отправления для маршрута в виде объекта Date. Объект Date измеряет время в миллисекундах с 1 января 1970 года. Если ни время отправления, ни время прибытия не указаны, предполагается, что время равно «сейчас».
modes optional
Тип: Array < TransitMode > optional
Один или несколько предпочтительных видов транспорта, например, автобус или поезд. Если предпочтение не задано, API возвращает лучший маршрут по умолчанию.
routingPreference optional
Тип: TransitRoutePreference optional
Предпочтение, которое может повлиять на выбор маршрута общественного транспорта, например, меньше ходить пешком. Если предпочтение не задано, API возвращает лучший маршрут по умолчанию.

Константы TransitMode

google.maps . TransitMode

Действительный режим транзита, например автобус, который можно указать в TransitOptions . Укажите их по значению или по имени константы. Например, 'BUS' или google.maps.TransitMode.BUS .

При использовании v=beta к нему можно получить доступ, вызвав const {TransitMode} = await google.map.importLibrary("routes") . См. Библиотеки в Maps JavaScript API .

BUS Указывает автобус в качестве предпочтительного вида транспорта.
RAIL Указывает железную дорогу в качестве предпочтительного вида транспорта.
SUBWAY Указывает метро в качестве предпочтительного вида транспорта.
TRAIN Указывает поезд в качестве предпочтительного вида транспорта.
TRAM Указывает трамвай в качестве предпочтительного вида транспорта.

Константы TransitRoutePreference

google.maps . TransitRoutePreference

Допустимый тип транзитного маршрута, который можно указать в TransitOptions . Укажите их по значению или по имени константы. Например, 'LESS_WALKING' или google.maps.TransitRoutePreference.LESS_WALKING .

При использовании v=beta к нему можно получить доступ, вызвав const {TransitRoutePreference} = await google.map.importLibrary("routes") . См. Библиотеки в Maps JavaScript API .

FEWER_TRANSFERS Указывает, что рассчитанный маршрут должен предпочитать ограниченное количество пересадок.
LESS_WALKING Указывает, что рассчитанный маршрут должен предпочитать ограниченное количество пеших прогулок.

Интерфейс TransitFare

google.maps . TransitFare Интерфейс google.maps . TransitFare

Тариф DirectionsRoute , состоящий из стоимости и валюты.

currency
Тип: string
Код валюты ISO 4217 , указывающий валюту, в которой выражен тариф.
value
Тип: number
Числовое значение тарифа, выраженное в данной currency .

Интерфейс TransitDetails

google.maps . TransitDetails Интерфейс google.maps . TransitDetails

Подробная информация об отправлении, прибытии и способе транзита, использованная на этом этапе.

arrival_stop
Тип: TransitStop
Остановка прибытия этого транзитного шага.
arrival_time
Тип: Time
Время прибытия этого шага в виде объекта Time.
departure_stop
Тип: TransitStop
Остановка отправления этого транзитного шага.
departure_time
Тип: Time
Время отправления этого шага в виде объекта Time.
headsign
Тип: string
Направление движения по этой линии указано на транспортном средстве или на остановке отправления.
headway
Тип: number
Ожидаемое количество секунд между эквивалентными транспортными средствами на этой остановке.
line
Тип: TransitLine
Подробная информация о транзитной линии, используемой на этом этапе.
num_stops
Тип: number
Количество остановок на этом шаге. Включает остановку прибытия, но не остановку отправления.
trip_short_name
Тип: string
Текст, который появляется в расписаниях и на вывесках для обозначения транзитной поездки для пассажиров, например, для обозначения номеров поездов пригородных поездов. Текст однозначно идентифицирует поездку в течение служебного дня.

Интерфейс TransitStop

google.maps . TransitStop Интерфейс google.maps . TransitStop

Подробная информация о транзитной остановке или станции.

location
Тип: LatLng
Расположение этой остановки.
name
Тип: string
Название этой транзитной остановки.

Интерфейс TransitLine

google.maps . TransitLine Интерфейс google.maps . TransitLine

Информация о транзитной линии, которая обслуживает этот транзитный этап.

agencies
Тип: Array < TransitAgency >
Транзитное агентство, которое управляет этой транзитной линией.
color
Тип: string
Цвет, обычно используемый в указателях для этой линии общественного транспорта, представлен в виде шестнадцатеричной строки.
icon
Тип: string
URL-адрес значка, связанного с этой строкой.
name
Тип: string
Полное название этой линии общественного транспорта, например, «8 Avenue Local».
short_name
Тип: string
Краткое название этой линии общественного транспорта, например, "E".
text_color
Тип: string
Цвет текста, обычно используемый в указателях для этой линии общественного транспорта, представлен в виде шестнадцатеричной строки.
url
Тип: string
URL-адрес агентства, относящийся к этой линии общественного транспорта.
vehicle
Тип используемого транспортного средства, например, поезд или автобус.

Интерфейс TransitAgency

google.maps . TransitAgency Интерфейс google.maps . TransitAgency

Информация об агентстве, управляющем транзитной линией.

name
Тип: string
Название этого транзитного агентства.
phone
Тип: string
Телефон транспортной компании.
url
Тип: string
URL транспортного агентства.

Интерфейс TransitVehicle

google.maps . TransitVehicle Интерфейс google.maps . TransitVehicle

Информация о транспортном средстве, которое работает на транзитной линии.

icon
Тип: string
URL-адрес значка, который соответствует типу транспортного средства, используемого в этой строке.
local_icon
Тип: string
URL-адрес значка, который соответствует типу транспортного средства, используемого в этом регионе, вместо более общего значка.
name
Тип: string
Имя для этого типа TransitVehicle, например, «Поезд» или «Автобус».
type
Тип: Тип VehicleType
Тип используемого транспортного средства, например, поезд, автобус или паром.

Константы типа транспортного средства

google.maps . VehicleType

Возможные значения для типов транспортных средств.

При использовании v=beta к нему можно получить доступ, вызвав const {VehicleType} = await google.map.importLibrary("routes") . См. Библиотеки в Maps JavaScript API .

BUS Автобус.
CABLE_CAR Транспортное средство, работающее на тросе, обычно на земле. Воздушные канатные дороги могут быть типа GONDOLA_LIFT .
COMMUTER_TRAIN Пригородная железная дорога.
FERRY Перевозить.
FUNICULAR Транспортное средство, которое поднимается по крутому склону тросом.
GONDOLA_LIFT Воздушная канатная дорога.
HEAVY_RAIL Тяжелый рельс.
HIGH_SPEED_TRAIN Высокоскоростной поезд.
INTERCITY_BUS Междугородний автобус.
METRO_RAIL Скоростной трамвай.
MONORAIL Монорельс.
OTHER Другие транспортные средства.
RAIL Железнодорожный.
SHARE_TAXI Маршрутное такси — вид автобусного транспорта с возможностью высаживать и забирать пассажиров в любом месте своего маршрута. Как правило, маршрутное такси использует микроавтобусы.
SUBWAY Подземный легкорельсовый транспорт.
TRAM Надземный легкорельсовый транспорт.
TROLLEYBUS Троллейбус.

Константы UnitSystem

google.maps . UnitSystem Константы google.maps . UnitSystem

Допустимые системы единиц измерения, которые можно указать в DirectionsRequest .

При использовании v=beta к нему можно получить доступ, вызвав const {UnitSystem} = await google.map.importLibrary("core") . См. Библиотеки в Maps JavaScript API .

IMPERIAL Указывает, что расстояния в DirectionsResult должны быть выражены в имперских единицах.
METRIC Указывает, что расстояния в DirectionsResult должны быть выражены в метрических единицах.

Дистанционный интерфейс

google.maps . Distance интерфейс

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

text
Тип: string
Строковое представление значения расстояния с использованием UnitSystem , указанной в запросе.
value
Тип: number
Расстояние в метрах.

Интерфейс продолжительности

google.maps . Duration Интерфейс google.maps . Duration

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

text
Тип: string
Строковое представление значения длительности.
value
Тип: number
Продолжительность в секундах.

Интерфейс времени

google.maps . Time Интерфейс google.maps . Time

Представление времени в виде объекта Date, локализованной строки и часового пояса.

text
Тип: string
Строка, представляющая значение времени. Время отображается в часовом поясе транзитной остановки.
time_zone
Тип: string
Часовой пояс, в котором находится эта остановка. Значением является название часового пояса, определенное в базе данных часовых поясов IANA, например, «Америка/Нью-Йорк».
value
Тип: Date
Время этого отправления или прибытия в виде объекта Date JavaScript.

Константы DirectionsTravelMode

google.maps . DirectionsTravelMode Константы google.maps . DirectionsTravelMode

Константы DirectionsUnitSystem

google.maps . DirectionsUnitSystem Константы google.maps . DirectionsUnitSystem