Route Matrix

Класс RouteMatrix

class google.maps.routes.RouteMatrix
library "routes"

Матрица маршрутов, рассчитанных для набора пар пунктов отправления и назначения с помощью RouteMatrix.computeRouteMatrix.

const {RouteMatrix} = await google.maps.importLibrary("routes");
computeRouteMatrix
computeRouteMatrix(request)
Параметры:
Возвращаемое значение: Promise<{matrix:RouteMatrix}>
Принимает список пунктов отправления и назначения и возвращает матрицу с информацией о маршруте для каждой комбинации пункта отправления и назначения.

Примечание. При использовании этого метода необходимо указать маску поля ответа в запросе, задав свойство ComputeRouteMatrixRequest.fields. Значение – это список путей к полям.

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

Использовать маску поля ответа с подстановочным знаком fields: ['*'] не рекомендуется по следующим причинам:
  • Выбирая только нужные поля, вы помогаете нашему серверу экономить вычислительные циклы, что позволяет нам возвращать вам результат с меньшей задержкой.
  • Чтобы обеспечить стабильную задержку, выбирайте только те поля, которые нужны для рабочей задачи. В будущем мы можем добавить дополнительные поля ответов, для которых может потребоваться дополнительное время вычислений. Если вы выберете все поля или все поля на верхнем уровне, то производительность может снизиться, поскольку любое новое поле, которое мы добавим, будет автоматически включено в ответ.
  • Выбирая только нужные поля, вы уменьшаете размер ответа и ускоряете его загрузку по сети.
rows
readonly
Строки матрицы. Каждая строка соответствует пункту отправления и содержит массив элементов RouteMatrixItem, каждый из которых представляет маршрут до пункта назначения.
Унаследованные: toJSON

Класс RouteMatrixRow

class google.maps.routes.RouteMatrixRow
library "routes"

Соответствует источнику, переданному в RouteMatrix.computeRouteMatrix. Содержит список объектов RouteMatrixItem, каждый из которых представляет маршрут до пункта назначения.

const {RouteMatrixRow} = await google.maps.importLibrary("routes");
items
readonly
Информация о маршруте для каждого пункта назначения.
Унаследованные: toJSON

Класс RouteMatrixItem

class google.maps.routes.RouteMatrixItem
library "routes"

Содержит информацию о маршруте, рассчитанном для пары точек отправления и назначения, переданной в RouteMatrix.computeRouteMatrix.

const {RouteMatrixItem} = await google.maps.importLibrary("routes");
condition
readonly
Тип: RouteMatrixItemCondition optional
Указывает, был ли найден маршрут.
distanceMeters
readonly
Тип: number optional
Расстояние маршрута в метрах.
durationMillis
readonly
Тип: number optional
Время, необходимое для прохождения маршрута, в миллисекундах. Если для ComputeRouteMatrixRequest.routingPreference задано значение TRAFFIC_UNAWARE, то это значение совпадает с RouteMatrixItem.staticDurationMillis. Если для параметра ComputeRouteMatrixRequest.routingPreference задано значение TRAFFIC_AWARE или TRAFFIC_AWARE_OPTIMAL, то это значение рассчитывается с учетом загруженности дорог.

Примечание. Если продолжительность превышает 2^53 миллисекунд, то это значение равно Number.POSITIVE_INFINITY.
error
readonly
Тип: RouteMatrixItemError optional
Ошибка, возникшая при расчете маршрута.
fallbackInfo
readonly
Тип: FallbackInfo optional
В некоторых случаях, когда сервер не может рассчитать маршрут с заданными настройками для этой конкретной пары отправления и назначения, он может вернуться к использованию другого режима расчета. Если используется резервный вариант, это поле содержит подробную информацию о резервном ответе. В противном случае это поле не задано.
localizedValues
readonly
Текстовые представления свойств RouteMatrixItem.
staticDurationMillis
readonly
Тип: number optional
Продолжительность поездки по маршруту без учета загруженности дорог.

Примечание. Если продолжительность превышает 2^53 миллисекунд, то это значение равно Number.POSITIVE_INFINITY.
travelAdvisory
readonly
Тип: RouteTravelAdvisory optional
Дополнительная информация о маршруте.

Интерфейс ComputeRouteMatrixRequest

интерфейс google.maps.routes.ComputeRouteMatrixRequest

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

destinations
Массив пунктов назначения, определяющий столбцы матрицы ответа. Значение, переданное в виде строки, может быть адресом, плюс-кодом или названием ресурса места. Значения высоты не учитываются.
fields
Тип: Iterable<string>
Набор полей, которые нужно получить. Укажите ["*"] для всех полей.
origins
Массив пунктов отправления, определяющий строки матрицы ответа. Значение, переданное в виде строки, может быть адресом, плюс-кодом или названием ресурса места. Значения высоты не учитываются.

На количество уникальных значений пунктов отправления и назначения накладывается несколько ограничений:
  • Общее количество пунктов отправления и назначения, указанных в виде string или Place, не должно превышать 50.
  • Произведение количества пунктов отправления и количества пунктов назначения не должно превышать 625.
  • Если для параметра ComputeRouteMatrixRequest.routingPreference задано значение TRAFFIC_AWARE_OPTIMAL, результат умножения числа пунктов отправления и назначения не должен превышать 100.
  • Если для параметра ComputeRouteMatrixRequest.travelMode задано значение TRANSIT, результат умножения числа пунктов отправления и назначения не должен превышать 100.
