Типы выходных данных LastMileDelivery

Ниже описываются типы выходных данных, которые содержат результаты анализа доставки до двери.

Заказы

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

Выходная таблица Заказы включает все поля, присутствующие во входной таблице Заказы. Поля, которые обновляются или добавляются в выходные данные, перечислены в следующей таблице:

ПолеОписаниеТип данных

ObjectID

ObjectID пространственного объекта.

ObjectID

RouteName

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

Это поле соответствует полю Name в выходной таблице Маршруты.

Текст

Sequence

Это обозначает последовательность заказа на маршруте.

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

Long

  • ViolatedConstraint_1
  • ViolatedConstraint_2
  • ViolatedConstraint_3
  • ViolatedConstraint_4

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

  • Превышено значение MaxOrderCount (0) – нельзя назначить маршруту уже назначенные заказы, поскольку это приведет к превышению максимального количества заказов, которое может быть назначено маршруту, как определено значением поля MaxOrderCount маршрута.
  • Превышена емкость (1) – уже назначенные заказы нельзя назначить маршруту, поскольку это привело бы к превышению емкости маршрута, заданной значением поля Capacities этого маршрута.
  • Превышение MaxTotalTime (2)– время в пути от начальной станции к конечной плюс время обслуживания и ожидания на обеих станциях превышает общее время маршрута, указанное значением поля MaxTotalTime.
  • Превышено значение MaxTotalTravelTime (3) – Время в пути от начальной станции к конечной превышает общее время в пути для этого маршрута, которое задано значением поля MaxTotalTravelTime для этого маршрута.
  • Превышено MaxTotalDistance (4) – расстояние пути от начальной станции к конечной превышает общее расстояние пути для маршрута, указанное значением поля MaxTotalDistance этого маршрута.
  • Жесткое временное окно (5) – Нарушено жесткое временное окно на связанной с данным маршрутом начальной станции, конечной станции или на перерыве.
  • Несоответствие специальному требованию (6) – В целевом маршруте не найдены специальные требования заказа.
  • Жесткая зона маршрута (7) – Заказ, предварительно назначенный маршруту, не попадает в пределы жесткой зоны маршрута.
  • Недостижимо (10) – Предварительно назначенный заказ расположен на элементе сети, который не достижим данным маршрутом.
  • Нарушение времени заказа InboundArriveTime или OutboundDepartTime (15) – заказ не может быть выполнен в пределах входящего времени прибытия или выходного времени отъезда. Нарушение выполнения заказа происходит, если все значения в поле LatestStartTime маршрута меньше значений InboundArriveTime либо ни один из маршрутов не достигнет станции до момента времени OutboundDepartTime заказа.
  • Невозможно установить первый/последний якорь (16) – у заказа есть правило Первый якорь или Последний якорь, но механизм расчета не смог его выполнить. Это нарушение происходит, когда число заказов Первого якоря или число заказов Последнего якоря больше, чем число доступных маршрутов.

Более подробно о решении проблем анализа сети

Примечание:

Значение поля нарушенного ограничения заказа, которому не назначен маршрут, может описывать или не описывать все нарушения по данному заказу. Если нарушение достаточно серьезно, чтобы немедленно исключить заказ из дальнейшего рассмотрения, механизм расчета это сделает, что предотвратит обнаружение других нарушений этого заказа. Если обнаруженное нарушение не приводит автоматически к прекращению создания решения, то такое нарушение заносится в поля нарушенных ограничений, и механизм расчета будет по-прежнему учитывать этот заказ. Любые дальнейшие подобные нарушения будут добавляться в поля нарушенных ограничений до тех пор, пока (а) механизм расчета не найдет нарушение, которое досрочно прекратит процесс расчета для данного конкретного заказа, или (б) механизм расчета не найдет общее решение этой задачи.

Long

FromPrevTravelTime

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

Значение в единицах, заданных свойством timeUnits объекта анализа.

Double

FromPrevDistance

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

Значение в единицах, заданных свойством distanceUnits объекта анализа.

Double

ArriveCurbApproach

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

Long

DepartCurbApproach

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

Long

ArriveTime

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

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

Это время прибытия отражает время в пути, которое использовалось механизмом расчета при оптимизации. Для сети с данными о трафике, условия трафика для определенного времени суток не используются; вместо этого механизм расчета использует нейтральное по времени среднее время в пути для этого этапа оптимизации.

