Выходные данные инструмента Расчет проблемы маршрутизации транспортных средств

После успешного выполнения, сервис возвращает решение задачи выбора маршрута транспорта. Решение состоит из выходных параметров, описанных ниже.

out_stops

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

Примечание:

Если для параметра Заполнить геометрии остановок задано True, этот параметр соответствует классу пространственных объектов. В противном случае это таблица.

Этот параметр поддерживает следующие поля:

ПолеОписание

Name

Имя остановки. Значение в этом поле такое же, как в поле Name входных заказов, остановок или перерывов. Вы можете использовать поле StopType, чтобы определить, относится ли значение поля Name к остановке, заказу или перерыву.

StopType

Указывает, что именно представляет остановка – станцию, заказ или перерыв. Значением поля является целое число, которое может быть интерпретировано следующим образом:

  • 0 - остановка является точкой заказа.
  • 1 - остановка является станцией.
  • 2 - остановка является перерывом.

PickupQuantities

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

Единицы измерения значений данного поля не хранятся. Вам нужно интерпретировать единицы, исходя из того, что вы задали в поле Capacities входных маршрутов и в поля PickupQuantities и DeliveryQuantities входных заказов.

DeliveryQuantities

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

Единицы измерения значений данного поля не хранятся. Вам нужно интерпретировать единицы, исходя из того, что вы ввели в поле Capacities входных маршрутов и в поля PickupQuantities и DeliveryQuantities входных заказов.

RouteName

Имя маршрута, для которого назначена остановка.

Sequence

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

FromPrevTravelTime

Истекшее время в пути от предыдущей остановки маршрута до текущей остановки.

Значения указаны в единицах, заданных в параметре Единицы времени.

FromPrevDistance

Расстояние по маршруту от предыдущей остановки до текущей остановки маршрута.

Значение в указано в единицах, заданных в параметре Единицы расстояния.

ArriveCurbApproach

Указывает на сторону транспортного средства, с которой должен находиться бордюр при прибытии на остановку. Значение 1 означает правую сторону транспортного средства, а значение 2 - левую сторону транспортного средства.

DepartCurbApproach

Указывает на сторону транспортного средства, с которой должен находиться бордюр при отправлении с остановки. Значение 1 означает правую сторону транспортного средства, а значение 2 - левую сторону транспортного средства.

ArriveTime

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

DepartTime

Время, когда маршрут отправляется от остановки. Время в этом поле отображено в часовом поясе, в котором находится остановка.

ArriveTimeUTC

Время, когда маршрут прибывает на остановку. Данное значение указывается в формате всемирного координированного времени (UTC).

DepartTimeUTC

Время, когда маршрут отправляется от остановки. Данное значение указывается в формате всемирного координированного времени (UTC).

WaitTime

Время ожидания или задержки на остановке. Например, значение времени ожидания будет добавлено, если по маршруту предусмотрено ожидание открытия (начала) временного окна.

Значения указаны в единицах, заданных в параметре Единицы времени.

ViolationTime

Величина времени между окончанием временного окна остановки и прибытием транспортного средства по маршруту.

Значения указаны в единицах, заданных в параметре Единицы времени.

ORIG_FID

ObjectID входного заказа, станции или перерыва. Данное поле может использоваться для присоединения атрибутов из входных объектов.

out_routes

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

Параметры Заполнить линии маршрута и Допуск упрощения линий маршрута влияют на геометрию выходных маршрутов.

Этот параметр поддерживает следующие поля:

ПолеОписание

Name

Название маршрута. Значения в этом поле копируются из поля Name входных маршрутов.

ViolatedConstraints

Прежние версии:

Это поле устарело и заменяется четырьмя отдельными полями от ViolatedConstraint_1 до ViolatedConstraint_4.

  • ViolatedConstraint_1
  • ViolatedConstraint_2
  • ViolatedConstraint_3
  • ViolatedConstraint_4

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

