Route (beta)

Класс маршрута

google.maps.routes . Route

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

Доступ осуществляется путем вызова const {Route} = await google.maps.importLibrary("routes") .
См. Библиотеки в Maps JavaScript API .

computeRoutes
computeRoutes(request)
Параметры:
Возвращаемое значение: Promise <{
routes: Array < Route > optional ,
fallbackInfo: FallbackInfo optional ,
geocodingResults: GeocodingResults optional
}>
Возвращает основной маршрут вместе с дополнительными альтернативными маршрутами с учетом набора конечных и промежуточных точек маршрута.

Примечание: Этот метод требует указания маски полей ответа в запросе, установив свойство ComputeRoutesRequest.fields . Значение представляет собой список путей к полям.

Например:
  • Маска поля всех доступных полей: fields: ['*']
  • Маска поля длительности, расстояния и пути на уровне маршрута: fields: ['durationMillis', 'distanceMeters', 'path']

Использование fields: ['*'] не рекомендуется по следующим причинам:
  • Выбор только необходимых вам полей помогает нашему серверу экономить вычислительные циклы, что позволяет нам возвращать вам результат с меньшей задержкой.
  • Выбор только тех полей, которые вам необходимы в производственном задании, обеспечивает стабильную задержку. В будущем мы можем добавить дополнительные поля ответа, и для их обработки может потребоваться больше времени. Если вы выберете все поля или все поля на верхнем уровне, производительность может снизиться, поскольку любое новое поле, которое мы добавим, будет автоматически включено в ответ.
  • Выбор только необходимых полей приводит к уменьшению размера ответа и, следовательно, к более быстрой загрузке по сети.
description
Тип: string optional
Описание маршрута.
distanceMeters
Тип: number optional
Пройденное расстояние маршрута в метрах.
durationMillis
Тип: number optional
Время, необходимое для прохождения маршрута в миллисекундах. Если параметру ComputeRoutesRequest.routingPreference задано значение TRAFFIC_UNAWARE , это значение совпадает с Route.staticDurationMillis . Если параметру ComputeRoutesRequest.routingPreference задано значение TRAFFIC_AWARE или TRAFFIC_AWARE_OPTIMAL , это значение рассчитывается с учётом дорожной ситуации.

Примечание: если длительность превышает 2^53 миллисекунды, то это значение равно Number.POSITIVE_INFINITY .
legs
Тип: Array < RouteLeg > optional
Совокупность этапов (отрезков пути между точками маршрута), составляющих маршрут. Каждый этап соответствует путешествию между двумя точками маршрута, не via .

Например:
  • Маршрут без промежуточных точек имеет только один этап.
  • Маршрут, включающий одну промежуточную точку без via имеет два этапа.
  • Маршрут, включающий одну via точку, имеет один этап.
Порядок этапов соответствует порядку точек маршрута от origin до intermediates и destination .
localizedValues
Тип: RouteLocalizedValues optional
Текстовые представления свойств Route .
optimizedIntermediateWaypointIndices
Тип: Array <number> optional
Если параметру ComputeRoutesRequest.optimizeWaypointOrder задано значение true , это поле содержит оптимизированный порядок промежуточных точек маршрута. В противном случае это поле пусто. Индекс начинается с 0 для первой промежуточной точки маршрута, указанной во входных данных.

Например, если вы введете:
  • Происхождение: Лос-Анджелес
  • Промежуточные точки маршрута: Даллас, Бангор, Финикс.
  • Пункт назначения: Нью-Йорк
и оптимизированный порядок промежуточных точек маршрута — Финикс, Даллас, Бангор, то это поле будет [2, 0, 1] .
path
Тип: Array < LatLngAltitude > optional
Список значений LatLngAltitude маршрута, которые можно использовать для построения полилинии маршрута. Степень детализации пути можно контролировать с помощью параметра ComputeRoutesRequest.polylineQuality .
polylineDetails
Тип: PolylineDetails optional
Содержит информацию о деталях пути.
routeLabels
Тип: Array < RouteLabel > optional
Метки маршрута, полезные для определения конкретных свойств и сравнения с другими.
routeToken
Тип: string optional
Непрозрачный токен, который можно передать в Navigation SDK для реконструкции маршрута во время навигации и, в случае изменения маршрута, сохранения первоначального намерения при его создании. Относитесь к этому токену как к непрозрачному объекту. Не сравнивайте его значение между запросами, так как оно может измениться, даже если сервис возвращает тот же самый маршрут.

Примечание: routeToken доступен только для запросов, у которых параметр ComputeRoutesRequest.routingPreference установлен на TRAFFIC_AWARE или TRAFFIC_AWARE_OPTIMAL . Он не поддерживается для запросов с via точками.
speedPaths
Тип: Array < SpeedPath > optional
Группировки участков маршрута с соответствующими им показаниями скорости. Для заполнения этого поля параметр ComputeRoutesRequest.routingPreference должен быть установлен в TRAFFIC_AWARE или TRAFFIC_AWARE_OPTIMAL , а ComputeRoutesRequest.extraComputations должен включать TRAFFIC_ON_POLYLINE .
staticDurationMillis
Тип: number optional
Продолжительность проезда по маршруту без учета дорожной обстановки.

Примечание: если длительность превышает 2^53 миллисекунды, то это значение равно Number.POSITIVE_INFINITY .
travelAdvisory
Тип: RouteTravelAdvisory optional
Дополнительная информация о маршруте.
viewport
Тип: LatLngBounds optional
Ограничивающая рамка области просмотра маршрута.
warnings
Тип: Array <string> optional
Массив предупреждений, отображаемых при отображении маршрута.
createPolylines
createPolylines([options])
Параметры:
Возвращаемое значение: Array < Polyline >
Создает полилинии маршрута на основе имеющихся данных.

Мультимодальные полилинии:
  • Требования:
  • Создаёт полилинию для каждого сегмента мультимодального маршрута. Стиль полилиний формируется в соответствии с режимом движения и данными о линии общественного транспорта на сегменте (при их наличии). Можно передавать параметры для изменения стиля полилинии в зависимости от режима движения и линии общественного транспорта.

Полилинии дорожного движения:
  • Требования:
  • Создаёт полилинию для каждого интервала маршрута, если показания скорости отличаются от предыдущего интервала. К полилиниям применяется стиль по умолчанию, зависящий от скорости. Можно передавать параметры для изменения стиля полилинии в зависимости от скорости.

Общая полилиния:
  • Требования:
  • Создаёт одну полилинию для всего маршрута с применением стиля по умолчанию. Можно передавать параметры для изменения стиля полилинии в зависимости от режима движения по маршруту. Для дальнейшей настройки полилинии можно создавать напрямую с помощью Route.path или RouteLeg.path .
