Типы входных данных маршрутов

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

Остановки

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

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

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

Name

Имя остановки. Имя используется в путевом листе. Если имя не указано, в выходных остановках, маршрутах и путевом листе автоматически создается уникальное имя с префиксом Location.

Строковое

RouteName

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

Строковое

Sequence

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

Если опция findBestSequence задана как True, то порядок посещения остановок для маршрутов (за исключением, возможно, первой и последней остановки) будет проигнорирован, чтобы инструмент мог найти последовательность посещения остановок с минимальными временными затратами для каждого маршрута. Значения свойств preserveFirstStop, preserveLastStop и returnToStart определяют, будут ли игнорироваться первое и последнее значения последовательности.

Integer

AdditionalTime

Время, затраченное на остановке, которое добавляется к общему времени маршрута. По умолчанию значение равно 0.

Единицы измерения для этого атрибута задаются свойством timeUnits анализируемого объекта.

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

Double

AdditionalDistance

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

Единицы измерения для этого атрибута задаются свойством distanceUnits анализируемого объекта.

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

Double

AdditionalCost

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

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

Double

TimeWindowStart

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

Значением этого атрибута должны быть время и дата, их можно указать с помощью объекта Python datetime, например, datetime.datetime(2019, 5, 11, 8, 30, 0), который представляет субботу 11 мая 2019 08:30:00 AM. Часовой пояс значения задается свойством timeZoneForTimeWindows объекта анализа.

Поле может содержать нулевое значение (null), это означает, что маршрут должен достичь остановки в любое время, до времени заданного параметром TimeWindowEnd. Если параметр TimeWindowEnd также содержит значение null, маршрут может посетить эту остановку в любое время.

Date

TimeWindowEnd

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

Значением этого атрибута должны быть время и дата, их можно указать с помощью объекта Python datetime, например, datetime.datetime(2019, 5, 11, 17, 30, 0), который представляет субботу 11 мая 2019 17:30:00 AM. Часовой пояс значения задается свойством timeZoneForTimeWindows объекта анализа.

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

Date

CurbApproach

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

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

Атрибут CurbApproach был разработан для работы с обоими типами национальных стандартов дорожного движения: правостороннего (США) и левостороннего (Великобритания). Для начала рассмотрим случай, когда остановка располагается с левой стороны транспортного средства. Это условие должно обязательно выполняться в независимости от того движется транспорт по левой или по правой полосе дороги. Вы можете выбрать, с какой из двух сторон подъехать к остановке, независимо от национального стандарта дорожного движения, т.е. где будет находится точка заказа – справа или слева от транспортного средства. Например, если необходимо подъехать к остановке так, чтобы она не была отделена от транспортного средства полосой движения, необходимо выбрать правую сторону транспортного средства (1) в США, и левую сторону транспортного средства (2) в Великобритании.

Integer

LocationType

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

  • 0 (Остановка) – место, через которое должен пройти маршрут. Это значение по умолчанию Короткое целое.
  • 1 (Точка пути) – место, через которое маршрут должен пройти без остановки. Точки пути могут использоваться для прокладки определенного маршрута (через указанную точку) без назначения остановки в этом месте. Точки пути не отображаются в путевом листе.

Integer

Bearing

Направление, в котором движется точка. Единицами измерения являются градусы, отсчитываются по часовой стрелке от истинного севера. Данное поле используется совместно с полем BearingTol.

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

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

Более подробно о направлении и допуске направления

Double

BearingTol

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

Единицами измерения являются градусы; в качестве значения по умолчанию используется 30. Значения должны быть больше 0 и меньше 180. Значение, равное 30, означает, что когда Network Analyst предпринимает попытку добавить сетевое положение на ребро, диапазон допустимых значений направления создается в пределах 15 градусов с каждой стороны ребра (слева и справа) и в обоих направлениях оцифровки ребра.

Более подробно о направлении и допуске направления