Они отображают одно нарушенное ограничение для каждого поля.

  • Превышено значение MaxOrderCount (0) - Нельзя назначить маршруту уже назначенные заказы, поскольку это приведет к превышению максимального количества заказов, которое может быть назначено маршруту, как определено значением поля MaxOrderCount маршрута.
  • Превышено значение Capacities (1) – Предварительно назначенные заказы нельзя назначить этому маршруту, поскольку это приведет к превышению общей емкости маршрута, заданной значением поля Capacities этого маршрута.
  • Превышено значение MaxTotalTime (2) – Время в пути от начальной станции до конечной плюс время обслуживания и ожидания на обеих станциях, а также перерывов, превышает общее время маршрута, заданное значением поля MaxTotalTime для этого маршрута.
  • Превышено значение MaxTotalTravelTime (3) – Время в пути от начальной станции к конечной превышает общее время в пути для этого маршрута, которое задано значением поля MaxTotalTravelTime для этого маршрута.
  • Превышено значение MaxTotalDistance (4) – Расстояние пути от начальной станции к конечной превышает общее расстояние пути для маршрута, который задан значением поля MaxTotalDistance для этого маршрута.
  • Жесткое временное окно (5) – Нарушено жесткое временное окно на связанной с данным маршрутом начальной станции, конечной станции или на перерыве.
  • Несоответствие специальному требованию (6) – В целевом маршруте не найдены специальные требования заказа.
  • Жесткая зона маршрута (7) – Заказ, предварительно назначенный маршруту, не попадает в пределы жесткой зоны маршрута.
  • Превышено значение MaxTransitTime для пары заказов (8) – Имеется предварительно назначенная маршруту пара заказов, и при назначении этой пары заказов будет превышено максимальное время нахождения в пути, заданное значением поля MaxTransitTime этой пары заказов.
  • Нарушение пары заказов (9) – Заказ принадлежит к паре заказов и не может быть назначен предварительно назначенному маршруту.
  • Недостижимо (10) – Предварительно назначенный заказ расположен на элементе сети, который не достижим данным маршрутом.
  • Невозможно вставить необходимый перерыв (11) – Перерыв на маршруте имеет пустое значение последовательности (null) при наличии предварительно назначенных заказов, и его нельзя вставить нигде, не вызвав других нарушений.
  • Невозможно вставить необходимое обновление (12) – Емкость маршрута превышена, и необходимо посетить обновление маршрута; однако связанное обновление маршрута имеет пустое значение последовательности (null) при наличии предварительно назначенных заказов, и его нельзя вставить нигде, не вызвав других нарушений.
  • Превышено значение MaxTravelTimeBetweenBreaks (13) – Механизму расчета не удалось вставить перерыв в пределах времени, указанного в поле MaxTravelTimeBetweenBreaks перерыва. Причина зачастую в таком предварительном назначении последовательности для перерыва, что он становится недостижимым в пределах максимального времени в пути.

  • Превышено значение MaxCumulWorkTime для перерыва (14) – Механизму расчета не удалось вставить перерыв в пределах времени, заданного полем MaxCumulWorkTime перерыва. Причина зачастую заключается в таком предварительном назначении последовательности перерыву, что он становится недостижимым в пределах максимального времени работы.
  • Нарушение значений InboundArriveTime или OutboundDepartTime заказа (15) – Заказ не может быть выполнен в пределах входящего времени прибытия или выходного времени отъезда. Это нарушение происходит, когда все значения в поле LatestStartTime маршрута ниже значений InboundArriveTime, либо ни один из этих маршрутов не может достичь станции ранее значения OutboundDepartTime этого заказа.
  • Невозможно установить первый/последний якорь (16) – У заказа есть правило Первый якорь или Последний якорь, но механизм расчета не смог его выполнить. Это нарушение происходит, когда число заказов Первого якоря или число заказов Последнего якоря больше, чем число доступных маршрутов.

OrderCount

Число заказов, назначенных маршруту.

TotalCost