arrivalTime
необязательно
Тип: Date optional
Время прибытия.

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

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

Примечание. В результате этих дополнительных вычислений в ответе могут появиться дополнительные поля. Чтобы эти дополнительные поля возвращались в ответе, их также необходимо указать в ComputeRouteMatrixRequest.fields.
internalUsageAttributionIds
необязательно
Тип: Iterable<string> optional
Идентификаторы, используемые для соотнесения вызовов с определенными пакетами или библиотеками OSS.
language
необязательно
Тип: string optional
Код языка по стандарту BCP-47, например "ru-RU" или "sr-Latn". Подробнее об идентификаторах региональных настроек Unicode… Список поддерживаемых языков приведен в разделе Поддержка языков. Если это значение не указано, язык определяется на основе настроек локализации Google Maps JavaScript API. В противном случае язык определяется по местоположению первого источника.
region
необязательно
Тип: string optional
Код региона, указываемый как двухсимвольное значение национального домена верхнего уровня (ccTLD). Подробнее о национальных доменах верхнего уровня… Если вы не укажете это значение, регион будет определяться на основе настроек локализации Google Maps JavaScript API. В противном случае регион определяется по местоположению первого источника.
routingPreference
необязательно
Тип: RoutingPreference optional
Указывает, как рассчитать матрицу маршрутов. Сервер пытается использовать выбранные настройки маршрутизации для расчета матрицы маршрутов. Если предпочтительный маршрут приводит к ошибке или слишком большой задержке, возвращается ошибка. Этот параметр можно указать, только если для ComputeRouteMatrixRequest.travelMode задано значение DRIVING или TWO_WHEELER. В противном случае запрос не будет выполнен.
trafficModel
необязательно
Тип: TrafficModel optional
Определяет выбор модели расчета в зависимости от загруженности дорог. Этот параметр влияет на возвращаемое значение поля RouteMatrixItem.durationMillis (прогнозируемое время в пути с учетом средних статистических показателей). ComputeRouteMatrixRequest.trafficModel доступен только для запросов, в которых для ComputeRouteMatrixRequest.routingPreference задано значение TRAFFIC_AWARE_OPTIMAL, а для ComputeRouteMatrixRequest.travelMode – DRIVING. Значение по умолчанию – BEST_GUESS.
transitPreference
необязательно
Тип: TransitPreference optional
Задает предпочтения, которые влияют на маршрут, возвращаемый для маршрутов TRANSIT.

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

Константы ComputeRouteMatrixExtraComputation

константы google.maps.routes.ComputeRouteMatrixExtraComputation
библиотека "routes"

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

Эти константы также можно использовать в качестве строк. В TypeScript строковые литералы определяются типом ComputeRouteMatrixExtraComputationString.

const {ComputeRouteMatrixExtraComputation} = await google.maps.importLibrary("routes");
TOLLS Информация о плате за проезд для элементов матрицы. Дополнительную информацию можно найти в документации по веб-сервису.

Константы RouteMatrixItemCondition

константы google.maps.routes.RouteMatrixItemCondition
библиотека "routes"

Состояние возвращаемого маршрута. Дополнительную информацию можно найти в документации по веб-сервису.

Эти константы также можно использовать в качестве строк. В TypeScript строковые литералы определяются типом RouteMatrixItemConditionString.

const {RouteMatrixItemCondition} = await google.maps.importLibrary("routes");
ROUTE_EXISTS Маршрут найден, и соответствующая информация заполнена для элемента. Дополнительную информацию можно найти в документации по веб-сервису.
ROUTE_NOT_FOUND Маршрут не найден. Дополнительную информацию можно найти в документации по веб-сервису.

Класс RouteMatrixItemError

class google.maps.routes.RouteMatrixItemError extends Error
library "routes"

Ошибка, которая произошла во время RouteMatrix.computeRouteMatrix для определенной пары пунктов отправления и назначения.

const {RouteMatrixItemError} = await google.maps.importLibrary("routes");
Унаследованные: toJSON

Класс RouteMatrixItemLocalizedValues

class google.maps.routes.RouteMatrixItemLocalizedValues
library "routes"

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

const {RouteMatrixItemLocalizedValues} = await google.maps.importLibrary("routes");
distance
readonly
Тип: string optional
Расстояние маршрута в текстовом формате.
distanceLanguage
readonly
Тип: string optional
Код языка по стандарту BCP-47, например "ru-RU" или "sr-Latn".

Подробную информацию можно найти на странице http://www.unicode.org/reports/tr35/#Unicode_locale_identifier.
duration
readonly
Тип: string optional
Продолжительность в текстовом формате, локализованная для региона запроса. Учитывает загруженность дорог.

Примечание. Если вы не запрашивали информацию о трафике, это значение будет совпадать со значением RouteMatrixItemLocalizedValues.staticDuration.
durationLanguage
readonly
Тип: string optional
Код языка по стандарту BCP-47, например "ru-RU" или "sr-Latn".

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

Подробную информацию можно найти на странице http://www.unicode.org/reports/tr35/#Unicode_locale_identifier.
Унаследованные: toJSON

Интерфейс RouteMatrixOrigin

интерфейс google.maps.routes.RouteMatrixOrigin

Один источник для ComputeRouteMatrixRequest.

waypoint
Местоположение источника. Значение, переданное в виде строки, может быть адресом или плюс-кодом. Значения высоты не учитываются.
routeModifiers
необязательно
Тип: RouteModifiers optional
Модификаторы для каждого маршрута, который использует это место в качестве начальной точки.