Double

NavLatency

Данное поле используется при расчете только, если для Bearing и BearingTol также введены значения; при этом ввод значения NavLatency является необязательным, даже если для Bearing и BearingTol заданы значения. NavLatency показывает, сколько, предположительно, проходит времени между отправкой данных GPS от движущегося транспортного средства на сервер и моментом, когда обработанный маршрут поступает на навигационное устройство транспортного средства.

Единицы измерения NavLatency используются те же, что и единицы, которые задаются свойством timeUnits анализируемого объекта.

Единицы измерения NavLatency используются те же, что и единицы, которые задаются свойством timeUnits анализируемого объекта.

Double

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

  • SourceID
  • SourceOID
  • PosAlong
  • SideOfEdge

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

Точечный барьер

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

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

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

Name

Имя барьера.

Строковое

BarrierType

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

  • 0 (Запрет) – Запрещает прохождение через барьер. Барьер, действующий как запрещающий, рассматривается как ограничительный точечный барьер.

  • 2 (добавленная стоимость) – прохождение через барьер увеличивает время в пути или расстояние на значение, указанное в полях Additional_Time, Additional_Distance и Additional_Cost. Этот тип барьера называется барьером дополнительной стоимости.

Short

Additional_Time

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

Значение этого поля должно быть больше или равно нулю, а его единицы измерения соответствуют заданным свойством timeUnits.

Double

Additional_Distance

Расстояние, которое добавляется при прохождении барьера. Это поле действительно только для барьеров с дополнительной стоимостью, и только если режим передвижения, применяемый для анализа использует атрибут импеданса на основе расстояния.

Значение этого поля должно быть больше или равно нулю, а его единицы измерения соответствуют заданным свойством distanceUnits.

Double

Additional_Cost

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

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

Double

FullEdge

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

  • (0) False – разрешает путь по ребру до барьера, но не через него. Это значение используется по умолчанию.
  • 1 (True) – Запрещает путь повсюду в связанном ребре.

Short

CurbApproach

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

  • 0 (Любая сторона транспортного средства) – Барьер влияет на перемещение по ребру в обоих направлениях.
  • 1 (Правая сторона транспортного средства) – Распространяется только на те транспортные средства, для которых барьер находится с правой стороны по ходу движения. Барьер не влияет на автомобили, которые передвигаются по этому же ребру, но при этом барьер находится слева от них.
  • 2 (Левая сторона транспортного средства) – Распространяется только на те транспортные средства, для которых барьер находится с левой стороны по ходу движения. Барьер не распространяется на автомобили, которые передвигаются по этому же ребру, но при этом барьер находится справа от них.

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

Свойство CurbApproach было разработано для работы с обоими типами национальных стандартов дорожного движения: правостороннего (США) и левостороннего (Великобритания). Сначала рассмотрим случай, когда пункт обслуживания располагается с левой стороны транспортного средства. Это условие должно обязательно выполняться в независимости от того движется транспорт по левой или по правой полосе дороги. От национального стандарта дорожного движения будет зависеть ваше решение, с какой из двух сторон подъехать к пункту обслуживания, т.е. должен ли он находиться с правой или левой стороны транспортного средства. Например, если необходимо подъехать к пункту обслуживания так, чтобы он не был отделен от транспортного средства полосой движения, необходимо выбрать правую сторону транспортного средства (1) в США, и левую сторону транспортного средства (2) в Великобритании.

Short

Bearing

Направление, в котором движется точка. Единицами измерения являются градусы, отсчитываются по часовой стрелке от истинного севера. Данное поле используется совместно с полем BearingTol.

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

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

Более подробно о направлении и допуске направления

Double

BearingTol

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

Единицами измерения являются градусы; в качестве значения по умолчанию используется 30. Значения должны быть больше 0 и меньше 180. Значение, равное 30, означает, что когда Network Analyst предпринимает попытку добавить сетевое положение на ребро, диапазон допустимых значений направления создается в пределах 15 градусов с каждой стороны ребра (слева и справа) и в обоих направлениях оцифровки ребра.

