Distance Matrix

Класс DistanceMatrixService

google.maps.DistanceMatrixService класс

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

Чтобы получить доступ, позвоните по номеру const {DistanceMatrixService} = await google.maps.importLibrary("routes").
Подробнее о библиотеках Maps JavaScript API…
DistanceMatrixService
DistanceMatrixService()
Параметры: нет.
Создает новый экземпляр DistanceMatrixService, который отправляет запросы матрицы расстояний на серверы Google.
getDistanceMatrix
getDistanceMatrix(request[, callback])
Параметры: 
Возвращаемое значение:  Promise<DistanceMatrixResponse>
Создает запрос матрицы расстояний.

Интерфейс DistanceMatrixRequest

google.maps.DistanceMatrixRequest интерфейс

Запрос матрицы расстояний, отправленный DistanceMatrixService, содержит массивы пунктов отправления и назначения, а также различные варианты расчета показателей.
destinations
Тип:  Array<string|LatLng|LatLngLiteral|Place>
Массив, содержащий строки с адресами, объекты LatLng или Place, на основе которых рассчитываются расстояние и время. Обязательно.
origins
Тип:  Array<string|LatLng|LatLngLiteral|Place>
Массив, содержащий строки с адресами, объекты LatLng или Place, на основе которых рассчитываются расстояние и время. Обязательно.
travelMode
Тип:  TravelMode
Запрошенный тип маршрута. Обязательно.
avoidFerries optional
Тип:  boolean optional
Если задано значение true, сервис Distance Matrix по возможности избегает паромов. Необязательное поле.
avoidHighways optional
Тип:  boolean optional
Если задано значение true, сервис "Матрица расстояний" по возможности избегает шоссе. Необязательное поле.
avoidTolls optional
Тип:  boolean optional
Если задано значение true, сервис "Матрица расстояний" по возможности избегает платных дорог. Необязательное поле.
drivingOptions optional
Тип:  DrivingOptions optional
Настройки, которые применяются только к запросам, где travelMode – это DRIVING. Этот объект не будет действовать для других способов передвижения.
language optional
Тип:  string 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
Предпочтительная система единиц измерения для показа расстояния. Необязательно. По умолчанию используется метрическая система.

Интерфейс DistanceMatrixResponse

google.maps.DistanceMatrixResponse интерфейс

Ответ на запрос DistanceMatrixService, состоящий из отформатированных адресов отправления и прибытия, а также последовательности элементов DistanceMatrixResponseRow, по одному для каждого соответствующего адреса отправления.
destinationAddresses
Тип:  Array<string>
Форматированные адреса пунктов назначения.
originAddresses
Тип:  Array<string>
Форматированные адреса пунктов отправления.
rows
Строки матрицы, соответствующие адресам пунктов отправления.

Интерфейс DistanceMatrixResponseRow

google.maps.DistanceMatrixResponseRow интерфейс

Строка ответа на запрос DistanceMatrixService, состоящая из последовательности элементов DistanceMatrixResponseElement, по одному для каждого соответствующего адреса назначения.
elements
Элементы строки, соответствующие адресам пунктов назначения.

Интерфейс DistanceMatrixResponseElement

google.maps.DistanceMatrixResponseElement интерфейс

Один элемент ответа на запрос DistanceMatrixService, который содержит продолжительность и расстояние от одной точки отправления до одной точки назначения.
distance
Тип:  Distance
Расстояние между данным пунктом отправления и пунктом назначения. Это свойство может быть не задано, если расстояние неизвестно.
duration
Тип:  Duration
Время пути между данным пунктом отправления и пунктом назначения. Это свойство может быть не задано, если длительность неизвестна.
duration_in_traffic
Тип:  Duration
Продолжительность поездки между пунктами отправления и назначения с учетом загруженности дорог, указанной в свойстве trafficModel. Это свойство может быть равно undefined, если продолжительность неизвестна. Доступно только клиентам с премиум-планом, если в запросе указан параметр drivingOptions.
fare
Тип:  TransitFare
Общая стоимость проезда между пунктами отправления и назначения. Применимо только к запросам на общественный транспорт.
status
Статус конкретной пары пунктов отправления и назначения.

Константы DistanceMatrixStatus

google.maps.DistanceMatrixStatus константы

Общий статус запроса, возвращаемый полем DistanceMatrixService после выполнения запроса к службе Distance Matrix. Укажите их по значению или по названию константы. Примеры: 'OK' или google.maps.DistanceMatrixStatus.OK.

Чтобы получить доступ, позвоните по номеру const {DistanceMatrixStatus} = await google.maps.importLibrary("routes").
Подробнее о библиотеках Maps JavaScript API…
INVALID_REQUEST Недопустимый запрос.
MAX_DIMENSIONS_EXCEEDED Запрос содержит более 25 пунктов отправления или более 25 пунктов назначения.
MAX_ELEMENTS_EXCEEDED Количество пунктов отправления и назначения превышает ограничение, установленное для одного запроса.
OK Ответ содержит действительный результат.
OVER_QUERY_LIMIT Запрошено слишком много элементов в допустимый период времени. Если повторить попытку некоторое время спустя, запрос может оказаться успешным.
REQUEST_DENIED Служба отклонила запрос на использование службы Distance Matrix вашей веб-страницей.
UNKNOWN_ERROR Запрос матрицы расстояний не обработан из-за ошибки сервера. Если повторить попытку, запрос может оказаться успешным.

Константы DistanceMatrixElementStatus

google.maps.DistanceMatrixElementStatus константы

Статус на уровне элемента для определенной пары "пункт отправления – пункт назначения", возвращаемый DistanceMatrixService после выполнения запроса к матрице расстояний. Эти значения указываются в виде строк, например 'OK'.

Чтобы получить доступ, позвоните по номеру const {DistanceMatrixElementStatus} = await google.maps.importLibrary("routes").
Подробнее о библиотеках Maps JavaScript API…
NOT_FOUND Не удалось выполнить геокодирование пункта отправления и/или назначения в этой паре.
OK Ответ содержит действительный результат.
ZERO_RESULTS Между исходной точкой и пунктом назначения не найдено ни одного маршрута.