createWaypointAdvancedMarkers
createWaypointAdvancedMarkers([options])
Параметры:
Возвращаемое значение: Promise < Array < AdvancedMarkerElement >>
Создаёт маркеры маршрута с метками «A», «B», «C» и т. д. для каждой путевой точки. К маркерам применяется стиль по умолчанию. Можно передать параметры для изменения стиля маркера на основе индекса маркера или свойств соответствующего RouteLeg . Параметр WaypointMarkerDetails.leg будет неопределён, если маршрут не имеет этапов.

Поле "legs" должно быть запрошено в ComputeRoutesRequest.fields для включения промежуточных точек маршрута.
toJSON
toJSON()
Параметры: нет
Возвращаемое значение: Object
Преобразуется в объект.

Интерфейс ComputeRoutesRequest

google.maps.routes . ComputeRoutesRequest

Запрос маршрутов.

destination
Пункт назначения маршрута. Значение, передаваемое в виде строки, может быть адресом, плюс-кодом или названием ресурса Place. Значения высоты над уровнем моря не учитываются при расчёте маршрутов.
fields
Тип: Iterable <string>
Коллекция полей для выборки. Укажите ["*"] для всех полей.
origin
Начальная точка маршрута. Значение, передаваемое в виде строки, может быть адресом, плюс-кодом или названием ресурса Place. Значения высоты не учитываются при расчёте маршрутов.
arrivalTime optional
Тип: Date optional
Время прибытия.

Примечание: можно задать только при установке ComputeRoutesRequest.travelMode в значение TRANSIT . Можно указать либо ComputeRoutesRequest.departureTime , либо ComputeRoutesRequest.arrivalTime , но не оба одновременно. Поездки с общественным транспортом доступны на срок до 7 дней в прошлом или до 100 дней в будущем.
computeAlternativeRoutes optional
Тип: boolean optional
Указывает, следует ли рассчитывать альтернативные маршруты в дополнение к текущему маршруту. Альтернативные маршруты не возвращаются для запросов с промежуточными точками маршрута.
departureTime optional
Тип: Date optional
Время отправления. Если вы не укажете это значение, по умолчанию будет использоваться время, когда вы сделали запрос.

Примечание: Указать время в прошлом можно только если для ComputeRoutesRequest.travelMode задано значение TRANSIT . Поездки на общественном транспорте доступны на срок до 7 дней в прошлом или до 100 дней в будущем.
extraComputations optional
Список дополнительных вычислений, которые могут быть использованы для выполнения запроса.

Примечание: Эти дополнительные вычисления могут возвращать дополнительные поля в ответе. Чтобы они были возвращены в ответе, их также необходимо указать в ComputeRoutesRequest.fields .
intermediates optional
Тип: Iterable < Waypoint > optional
Набор промежуточных точек маршрута (исключая конечные), предназначенных для остановок и проездов. Поддерживается до 25 промежуточных точек.
language optional
Тип: string optional
Код языка BCP-47, например, «en-US» или «sr-Latn». Подробнее см. в разделе «Идентификатор локали Unicode» . Список поддерживаемых языков см. в разделе « Поддержка языков» . Если это значение не указано, язык определяется на основе настроек локализации JavaScript API Google Карт. В противном случае язык определяется на основе местоположения источника.
optimizeWaypointOrder optional
Тип: boolean optional
Если задано значение true, сервис пытается минимизировать общую стоимость маршрута, переупорядочивая указанные промежуточные точки маршрута. Запрос завершается ошибкой, если какая-либо из промежуточных точек маршрута является промежуточной точкой. Используйте Route.optimizedIntermediateWaypointIndices в ответе, чтобы определить новый порядок. Если "optimizedIntermediateWaypointIndices" не запрошен в ComputeRoutesRequest.fields , запрос завершается ошибкой. Если задано значение false, Route.optimizedIntermediateWaypointIndices в ответе будет пустым.
polylineQuality optional
Тип: PolylineQuality optional
Задает предпочтение качеству полилинии.
region optional
Тип: string optional
Код региона, указанный как двухсимвольное значение ccTLD («домен верхнего уровня»). Подробнее см. в разделе Код страны для доменов верхнего уровня . Если это значение не указано, регион определяется на основе настроек локализации JavaScript API Google Карт. В противном случае регион определяется на основе местоположения источника.
requestedReferenceRoutes optional
Тип: Iterable < ReferenceRoute > optional
Указывает, какие эталонные маршруты следует рассчитать в рамках запроса в дополнение к маршруту по умолчанию. Эталонный маршрут — это маршрут с целью расчета, отличной от маршрута по умолчанию. Например, при расчете эталонного маршрута FUEL_EFFICIENT учитываются различные параметры, которые позволяют создать оптимальный по расходу топлива маршрут. При использовании этой функции ищите Route.routeLabels в полученных маршрутах.
routeModifiers optional
Тип: RouteModifiers optional
Набор условий, которые необходимо выполнить и которые влияют на способ расчета маршрутов. Например, можно указать объекты, которые следует избегать, такие как платные дороги или автомагистрали.
routingPreference optional
Тип: RoutingPreference optional
Указывает способ вычисления маршрута. Сервер пытается использовать выбранный параметр маршрутизации для вычисления маршрута. Если параметр маршрутизации приводит к ошибке или слишком большой задержке, возвращается ошибка. Этот параметр можно указать только в том случае, если ComputeRoutesRequest.travelMode имеет значение DRIVING или TWO_WHEELER , в противном случае запрос не будет выполнен.
trafficModel optional
Тип: TrafficModel optional
Задаёт допущения, которые следует использовать при расчёте времени в пути. Этот параметр влияет на значения Route.durationMillis и RouteLeg.durationMillis , которые содержат прогнозируемое время в пути на основе исторических средних значений. ComputeRoutesRequest.trafficModel доступен только для запросов, у которых параметр ComputeRoutesRequest.routingPreference установлен на TRAFFIC_AWARE_OPTIMAL , а ComputeRoutesRequest.travelMode — на DRIVING . Значение по умолчанию — BEST_GUESS .
transitPreference optional
Тип: TransitPreference optional
Указывает предпочтения, влияющие на возвращаемый маршрут для маршрутов TRANSIT .

Примечание: можно указать только в том случае, если для параметра ComputeRoutesRequest.travelMode установлено значение TRANSIT .
travelMode optional
Тип: TravelMode optional
Указывает вид транспорта.
units optional
Тип: UnitSystem optional
Задаёт единицы измерения для отображаемых полей, таких как навигационные инструкции. Единицы измерения, используемые для маршрута, этапа, длины шага и длительности, не зависят от этого значения. Если это значение не указано, отображаемые единицы измерения определяются на основе местоположения исходной точки.

