Класс DirectionsService
google.maps.DirectionsService
класс
Служба вычисления маршрутов между двумя и более местами на карте.
Чтобы получить доступ, позвоните по номеру const {DirectionsService} = await google.maps.importLibrary("routes").
Подробнее о библиотеках Maps JavaScript API…
Конструктор | |
|---|---|
DirectionsService |
DirectionsService()Параметры: нет.
Создает новый экземпляр DirectionsService, который отправляет запросы маршрутов на серверы Google. |
Методы | |
|---|---|
route |
route(request[, callback])Параметры:
Возвращаемое значение:
Promise<DirectionsResult>Выдает запрос на поиск маршрута. |
Интерфейс 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Массив промежуточных точек маршрута. Маршрут рассчитывается от начальной до конечной точки через все путевые точки, указанные в массиве. Максимальное количество путевых точек указано в руководстве для разработчиков. Путевые точки не поддерживаются в маршрутах на общественном транспорте. Необязательное поле. |
Константы 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 |
Эта веб-страница не может использовать службу Directions. |
UNKNOWN_ERROR |
Запрос маршрутов не обработан из-за ошибки сервера. Если повторить попытку, запрос может оказаться успешным. |
ZERO_RESULTS |
Между исходной точкой и пунктом назначения не найдено ни одного маршрута. |
Интерфейс DirectionsResult
google.maps.DirectionsResult
интерфейс
Ответ на запрос маршрута, полученный от сервера службы маршрутов. Вы можете отобразить их с помощью DirectionsRenderer или проанализировать этот объект и отобразить его самостоятельно. Вы должны показывать предупреждения и информацию об авторских правах, как указано в Условиях использования платформы Google Карт. Обратите внимание, что хотя этот результат похож на 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, каждый из которых содержит геокоды начальной, конечной и путевых точек маршрута. |
Класс DirectionsRenderer
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
интерфейс
Этот объект определяет свойства, которые можно задать для объекта DirectionsRenderer.
Свойства | |
|---|---|
directions optional |
Тип:
DirectionsResult optionalМаршруты, которые нужно показать на карте и/или на панели <div>, полученные в виде объекта DirectionsResult из DirectionsService. |
draggable optional |
Тип:
boolean optionalЕсли задано значение true, пользователь может перетаскивать и изменять маршруты, отрисованные этим объектом DirectionsRenderer. |
hideRouteList optional |
Тип:
boolean optionalПо умолчанию:
false.Это свойство указывает, должен ли модуль визуализации предоставлять список маршрутов, которые пользователь может выбрать на панели маршрутов. |
infoWindow optional |
Тип:
InfoWindow optionalInfoWindow, в котором будет отображаться текстовая информация при нажатии на маркер. Содержание существующего информационного окна будет перезаписано, а положение окна – изменено. Если информационное окно не указано, 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Блокирует вывод полилиний. |
Интерфейс DirectionsWaypoint
google.maps.DirectionsWaypoint
интерфейс
DirectionsWaypoint представляет собой местоположение между пунктом отправления и пунктом назначения, через которое должен проходить маршрут поездки.
Свойства | |
|---|---|
location optional |
Тип:
string|LatLng|LatLngLiteral|Place optionalМестоположение путевой точки. Это может быть строка адреса, LatLng или Place. Необязательное поле. |
stopover optional |
Тип:
boolean optionalПо умолчанию:
true.Если задано значение true, это означает, что путевая точка является остановкой между пунктами отправления и назначения. В результате маршрут будет разделен на два этапа. Если задано значение false, маршрут должен проходить через эту путевую точку, но не делиться на два отрезка. Это полезно, если вы хотите создать маршрут в ответ на перетаскивание пользователем путевых точек на карте. |
Интерфейс DirectionsGeocodedWaypoint
google.maps.DirectionsGeocodedWaypoint
интерфейс
Одна путевая точка с геокодом.
Свойства | |
|---|---|
partial_match optional |
Тип:
boolean optionalУказывает, что геокодер не вернул точное соответствие для исходной путевой точки, хотя и обнаружил частичное совпадение с запрашиваемым адресом. |
place_id optional |
Тип:
string optionalИдентификатор места, связанный с путевой точкой. Идентификатор места однозначно идентифицирует его в базе данных Google Places и на Google Картах. Подробнее об идентификаторах мест в руководстве для разработчиков Places API. |
types optional |
Тип:
Array<string> optionalМассив строк, указывающих тип возвращенного геокодированного элемента. Список возможных строк приведен в разделе Типы компонентов адреса руководства для разработчиков. |
Интерфейс DirectionsRoute
google.maps.DirectionsRoute
интерфейс
Один маршрут, содержащий набор отрезков в DirectionsResult. Обратите внимание, что хотя этот объект похож на JSON, он не является JSON в строгом смысле, поскольку прямо и косвенно включает объекты LatLng.
Свойства | |
|---|---|
bounds |
Тип:
LatLngBoundsГраницы этого маршрута. |
copyrights |
Тип:
stringТекст об авторских правах, который должен отображаться для этого маршрута. |
legs |
Тип:
Array<DirectionsLeg>Массив объектов DirectionsLeg, каждый из которых содержит информацию о шагах, из которых он состоит. Для каждой путевой точки остановки или конечной точки используется отдельный отрезок. Маршрут без промежуточных путевых точек содержит один объект DirectionsLeg, а маршрут с одной промежуточной путевой точкой – два. |
overview_path |
Массив LatLng, представляющий весь маршрут. Путь упрощен, чтобы сделать его подходящим для контекстов, где требуется небольшое количество вершин (например, для URL Static Maps API). |
overview_polyline |
Тип:
stringКодированная ломаная линия, представляющая маршрут в overview_path. Эта ломаная линия представляет собой приблизительный (сглаженный) путь полученного маршрута. |
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
интерфейс
Один этап, состоящий из набора шагов в DirectionsResult. Некоторые поля в отрезке могут возвращаться не для всех запросов. Обратите внимание, что хотя этот результат похож на JSON, он не является строго JSON, поскольку прямо и косвенно включает объекты LatLng.
Свойства | |
|---|---|
end_address |
Тип:
stringАдрес пункта назначения отрезка. Этот текст должен отображаться "как есть", без дополнительной программной обработки. |
end_location |
Тип:
LatLngDirectionsService рассчитывает маршруты между местоположениями, используя ближайший вариант транспорта (обычно дорогу) в начальном и конечном местоположениях. end_location – фактический геокод пункта назначения. Он может отличаться от end_location последнего шага, например если дорога находится далеко от пункта назначения этого отрезка. |
start_address |
Тип:
stringАдрес исходной точки этого отрезка. Этот текст должен отображаться "как есть", без дополнительной программной обработки. |
start_location |
Тип:
LatLngDirectionsService рассчитывает маршруты между местоположениями, используя ближайший вариант транспорта (обычно дорогу) в начальном и конечном местоположениях. start_location – фактическая начальная точка, которая может отличаться от start_location первого шага (например, если дорога находится далеко от начальной точки этого отрезка). |
steps |
Тип:
Array<DirectionsStep>Массив объектов DirectionsStep, каждый из которых содержит информацию об отдельных шагах на этом этапе. |
|
Тип:
Array<*>Информация о скорости движения на этапе. |
via_waypoints |
Массив путевых точек без остановок на этом этапе, которые были указаны в исходном запросе. Больше не поддерживается в альтернативных маршрутах. Версия 3.27 – последняя, в которой это свойство поддерживается. Если вы используете сервис Directions для реализации перетаскиваемых маршрутов, рекомендуем отключить перетаскивание в альтернативных маршрутах. Перетаскивание должно поддерживаться только для основного маршрута. Пользователи могут перетащить его так, чтобы он совпал с альтернативным. |
arrival_time optional |
Тип:
Time optionalРасчетное время прибытия в конечную точку этого участка. Применимо только для запросов TRANSIT. |
departure_time optional |
Тип:
Time optionalОжидаемое время отправления для этого этапа. Применимо только для запросов TRANSIT. |
distance optional |
Тип:
Distance optionalОбщее расстояние, покрываемое отрезком. Это свойство может быть не задано, если расстояние неизвестно. |
duration optional |
Тип:
Duration optionalОбщая длина этого отрезка. Это свойство может быть равно undefined, если продолжительность неизвестна. |
duration_in_traffic optional |
Тип:
Duration optionalОбщее время поездки по этому участку с учетом загруженности дорог, указанной в свойстве trafficModel. Это свойство может быть равно undefined, если продолжительность неизвестна. |
Интерфейс DirectionsStep
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. |
Интерфейс DirectionsPolyline
google.maps.DirectionsPolyline
интерфейс
Объект, содержащий свойство points, которое описывает ломаную линию DirectionsStep.
Свойства | |
|---|---|
points |
Тип:
string |
Интерфейс Place
google.maps.Place
интерфейс
Содержит информацию, необходимую для поиска, идентификации или описания места для DirectionsRequest или DistanceMatrixRequest. В данном случае "место" – это компания, объект инфраструктуры или географическое местоположение. Чтобы получить информацию о месте, ознакомьтесь с PlacesService.
Свойства | |
|---|---|
location optional |
Тип:
LatLng|LatLngLiteral optionalLatLng объекта, описанного этим местом. |
placeId optional |
Тип:
string optionalИдентификатор места (например, компании или объекта инфраструктуры). Идентификатор места – это уникальный идентификатор места в базе данных Google Карт. Обратите внимание, что placeId – это самый точный способ идентификации места. По возможности указывайте placeId, а не query. Идентификатор места можно получить из любого запроса к Places API, например TextSearch. Идентификаторы мест также можно получить из запросов к Geocoding API. Подробнее об идентификаторах мест… |
query optional |
Тип:
string optionalПоисковый запрос, описывающий место (например, компанию или объект инфраструктуры). Пример запроса: "Quay, Upper Level, Overseas Passenger Terminal 5 Hickson Road, The Rocks NSW". По возможности указывайте placeId, а не query. API не гарантирует точность сопоставления строки запроса с местом. Если указаны оба параметра (placeId и query), произойдет ошибка. |
Константы 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 |
Указывает запрос пешеходных маршрутов. |
Интерфейс DrivingOptions
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.
Чтобы получить доступ, позвоните по номеру const {TrafficModel} = await google.maps.importLibrary("routes").
Подробнее о библиотеках Maps JavaScript API…
Константы | |
|---|---|
BEST_GUESS |
Используйте статистику загруженности дорог, чтобы точнее оценивать время в пути. |
OPTIMISTIC |
Используйте статистику трафика, чтобы сделать оптимистичный прогноз продолжительности поездки. |
PESSIMISTIC |
Используйте статистику трафика, чтобы получить пессимистичную оценку продолжительности поездки с учетом загруженности дорог. |
Интерфейс TransitOptions
google.maps.TransitOptions
интерфейс
Объект TransitOptions, который будет включен в DirectionsRequest, если в качестве способа передвижения выбран общественный транспорт.
Свойства | |
|---|---|
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.
Чтобы получить доступ, позвоните по номеру const {TransitMode} = await google.maps.importLibrary("routes").
Подробнее о библиотеках Maps JavaScript API…
Константы | |
|---|---|
BUS |
Указывает, что предпочтительным способом передвижения является автобус. |
|
Указывает, что предпочтительным способом передвижения является легкое метро. |
RAIL |
Указывает, что предпочтительным способом передвижения является поезд. |
SUBWAY |
Указывает, что предпочтительным способом передвижения является метро. |
TRAIN |
Указывает, что предпочтительным способом передвижения является поезд. |
TRAM |
Указывает трамвай в качестве предпочитаемого способа передвижения. |
Константы 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
интерфейс
Стоимость проезда на DirectionsRoute , состоящая из значения и валюты.
Свойства | |
|---|---|
currency |
Тип:
stringКод валюты ISO 4217, в которой указана стоимость проезда. |
text |
Тип:
stringСтоимость проезда, выраженная в указанной валюте ( currency), в виде строки. |
value |
Тип:
numberЧисловое значение стоимости проезда, выраженное в указанной валюте currency. |
Интерфейс 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
интерфейс
Сведения об остановке или станции общественного транспорта.
Свойства | |
|---|---|
location |
Тип:
LatLngМестоположение остановки. |
name |
Тип:
stringНазвание остановки общественного транспорта. |
Интерфейс TransitLine
google.maps.TransitLine
интерфейс
Информация о маршруте общественного транспорта, который используется на этом шаге.
Свойства | |
|---|---|
agencies |
Тип:
Array<TransitAgency>Транспортное агентство, которое обслуживает этот маршрут. |
color |
Тип:
stringЦвет, которым обозначается этот маршрут, в виде шестнадцатеричной строки. |
icon |
Тип:
stringURL значка этого маршрута. |
name |
Тип:
stringПолное название маршрута, например "8 Avenue Local". |
short_name |
Тип:
stringСокращенное название маршрута общественного транспорта, например "E". |
text_color |
Тип:
stringЦвет текста, обычно используемого в знаках этого вида транспорта, представленный в виде шестнадцатеричной строки. |
url |
Тип:
stringURL агентства, относящийся к этой транспортной линии. |
vehicle |
Тип:
TransitVehicleТип транспортного средства, например поезд или автобус. |
Интерфейс TransitAgency
google.maps.TransitAgency
интерфейс
Информация об агентстве, которое управляет транспортной линией.
Свойства | |
|---|---|
name |
Тип:
stringНазвание транспортного агентства. |
phone |
Тип:
stringНомер телефона транспортного агентства. |
url |
Тип:
stringURL транспортного агентства. |
Интерфейс TransitVehicle
google.maps.TransitVehicle
интерфейс
Информация о транспортном средстве, которое работает на маршруте общественного транспорта.
Свойства | |
|---|---|
icon |
Тип:
stringURL значка, соответствующего виду транспорта на этом маршруте. |
local_icon |
Тип:
stringURL значка, который соответствует типу транспортного средства, используемого в этом регионе, вместо более общего значка. |
name |
Тип:
stringНазвание типа транспортного средства, например "Поезд" или "Автобус". |
type |
Тип:
VehicleTypeТип транспортного средства, например поезд, автобус или паром. |
Константы 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
константы
Допустимые системы единиц, которые можно указать в DirectionsRequest.
Чтобы получить доступ, позвоните по номеру const {UnitSystem} = await google.maps.importLibrary("core").
Подробнее о библиотеках Maps JavaScript API…
Константы | |
|---|---|
IMPERIAL |
Указывает, что расстояния в DirectionsResult должны быть выражены в имперских единицах измерения. |
METRIC |
Указывает, что расстояния в DirectionsResult должны быть выражены в метрических единицах. |
Интерфейс Distance
google.maps.Distance
интерфейс
Представляет расстояние в виде числового значения и отображаемой строки.
Свойства | |
|---|---|
text |
Тип:
stringСтроковое представление значения расстояния с использованием параметра UnitSystem, указанного в запросе. |
value |
Тип:
numberРасстояние в метрах. |
Интерфейс Продолжительность
google.maps.Duration
интерфейс
Представление длительности в виде числового значения и отображаемой строки.
Свойства | |
|---|---|
text |
Тип:
stringСтроковое представление длительности. |
value |
Тип:
numberДлительность в секундах. |
Интерфейс Time
google.maps.Time
интерфейс
Представление времени в виде объекта Date, локализованной строки и часового пояса.
Свойства | |
|---|---|
text |
Тип:
stringСтрока, представляющая значение времени. Время указывается в часовом поясе остановки общественного транспорта. |
time_zone |
Тип:
stringЧасовой пояс, в котором находится остановка. Значение представляет собой название часового пояса, определенное в базе данных часовых поясов IANA, например, "America/New_York". |
value |
Тип:
DateВремя отправления или прибытия, указанное в виде объекта Date JavaScript. |
Константы DirectionsTravelMode
google.maps.DirectionsTravelMode
константы
Константы DirectionsUnitSystem
google.maps.DirectionsUnitSystem
константы