Общая эксплуатационная стоимость маршрута, которая является суммой значений следующих полей: FixedCost, RegularTimeCost, OvertimeCost и DistanceCost.

RegularTimeCost

Стоимость обычного рабочего времени, за исключением неоплачиваемых перерывов.

OvertimeCost

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

DistanceCost

Компонент стоимости расстояния, получаемый умножением значений полей TotalDistance и CostPerUnitDistance.

TotalTime

Общая длительность маршрута. Она включает в себя значения времени в пути, а также времени обслуживания и ожидания на заказах, на станциях и в перерывах. Значение TotalTime является суммой значений следующих атрибутов:

  • StartDepotServiceTime
  • EndDepotServiceTime
  • TotalOrderServiceTime
  • TotalBreakServiceTime
  • TotalRenewalServiceTime
  • TotalWaitTime
  • TotalTravelTime

Значения указаны в единицах, заданных в параметре Единицы времени.

TotalOrderServiceTime

Общее время обслуживания, потраченное на всех заказах по маршруту.

Значения указаны в единицах, заданных в параметре Единицы времени.

TotalBreakServiceTime

Общее время обслуживания, потраченное на всех перерывах по маршруту.

Значения указаны в единицах, заданных в параметре Единицы времени.

TotalTravelTime

Общее время в пути для маршрута.

Значения указаны в единицах, заданных в параметре Единицы времени.

TotalDistance

Общее расстояние пути для маршрута.

Значение в указано в единицах, заданных в параметре Единицы расстояния.

StartTime

Время начала маршрута. Маршрут может начинаться до начала временного окна его начальной станции; в этом случае на начальной станции будет затрачено время ожидания. Значение времени в этом поле относится к часовому поясу, в котором находится остановка.

EndTime

Время окончания маршрута. Маршрут заканчивается по завершении обслуживания на конечной станции. Значение времени в этом поле относится к часовому поясу, в котором находится остановка.

StartTimeUTC

Время начала маршрута дается в формате Всемирного координированного времени (UTC).

EndTimeUTC

Время окончания маршрута в формате Всемирного координированного времени (UTC).

TotalWaitTime

Общее время ожидания на всех точках заказов, станциях и перерывах по маршруту.

Значения указаны в единицах, заданных в параметре Единицы времени.

TotalViolationTime

Общее время нарушения на всех заказах и перерывах по маршруту.

Значения указаны в единицах, заданных в параметре Единицы времени.

RenewalCount

Для маршрута с обновлениями это аналогично количеству посещений станций, для обновления транспортного средства, например, его разгрузки или разгрузки.

TotalRenewalServiceTime

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

Значения указаны в единицах, заданных в параметре Единицы времени.

out_directions

Обеспечивает доступ к пошаговому путевому листу для каждого маршрута.

Параметры Язык путевого листа, Единицы измерения расстояний путевого листа и Имя стиля путевого листа определяют путевой лист перемещения. Параметр возвращает пустые объекты, если параметр Заполнить путевой лист задан как False.

Ниже приведена таблица со списком полей, возвращаемых для выходного путевого листа:

ПолеОписание

RouteName

Название маршрута, к которому применяется действие перемещения. Значение совпадает с полем Name выходных маршрутов.

ArriveTime

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

Type

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

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

Значение Type это целое число из списков Типы маневров или Типы строк путевого листа, приведенных ниже.

Типы маневров

  • 0: Неизвестный
  • 1: Прибытие на остановку
  • 2: Двигайтесь прямо
  • 3: Возьмите левее
  • 4: Возьмите правее
  • 5: Поверните налево
  • 6: Поверните направо
  • 7: Резко поверните налево
  • 8: Резко поверните направо
  • 9: Выполните разворот
  • 10: Переправьтесь на пароме
  • 11: Проезжайте по кругу
  • 12: Слияние с шоссе
  • 13: Съезд с шоссе
  • 14: Следуйте по другому шоссе
  • 15: На развилке держитесь центра
  • 16: На развилке возьмите левее
  • 17: На развилке возьмите правее
  • 18: Станция отправления
  • 19: Элемент планирования движения
  • 20: Конец паромной переправы
  • 21: Съезд направо
  • 22: Съезд налево
  • 23: Поверните налево и немедленно поверните направо
  • 24: Поверните направо и немедленно поверните налево
  • 25: Поверните направо и немедленно поверните направо
  • 26: Поверните налево и немедленно поверните налево

