calculate-route
Описание
DeparturePosition и DestinationPosition. Требует предварительного создания ресурса вычисления маршрута.По умолчанию, если время отправления не указано, вычисление маршрута использует оптимальное время суток с учетом текущих дорожных условий.
Дополнительные параметры включают:
- Указание времени отправления с помощью
DepartureTimeилиDepartNow. Это вычисляет маршрут на основе прогнозируемых данных о трафике в заданное время.
Примечание
Нельзя указывать одновременноDepartureTime и DepartNow в одном запросе. Указание обоих параметров приводит к ошибке валидации.- Указание режима поездки с помощью TravelMode задает транспортный режим, используемый для расчета маршрута. Это также позволяет указать дополнительные предпочтения маршрута в
CarModeOptions, если путешествуете наCar, или вTruckModeOptions, если путешествуете наTruck.
Примечание
Если вы укажетеwalking для режима поездки, а ваш поставщик данных — Esri, начальная и конечная точки должны находиться в пределах 40 км друг от друга.См. также: AWS API Documentation
Синтаксис
calculate-route
--calculator-name <value>
--departure-position <value>
--destination-position <value>
[--waypoint-positions <value>]
[--travel-mode <value>]
[--departure-time <value>]
[--depart-now | --no-depart-now]
[--distance-unit <value>]
[--include-leg-geometry | --no-include-leg-geometry]
[--car-mode-options <value>]
[--truck-mode-options <value>]
[--arrival-time <value>]
[--optimize-for <value>]
[--key <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]
Параметры
--calculator-name (строка)
--departure-position (список)
Начальная точка маршрута. Определена в формате World Geodetic System (WGS 84): [longitude, latitude] .
- Например,
[-123.115, 49.285]
Примечание
Если вы укажете точку отправления, которая не расположена на дороге, Amazon Location переместит позицию на ближайшую дорогу. Если Esri является поставщиком вашего калькулятора маршрутов, указание маршрута длиной более 400 км возвращает ошибку400 RoutesValidationException.Допустимые значения: [-180 to 180,-90 to 90]
(двойное значение)
Синтаксис:
double double ...
--destination-position (список)
Конечная точка маршрута. Определена в формате World Geodetic System (WGS 84): [longitude, latitude] .
- Например,
[-122.339, 47.615]
Примечание
Если вы укажете пункт назначения, который не расположен на дороге, Amazon Location переместит позицию на ближайшую дорогу.Допустимые значения: [-180 to 180,-90 to 90]
(двойное значение)
Синтаксис:
double double ...
--waypoint-positions (список)
Указывает упорядоченный список до 23 промежуточных позиций, которые необходимо включить вдоль маршрута между начальной и конечной точкой.
- Например, от
DeparturePosition[-123.115, 49.285]маршрут следует порядку указания позиций промежуточных точек[[-122.757, 49.0021],[-122.349, 47.620]]
Примечание
Если вы укажете позицию промежуточной точки, которая не расположена на дороге, Amazon Location переместит позицию на ближайшую дорогу.
Указание более 23 промежуточных точек возвращает ошибку 400 ValidationException.
Если Esri является поставщиком вашего калькулятора маршрутов, указание маршрута длиной более 400 км возвращает ошибку 400 RoutesValidationException.
Допустимые значения: [-180 to 180,-90 to 90]
(список)
Сокращенный синтаксис:
double,double ...
Синтаксис JSON:
[
[double, ...]
...
]
--travel-mode (строка)
Указывает режим транспорта при вычислении маршрута. Используется для оценки скорости перемещения и совместимости с дорогами. Вы можете выбрать Car, Truck, Walking, Bicycle или Motorcycle в качестве вариантов для TravelMode.
Примечание
Bicycle и Motorcycle допустимы только при использовании Grab в качестве поставщика данных и только в Юго-Восточной Азии.
Truck недоступен для Grab.
Для получения более подробной информации об использовании Grab для маршрутизации, включая области охвата, см. GrabMaps в руководстве разработчика Amazon Location Service.
Указанный вами TravelMode также определяет способ указания предпочтений маршрута:
- При перемещении на
Carиспользуйте параметрCarModeOptions. - При перемещении на
Truckиспользуйте параметрTruckModeOptions.
Значение по умолчанию: Car
Возможные значения:
CarTruckWalkingBicycleMotorcycle
--departure-time (метка времени)
Указывает желаемое время отправления. Использует указанное время для расчета маршрута. В противном случае используется лучшее время суток с учетом дорожных условий для расчета маршрута.
- В формате ISO 8601:
YYYY-MM-DDThh:mm:ss.sssZ. Например,2020–07-2T12:15:20.000Z+01:00
--depart-now | --no-depart-now (логическое значение)
Устанавливает время отправления как текущее время. Использует текущее время для расчета маршрута. В противном случае используется лучшее время суток с учетом дорожных условий для расчета маршрута.
Значение по умолчанию: false
Допустимые значения: false | true
--distance-unit (строка)
Установите систему единиц измерения для указания расстояния.
Значение по умолчанию: Kilometers
Возможные значения:
KilometersMiles
--include-leg-geometry | --no-include-leg-geometry (логическое значение)
Установите значение для включения геометрических деталей в результат для каждого пути между парой позиций.
Значение по умолчанию: false
Допустимые значения: false | true
--car-mode-options (структура)
Указывает предпочтения маршрута при перемещении на Car, например, избегая маршрутов, использующих паром или платные дороги.
Требования: TravelMode должен быть указан как Car.
AvoidFerries -> (логическое значение)
Избегает паромных переправ при расчете маршрутов.
Значение по умолчанию: false
Допустимые значения: false | true
AvoidTolls -> (логическое значение)
Избегает платных дорог при расчете маршрутов.
Значение по умолчанию: false
Допустимые значения: false | true
Сокращенный синтаксис:
AvoidFerries=boolean,AvoidTolls=boolean
Синтаксис JSON:
{
"AvoidFerries": true|false,
"AvoidTolls": true|false
}
--truck-mode-options (структура)
Указывает предпочтения маршрута при перемещении на Truck, например, избегая маршрутов, использующих паром или платные дороги, и технические характеристики грузовика для рассмотрения при выборе оптимальной дороги.
Требования: TravelMode должен быть указан как Truck.
AvoidFerries -> (логическое значение)
Избегает паромных переправ при расчете маршрутов.
Значение по умолчанию: false
Допустимые значения: false | true
AvoidTolls -> (логическое значение)
Избегает платных дорог при расчете маршрутов.
Значение по умолчанию: false
Допустимые значения: false | true
Dimensions -> (структура)
Указывает технические характеристики габаритов грузовика, включая длину, высоту, ширину и единицу измерения. Используется для избежания дорог, которые не могут выдержать габариты грузовика.
Length -> (двойное значение)
Длина грузовика.
- Например,
15.5.
Примечание
Для маршрутов, рассчитанных с помощью ресурса HERE, это значение должно быть между 0 и 300 метрами.Height -> (двойное значение)
Высота грузовика.
- Например,
4.5.
Примечание
Для маршрутов, рассчитанных с помощью ресурса HERE, это значение должно быть между 0 и 50 метрами.Width -> (двойное значение)
Ширина грузовика.
- Например,
4.5.
Примечание
Для маршрутов, рассчитанных с помощью ресурса HERE, это значение должно быть между 0 и 50 метрами.Unit -> (строка)
Указывает единицу измерения для габаритов грузовика.
Значение по умолчанию: Meters
Weight -> (структура)
Указывает характеристики веса грузовика, включая общий вес и единицу измерения. Используется для избежания дорог, которые не могут выдержать вес грузовика.
Total -> (двойное значение)
Общий вес грузовика.
- Например,
3500.
Unit -> (строка)
Единица измерения для веса грузовика.
Значение по умолчанию: Kilograms
Сокращенный синтаксис:
AvoidFerries=boolean,AvoidTolls=boolean,Dimensions={Length=double,Height=double,Width=double,Unit=string},Weight={Total=double,Unit=string}
Синтаксис JSON:
{
"AvoidFerries": true|false,
"AvoidTolls": true|false,
"Dimensions": {
"Length": double,
"Height": double,
"Width": double,
"Unit": "Meters"|"Feet"
},
"Weight": {
"Total": double,
"Unit": "Kilograms"|"Pounds"
}
}
--arrival-time (метка времени)
Указывает желаемое время прибытия. Использует указанное время для расчета маршрута. В противном случае используется лучшее время суток с учетом дорожных условий для расчета маршрута.
Примечание
ArrivalTime не поддерживается Esri.--optimize-for (строка)
Указывает расстояние, для оптимизации которого необходимо вычислить маршрут.
Возможные значения:
FastestRouteShortestRoute
--key (строка)
--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 версии 1, и бинарные значения должны передаваться буквально. При предоставлении содержимого из файла, которое отображается в бинарный блок, 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.
Вывод
Legs -> (список)
Содержит подробности о каждом пути между парой позиций, включенных в маршрут, таких как: StartPosition , EndPosition , Distance , DurationSeconds , Geometry и Steps . Количество ног соответствует количеству позиций в запросе минус одному.
Например, маршрут с начальной и конечной позициями возвращает одну ногу с позициями, привязанными к ближайшей дороге:
StartPosition— начальная позиция.EndPosition— конечная позиция.
Маршрут с промежуточной точкой между начальной и конечной позицией возвращает две ноги с позициями, привязанными к ближайшей дороге:
- Нога 1:
StartPosition— начальная позиция.EndPosition— позиция промежуточной точки. - Нога 2:
StartPosition— позиция промежуточной точки.EndPosition— конечная позиция.
(структура)
Содержит детали рассчитанного маршрута для каждого пути между парой позиций. Количество ног соответствует количеству позиций в запросе минус одному.
Например, маршрут с начальной и конечной позициями возвращает одну ногу с позициями, привязанными к ближайшей дороге:
StartPosition— начальная позиция.EndPosition— конечная позиция.
Маршрут с промежуточной точкой между начальной и конечной позицией возвращает две ноги с позициями, привязанными к ближайшей дороге:
- Нога 1:
StartPosition— начальная позиция.EndPosition— позиция промежуточной точки. - Нога 2:
StartPosition— позиция промежуточной точки.EndPosition— конечная позиция.
StartPosition -> (список)
Начальная позиция ноги. Следует формату [longitude,latitude] .
Примечание
ЕслиStartPosition не расположена на дороге, она привязывается к ближайшей дороге.(двойное)
EndPosition -> (список)
Конечная позиция ноги. Следует формату [longitude,latitude] .
Примечание
ЕслиEndPosition не расположена на дороге, она привязывается к ближайшей дороге.(двойное)
Distance -> (двойное)
Расстояние между начальной StartPosition и конечной EndPosition точкой ноги по рассчитанному маршруту.
- По умолчанию используется единица измерения
Kilometers, если в запросе не указана единица измеренияDistanceUnit, равнаяMiles.
DurationSeconds -> (двойное)
StartPosition и конечной EndPosition точкой ноги. Режим поездки и время отправления, указанные в запросе, определяют рассчитанное время.Geometry -> (структура)
Содержит путь рассчитанного маршрута в виде геометрии полилинии.
LineString -> (список)
Упорядоченный список позиций, используемых для построения маршрута на карте.
Первая позиция расположена ближе к начальной точке ноги, а последняя — к конечной.
- Например,
[[-123.117, 49.284],[-123.115, 49.285],[-123.115, 49.285]]
(список)
Steps -> (список)
Содержит список шагов, представляющих подсекции ноги. Каждый шаг содержит инструкции о том, как перейти к следующему шагу ноги, такие как начальная позиция шага, конечная позиция, пройденное расстояние, продолжительность и смещение геометрии.
(структура)
Представляет элемент ноги в рамках маршрута. Шаг содержит инструкции о том, как перейти к следующему шагу ноги.
StartPosition -> (список)
Начальная позиция шага. Если позиция является первым шагом в ноге, эта позиция совпадает с начальной позицией ноги.
(двойное)
EndPosition -> (список)
Конечная позиция шага. Если позиция является последним шагом в ноге, эта позиция совпадает с конечной позицией ноги.
(двойное)
Distance -> (двойное)
StartPosition и конечной EndPosition точкой шага.DurationSeconds -> (двойное)
StartPosition до конечной EndPosition точки шага. Режим поездки и время отправления, указанные в запросе, определяют рассчитанное время.GeometryOffset -> (целое число)
Представляет начальную позицию или индекс в последовательности шагов в геометрии полилинии ноги. Например, индекс первого шага в геометрии ноги равен 0.
Включено в ответ для запросов, которые устанавливают IncludeLegGeometry в True.
Summary -> (структура)
Содержит информацию о всего маршруте, такую как: RouteBBox , DataSource , Distance , DistanceUnit и DurationSeconds .
RouteBBox -> (список)
Определяет географический прямоугольник, окружающий маршрут. Используется для приближения к маршруту при отображении на карте. Например, [min x, min y, max x, max y] .
Первые 2 bbox параметра описывают юго-западный угол:
- Первая
bboxпозиция — координата X или долгота юго-западного угла. - Вторая
bboxпозиция — координата Y или широта юго-западного угла.
Следующие 2 bbox параметра описывают северо-восточный угол:
- Третья
bboxпозиция — координата X или долгота северо-восточного угла. - Четвёртая
bboxпозиция — координата Y или широта северо-восточного угла.
(двойное)
DataSource -> (строка)
Источник данных о трафике и дорожной сети, используемый для расчёта маршрута. Указывает один из доступных поставщиков:
EsriGrabHere
Для получения дополнительной информации о поставщиках данных, см. поставщиков данных Amazon Location Service.
Distance -> (двойное)
Общее расстояние, пройденное по маршруту. Сумма расстояний между каждым пунктом назначения по маршруту.
Примечание
Если Esri является источником данных для расчета маршрута, расстояние маршрута не может превышать 400 км. Если маршрут превышает 400 км, ответ будет ошибкой400 RoutesValidationException.DurationSeconds -> (двойное)
DistanceUnit -> (строка)
© Copyright 2025, Amazon Web Services. Created using Sphinx.