Более подробно о направлении и допуске направления

Double

NavLatency

Данное поле используется при расчете только, если для Bearing и BearingTol также введены значения; при этом ввод значения NavLatency является необязательным, даже если для Bearing и BearingTol заданы значения. NavLatency показывает, сколько, предположительно, проходит времени между отправкой данных GPS от движущегося транспортного средства на сервер и моментом, когда обработанный маршрут поступает на навигационное устройство транспортного средства.

Единицы измерения NavLatency используются те же, что и единицы, которые задаются свойством timeUnits анализируемого объекта.

Единицы измерения NavLatency используются те же, что и единицы, которые задаются свойством timeUnits анализируемого объекта.

Double

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

  • SourceID
  • SourceOID
  • PosAlong
  • SideOfEdge

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

Линейный барьер

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

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

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

Name

Имя барьера.

Строковое

BarrierType

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

  • 0 (Ограничение) — запрещает перемещение везде, где барьер пересекает вашу транспортную сеть. Барьер рассматривается как ограничивающий линейный барьер.

  • 1 (Масштабированная стоимость) – масштабирует стоимость перемещения (время в пути или расстояние) по соответствующим улицам на коэффициент, указанный в поле ScaledTimeFactor или ScaledDistanceFactor. Если улицы частично покрыты барьером, время в пути или расстояние будет соответственно разделены, а затем масштабированы. Например, коэффициент 0,25 означает, что ожидаемое время перемещения по соответствующим улицам в четыре раза меньше обычного. Коэффициент 3,0 означает, что ожидаемое время перемещения будет в три раза дольше обычного. Этот тип барьера рассматривается как линейный барьер масштабируемой стоимости. Его можно использовать для моделирования снижения скорости движения из-за перекрытия полос во время проведения дорожных работ.

Short

ScaledTimeFactor

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

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

Double

ScaledDistanceFactor

Это коэффициент, на который умножается длина пути по улицам, пересеченным барьером. Значение поля должно быть больше нуля.

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

Double

ScaledCostFactor

Это коэффициент, на который умножается стоимость пути по улицам, пересеченным барьером. Значение поля должно быть больше нуля.

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

Double

Locations

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

Blob

Полигональный барьер

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

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

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

Name

Имя барьера.

Строковое

BarrierType

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

  • 0 (Ограничение) – запрещает прохождение через любую часть барьера. Этот барьер называется запрещающим полигональным барьером, поскольку он запрещает перемещение по пересекаемым улицам. Одним из применений этого типа барьеров является моделирование наводнений, покрывающих улицы, и перемещение по ним становится невозможным.

  • 1 (Масштабированная стоимость) – масштабирует стоимость перемещения (время в пути или расстояние) по соответствующим улицам на коэффициент, указанный в поле ScaledTimeFactor или ScaledDistanceFactor. Если улицы частично покрыты барьером, время в пути или расстояние будет соответственно разделены, а затем масштабированы. Например, коэффициент 0,25 означает, что ожидаемое время перемещения по соответствующим улицам в четыре раза меньше обычного. Коэффициент 3,0 означает, что ожидаемое время перемещения будет в три раза дольше обычного. Этот тип барьера называется полигональным барьером масштабируемой стоимости. Он может использоваться для моделирования погодных условий, из-за которых скорость перемещения в указанных регионах снижается.

Short

ScaledTimeFactor

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

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

Double

ScaledDistanceFactor

Это коэффициент, на который умножается длина пути по улицам, пересеченным барьером. Значение поля должно быть больше нуля.

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

Double

ScaledCostFactor

Это коэффициент, на который умножается стоимость пути по улицам, пересеченным барьером. Значение поля должно быть больше нуля.

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

Double

Locations

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

Blob