Spec-Zone.ru › AWS CLI v2

[ aws . geo-routes ]

optimize-waypoints

Описание

OptimizeWaypoints вычисляет оптимальный порядок прохождения между набором точек, чтобы минимизировать время или расстояние путешествия, исходя из ограничений дорожной сети и данных о потоке движения.

См. также: Документацию AWS API

Синтаксис

  optimize-waypoints
[--avoid <value>]
[--clustering <value>]
[--departure-time <value>]
[--destination <value>]
[--destination-options <value>]
[--driver <value>]
[--exclude <value>]
[--key <value>]
[--optimize-sequencing-for <value>]
--origin <value>
[--origin-options <value>]
[--traffic <value>]
[--travel-mode <value>]
[--travel-mode-options <value>]
[--waypoints <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]

Параметры

--avoid (структура)

Функции, которые будут избегаться. Избегание производится на основе наилучшего случая. Если избегание не может быть удовлетворено в конкретном случае, это значение игнорируется.

Areas -> (список)

Области, которые следует избегать.

(структура)

Область, которую следует избегать.

Geometry -> (структура)

Геометрия области, которую следует избегать.

BoundingBox -> (список)

Геометрия, определенная как прямоугольник. Первая пара представляет собой координаты X и Y (долготу и широту) юго-западного угла прямоугольника; вторая пара представляет собой координаты X и Y (долготу и широту) северо-восточного угла.

(двойное)

CarShuttleTrains -> (булево)

Параметры избегания для автомобилей-шаттлов-поездов.

ControlledAccessHighways -> (булево)

Избегать автомагистралей с контролируемым доступом при расчете маршрута.

DirtRoads -> (булево)

Избегать грунтовых дорог при расчете маршрута.

Ferries -> (булево)

Параметры избегания для паромов.

TollRoads -> (булево)

Избегает дорог, где указанные транспондеры для оплаты платных дорог являются единственным способом оплаты.

Tunnels -> (булево)

Избегать туннелей при расчете маршрута.

UTurns -> (булево)

Избегать разворотов на автомагистралях и скоростных автотрассах.

Синтаксис JSON:

{
  "Areas": [
    {
      "Geometry": {
        "BoundingBox": [double, ...]
      }
    }
    ...
  ],
  "CarShuttleTrains": true|false,
  "ControlledAccessHighways": true|false,
  "DirtRoads": true|false,
  "Ferries": true|false,
  "TollRoads": true|false,
  "Tunnels": true|false,
  "UTurns": true|false
}

--clustering (структура)

Кластеризация позволяет указать, как можно сгруппировать близлежащие контрольные точки, чтобы улучшить оптимизированную последовательность.

Algorithm -> (строка)

Используемый алгоритм. DrivingDistance объединяет все контрольные точки, находящиеся в пределах зоны автомобильного доступа, в один кластер. TopologySegment объединяет все контрольные точки, находящиеся в одном топологическом сегменте, в один кластер. Топологический сегмент — это линейный участок дороги между двумя перекрестками.

DrivingDistanceOptions -> (структура)

Параметры автомобильного расстояния, которые будут использоваться, когда алгоритм кластеризации — DrivingDistance.

DrivingDistance -> (целое)

DrivingDistance объединяет все контрольные точки, которые находятся в пределах автомобильного доступа друг к другу, в один кластер.

Краткая запись синтаксиса:

Algorithm=string,DrivingDistanceOptions={DrivingDistance=long}

Синтаксис JSON:

{
  "Algorithm": "DrivingDistance"|"TopologySegment",
  "DrivingDistanceOptions": {
    "DrivingDistance": long
  }
}

--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

--destination (список)

Конечная позиция маршрута в формате системы мировой геодезии (WGS 84): [longitude, latitude] .

(двойное)

Синтаксис:

double double ...

--destination-options (структура)

Параметры, связанные с пунктом назначения.

AccessHours -> (структура)

Часы доступа, соответствующие времени посещения контрольной точки.

From -> (структура)

Содержит идентификатор начальной контрольной точки в этом соединении.

DayOfWeek -> (строка)

День недели.

TimeOfDay -> (строка)