Типы строк путевого листа

  • 0: Тип строки путевого листа General
  • 1: Тип строки путевого листа Depart
  • 2: Тип строки путевого листа Arrive
  • 3: Тип строки путевого листа Length
  • 4: Тип строки путевого листа Time
  • 5: Тип строки путевого листа Time summary
  • 6: Тип строки путевого листа Time Window
  • 7: Тип строки путевого листа Violation Time
  • 8: Тип строки путевого листа Wait Time
  • 9: Тип строки путевого листа Service Time
  • 10: Тип строки путевого листа Estimated Arrival
  • 11: Тип строки путевого листа Cumulative Length
  • 12: Тип строки путевого листа Street name
  • 13: Тип строки путевого листа Alternate street name
  • 14: Тип строки путевого листа Sign branch information
  • 15: Тип строки путевого листа Sign toward information
  • 16: Тип строки путевого листа Cross street name
  • 17: Тип строки путевого листа Sign exit number

SubItemType

Указывает, содержит ли поле Type целое число из таблиц Типы маневров или Типы строк путевого листа,

  • Если значение SubItemType равно 1, то Type ссылаются на значения из таблицы Типы маневров.
  • Если значение SubItemType равно 2, то Type ссылаются на значения из таблицы Типы строк путевого листа.
  • Если значение SubItemType равно 2, то Type ссылаются на значения из таблицы Типы строк путевого листа.

Text

Текстовое описание путевого листа.

ElaspsedTime

Время, в минутах, прошедшее с начала движения по текущему направлению до начала следующего или до тех пор, пока маршрут не закончится на последнем участке путевого листа

DriveDistance

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

Значения указаны в единицах, заданных в параметре Directions_Distance_Units.

Данное значение равно нулю для направлений движения, которые происходят том же положении, где начинается другое. Например, DriveDistance равно 0 для текста путевого листа в начале маршрута.

out_unassigned_stops

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

Примечание:

Если для параметра Заполнить геометрии остановок задано True, этот параметр соответствует классу пространственных объектов. В противном случае это таблица.

Этот параметр поддерживает следующие поля:

ПолеОписание

StopType

Указывает, что именно представляет остановка – станцию, заказ или перерыв. Значением поля является целое число, которое может быть интерпретировано следующим образом:

  • 0 - остановка является точкой заказа.
  • 1 - остановка является станцией.
  • 2 - остановка является перерывом.

Name

Имя остановки. Значение в этом поле такое же, как в поле Name входных заказов, остановок или перерывов. Вы можете использовать поле StopType, чтобы определить, относится ли значение поля Name к остановке, заказу или перерыву.

ViolatedConstraints

Прежние версии:

Это поле устарело и заменяется четырьмя отдельными полями от ViolatedConstraint_1 до ViolatedConstraint_4.

  • ViolatedConstraint_1
  • ViolatedConstraint_2
  • ViolatedConstraint_3
  • ViolatedConstraint_4

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

