Route Matrix (beta)

Класс RouteMatrix

google.maps.routes . RouteMatrix

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

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

computeRouteMatrix
computeRouteMatrix(request)
Параметры:
Возвращаемое значение: Promise <{matrix: RouteMatrix }>
Принимает список пунктов отправления и назначения и возвращает матрицу, содержащую информацию о маршруте для каждой комбинации пунктов отправления и назначения.

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

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

Использование fields: ['*'] не рекомендуется по следующим причинам:
  • Выбор только необходимых вам полей помогает нашему серверу экономить вычислительные циклы, что позволяет нам возвращать вам результат с меньшей задержкой.
  • Выбор только тех полей, которые вам необходимы в производственном задании, обеспечивает стабильную задержку. В будущем мы можем добавить дополнительные поля ответа, и для их обработки может потребоваться больше времени. Если вы выберете все поля или все поля на верхнем уровне, производительность может снизиться, поскольку любое новое поле, которое мы добавим, будет автоматически включено в ответ.
  • Выбор только необходимых полей приводит к уменьшению размера ответа и, следовательно, к более быстрой загрузке по сети.
rows
Тип: Array < RouteMatrixRow >
Строки матрицы. Каждая строка соответствует исходной точке и содержит массив RouteMatrixItem , каждый из которых представляет маршрут к пункту назначения.
toJSON
toJSON()
Параметры: нет
Возвращаемое значение: Object
Преобразуется в объект.

Класс RouteMatrixRow

google.maps.routes . RouteMatrixRow

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

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

items
Тип: Array < RouteMatrixItem >
Информация о маршруте для каждого пункта назначения.
toJSON
toJSON()
Параметры: нет
Возвращаемое значение: Object
Преобразуется в объект.

Класс RouteMatrixItem

google.maps.routes . RouteMatrixItem

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

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