класс 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) Параметры:
Возвращаемое значение: нет Задайте (отсчитываемый от нуля) индекс маршрута в объекте 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 | Массив 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 | Массив путевых точек без пересадок на этом участке, которые были указаны в исходном запросе. Устарело в альтернативных маршрутах . Версия 3.27 будет последней версией API, которая добавляет дополнительные При использовании службы маршрутов для реализации перетаскиваемых маршрутов рекомендуется отключить перетаскивание альтернативных маршрутов. Только основной маршрут должен быть перетаскиваемым. Пользователи могут перетаскивать основной маршрут, пока он не совпадет с альтернативным маршрутом. |
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 | Последовательность LatLng , описывающая ход этого шага. Это приблизительный (сглаженный) путь шага. |
maneuver | Тип: string Содержит действие, которое нужно выполнить для текущего шага ( turn-left , merge , straight и т. д.). Значения могут быть изменены, и новые значения могут быть введены без предварительного уведомления. |
path | Последовательность 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 | Тип: TransitVehicle Тип используемого транспортного средства, например, поезд или автобус. |
Интерфейс 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