Distance Matrix

Оптимизируйте свои подборки Сохраняйте и классифицируйте контент в соответствии со своими настройками.

Класс DistanceMatrixService

google.maps . DistanceMatrixService Класс google.maps . DistanceMatrixService

Сервис для расчета расстояний между несколькими пунктами отправления и назначения.

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 , служба матрицы расстояний предписывает по возможности избегать паромов. По желанию.
avoidHighways optional
Тип: boolean optional
Если задано значение true , служба матрицы расстояний предписывает по возможности избегать автомагистралей. По желанию.
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, за некоторыми заметными исключениями. Например, ccTLD Соединенного Королевства — «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 s, по одному для каждого соответствующего адреса назначения.

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

Интерфейс DistanceMatrixResponseElement

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

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

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

Константы DistanceMatrixStatus

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

Статус верхнего уровня о запросе в целом, возвращаемый DistanceMatrixService после завершения запроса матрицы расстояний. Укажите их по значению или по имени константы. Например, 'OK' или google.maps.DistanceMatrixStatus.OK .

INVALID_REQUEST Предоставленный запрос недействителен.
MAX_DIMENSIONS_EXCEEDED Запрос содержит более 25 источников или более 25 пунктов назначения.
MAX_ELEMENTS_EXCEEDED Продукт пунктов отправления и назначения превышает ограничение на запрос.
OK Ответ содержит действительный результат.
OVER_QUERY_LIMIT Слишком много элементов было запрошено в течение допустимого периода времени. Запрос должен завершиться успешно, если вы повторите попытку через некоторое время.
REQUEST_DENIED Служба отказала вашей веб-странице в использовании службы матрицы расстояний.
UNKNOWN_ERROR Запрос матрицы расстояний не может быть обработан из-за ошибки сервера. Запрос может быть успешным, если вы попробуете еще раз.

Константы DistanceMatrixElementStatus

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

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

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