Время суток.

To -> (структура)

Содержит идентификатор конечной контрольной точки в этом соединении.

DayOfWeek -> (строка)

День недели.

TimeOfDay -> (строка)

Время суток.

AppointmentTime -> (строка)

Время приема в пункте назначения.

Heading -> (двойное)

GPS-азимут в позиции.

Id -> (строка)

Идентификатор контрольной точки.

ServiceDuration -> (целое)

Время обслуживания в пункте назначения. При назначении время обслуживания должно быть продолжительностью назначенного времени.

Единица измерения : seconds

SideOfStreet -> (структура)

Параметры для настройки сопоставления заданной позиции с стороной дороги.

Position -> (список)

Позиция определена как [longitude, latitude] .

(двойное)

UseWith -> (строка)

Стратегия, которая определяет, когда позиция стороны улицы должна использоваться. AnyStreet всегда будет использовать предоставленную позицию.

Значение по умолчанию: DividedStreetOnly

Краткая запись синтаксиса:

AccessHours={From={DayOfWeek=string,TimeOfDay=string},To={DayOfWeek=string,TimeOfDay=string}},AppointmentTime=string,Heading=double,Id=string,ServiceDuration=long,SideOfStreet={Position=[double,double],UseWith=string}

Синтаксис JSON:

{
  "AccessHours": {
    "From": {
      "DayOfWeek": "Monday"|"Tuesday"|"Wednesday"|"Thursday"|"Friday"|"Saturday"|"Sunday",
      "TimeOfDay": "string"
    },
    "To": {
      "DayOfWeek": "Monday"|"Tuesday"|"Wednesday"|"Thursday"|"Friday"|"Saturday"|"Sunday",
      "TimeOfDay": "string"
    }
  },
  "AppointmentTime": "string",
  "Heading": double,
  "Id": "string",
  "ServiceDuration": long,
  "SideOfStreet": {
    "Position": [double, ...],
    "UseWith": "AnyStreet"|"DividedStreetOnly"
  }
}

--driver (структура)

Параметры, связанные с водителем.

RestCycles -> (структура)

Графики работы и отдыха водителя, определенные коротким и длинным циклом. Перерыв необходимо сделать после короткого периода работы. Короткий цикл может повторяться до достижения длительного периода работы, после чего необходимо сделать длительный перерыв перед возобновлением работы.

LongCycle -> (структура)

Длинный цикл для графика работы и отдыха водителя.

RestDuration -> (целое)

Фаза отдыха цикла.

Единица измерения : seconds

WorkDuration -> (целое)

Фаза работы цикла.

Единица измерения : seconds

ShortCycle -> (структура)

Короткий цикл для графика работы и отдыха водителя

RestDuration -> (целое)

Фаза отдыха цикла.

Единица измерения : seconds

WorkDuration -> (целое)

Фаза работы цикла.

Единица измерения : seconds

RestProfile -> (структура)

Предварительно определенные профили отдыха для графика работы водителя. В настоящее время поддерживается только профиль ЕС.

Profile -> (строка)

Предварительно определенные профили отдыха для графика работы водителя. В настоящее время поддерживается только профиль ЕС.

TreatServiceTimeAs -> (строка)

Если время обслуживания, предоставленное в контрольной точке/пункте назначения, должно рассматриваться как перерыв или работа. Это влияет на общее время, возвращаемое в ответе.

Краткая запись синтаксиса:

RestCycles={LongCycle={RestDuration=long,WorkDuration=long},ShortCycle={RestDuration=long,WorkDuration=long}},RestProfile={Profile=string},TreatServiceTimeAs=string

Синтаксис JSON:

{
  "RestCycles": {
    "LongCycle": {
      "RestDuration": long,
      "WorkDuration": long
    },
    "ShortCycle": {
      "RestDuration": long,
      "WorkDuration": long
    }
  },
  "RestProfile": {
    "Profile": "string"
  },
  "TreatServiceTimeAs": "Rest"|"Work"
}

--exclude (структура)

Функции, которые следует строго исключить при расчете маршрута.

Countries -> (список)

Список стран, которые следует избегать, определенный двух- или трехбуквенными кодами стран.