Константы ComputeRoutesExtraComputation

google.maps.routes . ComputeRoutesExtraComputation

Дополнительные вычисления, выполняемые для запроса Route.computeRoutes .

Доступ осуществляется путем вызова const {ComputeRoutesExtraComputation} = await google.maps.importLibrary("routes") .
См. Библиотеки в Maps JavaScript API .

FLYOVER_INFO_ON_POLYLINE Информация о пролётах для маршрута(ов). Для возврата этой информации необходимо указать поле "polylineDetails" в ComputeRoutesRequest.fields . В настоящее время эти данные будут заполняться только для некоторых агломераций в Индии. Эта функция экспериментальная, и артикул/стоимость могут быть изменены.
FUEL_CONSUMPTION Расчетный расход топлива по маршруту(ам).
HTML_FORMATTED_NAVIGATION_INSTRUCTIONS Инструкции по навигации представлены в виде отформатированной HTML-строки. Этот контент предназначен только для чтения «как есть» и отображения. Не выполняйте его программный анализ.
NARROW_ROAD_INFO_ON_POLYLINE Информация об узких дорогах для маршрута(ов). Для возврата этой информации необходимо указать поле "polylineDetails" в ComputeRoutesRequest.fields . В настоящее время эти данные будут заполняться только для некоторых агломераций в Индии. Эта функция экспериментальная, и артикул/стоимость могут быть изменены.
TOLLS Информация о платных маршрутах.
TRAFFIC_ON_POLYLINE Полилинии с учетом дорожного движения для маршрута(ов).

Интерфейс DirectionalLocationLiteral

google.maps.routes . DirectionalLocationLiteral

Для удобства вместо экземпляров DirectionalLocation принимаются литералы объектов. Они преобразуются в DirectionalLocation при обнаружении их Maps JS API.

Этот интерфейс расширяет LatLngAltitudeLiteral .

heading optional
Тип: number optional
Направление по компасу, соответствующее направлению движения транспорта. Значения направления могут быть числами от 0 до 360, где 0 указывает направление на север, 90 — на восток и т. д. Это поле можно использовать только для DRIVING и TWO_WHEELER ComputeRoutesRequest.travelMode .
Унаследовано: altitude , lat , lng

Класс DirectionalLocation

google.maps.routes . DirectionalLocation

Содержит географическую точку и необязательный заголовок.

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

Этот класс реализует DirectionalLocationLiteral .

Доступ осуществляется путем вызова const {DirectionalLocation} = await google.maps.importLibrary("routes") .
См. Библиотеки в Maps JavaScript API .

Унаследовано: LatLngAltitude
heading
Тип: number optional
Направление по компасу, соответствующее направлению движения транспорта. Значения направления могут быть числами от 0 до 360, где 0 указывает направление на север, 90 — на восток и т. д. Это поле можно использовать только для DRIVING и TWO_WHEELER ComputeRoutesRequest.travelMode .
Унаследовано: altitude , lat , lng
toJSON
toJSON()
Параметры: нет
Возвращаемое значение: DirectionalLocationLiteral
Преобразуется в объект.
Унаследовано: equals

Класс FallbackInfo

google.maps.routes . FallbackInfo

Информация о том, как и почему в ответе Route.computeRoutes был использован резервный результат. Если это поле задано, это означает, что сервер использовал в качестве резервного режима маршрутизации режим, отличный от предпочитаемого вами.

Доступ осуществляется путем вызова const {FallbackInfo} = await google.maps.importLibrary("routes") .
См. Библиотеки в Maps JavaScript API .

reason
Тип: FallbackReason optional
Причина, по которой был использован резервный ответ вместо исходного. Это поле заполняется только при активации резервного режима и возврате резервного ответа.
routingMode
Тип: FallbackRoutingMode optional
Режим маршрутизации, используемый для ответа. Если был активирован резервный режим, он может отличаться от настроек маршрутизации, установленных в исходном клиентском запросе.

Константы FallbackReason

google.maps.routes . FallbackReason

Причина, по которой в ответе Route.computeRoutes был возвращен резервный ответ.

Доступ осуществляется путем вызова const {FallbackReason} = await google.maps.importLibrary("routes") .
См. Библиотеки в Maps JavaScript API .

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

Константы FallbackRoutingMode

google.maps.routes . FallbackRoutingMode

Фактический режим маршрутизации, используемый при возврате резервного ответа в ответе Route.computeRoutes .

Доступ осуществляется путем вызова const {FallbackRoutingMode} = await google.maps.importLibrary("routes") .
См. Библиотеки в Maps JavaScript API .

TRAFFIC_AWARE Указывает, что для вычисления ответа использовался RoutingPreference TRAFFIC_AWARE .
TRAFFIC_UNAWARE Указывает, что для вычисления ответа использовался RoutingPreference TRAFFIC_UNAWARE .

Класс GeocodedWaypoint

google.maps.routes . GeocodedWaypoint

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

Доступ осуществляется путем вызова const {GeocodedWaypoint} = await google.maps.importLibrary("routes") .
См. Библиотеки в Maps JavaScript API .

geocoderStatus
Тип: RPCStatus optional
Указывает код состояния, полученный в результате операции геокодирования.
intermediateWaypointRequestIndex
Тип: number optional
Индекс соответствующей промежуточной точки маршрута в запросе. Заполняется только в том случае, если соответствующая точка маршрута является промежуточной.
partialMatch
Тип: boolean
Указывает, что геокодер не вернул точное совпадение с исходным запросом, хотя и смог сопоставить часть запрошенного адреса. Рекомендуем проверить исходный запрос на наличие опечаток и/или неполного адреса.
placeId
Тип: string
Идентификатор места для этого результата.
types
Тип: Array <string>
Тип(ы) результата, представленные в виде нуля или более тегов типов. Поддерживаемые типы см. на странице https://developers.google.com/maps/documentation/geocoding/requests-geocoding#Types .
toJSON
toJSON()
Параметры: нет
Возвращаемое значение: Object
Преобразуется в объект.

Класс GeocodingResults

google.maps.routes . GeocodingResults

Содержит GeocodedWaypoint для исходной, конечной и промежуточных точек маршрута. Заполняется только для адресных точек маршрута.

Доступ осуществляется путем вызова const {GeocodingResults} = await google.maps.importLibrary("routes") .
См. Библиотеки в Maps JavaScript API .

destination
Тип: GeocodedWaypoint optional
Геокодированная точка маршрута для пункта назначения.
intermediates
Тип: Array < GeocodedWaypoint > optional
Список промежуточных геокодированных путевых точек, каждая из которых содержит индексное поле, соответствующее нулевому положению путевой точки в порядке, указанном в запросе.
origin
Тип: GeocodedWaypoint optional
Геокодированная точка отправления.
toJSON
toJSON()
Параметры: нет
Возвращаемое значение: Object
Преобразуется в объект.