Часовой пояс для значения поля ArriveTime берется из элемента сети, на котором расположен заказ.

Сдвиг метки времени

DepartTime

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

Это время отправления отражает время в пути, которое использовалось механизмом расчета при оптимизации. Для сети с данными о трафике, условия трафика для определенного времени суток не используются; вместо этого механизм расчета использует нейтральное по времени среднее время в пути для этого этапа оптимизации.

Часовой пояс для значения поля DepartTime берется из элемента сети, на котором расположен заказ.

Сдвиг метки времени

WaitTime

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

Значение в единицах, заданных свойством timeUnits объекта анализа.

Double

ViolationTime

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

Значение в единицах, заданных свойством timeUnits объекта анализа.

Double

Status

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

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

Long

Поля сетевого местоположения

  • SourceID
  • SourceOID
  • PosAlong
  • SideOfEdge
  • SnapX
  • SnapY
  • SnapZ
  • DistanceToNetworkInMeters

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

Дополнительные сведения о способе размещения входных данных в сети

Станции

Выходные данные являются копией входной таблицы Станции с дополнительной информацией о расположении складов в сети.

Выходная таблица Станции включает в себя все поля из входной таблицы Станции. В следующей таблице перечислены только те поля, которые добавляются в выходные данные:

ПолеОписаниеТип данных

ObjectID

ObjectID пространственного объекта.

ObjectID

Status

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

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

Long

Поля сетевого местоположения

  • SourceID
  • SourceOID
  • PosAlong
  • SideOfEdge
  • SnapX
  • SnapY
  • SnapZ
  • DistanceToNetworkInMeters

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

Дополнительные сведения о способе размещения входных данных в сети

DepotVisits

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

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

ПолеОписаниеТип данных

ObjectID

ObjectID пространственного объекта.

ObjectID

DepotName

Имя посещенной станции Это поле является внешним ключом для поля Name в таблице Станции.

Если в маршруте используется виртуальная станция, это означает, что маршрут начинается или заканчивается по заказу, а не по станции, DepotName имеет значение null.

Текст

VisitType

Причина посещения станции. Это поле ограничено доменом значений:

  • 1 – Начальная станция
  • 2 – Конечная станция

Long

RouteName

Имя маршрута, содержащего данное посещение. Это поле является внешним ключом для поля Name в таблице Маршруты.

Текст

Sequence

Последовательность посещенной станции на маршруте.

Выходные значения последовательности для маршрута едины для посещений станций и заказов. Последовательности начинаются с 0 на начальной станции и нумеруются по возрастающей.

Long

ServiceTime

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

Значение в единицах, заданных свойством timeUnits объекта анализа.

Double

FromPrevTravelTime

Время в пути до станции от предыдущего посещения на маршруте.

Значение в единицах, заданных свойством timeUnits объекта анализа.

Double

FromPrevDistance

Расстояние до станции от предыдущего посещения на маршруте.

Значение в единицах, заданных свойством distanceUnits объекта анализа.

Double

ArriveTime

Время прибытия на станцию.

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

Часовой пояс для значения поля ArriveTime берется из элемента сети, на котором расположена станция.

Сдвиг метки времени

DepartTime

Время отправления со станции.

Время отправления отражает время в пути, которое использовалось механизмом расчета при оптимизации. Для сети с данными о трафике, условия трафика для определенного времени суток не используются; вместо этого механизм расчета использует нейтральное по времени среднее время в пути для этого этапа оптимизации.

Часовой пояс для значения поля DepartTime берется из элемента сети, на котором расположена станция.

Сдвиг метки времени

  • LoadedQuantity_1
  • LoadedQuantity_2
  • LoadedQuantity_3
  • LoadedQuantity_4
  • LoadedQuantity_5
  • LoadedQuantity_6
  • LoadedQuantity_7
  • LoadedQuantity_8
  • LoadedQuantity_9

Величина (например, объем, вес,и количество), загружаемая на станции. Если имеется несколько емкостей, суммы в полях с LoadedQuantity_1 по LoadedQuantity_9 соответствуют совпадающим полям от Capacity_1 до Capacity_9 во входной таблице Маршруты.

Double

  • UnloadedQuantity_1
  • UnloadedQuantity_2
  • UnloadedQuantity_3
  • UnloadedQuantity_4
  • UnloadedQuantity_5
  • UnloadedQuantity_6
  • UnloadedQuantity_7
  • UnloadedQuantity_8
  • UnloadedQuantity_9

