Класс 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 , служба матрицы расстояний предписывает по возможности избегать паромов. Необязательный. |
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 | Тип: Array < DistanceMatrixResponseRow > Строки матрицы, соответствующие исходным адресам. |
Интерфейс DistanceMatrixResponseRow
google.maps . DistanceMatrixResponseRow Интерфейс google.maps . DistanceMatrixResponseRow
Строка ответа на запрос DistanceMatrixService , состоящая из последовательности элементов DistanceMatrixResponseElement , по одному для каждого соответствующего адреса назначения.
Характеристики | |
|---|---|
elements | Тип: Array < DistanceMatrixResponseElement > Элементы строки, соответствующие адресам назначения. |
Интерфейс 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 .
Получите доступ, вызвав 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 | Служба отказала вашей веб-странице в использовании службы матрицы расстояний. |
UNKNOWN_ERROR | Запрос матрицы расстояний не может быть обработан из-за ошибки сервера. Запрос может быть успешным, если вы попробуете еще раз. |
Константы DistanceMatrixElementStatus
google.maps . DistanceMatrixElementStatus Константы google.maps . DistanceMatrixElementStatus
Статус на уровне элемента для конкретной пары отправной точки и пункта назначения, возвращаемый DistanceMatrixService после завершения запроса матрицы расстояний. Эти значения указываются в виде строк, например, 'OK' .
Получите доступ, вызвав const {DistanceMatrixElementStatus} = await google.maps.importLibrary("routes") . См. Библиотеки в Maps JavaScript API .
Константы | |
|---|---|
NOT_FOUND | Исходная и/или конечная точка этой пары не может быть геокодирована. |
OK | Ответ содержит действительный результат. |
ZERO_RESULTS | Не удалось найти маршрут между пунктом отправления и пунктом назначения. |
Класс 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 , служба матрицы расстояний предписывает по возможности избегать паромов. Необязательный. |
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 | Тип: Array < DistanceMatrixResponseRow > Строки матрицы, соответствующие исходным адресам. |
Интерфейс DistanceMatrixResponseRow
google.maps . DistanceMatrixResponseRow Интерфейс google.maps . DistanceMatrixResponseRow
Строка ответа на запрос DistanceMatrixService , состоящая из последовательности элементов DistanceMatrixResponseElement , по одному для каждого соответствующего адреса назначения.
Характеристики | |
|---|---|
elements | Тип: Array < DistanceMatrixResponseElement > Элементы строки, соответствующие адресам назначения. |
Интерфейс 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 .
Получите доступ, вызвав 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 | Служба отказала вашей веб-странице в использовании службы матрицы расстояний. |
UNKNOWN_ERROR | Запрос матрицы расстояний не может быть обработан из-за ошибки сервера. Запрос может быть успешным, если вы попробуете еще раз. |
Константы DistanceMatrixElementStatus
google.maps . DistanceMatrixElementStatus Константы google.maps . DistanceMatrixElementStatus
Статус на уровне элемента для конкретной пары отправной точки и пункта назначения, возвращаемый DistanceMatrixService после завершения запроса матрицы расстояний. Эти значения указываются в виде строк, например, 'OK' .
Получите доступ, вызвав const {DistanceMatrixElementStatus} = await google.maps.importLibrary("routes") . См. Библиотеки в Maps JavaScript API .
Константы | |
|---|---|
NOT_FOUND | Исходная и/или конечная точка этой пары не может быть геокодирована. |
OK | Ответ содержит действительный результат. |
ZERO_RESULTS | Не удалось найти маршрут между пунктом отправления и пунктом назначения. |