Класс MultiModalSegment

google.maps.routes . MultiModalSegment

Предоставляет сводную информацию о мультимодальном сегменте RouteLeg.steps маршрута. Мультимодальный сегмент определяется как один или несколько смежных RouteLegStep с одинаковым TravelMode .

Доступ осуществляется путем вызова const {MultiModalSegment} = await google.maps.importLibrary("routes") .
См. Библиотеки в Maps JavaScript API .

instructions
Тип: string optional
Инструкции по навигации в этом многомодальном сегменте.
maneuver
Тип: string optional
Навигационный манёвр, который необходимо выполнить на этом этапе. Список возможных значений см. в разделе «Маневр» .
stepEndIndex
Тип: number
Соответствующий индекс RouteLegStep , который является концом многомодального сегмента.
stepStartIndex
Тип: number
Соответствующий индекс RouteLegStep , который является началом многомодального сегмента.
travelMode
Тип: TravelMode optional
Вид транспорта, используемый для данного мультимодального сегмента.
toJSON
toJSON()
Параметры: нет
Возвращаемое значение: Object
Преобразуется в объект.

Класс PolylineDetailInfo

google.maps.routes . PolylineDetailInfo

Содержит информацию об объекте дороги вдоль участка полилинии.

Доступ осуществляется путем вызова const {PolylineDetailInfo} = await google.maps.importLibrary("routes") .
См. Библиотеки в Maps JavaScript API .

endIndex
Тип: number optional
Конечный индекс данного объекта дороги в полилинии.
presence
Тип: RoadFeatureState optional
Обозначает, существует ли дорожный объект вдоль полилинии.
startIndex
Тип: number optional
Начальный индекс этого дорожного объекта в полилинии.
toJSON
toJSON()
Параметры: нет
Возвращаемое значение: Object
Преобразуется в объект.

Класс PolylineDetails

google.maps.routes . PolylineDetails

Подробная информация, соответствующая заданному индексу или непрерывному сегменту полилинии. Для полилинии с точками P_0, P_1, ..., P_N (индекс отсчитывается от нуля) свойство PolylineDetails описывает дорожный объект для заданного интервала.

Доступ осуществляется путем вызова const {PolylineDetails} = await google.maps.importLibrary("routes") .
См. Библиотеки в Maps JavaScript API .

flyoverInfo
Детали пролета вдоль полилинии.
narrowRoadInfo
Детали узкой дороги вдоль полилинии.
toJSON
toJSON()
Параметры: нет
Возвращаемое значение: Object
Преобразуется в объект.

Константы PolylineQuality

google.maps.routes . PolylineQuality

Определяет качество полилинии.

Доступ осуществляется путем вызова const {PolylineQuality} = await google.maps.importLibrary("routes") .
См. Библиотеки в Maps JavaScript API .

HIGH_QUALITY Задаёт высококачественную полилинию, составленную из большего количества точек, чем указано OVERVIEW за счёт увеличения размера отклика. Используйте это значение, когда требуется более высокая точность.
OVERVIEW Задаёт обзорную ломаную линию, составленную из небольшого количества точек. Использование этого параметра обеспечивает меньшую задержку запроса по сравнению с HIGH_QUALITY . Используйте это значение при отображении обзора маршрута.

Константы ReferenceRoute

google.maps.routes . ReferenceRoute

Поддерживаемый опорный маршрут в ComputeRoutesRequest .

Доступ осуществляется путем вызова const {ReferenceRoute} = await google.maps.importLibrary("routes") .
См. Библиотеки в Maps JavaScript API .

FUEL_EFFICIENT Маршрут с низким расходом топлива.
SHORTER_DISTANCE Маршрут с более коротким расстоянием поездки.

Константы RoadFeatureState

google.maps.routes . RoadFeatureState

Инкапсулирует состояния дорожных объектов вдоль участка полилинии.

Доступ осуществляется путем вызова const {RoadFeatureState} = await google.maps.importLibrary("routes") .
См. Библиотеки в Maps JavaScript API .

DOES_NOT_EXIST Дорожный объект отсутствует.
EXISTS Дорожный объект существует.

Константы RouteLabel

google.maps.routes . RouteLabel

Метки маршрута, полезные для определения конкретных объектов и сравнения их с другими.

Доступ осуществляется путем вызова const {RouteLabel} = await google.maps.importLibrary("routes") .
См. Библиотеки в Maps JavaScript API .

DEFAULT_ROUTE Лучший маршрут по умолчанию, возвращаемый для расчета маршрута.
DEFAULT_ROUTE_ALTERNATE Альтернатива «лучшему» маршруту по умолчанию. Такие маршруты будут возвращены при указании ComputeRoutesRequest.computeAlternativeRoutes .
FUEL_EFFICIENT Топливосберегающий маршрут. Маршруты, отмеченные этим значением, оптимизированы по экологическим параметрам, таким как расход топлива.
SHORTER_DISTANCE Более короткий маршрут. Это экспериментальная функция.

Класс RouteLeg

google.maps.routes . RouteLeg

Содержит сегмент между via точками маршрута.

Доступ осуществляется путем вызова const {RouteLeg} = await google.maps.importLibrary("routes") .
См. Библиотеки в Maps JavaScript API .

distanceMeters
Тип: number
Пройденное расстояние по отрезку маршрута в метрах.
durationMillis
Тип: number optional
Время, необходимое для прохождения участка маршрута в миллисекундах. Если параметру ComputeRoutesRequest.routingPreference задано значение TRAFFIC_UNAWARE , это значение совпадает со значением staticDurationMillis . Если параметру ComputeRoutesRequest.routingPreference задано значение TRAFFIC_AWARE или TRAFFIC_AWARE_OPTIMAL , это значение рассчитывается с учётом дорожной ситуации.

Примечание: если длительность превышает 2^53 миллисекунды, то это значение равно Number.POSITIVE_INFINITY .
endLocation
Тип: DirectionalLocation optional
Конечное местоположение этого отрезка. Это местоположение может отличаться от ComputeRoutesRequest.destination . Например, если ComputeRoutesRequest.destination не находится рядом с дорогой, это точка на дороге.
localizedValues
Тип: RouteLegLocalizedValues optional
Текстовые представления свойств RouteLeg .
path
Тип: Array < LatLngAltitude >
Список значений LatLngAltitude для участка маршрута, которые можно использовать для построения полилинии участка маршрута. Степень детализации пути можно контролировать с помощью параметра ComputeRoutesRequest.polylineQuality .
speedPaths
Тип: Array < SpeedPath >
Группы участков маршрута с соответствующими им значениями скорости. Для заполнения этого поля параметр ComputeRoutesRequest.routingPreference должен быть установлен в TRAFFIC_AWARE или TRAFFIC_AWARE_OPTIMAL , а ComputeRoutesRequest.extraComputations должен включать TRAFFIC_ON_POLYLINE .
startLocation
Тип: DirectionalLocation optional
Начальная точка этого этапа. Это местоположение может отличаться от ComputeRoutesRequest.origin . Например, если ComputeRoutesRequest.origin не находится рядом с дорогой, это точка на дороге.
staticDurationMillis
Тип: number optional
Продолжительность проезда по участку без учета условий дорожного движения.