Они отображают одно нарушенное ограничение для каждого поля.

  • Превышено значение MaxOrderCount (0) - Нельзя назначить маршруту уже назначенные заказы, поскольку это приведет к превышению максимального количества заказов, которое может быть назначено маршруту, как определено значением поля MaxOrderCount маршрута.
  • Превышено значение Capacities (1) – Предварительно назначенные заказы нельзя назначить этому маршруту, поскольку это приведет к превышению общей емкости маршрута, заданной значением поля Capacities этого маршрута.
  • Превышено значение MaxTotalTime (2) – Время в пути от начальной станции до конечной плюс время обслуживания и ожидания на обеих станциях, а также перерывов, превышает общее время маршрута, заданное значением поля MaxTotalTime для этого маршрута.
  • Превышено значение MaxTotalTravelTime (3) – Время в пути от начальной станции к конечной превышает общее время в пути для этого маршрута, которое задано значением поля MaxTotalTravelTime для этого маршрута.
  • Превышено значение MaxTotalDistance (4) – Расстояние пути от начальной станции к конечной превышает общее расстояние пути для маршрута, который задан значением поля MaxTotalDistance для этого маршрута.
  • Жесткое временное окно (5) – Нарушено жесткое временное окно на связанной с данным маршрутом начальной станции, конечной станции или на перерыве.
  • Несоответствие специальному требованию (6) – В целевом маршруте не найдены специальные требования заказа.
  • Жесткая зона маршрута (7) – Заказ, предварительно назначенный маршруту, не попадает в пределы жесткой зоны маршрута.
  • Превышено значение MaxTransitTime для пары заказов (8) – Имеется предварительно назначенная маршруту пара заказов, и при назначении этой пары заказов будет превышено максимальное время нахождения в пути, заданное значением поля MaxTransitTime этой пары заказов.
  • Нарушение пары заказов (9) – Заказ принадлежит к паре заказов и не может быть назначен предварительно назначенному маршруту.
  • Недостижимо (10) – Предварительно назначенный заказ расположен на элементе сети, который не достижим данным маршрутом.
  • Невозможно вставить необходимый перерыв (11) – Перерыв на маршруте имеет пустое значение последовательности (null) при наличии предварительно назначенных заказов, и его нельзя вставить нигде, не вызвав других нарушений.
  • Невозможно вставить необходимое обновление (12) – Емкость маршрута превышена, и необходимо посетить обновление маршрута; однако связанное обновление маршрута имеет пустое значение последовательности (null) при наличии предварительно назначенных заказов, и его нельзя вставить нигде, не вызвав других нарушений.
  • Превышено значение MaxTravelTimeBetweenBreaks (13) – Механизму расчета не удалось вставить перерыв в пределах времени, указанного в поле MaxTravelTimeBetweenBreaks перерыва. Причина зачастую в таком предварительном назначении последовательности для перерыва, что он становится недостижимым в пределах максимального времени в пути.

  • Превышено значение MaxCumulWorkTime для перерыва (14) – Механизму расчета не удалось вставить перерыв в пределах времени, заданного полем MaxCumulWorkTime перерыва. Причина зачастую заключается в таком предварительном назначении последовательности перерыву, что он становится недостижимым в пределах максимального времени работы.
  • Нарушение значений InboundArriveTime или OutboundDepartTime заказа (15) – Заказ не может быть выполнен в пределах входящего времени прибытия или выходного времени отъезда. Это нарушение происходит, когда все значения в поле LatestStartTime маршрута ниже значений InboundArriveTime, либо ни один из этих маршрутов не может достичь станции ранее значения OutboundDepartTime этого заказа.
  • Невозможно установить первый/последний якорь (16) – У заказа есть правило Первый якорь или Последний якорь, но механизм расчета не смог его выполнить. Это нарушение происходит, когда число заказов Первого якоря или число заказов Последнего якоря больше, чем число доступных маршрутов.

Status

