Distance Matrix

Класс DistanceMatrixService

google.maps . 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 Интерфейс 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 , дает указание службе Distance Matrix избегать шоссе, где это возможно. Необязательный.
avoidTolls optional
Тип: boolean optional
Если true , дает указание службе Distance Matrix избегать платных дорог, где это возможно. Необязательный.
drivingOptions optional
Тип: DrivingOptions optional
Настройки, которые применяются только к запросам, в которых travelMode имеет DRIVING . Этот объект не будет иметь никакого эффекта для других режимов движения.
language optional
Тип: string optional
Идентификатор языка, на котором должны возвращаться результаты, если это возможно. См. список поддерживаемых языков .
region optional
Тип: string optional
Код региона, используемый в качестве смещения для запросов геокодирования. Код региона принимает двухсимвольное значение ccTLD («домен верхнего уровня») . Большинство кодов ccTLD идентичны кодам ISO 3166-1, за некоторыми заметными исключениями. Например, нДВУ Соединенного Королевства — «uk» ( .co.uk ), а его код ISO 3166-1 — «gb» (технически для организации «Соединенное Королевство Великобритании и Северной Ирландии»).
transitOptions optional
Тип: TransitOptions optional
Настройки, которые применяются только к запросам, в которых travelMode имеет значение TRANSIT. Этот объект не будет иметь никакого эффекта для других режимов движения.
unitSystem optional
Тип: UnitSystem optional
Предпочтительная система единиц для отображения расстояния. Необязательный; по умолчанию используется метрика.

Интерфейс DistanceMatrixResponse

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

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

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

Интерфейс DistanceMatrixResponseRow

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

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

elements
Элементы строки, соответствующие адресам назначения.

Интерфейс DistanceMatrixResponseElement

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

Один элемент ответа на запрос DistanceMatrixService , который содержит продолжительность и расстояние от одного источника до одного пункта назначения.

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

Константы DistanceMatrixStatus

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

Статус верхнего уровня запроса, обычно возвращаемый DistanceMatrixService после завершения запроса матрицы расстояний. Укажите их по значению или используя имя константы. Например, '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 Запрос Distance Matrix не удалось обработать из-за ошибки сервера. Запрос может быть успешным, если вы повторите попытку.

Константы DistanceMatrixElementStatus

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

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

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

NOT_FOUND Происхождение и/или назначение этого соединения не удалось геокодировать.
OK Ответ содержит действительный результат.
ZERO_RESULTS Не удалось найти маршрут между пунктом отправления и пунктом назначения.