(строка)

Краткая запись синтаксиса:

Countries=string,string

Синтаксис JSON:

{
  "Countries": ["string", ...]
}

--key (строка)

Необязательно: ключ API, который нужно использовать для авторизации. При выполнении запроса должен быть предоставлен либо ключ API, либо действительный подпись SigV4.

--optimize-sequencing-for (строка)

Определяет критерии оптимизации для вычисленной последовательности.

Значение по умолчанию: FastestRoute .

Возможные значения:

  • FastestRoute
  • ShortestRoute

--origin (список)

Начальная позиция маршрута.

(двойное)

Синтаксис:

double double ...

--origin-options (структура)

Параметры, связанные с начальной точкой.

Id -> (строка)

Идентификатор начала.

Краткая запись синтаксиса:

Id=string

Синтаксис JSON:

{
  "Id": "string"
}

--traffic (структура)

Параметры, связанные с трафиком.

Usage -> (строка)

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

Значение по умолчанию: UseTrafficData

Краткая запись синтаксиса:

Usage=string

Синтаксис JSON:

{
  "Usage": "IgnoreTrafficData"|"UseTrafficData"
}

--travel-mode (строка)

Указывает способ передвижения при расчете маршрута. Используется для оценки скорости движения и совместимости с дорогами.

Значение по умолчанию: Car

Возможные значения:

  • Car
  • Pedestrian
  • Scooter
  • Truck

--travel-mode-options (структура)

Параметры режима передвижения для указанного режима передвижения.

Pedestrian -> (структура)

Параметры режима передвижения при указанном режиме передвижения — «Пешеход»

Speed -> (двойное)

Скорость ходьбы.

Единица измерения : KilometersPerHour

Truck -> (структура)

Параметры режима передвижения при указанном режиме передвижения — «Грузовик»

GrossWeight -> (целое)

Полная масса транспортного средства, включая прицепы и груз.

Единица измерения : Kilograms

HazardousCargos -> (список)

Список опасных грузов, перевозимых в транспортном средстве.

(строка)

Height -> (целое)

Высота транспортного средства.

Единица измерения : centimeters

Length -> (целое)

Длина транспортного средства.

Единица измерения : centimeters

Trailer -> (структура)

Параметры прицепа, соответствующие транспортному средству.

TrailerCount -> (целое)

Количество прицепов, прицепленных к транспортному средству.

Значение по умолчанию: 0

TruckType -> (строка)

Тип грузовика.

TunnelRestrictionCode -> (строка)

Код ограничения проезда через туннель.

Категории туннелей в этом списке указывают ограничения, которые применяются к определенным туннелям в Великобритании. Они относятся к видам опасных грузов, которые могут перевозиться через них.

  • Категория туннеля B
    • Уровень риска : Ограниченный риск
    • Ограничения : Несколько ограничений
  • Категория туннеля C
    • Уровень риска : Средний риск
    • Ограничения : Некоторые ограничения
  • Категория туннеля D
    • Уровень риска : Высокий риск
    • Ограничения : Многие ограничения применяются
  • Категория туннеля E
    • Уровень риска : Очень высокий риск
    • Ограничения : Ограничение проезда через туннель

WeightPerAxle -> (целое)

Максимальная масса на ось, независимо от типа или группы осей. Предназначено для использования в странах, где различия между типами или группами осей не учитываются.

Единица измерения : Kilograms

Width -> (целое)

Ширина транспортного средства.

Единица измерения : centimeters

Краткая запись синтаксиса:

Pedestrian={Speed=double},Truck={GrossWeight=long,HazardousCargos=[string,string],Height=long,Length=long,Trailer={TrailerCount=integer},TruckType=string,TunnelRestrictionCode=string,WeightPerAxle=long,Width=long}

Синтаксис JSON:

{
  "Pedestrian": {
    "Speed": double
  },
  "Truck": {
    "GrossWeight": long,
    "HazardousCargos": ["Combustible"|"Corrosive"|"Explosive"|"Flammable"|"Gas"|"HarmfulToWater"|"Organic"|"Other"|"Poison"|"PoisonousInhalation"|"Radioactive", ...],
    "Height": long,
    "Length": long,
    "Trailer": {
      "TrailerCount": integer
    },
    "TruckType": "StraightTruck"|"Tractor",
    "TunnelRestrictionCode": "string",
    "WeightPerAxle": long,
    "Width": long
  }
}