Указывает статус точки относительно ее местоположения в сети и результат анализа. Список возможных значений следующий:

  • 0 (OK)– Точка успешно найдена в сети.
  • 1 (Не найдено)—Точка не была успешно найдена в сети и, следовательно, не была включена в анализ.
  • 2 (Элемент сети не найден) – Невозможно найти элемент сети, определяемый полями сетевого расположения данной точки. Это может произойти, если элемент сети, где должна быть расположена эта точка, был удален, а перерасчет сетевого положения не выполнен.
  • 3 (Непроходимый элемент)—Сетевой элемент, на котором расположена точка, не является проходимым. Это может произойти, если элемент имеет ограничения, заданные с помощью атрибута ограничения.
  • 4 (Некорректные значения поля) – значения поля выходят за диапазон домена кодированных значений или интервального домена. Например, существует отрицательное значение, когда необходимы только положительные значения.
  • 5 (Не достигнуто)—Точка не может быть достигнута механизмом расчета. Точка может находиться на отдельном участке сети, который не соединяется с другими входными данными, либо перемещению в эту точку или из нее препятствуют барьеры или ограничения.
  • 6 (Нарушение временного окна)—Эта точка не могла быть достигнута в пределах установленных временных окон. Этот статус применяется только к типам сетевого анализа, которые поддерживают временные окна.
  • 7(не размещен на ближайшем) – ближайшее сетевое местоположение к точке не может быть пройдено из-за ограничения или барьера, поэтому вместо этого точка была расположена на ближайшем сетевом объекте.

solve_succeeded

Используйте этот параметр для определения, успешным ли был анализ.

output_result_file

Данный параметр используется для доступа к результатам анализа в виде файла .zip, содержащего один или несколько файлов для каждого из выходных данных. Формат отдельного файла задается параметром Выходной формат. Значение параметра не заполнено, если для параметра Выходной формат задано Набор объектов.

Если задан файловой выходной формат, например, файл JSON или файл GeoJSON, к отображению не будут добавлены выходные данные, так как приложения, такие как ArcMap или ArcGIS Pro, не могут отображать содержимое полученных файлов. Напротив, файл загружается в временную директорию вашего компьютера. В ArcGIS Pro местоположение загруженного файла можно определить, просмотрев значение параметра Выходной результирующий файл в соответствующей строке отчета о выполнении инструмента в истории геообработки вашего проекта. В ArcMap местоположение файла можно определить с помощью опции Копировать местоположение ниспадающего меню параметра Выходной результирующий файл в соответствующей строке отчета о выполнении инструмента в окне Результаты геообработки.

output_route_data

Используйте данный параметр для доступа к файлу .zip, содержащему файловую базу геоданных, в которой хранятся входные и выходные данные анализа в формате, который может быть использован для дальнейшей публикации слоев маршрутов на ArcGIS Online или Portal for ArcGIS. Значение параметра заполняется, только если для параметра Сохранить данные маршрута задано True.

Файл загружается в временную директорию вашего компьютера. В ArcGIS Pro местоположение загруженного файла можно определить, просмотрев значение параметра Выходные данные маршрута в соответствующей строке отчета о выполнении инструмента в истории геообработки вашего проекта. В ArcMap местоположение загруженного файла можно определить с помощью опции Копировать местоположение ниспадающего меню параметра Выходные данные маршрута в соответствующей строке отчета о выполнении инструмента в окне Результаты геообработки.

output_network_analysis_layer

Используйте этот параметр для доступа к файлу слоя сетевого анализа, хранящий настройки, а также входные и выходные данные анализа. Значение параметра заполняется, только если для параметра Сохранить выходной слой сетевого анализа задано True.

Файл загружается в временную директорию вашего компьютера. В ArcGIS Pro местоположение загруженного файла можно определить, просмотрев значение параметра Выходной слой сетевого анализа в соответствующей строке отчета о выполнении инструмента в истории геообработки вашего проекта. В ArcMap местоположение загруженного файла можно определить с помощью опции Копировать местоположение ниспадающего меню параметра Выходной слой сетевого анализа в соответствующей строке отчета о выполнении инструмента в окне Результаты геообработки.

Примечание:

Вы не можете работать с этим файлом напрямую, даже если вы откроете его в приложении ArcGIS Desktop, например, в ArcMap, поскольку его источник данных не будет корректным. Этот файл предназначен для отправки в техническую поддержку Esri для диагностики качества результатов, получаемых инструментом.