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

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

Остановки

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

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

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

Name

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

Text

RouteName

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

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

  • Если некоторые остановки имеют имена маршрутов, они группируются в маршрут с тем же именем. Если у одних остановок имеется значение RouteName, а у других – нет, то последние (которые без имен маршрутов) указываются в списке результатов как не назначенные и исключаются из решения.
  • Если ни у одной из остановок нет значения RouteName, все остановки относятся к одному и тому же маршруту, и создается один маршрут.
  • RouteName значения не чувствительны к регистру. Например, Маршрут 1 будет интерпретироваться как тот же маршрут, что и МАРШРУТ 1.

Text

Sequence

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

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

Long

AdditionalTime

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

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

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

Double

AdditionalDistance

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

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

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

Double

AdditionalCost

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

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

Double

TimeWindowStart

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

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

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

Date

TimeWindowEnd

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

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

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

Date

CurbApproach

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

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

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

Long

LocationType

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

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

Long

Bearing

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

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

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

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

Double

BearingTol

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

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

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

Double

NavLatency

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

Единицы измерения NavLatency совпадают с единицами вашего атрибута импеданса.

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

Double

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

  • SourceID
  • SourceOID
  • PosAlong
  • SideOfEdge

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

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

PointBarriers

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

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

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

Name

Имя барьера.

Text

BarrierType

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

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

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

Long

Additional_Time

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

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

Double

Additional_Distance

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

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

Double

AdditionalCost

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

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

Double

FullEdge

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

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

Long

CurbApproach

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

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

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

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

Long

Bearing

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

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

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

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

Double

BearingTol

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

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

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

Double

NavLatency

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

Единицы измерения NavLatency совпадают с единицами вашего атрибута импеданса.

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

Double

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

  • SourceID
  • SourceOID
  • PosAlong
  • SideOfEdge

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

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

LineBarriers

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

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

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

Name

Имя барьера.

Text

BarrierType

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

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

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

Long

ScaledTimeFactor

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

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

Double

ScaledDistanceFactor

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

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

Double

ScaledCostFactor

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

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

Double

Locations

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

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

Blob

PolygonBarriers

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

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

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

Name

Имя барьера.

Text

BarrierType

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

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

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

Long

ScaledTimeFactor

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

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

Double

ScaledDistanceFactor

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

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

Double

ScaledCostFactor

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

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

Double

Locations

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

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

Blob