--waypoints (список)

Список контрольных точек между Origin и Destination.

(структура)

Контрольная точка между начальной и конечной точкой.

AccessHours -> (структура)

Часы доступа, соответствующие времени посещения контрольной точки.

From -> (структура)

Содержит идентификатор начальной контрольной точки в этом соединении.

DayOfWeek -> (строка)

День недели.

TimeOfDay -> (строка)

Время суток.

To -> (структура)

Содержит идентификатор конечной контрольной точки в этом соединении.

DayOfWeek -> (строка)

День недели.

TimeOfDay -> (строка)

Время суток.

AppointmentTime -> (строка)

Время приема в контрольной точке.

Before -> (список)

Ограничение, определяющее, какие контрольные точки должны посещаться после этой контрольной точки.

(целое число)

Heading -> (двойное)

GPS азимут в точке.

Id -> (строка)

Идентификатор контрольной точки.

Position -> (список)

Позиция, определенная как [longitude, latitude].

(двойное)

ServiceDuration -> (целое число с длинной арифметикой)

Время обслуживания в контрольной точке. При назначении время обслуживания должно быть продолжительностью назначения.

Единица : seconds

SideOfStreet -> (структура)

Параметры для настройки соответствия указанной позиции стороне улицы.

Position -> (список)

Позиция, определенная как [longitude, latitude].

(двойное)

UseWith -> (строка)

Стратегия, определяющая, когда должна использоваться позиция стороны улицы. AnyStreet всегда будет использовать предоставленную позицию.

Значение по умолчанию: DividedStreetOnly

Синтаксис сокращений:

AccessHours={From={DayOfWeek=string,TimeOfDay=string},To={DayOfWeek=string,TimeOfDay=string}},AppointmentTime=string,Before=integer,integer,Heading=double,Id=string,Position=double,double,ServiceDuration=long,SideOfStreet={Position=[double,double],UseWith=string} ...

Синтаксис JSON:

[
  {
    "AccessHours": {
      "From": {
        "DayOfWeek": "Monday"|"Tuesday"|"Wednesday"|"Thursday"|"Friday"|"Saturday"|"Sunday",
        "TimeOfDay": "string"
      },
      "To": {
        "DayOfWeek": "Monday"|"Tuesday"|"Wednesday"|"Thursday"|"Friday"|"Saturday"|"Sunday",
        "TimeOfDay": "string"
      }
    },
    "AppointmentTime": "string",
    "Before": [integer, ...],
    "Heading": double,
    "Id": "string",
    "Position": [double, ...],
    "ServiceDuration": long,
    "SideOfStreet": {
      "Position": [double, ...],
      "UseWith": "AnyStreet"|"DividedStreetOnly"
    }
  }
  ...
]

--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 (булево)

Включить отладку протоколирования.

--endpoint-url (строка)

Переопределить URL по умолчанию команды заданным URL.

--no-verify-ssl (булево)

По умолчанию AWS CLI использует SSL при взаимодействии с AWS-сервисами. Для каждого подключения SSL AWS CLI будет проверять сертификаты SSL. Этот параметр переопределяет поведение проверки сертификатов SSL по умолчанию.

--no-paginate (булево)

Отключить автоматическую постраничность. Если автоматическая постраничность отключена, AWS CLI выполнит только один вызов для первой страницы результатов.

--output (строка)

Стиль форматирования для вывода команды.

  • json
  • текст
  • таблица
  • yaml
  • yaml-поток

--query (строка)

Запрос JMESPath для фильтрации данных ответа.

--profile (строка)

Использовать определённый профиль из файла аутентификации.

--region (строка)

Регион для использования. Переопределяет параметры конфигурации/окружения.

--version (строка)

Отобразить версию этого инструмента.

--color (строка)

Включить/выключить цветной вывод.

  • включено
  • выключено
  • автоматически

