НаправленияКласс обслуживания
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 , служба маршрутов будет избегать автомагистралей, где это возможно. Необязательно. |
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
Статус, возвращаемый 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 | Не удалось найти маршрут между пунктом отправления и пунктом назначения. |
Интерфейс 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 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 Подавить рендеринг полилиний. |
Интерфейс DirectionsWaypoint
google.maps . DirectionsWaypoint
DirectionsWaypoint
представляет собой местоположение между отправной точкой и пунктом назначения, через которое должен быть проложен маршрут поездки.
Характеристики | |
---|---|
location optional | Тип: string| LatLng | LatLngLiteral | Place optional Местоположение точки маршрута. Может быть адресной строкой, LatLng или Place . Необязательно. |
stopover optional | Тип: boolean optional По умолчанию: true Значение true указывает, что эта путевая точка является остановкой между начальной и конечной точками. Это приводит к разделению маршрута на два этапа. Значение false указывает, что маршрут должен быть смещен так, чтобы проходить через эту путевую точку, но не разделяться на два этапа. Это полезно, если вы хотите создать маршрут в ответ на перетаскивание пользователем путевых точек на карте. |
Интерфейс «НаправленияГеокодированные путевые точки»
google.maps . DirectionsGeocodedWaypoint
Одна геокодированная путевая точка.
Характеристики | |
---|---|
partial_match optional | Тип: boolean optional Не вернул ли геокодер точное совпадение для исходной точки маршрута, хотя ему удалось сопоставить часть запрошенного адреса. |
place_id optional | Тип: string optional Идентификатор места, связанный с путевой точкой. Идентификаторы места однозначно идентифицируют место в базе данных Google Places и на Google Картах. Подробнее об идентификаторах места см. в руководстве разработчика API Places. |
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-адреса 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 | Тип: 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, которая добавит дополнительные При использовании сервиса Directions Service для реализации перетаскиваемых маршрутов рекомендуется отключить перетаскивание альтернативных маршрутов. Перетаскивание должно быть доступно только для основного маршрута. Пользователи могут перетаскивать основной маршрут до тех пор, пока он не совпадёт с альтернативным. |
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
Один объект 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 Содержит объект с одним свойством «точки», содержащим закодированное ломаное представление ступени. Эта ломаная представляет собой приблизительный (сглаженный) путь ступени. |
steps optional | Тип: Array < DirectionsStep > optional Подэтапы данного этапа. Указаны для нетранзитных участков транзитных маршрутов. |
transit optional | Тип: TransitDetails optional Информация об этом этапе, связанная с общественным транспортом. Это свойство не будет определено, если только способ передвижения на этом этапе не выбран как TRANSIT . |
transit_details optional | Тип: TransitDetails optional Подробная информация, касающаяся этого шага, если вид передвижения — TRANSIT . |
Интерфейс 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 Карт. Обратите внимание, что placeId — наиболее точный способ идентификации места. По возможности следует указывать placeId , а не query . Идентификатор места можно получить из любого запроса к API Places, например, с помощью TextSearch . Идентификаторы мест также можно получить из запросов к 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
, если режим передвижения установлен на 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
.
Доступ осуществляется путем вызова 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 | Тип: string URL-адрес значка, связанного с этой строкой. |
name | Тип: string Полное название этой транспортной линии, например, «8 Avenue Local». |
short_name | Тип: string Краткое название этой транзитной линии, например, «E». |
text_color | Тип: string Цвет текста, обычно используемый в вывесках для этой линии общественного транспорта, представленный в виде шестнадцатеричной строки. |
url | Тип: string URL-адрес агентства, относящегося к данной транспортной линии. |
vehicle | Тип: TransitVehicle Тип используемого транспортного средства, например поезд или автобус. |
Интерфейс TransitAgency
google.maps . TransitAgency
Информация об агентстве, эксплуатирующем транзитную линию.
Характеристики | |
---|---|
name | Тип: string Название этого транзитного агентства. |
phone | Тип: string Номер телефона транспортного агентства. |
url | Тип: string URL-адрес транспортного агентства. |
Интерфейс TransitVehicle
google.maps . TransitVehicle
Информация о транспортном средстве, работающем на транзитной линии.
Характеристики | |
---|---|
icon | Тип: string URL-адрес значка, соответствующего типу транспортного средства, используемого на этой линии. |
local_icon | Тип: string URL-адрес значка, соответствующего типу транспортного средства, используемого в этом регионе, вместо более общего значка. |
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 должны быть выражены в метрических единицах. |
Интерфейс расстояния
google.maps . Distance
Представление расстояния в виде числового значения и отображаемой строки.
Характеристики | |
---|---|
text | Тип: string Строковое представление значения расстояния с использованием UnitSystem , указанной в запросе. |
value | Тип: number Расстояние в метрах. |
Интерфейс продолжительности
google.maps . Duration
Представление длительности в виде числового значения и отображаемой строки.
Характеристики | |
---|---|
text | Тип: string Строковое представление значения длительности. |
value | Тип: number Длительность в секундах. |
Интерфейс времени
google.maps . Time
Представление времени в виде объекта Date, локализованной строки и часового пояса.
Характеристики | |
---|---|
text | Тип: string Строка, представляющая значение времени. Время отображается в часовом поясе остановки общественного транспорта. |
time_zone | Тип: string Часовой пояс, в котором находится эта остановка. Значение — название часового пояса, как определено в базе данных часовых поясов IANA, например, «America/New_York». |
value | Тип: Date Время отправления или прибытия, указанное как объект JavaScript Date. |
Константы DirectionsTravelMode
google.maps . DirectionsTravelMode
Константы DirectionsUnitSystem
google.maps . DirectionsUnitSystem