Примечание: если длительность превышает 2^53 миллисекунды, то это значение равно Number.POSITIVE_INFINITY .
steps
Тип: Array < RouteLegStep >
Массив шагов, обозначающих сегменты в пределах этого этапа. Каждый шаг представляет собой одну навигационную инструкцию.
stepsOverview
Тип: StepsOverview optional
Обзорная информация об этапах этого RouteLeg . Это поле заполняется только для маршрутов TRANSIT .
travelAdvisory
Тип: RouteLegTravelAdvisory optional
Содержит дополнительную информацию, о которой следует сообщить пользователю, например, о возможных ограничениях зон движения на участке маршрута.
toJSON
toJSON()
Параметры: нет
Возвращаемое значение: Object
Преобразуется в объект.

Класс RouteLegLocalizedValues

google.maps.routes . RouteLegLocalizedValues

Текстовые представления RouteLeg .

Доступ осуществляется путем вызова const {RouteLegLocalizedValues} = await google.maps.importLibrary("routes") .
См. Библиотеки в Maps JavaScript API .

distance
Тип: string optional
Пройденное расстояние по участку маршрута в текстовом виде.
distanceLanguage
Тип: string optional
Код языка BCP-47 удаленного текста, например «en-US» или «sr-Latn».

Более подробную информацию см. по адресу http://www.unicode.org/reports/tr35/#Unicode_locale_identifier .
duration
Тип: string optional
Длительность, представленная в текстовом виде и локализованная в регионе запроса. Учитывает дорожную обстановку.
durationLanguage
Тип: string optional
Код языка длительности текста BCP-47, например «en-US» или «sr-Latn».

Более подробную информацию см. по адресу http://www.unicode.org/reports/tr35/#Unicode_locale_identifier .
staticDuration
Тип: string optional
Продолжительность без учета дорожной обстановки, указана в текстовом виде.
staticDurationLanguage
Тип: string optional
Код языка BCP-47 статического текста длительности, например «en-US» или «sr-Latn».
toJSON
toJSON()
Параметры: нет
Возвращаемое значение: Object
Преобразуется в объект.

Класс RouteLegStep

google.maps.routes . RouteLegStep

Содержит сегмент RouteLeg . Шаг соответствует одной навигационной инструкции. Участки маршрута состоят из шагов.

Доступ осуществляется путем вызова const {RouteLegStep} = await google.maps.importLibrary("routes") .
См. Библиотеки в Maps JavaScript API .

distanceMeters
Тип: number
Расстояние, пройденное на этом этапе, в метрах.
endLocation
Тип: DirectionalLocation optional
Конечное местоположение этого шага.
instructions
Тип: string optional
Инструкции по выполнению этого шага.
localizedValues
Тип: RouteLegStepLocalizedValues optional
Текстовые представления свойств RouteLegStep .
maneuver
Тип: string optional
Навигационный манёвр, который необходимо выполнить на этом этапе. Список возможных значений см. в разделе «Маневр» .
path
Тип: Array < LatLngAltitude >
Список значений LatLngAltitude для этапа маршрута, которые можно использовать для построения ломаной линии этапа маршрута. Уровень детализации пути можно контролировать с помощью параметра ComputeRoutesRequest.polylineQuality . Для заполнения поля "path" необходимо запросить его в ComputeRoutesRequest.fields .
startLocation
Тип: DirectionalLocation optional
Начальная точка этого шага.
staticDurationMillis
Тип: number optional
Продолжительность проезда по этому этапу без учета дорожной обстановки.

Примечание: если длительность превышает 2^53 миллисекунды, то это значение равно Number.POSITIVE_INFINITY .
transitDetails
Тип: TransitDetails optional
Подробная информация, касающаяся этого шага, если вид передвижения — TRANSIT .
travelMode
Тип: TravelMode optional
Режим передвижения, используемый на этом этапе.
toJSON
toJSON()
Параметры: нет
Возвращаемое значение: Object
Преобразуется в объект.

Класс RouteLegStepLocalizedValues

google.maps.routes . RouteLegStepLocalizedValues

Текстовые представления свойств RouteLegStep .

Доступ осуществляется путем вызова const {RouteLegStepLocalizedValues} = await google.maps.importLibrary("routes") .
См. Библиотеки в Maps JavaScript API .

distance
Тип: string optional
Пройденное расстояние по этапу маршрута в текстовом виде.
distanceLanguage
Тип: string optional
Код языка BCP-47 удаленного текста, например «en-US» или «sr-Latn».

Более подробную информацию см. по адресу http://www.unicode.org/reports/tr35/#Unicode_locale_identifier .
staticDuration
Тип: string optional
Продолжительность без учета дорожной обстановки, указана в текстовом виде.
staticDurationLanguage
Тип: string optional
Код языка BCP-47 статического текста длительности, например «en-US» или «sr-Latn».

Более подробную информацию см. по адресу http://www.unicode.org/reports/tr35/#Unicode_locale_identifier .
toJSON
toJSON()
Параметры: нет
Возвращаемое значение: Object
Преобразуется в объект.

Класс RouteLegTravelAdvisory

google.maps.routes . RouteLegTravelAdvisory

Содержит дополнительную информацию, о которой следует сообщить пользователю на RouteLeg .

Доступ осуществляется путем вызова const {RouteLegTravelAdvisory} = await google.maps.importLibrary("routes") .
См. Библиотеки в Maps JavaScript API .

speedReadingIntervals
Тип: Array < SpeedReadingInterval > optional
Интервалы измерения скорости, детализирующие плотность трафика. Применимо в случаях TRAFFIC_AWARE и TRAFFIC_AWARE_OPTIMAL ComputeRoutesRequest.routingPreference . Интервалы охватывают всю ломаную линию RouteLeg без перекрытия. Начальная точка указанного интервала совпадает с конечной точкой предыдущего интервала.

Пример:
  polyline: A ---- B ---- C ---- D ---- E ---- F ---- G 
 speedReadingIntervals: [A,C), [C,D), [D,G)
