[ aws . geo-routes ]
calculate-route-matrix
Описание
Используйте CalculateRouteMatrix для вычисления результатов для всех пар «Исходные точки» — «Пункты назначения». Каждая строка соответствует одному элементу в «Исходные точки». Каждый элемент в строке соответствует маршруту от этого элемента в «Исходные точки» к элементу в позиции «Пункты назначения».
См. также: Документацию AWS API
Синтаксис
calculate-route-matrix
[--allow <value>]
[--avoid <value>]
[--depart-now | --no-depart-now]
[--departure-time <value>]
--destinations <value>
[--exclude <value>]
[--key <value>]
[--optimize-routing-for <value>]
--origins <value>
--routing-boundary <value>
[--traffic <value>]
[--travel-mode <value>]
[--travel-mode-options <value>]
[--cli-input-json | --cli-input-yaml]
[--generate-cli-skeleton <value>]
[--debug]
[--endpoint-url <value>]
[--no-verify-ssl]
[--no-paginate]
[--output <value>]
[--query <value>]
[--profile <value>]
[--region <value>]
[--version <value>]
[--color <value>]
[--no-sign-request]
[--ca-bundle <value>]
[--cli-read-timeout <value>]
[--cli-connect-timeout <value>]
[--cli-binary-format <value>]
[--no-cli-pager]
[--cli-auto-prompt]
[--no-cli-auto-prompt]
Параметры
--allow (структура)
Функции, разрешённые при вычислении маршрута.
Hot -> (boolean)
Разрешить использование полос Hot (High Occupancy Toll) при вычислении маршрута.
Значение по умолчанию: false
Hov -> (boolean)
Разрешить использование полос Hov (High Occupancy vehicle) при вычислении маршрута.
Значение по умолчанию: false
Сокращённый синтаксис:
Hot=boolean,Hov=boolean
Синтаксис JSON:
{
"Hot": true|false,
"Hov": true|false
}
--avoid (структура)
Функции, которые нужно избегать при вычислении маршрута. Избегание происходит на основе наилучшего случая. Если избегание не может быть выполнено в конкретном случае, это считается нарушением и в возвращаемом ответе появляется уведомление о нарушении.
Areas -> (список)
Области, которые следует избегать.
(структура)
Область, которую следует избегать.
Geometry -> (структура)
Геометрия области, которую следует избегать.
BoundingBox -> (список)
Геометрия, определённая как прямоугольник. Первая пара представляет координаты X и Y (долгота и широта) юго-западного угла прямоугольника; вторая пара представляет координаты X и Y (долгота и широта) северо-восточного угла.
(double)
Polygon -> (список)
Геометрия, определённая как многоугольник с единственным линейным кольцом.
(список)
(список)
PolylinePolygon -> (список)
Список изолиний PolylinePolygon. Для каждой изолинии PolylinePolygon он содержит PolylinePolygon первого линейного кольца (внешнего кольца) и от второго элемента до последнего (внутренние кольца). Для получения дополнительной информации о кодировании полилиний см. https://github.com/heremaps/flexiblepolyline/blob/master/README.md .
(строка)
CarShuttleTrains -> (boolean)
ControlledAccessHighways -> (boolean)
DirtRoads -> (boolean)
Ferries -> (boolean)
TollRoads -> (boolean)
TollTransponders -> (boolean)
TruckRoadTypes -> (список)
Идентификаторы типов дорог для грузовиков. BK1 через BK4 применяются только к Швеции. A2,A4,B2,B4,C,D,ET2,ET4 применяются только к Мексике.
Примечание
В настоящее время других поддерживаемых значений нет по состоянию на 26 апреля 2024 г.(строка)
Tunnels -> (boolean)
UTurns -> (boolean)
ZoneCategories -> (список)
Категории зон, которые следует избегать.
(структура)
Категории зон, которые следует избегать.
Category -> (строка)
Синтаксис JSON:
{
"Areas": [
{
"Geometry": {
"BoundingBox": [double, ...],
"Polygon": [
[
[double, ...]
...
]
...
],
"PolylinePolygon": ["string", ...]
}
}
...
],
"CarShuttleTrains": true|false,
"ControlledAccessHighways": true|false,
"DirtRoads": true|false,
"Ferries": true|false,
"TollRoads": true|false,
"TollTransponders": true|false,
"TruckRoadTypes": ["string", ...],
"Tunnels": true|false,
"UTurns": true|false,
"ZoneCategories": [
{
"Category": "CongestionPricing"|"Environmental"|"Vignette"
}
...
]
}
--depart-now | --no-depart-now (boolean)
--departure-time (строка)
Время отправления из исходной точки.
Формат времени:YYYY-MM-DDThh:mm:ss.sssZ | YYYY-MM-DDThh:mm:ss.sss+hh:mm
Примеры:
2020-04-22T17:57:24Z
2020-04-22T17:57:24+02:00
--destinations (список)
Список пунктов назначения для маршрута.
Примечание
Расчёты маршрутов оплачиваются за каждую пару «Исходная точка» — «Пункт назначения». Если вы используете большую матрицу исходных и конечных точек, ваши расходы увеличатся соответственно. См. Страница цен Amazon Location <https://docs.aws.amazon.com/location/latest/developerguide/routes-pricing.html>`__ для получения дополнительной информации.(структура)
Пункт назначения маршрута.
Options -> (структура)
Параметры, относящиеся к пункту назначения.
AvoidActionsForDistance -> (длинное целое число)
Heading -> (двойное)
Matching -> (структура)
Параметры для настройки соответствия заданной позиции дорожной сети.
NameHint -> (строка)
OnRoadThreshold -> (длинное целое число)
Если расстояние до автомагистрали/моста/тоннеля/съезда находится в пределах порога, точка маршрута будет привязана к автомагистрали/мосту/тоннелю/съезду.
meters
Radius -> (длинное целое число)
Рассматривает все дороги в заданном радиусе для сопоставления заданного пункта назначения. Дороги, которые учитываются, определяются заданной стратегией.
Meters
Strategy -> (строка)
SideOfStreet -> (структура)
Параметры для настройки соответствия заданной позиции стороне дороги.
Position -> (список)
Позиция, определённая как [longitude, latitude] .
(double)
UseWith -> (строка)
Стратегия определения, когда должна использоваться позиция стороны дороги. AnyStreet всегда будет использовать предоставленную позицию.
Значение по умолчанию: DividedStreetOnly
Position -> (список)
Позиция, определённая как [longitude, latitude] .
(double)
Синтаксис JSON:
[
{
"Options": {
"AvoidActionsForDistance": long,
"Heading": double,
"Matching": {
"NameHint": "string",
"OnRoadThreshold": long,
"Radius": long,
"Strategy": "MatchAny"|"MatchMostSignificantRoad"
},
"SideOfStreet": {
"Position": [double, ...],
"UseWith": "AnyStreet"|"DividedStreetOnly"
}
},
"Position": [double, ...]
}
...
]
--exclude (структура)
Функции, которые должны быть строго исключены при вычислении маршрута.
Countries -> (список)
Список стран, которые следует избегать, определённых кодами стран из двух или трёх букв.
(строка)
Сокращённый синтаксис:
Countries=string,string
Синтаксис JSON:
{
"Countries": ["string", ...]
}
--key (строка)
--optimize-routing-for (строка)
Указывает критерии оптимизации для вычисления маршрута.
Значение по умолчанию: FastestRoute
Возможные значения:
FastestRouteShortestRoute
--origins (список)
Позиция в долготе и широте для исходной точки.
Примечание
Расчёты маршрутов оплачиваются за каждую пару «Исходная точка» — «Пункт назначения». Использование большого количества исходных точек в запросе может привести к неожиданным расходам. См. Страница цен Amazon Location <https://docs.aws.amazon.com/location/latest/developerguide/routes-pricing.html>`__ для получения дополнительной информации.(структура)
Начальная позиция для маршрута.
Options -> (структура)
Параметры, относящиеся к исходной точке.
AvoidActionsForDistance -> (длинное целое число)
Heading -> (двойное)
Matching -> (структура)
Параметры для настройки соответствия заданной позиции дорожной сети.
NameHint -> (строка)
OnRoadThreshold -> (длинное целое число)
Если расстояние до автомагистрали/моста/тоннеля/съезда находится в пределах порога, точка маршрута будет привязана к автомагистрали/мосту/тоннелю/съезду.
meters
Radius -> (длинное целое число)
Рассматривает все дороги в заданном радиусе для сопоставления заданной позиции. Дороги, которые учитываются, определяются заданной стратегией.
Meters
Strategy -> (строка)
SideOfStreet -> (структура)
Параметры для настройки соответствия заданной позиции стороне дороги.
Position -> (список)
Позиция, определённая как [longitude, latitude] .
(double)
UseWith -> (строка)
Стратегия определения, когда должна использоваться позиция стороны дороги. AnyStreet всегда будет использовать предоставленную позицию.
Значение по умолчанию: DividedStreetOnly
Position -> (список)
Позиция, определённая как [longitude, latitude] .
(double)
Синтаксис JSON:
[
{
"Options": {
"AvoidActionsForDistance": long,
"Heading": double,
"Matching": {
"NameHint": "string",
"OnRoadThreshold": long,
"Radius": long,
"Strategy": "MatchAny"|"MatchMostSignificantRoad"
},
"SideOfStreet": {
"Position": [double, ...],
"UseWith": "AnyStreet"|"DividedStreetOnly"
}
},
"Position": [double, ...]
}
...
]
--routing-boundary (структура)
Границы, в рамках которых будет рассчитываться матрица. Все данные, точки отправления и назначения за пределами границ считаются недействительными.
Примечание
Когда граница маршрутизации запроса была установлена как AutoCircle, граница маршрутизации ответа вернёт Circle, выведенный из настроек AutoCircle.Геометрия -> (структура)
Геометрия области, которую необходимо обойти.
AutoCircle -> (структура)
Предоставляет окружность, которая использовалась при расчёте маршрута.
Отступ -> (длинное целое)
Максимальный радиус -> (длинное целое)
Circle -> (структура)
Геометрия, определённая как окружность. Когда граница маршрутизации запроса была установлена как AutoCircle, граница маршрутизации ответа вернёт Circle, выведенную из настроек AutoCircle.
Центр -> (список)
Центр окружности, определённый в координатах долготы и широты.
Пример: [-123.1174, 49.2847] представляет позицию с долготой -123.1174 и широтой 49.2847.
(двойное число)
Радиус -> (двойное число)
Радиус окружности.
meters
Прямоугольник -> (список)
Геометрия, определённая как прямоугольник. Первая пара представляет координаты X и Y (долготу и широту) юго-западного угла прямоугольника; вторая пара представляет координаты X и Y (долготу и широту) северо-восточного угла.
(двойное число)
Многоугольник -> (список)
Геометрия, определённая как многоугольник с единственным линейным кольцом.
(список)
(список)
Без ограничений -> (булево)
Синтаксис JSON:
{
"Geometry": {
"AutoCircle": {
"Margin": long,
"MaxRadius": long
},
"Circle": {
"Center": [double, ...],
"Radius": double
},
"BoundingBox": [double, ...],
"Polygon": [
[
[double, ...]
...
]
...
]
},
"Unbounded": true|false
}
--traffic (структура)
Параметры, относящиеся к дорожному движению.
Порог события потока -> (длинное целое)
Использование -> (строка)
Определяет, должно ли использоваться дорожное движение или игнорироваться при расчёте маршрута.
Значение по умолчанию: UseTrafficData
Краткая форма синтаксиса:
FlowEventThresholdOverride=long,Usage=string
Синтаксис JSON:
{
"FlowEventThresholdOverride": long,
"Usage": "IgnoreTrafficData"|"UseTrafficData"
}
--travel-mode (строка)
Указывает вид транспорта при расчёте маршрута. Используется для оценки скорости передвижения и совместимости с дорогами.
Значение по умолчанию: Car
Возможные значения:
CarPedestrianScooterTruck
--travel-mode-options (структура)
Параметры режима передвижения для предоставленного режима передвижения.
Автомобиль -> (структура)
Параметры режима передвижения, когда предоставленный режим передвижения — «Автомобиль»
Госномер -> (структура)
Госномер транспортного средства.
Последняя цифра -> (строка)
Максимальная скорость -> (двойное число)
Максимальная скорость
KilometersPerHour
Занятость -> (целое число)
Количество пассажиров в автомобиле.
Значение по умолчанию: 1
Самокат -> (структура)
Параметры режима передвижения, когда предоставленный режим передвижения — Scooter
Примечание
Когда режим передвижения установлен наScooter, то опция избегания ControlledAccessHighways по умолчанию устанавливается в true.Госномер -> (структура)
Госномер транспортного средства.
Последняя цифра -> (строка)
Максимальная скорость -> (двойное число)
Максимальная скорость.
KilometersPerHour
Занятость -> (целое число)
Количество пассажиров в транспортном средстве.
Значение по умолчанию: 1
Грузовик -> (структура)
Параметры режима передвижения, когда предоставленный режим передвижения — «Грузовик»
Количество осей -> (целое число)
Полный вес -> (длинное целое)
Полный вес транспортного средства, включая прицепы и груз на полную вместимость.
Kilograms
Опасные грузы -> (список)
Список опасных грузов, находящихся в транспортном средстве.
(строка)
Высота -> (длинное целое)
Высота транспортного средства.
centimeters
Длина от КПП до задней оси -> (длинное целое)
Длина от кронштейна до задней оси транспортного средства
centimeters
Длина -> (длинное целое)
Длина транспортного средства.
centimeters
Госномер -> (структура)
Госномер транспортного средства.
Последняя цифра -> (строка)
Максимальная скорость -> (двойное число)
Максимальная скорость
KilometersPerHour
Занятость -> (целое число)
Количество пассажиров в транспортном средстве.
Значение по умолчанию: 1
Грузоподъёмность -> (длинное целое)
Грузоподъёмность транспортного средства и прицепов, прицепленных к нему.
kilograms
Прицеп -> (структура)
Параметры прицепов, соответствующие транспортному средству.
Количество прицепов -> (целое число)
Количество прицепов, прицепленных к транспортному средству.
Значение по умолчанию: 0
Тип грузовика -> (строка)
Код ограничения туннелей -> (строка)
Код ограничения проезда через туннели.
Категории туннелей в этом списке указывают на ограничения, которые применяются к определенным туннелям в Великобритании. Они относятся к видам опасных грузов, которые могут перевозиться через них.
-
Категория туннеля B
- Уровень риска : ограниченный риск
- Ограничения : немного ограничений
-
Категория туннеля C
- Уровень риска : средний риск
- Ограничения : некоторые ограничения
-
Категория туннеля D
- Уровень риска : высокий риск
- Ограничения : много ограничений
-
Категория туннеля E
- Уровень риска : очень высокий риск
- Ограничения : ограниченный проезд
Вес на ось -> (длинное целое)
Наибольший вес на ось независимо от типа оси или группы осей. Предназначен для использования в странах, где различия между типами или группами осей не учитываются.
Kilograms
Вес на группу осей -> (структура)
Указывает общий вес для указанной группы осей. Предназначен для использования в странах, имеющих различные правила, основанные на типе группы осей.
Одна ось -> (длинное целое)
Вес для группы осей с одной осью.
Kilograms
Двойная ось -> (длинное целое)
Вес для группы осей с двумя осями.
Kilograms
Тройная ось -> (длинное целое)
Вес для группы осей с тремя осями.
Kilograms
Четверная ось -> (длинное целое)
Вес для группы осей с четырьмя осями.
Kilograms
Пятерная ось -> (длинное целое)
Вес для группы осей с пятью осями.
Kilograms
Ширина -> (длинное целое)
Ширина транспортного средства.
centimeters
Краткая форма синтаксиса:
Car={LicensePlate={LastCharacter=string},MaxSpeed=double,Occupancy=integer},Scooter={LicensePlate={LastCharacter=string},MaxSpeed=double,Occupancy=integer},Truck={AxleCount=integer,GrossWeight=long,HazardousCargos=[string,string],Height=long,KpraLength=long,Length=long,LicensePlate={LastCharacter=string},MaxSpeed=double,Occupancy=integer,PayloadCapacity=long,Trailer={TrailerCount=integer},TruckType=string,TunnelRestrictionCode=string,WeightPerAxle=long,WeightPerAxleGroup={Single=long,Tandem=long,Triple=long,Quad=long,Quint=long},Width=long}
Синтаксис JSON:
{
"Car": {
"LicensePlate": {
"LastCharacter": "string"
},
"MaxSpeed": double,
"Occupancy": integer
},
"Scooter": {
"LicensePlate": {
"LastCharacter": "string"
},
"MaxSpeed": double,
"Occupancy": integer
},
"Truck": {
"AxleCount": integer,
"GrossWeight": long,
"HazardousCargos": ["Combustible"|"Corrosive"|"Explosive"|"Flammable"|"Gas"|"HarmfulToWater"|"Organic"|"Other"|"Poison"|"PoisonousInhalation"|"Radioactive", ...],
"Height": long,
"KpraLength": long,
"Length": long,
"LicensePlate": {
"LastCharacter": "string"
},
"MaxSpeed": double,
"Occupancy": integer,
"PayloadCapacity": long,
"Trailer": {
"TrailerCount": integer
},
"TruckType": "LightTruck"|"StraightTruck"|"Tractor",
"TunnelRestrictionCode": "string",
"WeightPerAxle": long,
"WeightPerAxleGroup": {
"Single": long,
"Tandem": long,
"Triple": long,
"Quad": long,
"Quint": long
},
"Width": long
}
}
--cli-input-json | --cli-input-yaml (строка) Читает аргументы из предоставленной строки JSON. Строка JSON соответствует формату, предоставленному --generate-cli-skeleton. Если на командной строке предоставлены другие аргументы, эти значения переопределят значения, предоставленные JSON. Невозможно передать произвольные двоичные значения с помощью значения, предоставленного JSON, так как строка будет воспринята буквально. Это может не быть указано вместе с --cli-input-yaml.
--generate-cli-skeleton (строка) Выводит JSON-скелет в стандартный вывод без отправки запроса к API. Если предоставлено значение без значения или со значением input, выводит пример входного JSON, который может быть использован как аргумент для --cli-input-json. Аналогично, если предоставлено yaml-input, будет напечатан пример входного YAML, который можно использовать с --cli-input-yaml. Если предоставлено значение output, проверяет входные данные команд и возвращает пример выходного JSON для этой команды. Сгенерированный JSON-скелет не стабилен между версиями AWS CLI, и нет гарантий обратной совместимости в сгенерированном JSON-скелете.
Общие параметры
--debug (boolean)
Включить отладочную запись в журнал.
--endpoint-url (string)
Переопределить стандартный URL команды заданным URL.
--no-verify-ssl (boolean)
По умолчанию AWS CLI использует SSL при взаимодействии с AWS-сервисами. Для каждого SSL-соединения AWS CLI будет проверять SSL-сертификаты. Этот параметр переопределяет стандартное поведение проверки SSL-сертификатов.
--no-paginate (boolean)
Отключить автоматическую постраничную навигацию. Если автоматическая постраничная навигация отключена, AWS CLI выполнит только один вызов для первой страницы результатов.
--output (string)
Стиль форматирования вывода команды.
- json
- text
- table
- yaml
- yaml-stream
--query (string)
Запрос JMESPath для фильтрации данных ответа.
--profile (string)
Использовать определенный профиль из файла учетных данных.
--region (string)
Регион для использования. Переопределяет настройки конфигурации/среды.
--version (string)
Отобразить версию этого инструмента.
--color (string)
Включить/выключить цветной вывод.
- on
- off
- auto
--no-sign-request (boolean)
Не подписывать запросы. Учетные данные не будут загружены, если этот аргумент указан.
--ca-bundle (string)
Файл с пакетом сертификатов CA для проверки SSL-сертификатов. Переопределяет настройки конфигурации/среды.
--cli-read-timeout (int)
Максимальное время чтения сокета в секундах. Если значение равно 0, чтение сокета будет блокирующим и не будет иметь таймаута. Значение по умолчанию — 60 секунд.
--cli-connect-timeout (int)
Максимальное время подключения сокета в секундах. Если значение равно 0, подключение сокета будет блокирующим и не будет иметь таймаута. Значение по умолчанию — 60 секунд.
--cli-binary-format (string)
Стиль форматирования, используемый для двоичных блоков. Формат по умолчанию — base64. Формат base64 ожидает, что двоичные блоки будут предоставлены как строка, закодированная в base64. Формат raw-in-base64-out сохраняет совместимость с поведением AWS CLI V1, а двоичные значения должны передаваться буквально. При предоставлении содержимого из файла, сопоставляющегося с двоичным блоком fileb://, всегда будет обрабатываться как двоичный и будет использоваться содержимое файла непосредственно независимо от настройки cli-binary-format. При использовании file:// содержимое файла должно быть должным образом отформатировано для настроенного cli-binary-format.
- base64
- raw-in-base64-out
--no-cli-pager (boolean)
Отключить вывод страниц для CLI.
--cli-auto-prompt (boolean)
Автоматически запросить параметры ввода для CLI.
--no-cli-auto-prompt (boolean)
Отключить автоматическое запросы параметров ввода для CLI.
Вывод
ErrorCount -> (целое число)
PricingBucket -> (строка)
RouteMatrix -> (список)
Рассчитанная матрица маршрутов, содержащая результаты для всех пар позиций «Начало» и «Конец». Каждая строка соответствует одному элементу в «Начало». Каждый элемент в строке соответствует маршруту от этого элемента в «Начало» к элементу в «Конец».
(список)
(структура)
Рассчитанная матрица маршрутов, содержащая результаты для всех пар позиций «Начало» и «Конец». Каждая строка соответствует одному элементу в «Начало». Каждый элемент в строке соответствует маршруту от этого элемента в «Начало» к элементу в «Конец».
Distance -> (целое число большого размера)
Duration -> (целое число большого размера)
Ожидаемая продолжительность перемещения по маршруту.
seconds
Error -> (строка)
RoutingBoundary -> (структура)
Граница, в рамках которой должна быть рассчитана матрица. Все данные, точки начала и назначения за пределами границы, считаются недействительными.
Примечание
Когда граница маршрутизации запроса устанавливается как AutoCircle, граница маршрутизации ответа вернет круг, полученный из настроек AutoCircle.Geometry -> (структура)
Геометрия области, которую следует избегать.
AutoCircle -> (структура)
Предоставляет круг, который использовался при расчете маршрута.
Margin -> (целое число большого размера)
MaxRadius -> (целое число большого размера)
Circle -> (структура)
Геометрия, определенная как круг. Когда граница маршрутизации запроса была установлена как AutoCircle, граница маршрутизации ответа вернёт Circle, полученную из настроек AutoCircle.
Center -> (список)
Центр круга, определенный в координатах долготы и широты.
Например: [-123.1174, 49.2847] представляет позицию с долготой -123.1174 и широтой 49.2847.
(двойное)
Radius -> (двойное)
Радиус круга.
meters
BoundingBox -> (список)
Геометрия, определенная как прямоугольник. Первая пара представляет координаты X и Y (долгота и широта) юго-западного угла прямоугольника; вторая пара представляет координаты X и Y (долгота и широта) северо-восточного угла.
(двойное)
Polygon -> (список)
Геометрия, определенная как многоугольник с одной линией.
(список)
(список)
Unbounded -> (boolean)
© Copyright 2025, Amazon Web Services. Created using Sphinx.