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

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

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 целое число из таблицы Directions String Types или Maneuver Types.

  • Если для параметра SubItemType указано значение 1, то значения Type берутся из таблицы Maneuver Types.
  • Если для параметра SubItemType указано значение 2, то значения Type берутся из таблицы Directions String Types.

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 - Остановка была успешно оценена.
  • 1 - Точка не найдена в сети.
  • 2 – Невозможно найти элемент сети, определяемый полями сетевого расположения данной точки. Это может произойти, если элемент сети, где должна быть расположена эта точка, был удален, а перерасчет сетевого положения не выполнен.
  • 3 - Улица, на которой находится остановка, не проходима. Это может произойти, если улица имеет ограничение, заданное параметром restrictions.
  • 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 для диагностики качества результатов, получаемых инструментом.