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

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

Остановки

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

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

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

Name

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

Строка

RouteName

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

Строка

Sequence

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

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

Целочисленное

AdditionalTime

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

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

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

Двойной точности

AdditionalDistance

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

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

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

Двойной точности

AdditionalCost

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

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

Двойной точности

TimeWindowStart

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

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

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

Дата

TimeWindowEnd

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

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

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

Дата

CurbApproach

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

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

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

Целочисленное

LocationType

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

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

Целочисленное

Bearing

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

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

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

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

Двойной точности

BearingTol

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

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

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

Двойной точности

NavLatency

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

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

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

Двойной точности

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

  • SourceID
  • SourceOID
  • PosAlong
  • SideOfEdge

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

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

PointBarriers

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

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

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

Name

Имя барьера.

Строка

BarrierType

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

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

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

Короткое целое

Additional_Time

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

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

Двойной точности

Additional_Distance

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

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

Двойной точности

AdditionalCost

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

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

Двойной точности

FullEdge

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

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

Короткое целое

CurbApproach

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

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

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

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

Короткое целое

Bearing

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

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

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

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

Двойной точности

BearingTol

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

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

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

Двойной точности

NavLatency

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

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

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

Двойной точности

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

  • SourceID
  • SourceOID
  • PosAlong
  • SideOfEdge

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

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

LineBarriers

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

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

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

Name

Имя барьера.

Строка

BarrierType

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

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

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

Короткое целое

ScaledTimeFactor

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

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

Двойной точности

ScaledDistanceFactor

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

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

Двойной точности

ScaledCostFactor

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

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

Двойной точности

Locations

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

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

Blob

PolygonBarriers

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

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

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

Name

Имя барьера.

Строка

BarrierType

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

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

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

Короткое целое

ScaledTimeFactor

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

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

Двойной точности

ScaledDistanceFactor

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

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

Двойной точности

ScaledCostFactor

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

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

Двойной точности

Locations

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

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

Blob