Величина (например, объем, вес или количество), выгружаемая на станции. Если имеется несколько емкостей, суммы в полях с UnloadedQuantity_1 по UnloadedQuantity_9 соответствуют совпадающим полям от Capacity_1 до Capacity_9 во входной таблице Маршруты.

Double

Маршруты

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

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

Имя поляОписаниеТип данных

ObjectID

ObjectID пространственного объекта.

ObjectID

  • ViolatedConstraint_1
  • ViolatedConstraint_2
  • ViolatedConstraint_3
  • ViolatedConstraint_4

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

  • Превышено значение MaxOrderCount (0) – нельзя назначить маршруту уже назначенные заказы, поскольку это приведет к превышению максимального количества заказов, которое может быть назначено маршруту, как определено значением поля MaxOrderCount маршрута.
  • Превышена емкость (1) – уже назначенные заказы нельзя назначить маршруту, поскольку это привело бы к превышению емкости маршрута, заданной значением поля Capacities этого маршрута.
  • Превышение MaxTotalTime (2)– время в пути от начальной станции к конечной плюс время обслуживания и ожидания на обеих станциях превышает общее время маршрута, указанное значением поля MaxTotalTime.
  • Превышено значение MaxTotalTravelTime (3) – Время в пути от начальной станции к конечной превышает общее время в пути для этого маршрута, которое задано значением поля MaxTotalTravelTime для этого маршрута.
  • Превышено MaxTotalDistance (4) – расстояние пути от начальной станции к конечной превышает общее расстояние пути для маршрута, указанное значением поля MaxTotalDistance этого маршрута.
  • Жесткое временное окно (5) – Нарушено жесткое временное окно на связанной с данным маршрутом начальной станции, конечной станции или на перерыве.
  • Несоответствие специальному требованию (6) – В целевом маршруте не найдены специальные требования заказа.
  • Жесткая зона маршрута (7) – Заказ, предварительно назначенный маршруту, не попадает в пределы жесткой зоны маршрута.
  • Недостижимо (10) – Предварительно назначенный заказ расположен на элементе сети, который не достижим данным маршрутом.
  • Нарушение времени заказа InboundArriveTime или OutboundDepartTime (15) – заказ не может быть выполнен в пределах входящего времени прибытия или выходного времени отъезда. Нарушение выполнения заказа происходит, если все значения в поле LatestStartTime маршрута меньше значений InboundArriveTime либо ни один из маршрутов не достигнет станции до момента времени OutboundDepartTime заказа.
  • Невозможно установить первый/последний якорь (16) – у заказа есть правило Первый якорь или Последний якорь, но механизм расчета не смог его выполнить. Это нарушение происходит, когда число заказов Первого якоря или число заказов Последнего якоря больше, чем число доступных маршрутов.

Long

OrderCount

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

Long

TotalCost

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

Double

RegularTimeCost

Стоимость обычного рабочего времени.

Double

OvertimeCost

Стоимость сверхурочных работ.

Double

DistanceCost

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

Double

TotalTime

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

  • StartDepotServiceTime
  • EndDepotServiceTime
  • TotalOrderServiceTime
  • TotalWaitTime
  • TotalTravelTime

Значение в единицах, заданных свойством timeUnits объекта анализа.

Double

TotalOrderServiceTime

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

Значение в единицах, заданных свойством timeUnits объекта анализа.

Double

TotalTravelTime

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

Значение в единицах, заданных свойством timeUnits объекта анализа.

Double

TotalDistance

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

Значение в единицах, заданных свойством distanceUnits объекта анализа.

Double

StartTime

Время начала маршрута.

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

Сдвиг метки времени

EndTime

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

Часовой пояс для значения поля EndTime берется из элемента сети, на котором расположена последняя станция или последний заказ.

Сдвиг метки времени

TotalWaitTime

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

Значение в единицах, заданных свойством timeUnits объекта анализа.

Double

TotalViolationTime

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

Значение в единицах, заданных свойством timeUnits объекта анализа.

Double

DirectionPoints

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

Имя поляОписаниеТип данных

ObjectID

ObjectID пространственного объекта.

ObjectID

RouteID

Значение ObjectID выходного объекта Routes, с которым связана эта точка направления.

Long

Sequence

Последовательность точек направления для маршрута, начиная с 1.