--no-sign-request (булево)

Не подписывать запросы. Кредиты не будут загружены, если этот аргумент предоставлен.

--ca-bundle (строка)

Файл с сертификатом CA для проверки SSL-сертификатов. Переопределяет параметры конфигурации/окружения.

--cli-read-timeout (целое число)

Максимальное время чтения сокета в секундах. Если значение установлено в 0, чтение сокета будет выполняться блокирующим образом без таймаута. Значение по умолчанию - 60 секунд.

--cli-connect-timeout (целое число)

Максимальное время подключения сокета в секундах. Если значение установлено в 0, подключение сокета будет выполняться блокирующим образом без таймаута. Значение по умолчанию - 60 секунд.

--cli-binary-format (строка)

Стиль форматирования, используемый для двоичных блоков. Формат по умолчанию - 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 (булево)

Отключить пейджер CLI для вывода.

--cli-auto-prompt (булево)

Автоматически запрашивать параметры входных данных CLI.

--no-cli-auto-prompt (булево)

Отключить автоматическое запроса параметров входных данных CLI.

Вывод

Connections -> (список)

Подробная информация о соединении от одной контрольной точки к следующей в оптимизированной последовательности.

(структура)

Это содержит информацию, такую как расстояние и продолжительность от одной контрольной точки до следующей контрольной точки в последовательности.

Distance -> (целое число с длинной арифметикой)

Расстояние этапа.

From -> (строка)

содержит идентификатор начальной контрольной точки в этом соединении.

RestDuration -> (целое число с длинной арифметикой)

Время отдыха, прежде чем водитель сможет продолжить движение.

To -> (строка)

Содержит идентификатор конечной контрольной точки в этом соединении.

TravelDuration -> (целое число с длинной арифметикой)

Общее время.

Единица : seconds

WaitDuration -> (целое число с длинной арифметикой)

Продолжительность шага ожидания.

Единица : seconds

Distance -> (целое число с длинной арифметикой)

Общее расстояние для прохождения всей последовательности.

Duration -> (целое число с длинной арифметикой)

Общее время прохождения всей последовательности.

Единица : seconds

ImpedingWaypoints -> (список)

Возвращает контрольные точки, которые привели к ошибке оптимизации, и ограничения, которые не были удовлетворены, что привело к ошибке.

(структура)

Препятствующая контрольная точка.

FailedConstraints -> (список)

Неудовлетворённые ограничения для препятствующей контрольной точки.

(структура)

Неудовлетворённое ограничение.

Constraint -> (строка)

Неудовлетворённое ограничение.

Reason -> (строка)

Причина неудовлетворённого ограничения.

Id -> (строка)

Идентификатор контрольной точки.

Position -> (список)

Позиция, определенная как [longitude, latitude].

(двойное)

OptimizedWaypoints -> (список)

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

(структура)

Оптимизированная контрольная точка.

ArrivalTime -> (строка)

Ожидаемое время прибытия в пункт назначения.

Формат времени: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

ClusterIndex -> (целое число)

Индекс кластера, к которому относится контрольная точка. Индекс включается в ответ только в том случае, если кластеризация была выполнена при обработке запроса.

DepartureTime -> (строка)

Ожидаемое время выезда из начальной точки.

Формат времени: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

Id -> (строка)

Идентификатор контрольной точки.

Position -> (список)

Позиция, определенная как [longitude, latitude].

(двойное)

PricingBucket -> (строка)

Ценовой сегмент, за который взимается плата при запросе.

TimeBreakdown -> (структура)

Детализация времени для последовательности.

RestDuration -> (целое число с длинной арифметикой)

Фаза отдыха цикла.

Единица : seconds

ServiceDuration -> (целое число с длинной арифметикой)

Время обслуживания в пункте назначения. При назначении время обслуживания должно быть продолжительностью назначения.

Единица : seconds

TravelDuration -> (целое число с длинной арифметикой)

Фаза путешествия цикла.

Единица : seconds

WaitDuration -> (целое число с длинной арифметикой)

Фаза ожидания цикла.

Единица : seconds

© Copyright 2025, Amazon Web Services. Created using Sphinx.

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API