Класс DirectionsService
google.maps . DirectionsService
Класс google.maps . DirectionsService
Сервис для расчета маршрутов между двумя и более местами.
Доступ осуществляется путем вызова const {DirectionsService} = await google.maps.importLibrary("routes")
. См. раздел Библиотеки в Maps JavaScript API .
Конструктор | |
---|---|
DirectionsService | DirectionsService() Параметры: Нет Создает новый экземпляр DirectionsService , который отправляет запросы маршрутов на серверы Google. |
Методы | |
---|---|
route | route(request[, callback]) Параметры:
Возвращаемое значение: Promise < DirectionsResult > Оформить запрос на поиск маршрута. |
Интерфейс запроса маршрутов
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 , инструктирует службу маршрутов избегать паромов, где это возможно. Необязательный. |
avoidHighways optional | Тип: boolean optional Если true , инструктирует службу маршрутов избегать шоссе, где это возможно. Необязательный. |
avoidTolls optional | Тип: boolean optional Если true , инструктирует службу маршрутов избегать платных дорог, где это возможно. Необязательный. |
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, за некоторыми заметными исключениями. Например, нДВУ Соединенного Королевства — «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
.
Доступ осуществляется путем вызова const {DirectionsStatus} = await google.maps.importLibrary("routes")
. См. раздел Библиотеки в Maps JavaScript API .
Константы | |
---|---|
INVALID_REQUEST | Предоставленный DirectionsRequest недействителен. |
MAX_WAYPOINTS_EXCEEDED | В DirectionsRequest было указано слишком много DirectionsWaypoint . См. руководство разработчика , чтобы узнать максимально допустимое количество путевых точек. |
NOT_FOUND | По крайней мере одну из точек отправления, назначения или маршрутных точек не удалось геокодировать. |
OK | Ответ содержит действительный DirectionsResult . |
OVER_QUERY_LIMIT | Веб-страница превысила лимит запросов за слишком короткий период времени. |
REQUEST_DENIED | Веб-странице не разрешено использовать службу маршрутов. |
UNKNOWN_ERROR | Запрос направления не удалось обработать из-за ошибки сервера. Запрос может быть успешным, если вы повторите попытку. |
ZERO_RESULTS | Не удалось найти маршрут между пунктом отправления и пунктом назначения. |
НаправленияРезультат интерфейса
google.maps . DirectionsResult
интерфейса
Ответ о направлениях, полученный с сервера маршрутов. Вы можете визуализировать их с помощью DirectionsRenderer
или проанализировать этот объект и отобразить его самостоятельно. Вы должны отображать предупреждения и сведения об авторских правах, как указано в Условиях использования платформы Google Maps . Обратите внимание: хотя этот результат и «подобен JSON», он не является строго JSON, поскольку косвенно включает объекты LatLng
.
Характеристики | |
---|---|
request | Тип: DirectionsRequest DirectionsRequest, который дал этот результат. |
routes | Тип: Array < DirectionsRoute > Массив DirectionsRoute , каждый из которых содержит информацию об участках и шагах, из которых он состоит. Будет только один маршрут, если только DirectionsRequest не был создан с provideRouteAlternatives , установленным в true . |
available_travel_modes optional | Тип: Array < TravelMode > optional Содержит множество доступных режимов путешествия. Это поле возвращается, когда запрос указывает режим передвижения и не дает результатов. Массив содержит доступные способы передвижения в странах заданного набора путевых точек. Это поле не возвращается, если одна или несколько путевых точек являются «через путевые точки». |
geocoded_waypoints optional | Тип: Array < DirectionsGeocodedWaypoint > optional Массив DirectionsGeocodedWaypoint , каждый из которых содержит информацию о геокодировании пункта отправления, назначения и путевых точек. |
НаправленияКласс Renderer
google.maps . DirectionsRenderer
Отображает направления, полученные от DirectionsService
.
Этот класс расширяет MVCObject
.
Доступ осуществляется путем вызова const {DirectionsRenderer} = await google.maps.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 Подавить отрисовку полилиний. |
Направления Интерфейс Waypoint
google.maps . DirectionsWaypoint
Направления Интерфейс google.maps . DirectionsWaypoint
DirectionsWaypoint
представляет собой местоположение между пунктом отправления и пунктом назначения, через которое должна быть проложена поездка.
Характеристики | |
---|---|
location optional | Тип: string| LatLng | LatLngLiteral | Place optional Местоположение путевой точки. Может быть адресной строкой, LatLng или Place . Необязательный. |
stopover optional | Тип: boolean optional По умолчанию: true Если true , это означает, что эта путевая точка является остановкой между отправной точкой и пунктом назначения. Это приводит к разделению маршрута на два этапа. Если false , указывает, что маршрут должен проходить через эту точку, но не разделяться на два участка. Это полезно, если вы хотите создать маршрут в ответ на перетаскивание пользователем путевых точек на карте. |
НаправленияИнтерфейсGeocodedWaypoint
google.maps . DirectionsGeocodedWaypoint
Одна геокодированная путевая точка.
Характеристики | |
---|---|
partial_match optional | Тип: boolean optional Не вернул ли геокодер точное совпадение исходной путевой точки, хотя он смог сопоставить часть запрошенного адреса. |
place_id optional | Тип: string optional Идентификатор места, связанный с путевой точкой. Идентификаторы мест однозначно идентифицируют место в базе данных Google Адресов и на Картах Google. Подробную информацию об идентификаторах мест можно найти в руководстве разработчика API Places. |
types optional | Тип: Array <string> optional Массив строк, обозначающий тип возвращаемого геокодированного элемента. Список возможных строк см. в разделе «Типы компонентов адреса» Руководства разработчика. |
НаправленияИнтерфейс маршрута
google.maps . DirectionsRoute
Одиночный маршрут, содержащий набор этапов в DirectionsResult
. Обратите внимание: хотя этот объект и «подобен JSON», он не является строго JSON, поскольку прямо или косвенно включает в себя объекты LatLng
.
Характеристики | |
---|---|
bounds | Тип: LatLngBounds Границы этого маршрута. |
copyrights | Тип: string Текст об авторских правах, который будет отображаться для этого маршрута. |
legs | Тип: Array < DirectionsLeg > Массив DirectionsLeg , каждый из которых содержит информацию о шагах, из которых он состоит. Для каждой указанной промежуточной точки или пункта назначения будет один этап. Таким образом, маршрут без остановочных точек будет содержать один 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 Суммарный тариф за всю транзитную поездку. Применимо только к запросам на транзит. |
НаправленияLeg интерфейс
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 , каждый из которых содержит информацию об отдельных шагах этого этапа. |
| Тип: 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 , поскольку продолжительность может быть неизвестна. |
НаправленияШаговый интерфейс
google.maps . DirectionsStep
интерфейс
Один DirectionsStep
в DirectionsResult
. Некоторые поля могут быть undefined
. Обратите внимание: хотя этот объект и «подобен JSON», он не является строго JSON, поскольку напрямую включает в себя объекты LatLng
.
Характеристики | |
---|---|
encoded_lat_lngs | Тип: string Закодированное полилинейное представление шага. Это приблизительный (сглаженный) путь ступени. |
end_location | Тип: LatLng Конечная позиция этого шага. |
| Тип: LatLng Конечная позиция этого шага. |
instructions | Тип: string Инструкции для этого шага. |
| Последовательность LatLng , описывающая ход этого шага. Это приблизительный (сглаженный) путь ступени. |
maneuver | Тип: string Содержит действие, которое необходимо выполнить для текущего шага ( turn-left , merge , straight и т. д.). Значения могут быть изменены, а новые значения могут быть введены без предварительного уведомления. |
path | Последовательность LatLng , описывающая ход этого шага. Это приблизительный (сглаженный) путь ступени. |
start_location | Тип: LatLng Начальное местоположение этого шага. |
| Тип: LatLng Начальное местоположение этого шага. |
travel_mode | Тип: TravelMode Способ передвижения, используемый на этом этапе. |
distance optional | Тип: Distance optional Расстояние, преодолеваемое этим шагом. Это свойство может быть undefined , поскольку расстояние может быть неизвестно. |
duration optional | Тип: Duration optional Типичное время, необходимое для выполнения этого шага, в секундах и в текстовой форме. Это свойство может быть undefined , поскольку продолжительность может быть неизвестна. |
| Тип: DirectionsPolyline optional Содержит объект с единственным свойством «points», содержащим закодированное представление шага ломаной линией . Эта ломаная линия представляет собой приблизительную (сглаженную) траекторию ступени. |
steps optional | Тип: Array < DirectionsStep > optional Подэтапы этого шага. Указан для нетранзитных участков транзитных маршрутов. |
transit optional | Тип: TransitDetails optional Подробности об этом этапе, специфичные для транзита. Это свойство будет неопределенным, если только режим движения на этом этапе не будет TRANSIT . |
transit_details optional | Тип: TransitDetails optional Подробности, относящиеся к этому шагу, если режим движения — TRANSIT . |
НаправленияИнтерфейс Polyline
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
.
Доступ осуществляется путем вызова const {TravelMode} = await google.maps.importLibrary("routes")
. См. раздел Библиотеки в Maps JavaScript API .
Константы | |
---|---|
BICYCLING | Указывает запрос велосипедных маршрутов. |
DRIVING | Указывает запрос маршрута проезда. |
TRANSIT | Указывает запрос транзитных направлений. |
WALKING | Указывает запрос пешеходных маршрутов. |
Интерфейс параметров вождения
google.maps . DrivingOptions
Интерфейс google.maps . DrivingOptions
Настраивает DirectionsRequest
, когда для режима передвижения установлено значение DRIVING
.
Характеристики | |
---|---|
departureTime | Тип: Date Желаемое время отправления для маршрута в виде объекта Date . Объект Date измеряет время в миллисекундах с 1 января 1970 года. Это необходимо указать, чтобы DrivingOptions был действительным. Время отправления должно быть установлено на текущее время или какое-то время в будущем. Это не может быть в прошлом. |
trafficModel optional | Тип: TrafficModel optional Предпочтительное предположение, которое следует использовать при прогнозировании продолжительности трафика. По умолчанию — BEST_GUESS . |
Константы модели трафика
google.maps . TrafficModel
Константы google.maps . TrafficModel
Допущения, которые следует использовать при прогнозировании продолжительности пробок. Указывается как часть DirectionsRequest
или DistanceMatrixRequest
. Укажите их по значению или используя имя константы. Например, 'bestguess'
или google.maps.TrafficModel.BEST_GUESS
.
Доступ осуществляется путем вызова const {TrafficModel} = await google.maps.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
Константы google.maps . TransitMode
Действительный режим транзита, например автобус, который можно указать в TransitOptions
. Укажите их по значению или используя имя константы. Например, 'BUS'
или google.maps.TransitMode.BUS
.
Доступ осуществляется путем вызова const {TransitMode} = await google.maps.importLibrary("routes")
. См. раздел Библиотеки в Maps JavaScript API .
Константы | |
---|---|
BUS | Указывает автобус как предпочтительный вид транспорта. |
RAIL | Определяет железнодорожный транспорт как предпочтительный вид транспорта. |
SUBWAY | Указывает метро как предпочтительный вид транспорта. |
TRAIN | Указывает поезд как предпочтительный вид транспорта. |
TRAM | Указывает трамвай как предпочтительный вид транспорта. |
Константы TransitRoutePreference
google.maps . TransitRoutePreference
Константы google.maps . TransitRoutePreference
Допустимый тип транзитного маршрута, который можно указать в TransitOptions
. Укажите их по значению или используя имя константы. Например, 'LESS_WALKING'
или google.maps.TransitRoutePreference.LESS_WALKING
.
Доступ осуществляется путем вызова const {TransitRoutePreference} = await google.maps.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 Текст, который появляется в расписаниях и вывесках для обозначения пассажирами транзитной поездки, например, для обозначения номеров поездов пригородных поездов. Текст однозначно идентифицирует поездку в течение дня обслуживания. |
Интерфейс ТранзитСтоп
google.maps . TransitStop
Интерфейс google.maps . TransitStop
Подробная информация о транзитной остановке или станции.
Характеристики | |
---|---|
location | Тип: LatLng Расположение этой остановки. |
name | Тип: string Название этой транзитной остановки. |
Интерфейс ТранзитЛайн
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 Тип используемого транспортного средства, например, поезд или автобус. |
Интерфейс Транзитагентства
google.maps . TransitAgency
Интерфейс google.maps . TransitAgency
Информация об агентстве, эксплуатирующем транзитную линию.
Характеристики | |
---|---|
name | Тип: string Название этого транзитного агентства. |
phone | Тип: string Телефон транзитного агентства. |
url | Тип: string URL-адрес транзитного агентства. |
Интерфейс транзитного транспортного средства
google.maps . TransitVehicle
Интерфейс google.maps . TransitVehicle
Сведения о транспортном средстве, работающем на транзитной линии.
Характеристики | |
---|---|
icon | Тип: string URL-адрес значка, соответствующего типу транспортного средства, используемому в этой строке. |
local_icon | Тип: string URL-адрес значка, соответствующего типу транспортного средства, используемого в этом регионе, вместо более общего значка. |
name | Тип: string Имя для этого типа транзитного транспортного средства, например «Поезд» или «Автобус». |
type | Тип: Тип VehicleType Тип используемого транспортного средства, например, поезд, автобус или паром. |
Константы типа транспортного средства
google.maps . VehicleType
Константы google.maps . VehicleType
Возможные значения для типов транспортных средств.
Доступ осуществляется путем вызова const {VehicleType} = await google.maps.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
.
Доступ осуществляется путем вызова const {UnitSystem} = await google.maps.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
интерфейс
Представление времени в виде объекта Date, локализованной строки и часового пояса.
Характеристики | |
---|---|
text | Тип: string Строка, представляющая значение времени. Время отображается в часовом поясе транзитной остановки. |
time_zone | Тип: string Часовой пояс, в котором находится эта остановка. Значением является название часового пояса, определенное в базе данных часовых поясов IANA, например «Америка/Нью_Йорк». |
value | Тип: Date Время отправления или прибытия в виде объекта даты JavaScript. |
Константы DirectionsTravelMode
google.maps . DirectionsTravelMode
Константы google.maps . DirectionsTravelMode
НаправленияUnitСистемные константы
google.maps . DirectionsUnitSystem
константы