tollInfo
Тип: TollInfo optional
Содержит информацию о платных дорогах на определённом RouteLeg . Это поле заполняется только в том случае, если на этом RouteLeg ожидаются платные дороги. Если это поле задано, но поле TollInfo.estimatedPrices не заполнено, то участок маршрута содержит платные дороги, но их предполагаемая стоимость неизвестна. Если это поле пустое, то на этом участке RouteLeg нет платных дорог.
toJSON
toJSON()
Параметры: нет
Возвращаемое значение: Object
Преобразуется в объект.

Класс RouteLocalizedValues

google.maps.routes . RouteLocalizedValues

Текстовые представления свойств Route .

Доступ осуществляется путем вызова const {RouteLocalizedValues} = await google.maps.importLibrary("routes") .
См. Библиотеки в Maps JavaScript API .

distance
Тип: string optional
Пройденное расстояние по маршруту, представленное в текстовом виде.
distanceLanguage
Тип: string optional
Код языка BCP-47 удаленного текста, например «en-US» или «sr-Latn».

Более подробную информацию см. по адресу http://www.unicode.org/reports/tr35/#Unicode_locale_identifier .
duration
Тип: string optional
Длительность, представленная в текстовом виде и локализованная в регионе запроса. Учитывает дорожную ситуацию. Примечание: если вы не запрашивали информацию о дорожной ситуации, это значение совпадает со значением staticDuration .
durationLanguage
Тип: string optional
Код языка длительности текста BCP-47, например «en-US» или «sr-Latn».

Более подробную информацию см. по адресу http://www.unicode.org/reports/tr35/#Unicode_locale_identifier .
staticDuration
Тип: string optional
Продолжительность без учета дорожной обстановки, указана в текстовом виде.
staticDurationLanguage
Тип: string optional
Код языка BCP-47 статического текста длительности, например «en-US» или «sr-Latn».
transitFare
Тип: string optional
Стоимость проезда представлена ​​в текстовом виде.
transitFareLanguage
Тип: string optional
Код языка BCP-47 текста тарифа на проезд, например «en-US» или «sr-Latn».
toJSON
toJSON()
Параметры: нет
Возвращаемое значение: Object
Преобразуется в объект.

Интерфейс RouteModifiers

google.maps.routes . RouteModifiers

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

avoidFerries optional
Тип: boolean optional
Если установлено значение true , паромные переправы будут избегаться там, где это целесообразно, отдавая предпочтение маршрутам без паромов. Применимо только к TravelMode DRIVING или TWO_WHEELER .
avoidHighways optional
Тип: boolean optional
Если установлено значение true , автомагистрали будут объезжаться там, где это целесообразно, отдавая предпочтение маршрутам, не содержащим автомагистралей. Применимо только к режиму DRIVING или TWO_WHEELER TravelMode .
avoidIndoor optional
Тип: boolean optional
Если установлено значение true , навигация внутри помещений будет избегаться, где это целесообразно, отдавая предпочтение маршрутам без навигации внутри помещений. Применимо только к режиму WALKING TravelMode .
avoidTolls optional
Тип: boolean optional
Если установлено значение true , платные дороги будут объезжаться там, где это целесообразно, отдавая предпочтение маршрутам без платных дорог. Применимо только к режиму DRIVING или TWO_WHEELER TravelMode .
tollPasses optional
Тип: Iterable <string> optional
Инкапсулирует информацию о платных проездных. Если проездные предоставлены, API пытается вернуть стоимость проезда. Если проездные не предоставлены, API считает проездной неизвестным и пытается вернуть стоимость проезда наличными. Применимо только к DRIVING или TWO_WHEELER TravelMode . Список допустимых значений см. в TollPass.
vehicleInfo optional
Тип: VehicleInfo optional
Указывает информацию о транспортном средстве.

Интерфейс RoutePolylineDetails

google.maps.routes . RoutePolylineDetails Интерфейс google.maps.routes . RoutePolylineDetails

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

speed optional
Тип: Speed optional
Показания скорости на участке маршрута, соответствующем данной ломаной линии. Заполняется только для маршрутов с информацией о дорожном движении.
transitDetails optional
Тип: TransitDetails optional
Информация о транзитных маршрутах на участке маршрута, соответствующем этой ломаной линии. Заполняется только для маршрутов с транзитными маршрутами.
travelMode optional
Тип: TravelMode optional
Режим движения участка маршрута, соответствующего данной полилинии. Пустой для полилиний трафика.

RoutePolylineOptions interface

google.maps.routes . RoutePolylineOptions

Опции создания полилиний маршрута.

colorScheme optional
Тип: ColorScheme optional
Цветовая схема, используемая для полилинии. Если указано значение FOLLOW_SYSTEM , а colorScheme карты также равна FOLLOW_SYSTEM , полилинии будут рисоваться в том же темном/светлом режиме, что и карта. Если этот параметр не указан, Route.createPolylines пытается использовать colorScheme карты или возвращается к системному значению по умолчанию.
polylineOptions optional
Параметры настройки стиля полилинии. Это может быть либо объект PolylineOptions , который применяется ко всем полилиниям маршрута, либо функция, которая принимает PolylineOptions и RoutePolylineDetails по умолчанию и возвращает PolylineOptions , которые будут применены к этой полилинии.

Класс RouteTravelAdvisory

google.maps.routes . RouteTravelAdvisory

Содержит дополнительную информацию, о которой пользователь должен быть проинформирован на Route .

Доступ осуществляется путем вызова const {RouteTravelAdvisory} = await google.maps.importLibrary("routes") .
См. Библиотеки в Maps JavaScript API .

fuelConsumptionMicroliters
Тип: number optional
Прогнозируемый расход топлива в микролитрах.

Примечание. Если расход топлива превышает 2^53 микролитра, то это значение равно Number.POSITIVE_INFINITY .
routeRestrictionsPartiallyIgnored
Тип: boolean optional
Route может иметь ограничения, не подходящие для запрошенного режима передвижения или модификаторов маршрута.
speedReadingIntervals
Тип: Array < SpeedReadingInterval > optional
Интервалы считывания скорости с подробным описанием плотности трафика. Применимо в случае TRAFFIC_AWARE и TRAFFIC_AWARE_OPTIMAL ComputeRoutesRequest.routingPreference . Интервалы охватывают всю полилинию Route без перекрытия. Начальная точка указанного интервала совпадает с конечной точкой предыдущего интервала.

Пример:
  polyline: A ---- B ---- C ---- D ---- E ---- F ---- G 
 speedReadingIntervals: [A,C), [C,D), [D,G)