Long

DirectionPointType

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

  • Заголовок (1)
  • Прибытие (50)
  • Отправление (51)
  • Прямо (52)
  • На пароме (100)
  • Не на пароме (101)
  • Центральная развилка (102)
  • Обход (103)
  • Разворот (104)
  • Дверь (150)
  • Лестница (151)
  • Лифт (152)
  • Эскалатор (153)
  • Пешеходная дорожка (154)
  • Левая развилка (200)
  • Левая пешеходная дорожка (201)
  • Обход по часовой стрелке (202)
  • Левый разворот (203)
  • Возьмите левее (204)
  • Левый поворот (205)
  • Резко влево (206)
  • Левый поворот и затем резкий левый поворот (207)
  • Левый поворот и затем резкий правый поворот (208)
  • Правая развилка (300)
  • Правая пешеходная дорожка (301)
  • Обход против часовой стрелки (302)
  • Правый разворот (303)
  • Держитесь правее (304)
  • Правый поворот (305)
  • Резко вправо (306)
  • Правый поворот и затем резкий левый поворот (307)
  • Правый поворот и затем резкий правый поворот (308)
  • Лифт вверх (400)
  • Эскалатор вверх (401)
  • Лестница вверх (402)
  • Лифт вниз (500)
  • Эскалатор вниз (501)
  • Лестница вниз (502)
  • Общее событие (1000)
  • Ориентир (1001)
  • Смена часового пояса (1002)
  • ДТП (1003)
  • Барьерное событие с масштабируемой стоимостью (1004)
  • Пересечение границы (1005)
  • Нарушение ограничения (1006)
  • Полоса (1007)

Long

OrderID

Значение ObjectID выходного объекта Orders, с которым связана эта точка направления.

Long

DepotVisitID

Значение ObjectID выходного объекта DepotVisits, с которым связана эта точка направления.

Long

BreakVisitID

Примечание:

Это поле не используется для анализа доставки до двери.

Long

DisplayText

Текст указаний для отображения в клиентском приложении.

Текст

ArrivalTime

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

Дата

ArrivalUTCOffset

Разница в минутах между местным временем в месте маневра и временем UTC, показанным в поле ArrivalTime.

Double

Name

Имя точки направления.

Текст

ExitName

Название съезда с шоссе, которое появляется в инструкции направления движения.

Текст

AlternateName

Альтернативное название для источника, которое появляется в инструкции направления движения.

Текст

IntersectingName

Название пересекающейся или поперечной улицы, которое появляется в инструкции направления движения.

Текст

BranchName

Название ветви указателя, которое появляется в инструкции направления движения.

Текст

TowardName

Название указателя к месту назначения, которое появляется в инструкции направления движения.

Текст

Level

Уровень здания, на котором происходит это событие направления. Это значение соответствует свойству Level, определенному в наборе сетевых данных, используемом для анализа.

Long

ShortVoiceInstruction

Короткий текст для голосового руководства в клиентском приложении.

Текст

VoiceInstruction

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

Текст

Azimuth

Направление в градусах транспортного средства, отходящего от этой точки. Ноль указывает на север.

Double

DirectionLines

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

Имя поляОписаниеТип данных

ObjectID

ObjectID пространственного объекта.

ObjectID

DirectionPointID

Значение ObjectID объекта в таблице DirectionPoints, с которым связана эта линия.

Long

RouteID

Значение ObjectID выходного объекта Routes, с которым связана эта линия направления.

Long

DirectionLineType

Определяет тип ситуации направления, описываемого этой линией, обозначенной одним из следующих значений:

  • Неизвестно (0)
  • Сегмент (1)
  • Маневр Сегмент (1)
  • Нарушение ограничения (3)
  • Барьер с масштабируемой стоимостью (4)
  • Интенсивное движение (5)
  • Медленное движение (6)
  • Умеренное движение (7)

Long

Meters

Длина сегмента линии измеряется в метрах.

Double

Minutes

Время в пути по сегменту линии в минутах.

Double

FromLevel

Уровень здания, на котором начинается это событие направления. Это значение соответствует свойству Level, определенному в наборе сетевых данных, используемом для анализа.

Более подробно о конфигурации направлений набора сетевых данных

Long

ToLevel

Уровень здания, на котором заканчивается это событие направления. Это значение соответствует свойству Level, определенному в наборе сетевых данных, используемом для анализа.

Long