tollInfo
Тип: TollInfo optional
Содержит информацию о платных дорогах по Route . Это поле заполняется только в том случае, если на Route ожидается плата за проезд. Если это поле установлено, но TollInfo.estimatedPrices не заполнено, маршрут содержит сборы за проезд, но расчетная цена неизвестна. Если это поле пустое, то плата за проезд на Route отсутствует.
transitFare
Тип: Money optional
Если присутствует, содержит общую стоимость проезда или билетов по этому Route . Это свойство возвращается только для TRANSIT ComputeRoutesRequest.travelMode и только для маршрутов, где информация о тарифах доступна для всех этапов транзита.
toJSON
toJSON()
Параметры: нет
Возвращаемое значение: Object
Преобразуется в объект.

Константы RoutingPreference

google.maps.routes . RoutingPreference

Факторы, которые следует учитывать при расчете маршрута.

Доступ осуществляется путем вызова const {RoutingPreference} = await google.maps.importLibrary("routes") .
См. Библиотеки в Maps JavaScript API .

TRAFFIC_AWARE Рассчитывает маршруты с учетом условий движения в реальном времени. В отличие от TRAFFIC_AWARE_OPTIMAL , применяются некоторые оптимизации, позволяющие значительно сократить задержку.
TRAFFIC_AWARE_OPTIMAL Рассчитывает маршруты с учетом условий движения в реальном времени, без применения большинства оптимизаций производительности. Использование этого значения приводит к самой высокой задержке.
TRAFFIC_UNAWARE Рассчитывает маршруты без учета условий движения в реальном времени. Подходит, когда условия дорожного движения не имеют значения или неприменимы. Использование этого значения обеспечивает минимальную задержку.

Константы скорости

google.maps.routes . Speed

Классификация скорости полилинии на основе данных о дорожном движении.

Доступ осуществляется путем вызова const {Speed} = await google.maps.importLibrary("routes") .
См. Библиотеки в Maps JavaScript API .

NORMAL Скорость нормальная, пробок нет.
SLOW Обнаружено замедление, средний трафик.
TRAFFIC_JAM Задержки на дорогах.

Интерфейс SpeedPath

google.maps.routes . SpeedPath

Группирует значения LatLngAltitude интервала маршрута с показаниями скорости для этого интервала.

path
Тип: Array < LatLngAltitude >
Путь, пройденный этой скоростной дорогой.
speed optional
Тип: Speed optional
Скорость чтения пути.

Класс SpeedReadingInterval

google.maps.routes . SpeedReadingInterval

Индикатор плотности трафика на непрерывном участке ломаной линии или пути. Учитывая путь с точками P_0, P_1,..., P_N (индекс, начинающийся с нуля), SpeedReadingInterval описывает плотность трафика в интервале.

Доступ осуществляется путем вызова const {SpeedReadingInterval} = await google.maps.importLibrary("routes") .
См. Библиотеки в Maps JavaScript API .

endPolylinePointIndex
Тип: number optional
Конечный индекс этого интервала в полилинии.
speed
Тип: Speed optional
Скорость движения в этом интервале.
startPolylinePointIndex
Тип: number optional
Начальный индекс этого интервала в полилинии.
toJSON
toJSON()
Параметры: нет
Возвращаемое значение: нет
Преобразуется в объект.

Класс «Обзор шагов»

google.maps.routes . StepsOverview

Предоставляет обзорную информацию о списке RouteLeg.steps .

Доступ осуществляется путем вызова const {StepsOverview} = await google.maps.importLibrary("routes") .
См. Библиотеки в Maps JavaScript API .

multiModalSegments
Обобщенная информация о различных мультимодальных сегментах RouteLeg.steps .
toJSON
toJSON()
Параметры: нет
Возвращаемое значение: Object
Преобразуется в объект.

Класс TollInfo

google.maps.routes . TollInfo

Инкапсулирует информацию о платных дорогах в Route или RouteLeg .

Доступ осуществляется путем вызова const {TollInfo} = await google.maps.importLibrary("routes") .
См. Библиотеки в Maps JavaScript API .

estimatedPrices
Тип: Array < Money > optional
Денежная сумма дорожных сборов для соответствующего Route или RouteLeg . В этом списке указаны суммы для каждой валюты, которые, как ожидается, будут взиматься на станциях взимания платы за проезд. Обычно этот список содержит только один элемент для маршрутов, стоимость проезда в которых указана в одной валюте. Для международных поездок этот список может содержать несколько пунктов, отражающих стоимость проезда в разных валютах.
toJSON
toJSON()
Параметры: нет
Возвращаемое значение: Object
Преобразуется в объект.

Класс TransitAgency

google.maps.routes . TransitAgency

Информация о транзитном агентстве.

Доступ осуществляется путем вызова const {TransitAgency} = await google.maps.importLibrary("routes") .
См. Библиотеки в Maps JavaScript API .

name
Тип: string optional
Название этого транзитного агентства.
phoneNumber
Тип: string optional
Номер телефона транзитного агентства в соответствии с региональным стандартом.
url
Тип: URL optional
URL-адрес транзитного агентства.
toJSON
toJSON()
Параметры: нет
Возвращаемое значение: Object
Преобразуется в объект.

Класс TransitDetails

google.maps.routes . TransitDetails

Дополнительная информация о транзитном этапе маршрута.

Доступ осуществляется путем вызова const {TransitDetails} = await google.maps.importLibrary("routes") .
См. Библиотеки в Maps JavaScript API .

arrivalStop
Тип: TransitStop optional
Информация об остановке прибытия на шаг.
arrivalTime
Тип: Date optional
Расчетное время прибытия шага.
departureStop
Тип: TransitStop optional
Информация об остановке отправления на шаг.
departureTime
Тип: Date optional
Ориентировочное время выхода на шаг.
headsign
Тип: string optional
Указывает направление движения по этой линии, указанное на транспортном средстве или на остановке отправления. Направление часто является конечной станцией.
headwayMillis
Тип: number optional
Указывает ожидаемое время в миллисекундах между отправлениями с одной и той же остановки в это время. Например, при значении интервала 600 000 вам придется ждать десять минут, если вы опоздаете на автобус.

Примечание. Если интервал превышает 2^53 миллисекунды, это значение равно Number.POSITIVE_INFINITY .
stopCount
Тип: number
Количество остановок от остановки отправления до остановки прибытия. Это количество включает остановку прибытия, но исключает остановку отправления. Например, если ваш маршрут отправляется от остановки A, проходит через остановки B и C и прибывает на остановку D, stopCount будет равно 3.
transitLine
Тип: TransitLine optional
Информация о транзитной линии, используемой на шаге.
tripShortText
Тип: string optional
Текст, который появляется в расписаниях и вывесках для обозначения пассажирами транзитной поездки. Текст однозначно идентифицирует поездку в течение дня обслуживания. Например, «538» — это tripShortText поезда Amtrak, который отправляется из Сан-Хосе, Калифорния, в 15:10 по будням в Сакраменто, Калифорния.
toJSON
toJSON()
Параметры: нет
Возвращаемое значение: Object
Преобразуется в объект.

Класс ТранзитЛайн

google.maps.routes . TransitLine

Информация о транзитной линии.

Доступ осуществляется путем вызова const {TransitLine} = await google.maps.importLibrary("routes") .
См. Библиотеки в Maps JavaScript API .

agencies
Тип: Array < TransitAgency >
Транзитное агентство (или агентства), которое управляет этой транзитной линией.
color
Тип: string optional
Цвет, обычно используемый в вывесках этой линии. Представлено в шестнадцатеричном формате.
iconURL
Тип: URL optional
URL-адрес значка, связанного с этой строкой.
name
Тип: string optional
Полное название этой транспортной линии, например, «8 Avenue Local».
shortName
Тип: string optional
Краткое название этой транзитной линии. Обычно это имя представляет собой номер строки, например «M7» или «355».
textColor
Тип: string optional
Цвет, обычно используемый в тексте на вывесках этой линии. Представлено в шестнадцатеричном формате.
url
Тип: URL optional
URL-адрес этой транзитной линии, предоставленный транзитным агентством.
vehicle
Тип: TransitVehicle optional
Тип транспортного средства, курсирующего по данной транзитной линии.
toJSON
toJSON()
Параметры: нет
Возвращаемое значение: Object
Преобразуется в объект.

Интерфейс ТранзитПреференце

google.maps.routes . TransitPreference

Предпочтения для маршрутов на основе TRANSIT , которые влияют на возвращаемый маршрут.

allowedTransitModes optional
Тип: Iterable < TransitMode > optional
Набор режимов движения, которые можно использовать при прокладывании TRANSIT маршрута. По умолчанию используются все поддерживаемые способы передвижения.
routingPreference optional
Тип: TransitRoutePreference optional
Предпочтение маршрутизации, которое, если оно указано, влияет на возвращаемый маршрут TRANSIT .

Класс ТранзитСтоп

google.maps.routes . TransitStop

Информация о транзитной остановке.

Доступ осуществляется путем вызова const {TransitStop} = await google.maps.importLibrary("routes") .
См. Библиотеки в Maps JavaScript API .

location
Тип: DirectionalLocation optional
Местоположение остановки, выраженное в координатах широты/долготы и необязательном заголовке.
name
Тип: string optional
Название транзитной остановки.
toJSON
toJSON()
Параметры: нет
Возвращаемое значение: Object
Преобразуется в объект.

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

google.maps.routes . TransitVehicle

Сведения о транспортном средстве, используемом на транзитных маршрутах.

Доступ осуществляется путем вызова const {TransitVehicle} = await google.maps.importLibrary("routes") .
См. Библиотеки в Maps JavaScript API .

iconURL
Тип: URL optional
URL-адрес значка, связанного с этим типом транспортного средства.
localIconURL
Тип: URL optional
URL-адрес значка, связанного с этим типом транспортного средства, основанный на знаках местного транспорта.
name
Тип: string optional
Название этого автомобиля, с большой буквы.
nameLanguage
Тип: string optional
Языковой код BCP-47 текста названия автомобиля, например «en-US» или «sr-Latn».

Для получения дополнительной информации см.: https://www.unicode.org/reports/tr35/#Unicode_locale_identifier .
vehicleType
Тип: string optional
Тип используемого транспортного средства.

См. https://developers.google.com/maps/documentation/routes/reference/rpc/google.maps.routing.v2#transitvehicletype для получения списка возможных значений.
toJSON
toJSON()
Параметры: нет
Возвращаемое значение: Object
Преобразуется в объект.

Константы VehicleEmissionType

google.maps.routes . VehicleEmissionType

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

Доступ осуществляется путем вызова const {VehicleEmissionType} = await google.maps.importLibrary("routes") .
См. Библиотеки в Maps JavaScript API .

DIESEL Автомобиль, работающий на дизельном топливе.
ELECTRIC Транспортное средство с электроприводом.
GASOLINE Автомобиль, работающий на бензине/бензине.
HYBRID Гибридное топливо (например, бензин + электромобиль).

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

google.maps.routes . VehicleInfo

Содержит информацию о транспортном средстве, например тип выбросов транспортного средства.

emissionType optional
Тип: VehicleEmissionType optional
Описывает тип выбросов автомобиля. Применяется только к режиму движения DRIVING .

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

google.maps.routes . Waypoint

Представляет путевую точку на маршруте.

location
Местоположение путевой точки. Строка может быть адресом, плюсовым кодом или именем ресурса места.
sideOfRoad optional
Тип: boolean optional
Указывает, что местоположение этой путевой точки предназначено для того, чтобы транспортное средство остановилось на определенной стороне дороги. Если вы установите это значение, маршрут будет проходить через местоположение, так что транспортное средство сможет остановиться на той стороне дороги, к которой местоположение смещено от центра дороги. Эта опция работает только для DRIVING и TWO_WHEELER ComputeRoutesRequest.travelMode
vehicleStopover optional
Тип: boolean optional
Указывает, что путевая точка предназначена для остановки транспортных средств с намерением либо посадить, либо высадить ее. Если вы установите это значение, расчетный маршрут не будет включать via точки на дорогах, которые непригодны для посадки и высадки. Этот параметр работает только для DRIVING и TWO_WHEELER ComputeRoutesRequest.travelMode и когда Waypoint.location не является string или Place .
via optional
Тип: boolean optional
Отмечает эту путевую точку как веху, а не как точку остановки. Для каждой via точки в ComputeRoutesRequest Route.computeRoutes добавляет запись в массив Route.legs , чтобы предоставить подробную информацию об остановках на этом этапе поездки.

Установите для этого значения значение true , если вы хотите, чтобы маршрут проходил через эту точку без остановок. Через путевые точки не добавляется запись в массив Route.legs , но они маршрутизируют путешествие через путевую точку.

Примечания:
  • Вы можете установить это значение только для промежуточных точек маршрута. Запрос не будет выполнен, если вы установите это поле для путевых точек терминала.
  • Если ComputeRoutesRequest.optimizeWaypointOrder имеет значение true , для этого поля нельзя установить значение true; в противном случае запрос не будет выполнен.

Интерфейс WaypointMarkerDetails

google.maps.routes . WaypointMarkerDetails

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

index
Тип: number
Индекс маркера.
totalMarkers
Тип: number
Общее количество маркеров на маршруте.
leg optional
Тип: RouteLeg optional
Нога, которой принадлежит маркер. Пусто, если у маршрута нет этапов.