FindRoutes (Маршрут)

Краткая информация

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

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

Примечание:

При использовании FindRoutes для прокладки маршрутов для нескольких транспортных средств, необходимо распределить остановки по маршрутам перед запуском задачи. Если вам требуется инструмент для определения наилучшего способа распределения остановок по транспортным средствам, а затем по маршрутам, вместо него используйте инструмент SolveVehicleRoutingProblem.

Рисунок

Использование

• Инструмент находит кратчайшие маршруты на основе времени в пути, если для параметра Единицы измерения (Measurement Units) используются единицы времени, и на основе расстояния, если используются единицы измерения расстояний.

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

• Вы можете добавить до 250 точечных барьеров. Вы можете добавить любое количество линейных или полигональных барьеров, но линейные барьеры не могут пересекать более 500 объектов-улиц, а полигональные – более 2,000 объектов.

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

• Независимо от того, включен ли параметр Использовать иерархию (Use Hierarchy) (True), иерархия всегда используется, если прямолинейное расстояние между любой парой остановок составляет более 50 миль (80.46 км).

• Если расстояние между входной точкой и ближайшей проезжей улицей больше 12.42 миль (20 км), точка исключается из анализа.

Синтаксис

FindRoutes_naagol (Stops, Measurement_Units, {Analysis_Region}, {Reorder_Stops_to_Find_Optimal_Routes}, {Preserve_Terminal_Stops}, {Return_to_Start}, {Use_Time_Windows}, {Time_of_Day}, Time_Zone_for_Time_of_Day, {UTurn_at_Junctions}, {Point_Barriers}, {Line_Barriers}, {Polygon_Barriers}, {Use_Hierarchy}, {Restrictions}, {Attribute_Parameter_Values}, {Route_Shape}, {Route_Line_Simplification_Tolerance}, {Populate_Route_Edges}, {Populate_Directions}, {Directions_Language}, {Directions_Distance_Units}, {Directions_Style_Name})

Параметр	Объяснение	Тип данных
Stops	Задайте две или более остановок для определения маршрута между ними. Вы можете добавить до 10,000 остановок и присвоить до 150 остановок каждому маршруту. (Распределяйте остановки по маршрутам с помощью атрибута RouteName.) При указании остановок вы можете задать с помощью атрибутов свойства каждой из них, такие как имя или время обслуживания. Для задания свойств остановок можно использовать следующие атрибуты: Имя (Name) – название остановки. Имя используется в путевом листе. Если имя не указано, в выходных остановках, маршрутах и путевом листе автоматически создается уникальное имя с префиксом Location. RouteName – имя маршрута, к которому относится остановка. Присвоение различным остановкам одного и того же имени маршрута приводит к группировке остановок, т.е. все они будут включены в один маршрут. Вы можете создавать несколько маршрутов за один раз, присваивая уникальные имена маршрутов различным группам остановок. С помощью этого инструмента вы можете группировать до 150 остановок на один маршрут. Последовательность (Sequence) – выходные маршруты пройдут по остановкам в том порядке, который задан этим атрибутом. В пределах группы остановок с одинаковым значением RouteName порядковый номер должен быть больше 0, но не должен превышать максимальное число остановок. Кроме того, порядковый номер не должен дублироваться. Если параметр Изменить порядок остановок для нахождения оптимального маршрута (Reorder Stops To Find Optimal Routes) включен (True), все значения последовательности, кроме первого и последнего, игнорируются, поэтому инструмент может определить последовательность, минимизирующую общую протяженность маршрута. (Параметры Сохранить порядок остановок (Preserve Ordering of Stops) и Возврат в начало (Return to Start) определяют, будут ли игнорироваться первое и последнее значения последовательности.) AdditionalTime – время, затраченное на остановке, которое добавляется к общему времени маршрута. Единицы измерения для этого атрибута задаются параметром Единицы измерения (Measurement Units). Значение атрибута включается в анализ, только когда единицами измерения являются единицы времени. По умолчанию значение равно 0. Вы можете учитывать дополнительное время, необходимое для завершения задачи на остановке например, починка прибора, вручение посылки или проверка разрешений. AdditionalDistance – дополнительное расстояние, пройденное на остановке, которое добавляется к общей протяженности маршрута. Единицы измерения для этого атрибута задаются параметром Единицы измерения (Measurement Units). Значение атрибута включается в анализ, только когда единицами измерения являются единицы расстояния. По умолчанию значение равно 0. Обычно расположение остановки, например, Дом, находится не на самой улице, а на некотором удалении от проезжей части. Значение этого атрибута может использоваться для учета расстояния между действительным местоположением остановки и ее положением на улице, если имеет смысл включать это расстояние в общую протяженность пути. TimeWindowStart – самое раннее время посещения остановки. Убедитесь, что значение имеет формат даты-времени, например, 8/12/2015 12:15 PM. Задавая начало и окончание временного окна посещения остановки, можно указать, когда именно маршрут достигнет этой остановки. Если параметр Использовать временные окна (Use Time Windows) включен и для Единиц измерения (Measurement Units) выбрано время, инструмент попытается найти решение, минимизирующее расстояние маршрута и позволяющее посетить остановку в указанное временное окно. При решении задачи, которая охватывает несколько часовых поясов, значения временного окна каждой остановки соответствуют ее часовому поясу. Поле может содержать нулевое значение (null), это означает, что маршрут должен достичь остановки в любое время, до заданного параметром TimeWindowEnd. Если параметр TimeWindowEnd также содержит значение null, маршрут может посетить эту остановку в любое время. TimeWindowEnd – самое позднее время посещения остановки. Убедитесь, что значение имеет формат даты-времени, например, 8/12/2015 12:15 PM. Задавая начало и окончание временного окна посещения остановки, можно указать, когда именно маршрут достигнет этой остановки. Если параметр Использовать временные окна (Use Time Windows) включен и для Единиц измерения (Measurement Units) выбрано время, инструмент попытается найти решение, минимизирующее расстояние маршрута и позволяющее посетить остановку в указанное временное окно. При решении задачи, которая охватывает несколько часовых поясов, значения временного окна каждой остановки соответствуют ее часовому поясу. Поле может содержать нулевое значение (null), это означает, что маршрут должен достичь остановки в любое время, после заданного параметром TimeWindowStart. Если параметр TimeWindowStart также содержит значение null, маршрут может посетить эту остановку в любое время. CurbApproach – указывает направление, в котором транспортное средство может подъехать или отъехать от остановки. Значение поля указывается одним из следующих целых чисел (используйте числовой код, а не имя в скобках): 0 (С любой стороны) – транспортное средство может подъезжать и отъезжать от остановки в любом направлении, т.е. в месте остановки разрешен разворот. Данный параметр можно выбрать, если возле остановки можно развернуться и это удобно. Такое решение может зависеть от ширины дороги и интенсивности движения или от наличия на остановке места для стоянки, где транспортное средство может выполнить разворот. 1 (Справа по направлению движения) – когда транспортное средство подъезжает или отъезжает от остановки, она должна находиться по правую сторону транспортного средства. Разворот запрещен. Эта опция обычно используется для таких транспортных средств, как автобусы, которые должны подъезжать к автобусной остановке так, чтобы она находилась справа. 2 (Слева по направлению движения) – когда транспортное средство подъезжает и отъезжает от остановки, бордюр должен находиться с левой стороны транспортного средства. Разворот запрещен. Эта опция обычно используется для таких транспортных средств, как автобусы, которые должны подъезжать к автобусной остановке так, чтобы она находилась слева. 3 (Нет разворота) – при подъезде транспортного средства к остановке бордюр может располагаться с любой стороны транспортного средства. Но при отправлении транспортное средство не должно выполнять разворот. Свойство CurbApproach было разработано для работы с обоими типами национальных стандартов дорожного движения: правостороннего (США) и левостороннего (Великобритания). Для начала рассмотрим случай, когда остановка располагается с левой стороны транспортного средства. Это условие должно обязательно выполняться в независимости от того движется транспорт по левой или по правой полосе дороги. Вы можете выбрать, с какой из двух сторон подъехать к остановке, независимо от национального стандарта дорожного движения, т.е. где будет находится точка заказа – справа или слева от транспортного средства. Например, если необходимо подходить к остановке так, чтобы отсутствовала полоса движения между транспортным средством и остановкой, то в США необходимо выбрать правую сторону транспорта (1), а в Великобритании левую сторону (2).	Feature Set
Measurement_Units	Укажите единицы, которые должны использоваться для измерения и указания общей продолжительности или протяженности пути для выходных маршрутов. Единицы, выбранные для этого параметра, определяют, будет ли инструмент измерять протяженность или продолжительность пути для нахождения наилучшего маршрута. Выберите единицы времени для минимизации времени в пути. Для минимизации протяженности пути выберите единицы расстояния. Выбранные вами единицы инструмент будет использовать также для указания общей продолжительности или протяженности пути в результатах. Можно выбрать следующие варианты: Метры (Meters) Километры (Kilometers) Футы (Kilometers) Ярды (Yards) Мили (Miles) Морские мили (NauticalMiles) Секунды (Seconds) Минуты (Minutes) Часы (Hours) Дни (Days)	String
Analysis_Region (дополнительно)	Укажите регион, в котором выполняется анализ. Если значение этого параметра не указано, инструмент автоматически вычислит имя региона на основе местоположения входных точек. Задание имени региона рекомендуется для увеличения скорости работы инструмента. Чтобы задать регион используйте одно из следующих значений: Europe (Европа) India (Индия) Japan (Япония) Korea (Корея) MiddleEastAndAfrica (Средний Восток и Африка) NorthAmerica (Северная Америка) Oceania (Океания) SouthAmerica (Южная Америка) SouthEastAsia (Юго-Восточная Азия) Тайвань Таиланд	String
Reorder_Stops_to_Find_Optimal_Routes (дополнительно)	Позволяет выбрать посещение остановок в указанном вами порядке или в порядке, определяемом инструментом для минимизации общей протяженности маршрута. Отмечена (Истина) (Checked (True)): Порядок остановок соответствует заданному вами порядку. Это является опцией по умолчанию. Порядок посещения остановок можно задать с помощью атрибута Sequence входных объектов-остановок или разрешить определение порядка по ID объектов-остановок. Не отмечена (Ложь) (Unchecked (False)): Инструмент определит порядок посещения с минимальной длиной маршрута или временем в пути. Порядок остановок может быть изменен в соответствии с временным окном. Дополнительные параметры позволяют сохранить первую и последнюю остановки, разрешив инструменту изменить порядок промежуточных остановок. Определение оптимального порядка остановок и поиск наилучшего маршрута часто называется задачей по поиску маршрута коммивояжера (TSP).	Boolean
Preserve_Terminal_Stops (дополнительно)	Когда параметр Изменить порядок остановок для нахождения оптимальных маршрутов (Reorder Stops to Find Optimal Routes) включен (или True), вы можете сохранить последовательность первой и последней остановок и позволить инструменту изменить порядок остальных. Первая и последняя остановки определяются по атрибутивным значениям Sequence или, если значения Sequence равны null, по значениям Object ID. Сохранить первую остановку (Preserve First): Инструмент не будет изменять порядок первой остановки. Выберите эту опцию, если вы начинаете маршрут из известного места, такое как дом, штаб-квартира или текущее положение. Сохранить последнюю остановку (Preserve Last): Инструмент не будет изменять порядок последней остановки. Маршруты могут начинаться с любой остановки, но должны заканчиваться в указанной. Сохранить первую и последнюю остановку (Preserve First and Last): Инструмент не будет менять порядок первой и последней остановок. Не сохранять ни одну (Preserve None): Инструмент может изменить порядок любой остановки, включая первую и последнюю. Маршрут может начинаться и заканчиваться на любой остановке. Параметр Сохранить конечные остановки (Preserve Terminal Stops) игнорируется при отключении (или False) параметра Изменить порядок остановок для нахождения оптимальных маршрутов (Reorder Stops to Find Optimal Routes).	String
Return_to_Start (дополнительно)	Выберите, должен ли маршрут начинаться и заканчиваться в одном и том же месте. С помощью этой опции можно избежать дублирования первой остановки для ее использования также в качестве конечной. Начало маршрута является остановкой с наименьшим значением атрибута Sequence. Если значения атрибута Sequence являются нулевыми, это будет объект с наименьшим значением Object ID. Отмечена (Истина) (Checked (True)): Маршрут будет начинаться и заканчиваться на первой остановке. Это значение используется по умолчанию. Когда оба параметра, Изменить порядок остановок для нахождения оптимальных маршрутов (Reorder Stops to Find Optimal Routes) и Возврат в начало (Return to Start), включены (или True), в параметре Сохранить конечные остановки (Preserve Terminal Stops) необходимо выбрать значение Сохранить первую остановку. Не отмечена (Ложь) (Unchecked (False)): Маршрут не будет начинаться и заканчиваться на первой остановке.	Boolean
Use_Time_Windows (дополнительно)	Включите эту опцию (или установите значение True), если какая-либо из остановок имеет временное окно, задающее время прибытия. Вы можете добавить временные окна к входным остановкам, введя значения времени в атрибуты TimeWindowStart и TimeWindowEnd. Отмечена (Истина) (Checked (True)): Входные остановки имеют временные окна и инструмент должен их учитывать. Не отмечена (Ложь) (Unchecked (False)): Входные остановки не имеют временных окон, а если имеют, вы не хотите учитывать их. Это значение используется по умолчанию. При включении опции Использовать временные окна (Use Time Windows) (или True), инструмент будет работать немного дольше, даже если ни одна из остановок не имеет временного окна, поэтому эту опцию по возможности рекомендуется отключать (задавать False).	Boolean
Time_of_Day (дополнительно)	Указывает время и дату начала маршрутов. Если вы указываете в качестве значения этого параметра текущие дату и время, при нахождении наилучших маршрутов инструмент будет использовать текущие условия дорожного движения, и общее время пути будет учитывать условия дорожного движения. Указание времени суток позволяет создавать более точные маршруты и точнее оценивать время в пути, поскольку будут учтены условия дорожного движения в конкретный день и час. Параметр Часовой пояс для времени суток (Time Zone for Time of Day) определяет, как будут указываться время и дата, в UTC или в часовом поясе, в котором находится остановка. Инструмент игнорирует этот параметр, если в Единицах измерения (Measurement Units) не выбрано время.	Date
Time_Zone_for_Time_of_Day	Указывает часовой пояс параметра Время суток (Time of Day). Географически локальное (Geographically Local): Значение параметра Время дня (Time of Day) относится к часовому поясу, в котором находится первая остановка маршрута. Если вы создаете несколько маршрутов в различных часовых поясах, время начала будет отсчитываться от Всемирного координированного времени (UTC). Например, если Время дня (Time of Day) имеет значение 2-е Января, 10:00 a.m., это означает, что маршрут начнется в 10:00 утра Восточное время (3.00 p.m. по UTC) для часового пояса Восточное время, и в 10:00 утра Центральное поясное время (4:00 p.m. по UTC) для часового пояса Центральное время. Время начала по UTC будет отличаться на один час. Время и дата прибытия и отправления, записанные в выходном классе объектов-остановок, будут соответствовать часовому поясу первой остановки каждого маршрута. UTC: Значения параметра Время дня (Time of Day) указываются во Всемирном координированном времени (UTC). Используйте эту опцию, если вы хотите создать маршрут для определенного времени, например текущего, но точно не знаете, в каком часовом поясе будет находиться первая остановка. Если вы создаете несколько маршрутов, охватывающих различные часовые пояса, время начала по UTC будет синхронизировано. Например, если Время дня (Time of Day) имеет значение 2-е Января, 10:00 a.m., это означает, что маршрут начнется в 5:00 утра по Стандартному Восточному времени (UTC-5:00) для часового пояса Восточное время, и в 4:00 утра по Центральному стандартному времени (UTC-6:00) для маршрутов в часовом поясе Центральное время. Оба маршрута начнутся в 10:00 утра по UTC. Время и дата прибытия и отправления, записанные в выходном классе объектов-остановок, будут соответствовать времени UTC.	String
UTurn_at_Junctions (дополнительно)	Правила разворота на соединениях. При разрешении U-образных разворотов неявно предполагается, что механизм расчета позволяет разворот на соединении и продолжение движения по той же улице в обратную сторону. Учитывая, что соединения представляют собой пересечения улиц и тупики, различные транспортные средства могут разворачиваться на некоторых соединениях, но не на всех – это зависит от того, является ли соединение перекрестком или тупиком. Для соответствия, параметр правил разворотов в неявном виде указывает количество ребер, или улиц, участвующих в соединении, что представляет валентность соединения. Ниже приведены допустимые значения для данного параметра; каждое из них сопровождается описанием значения в терминах валентности соединения. Разрешено (Allowed): Развороты разрешены в соединениях с любым количеством смежных ребер или улиц. Это значение используется по умолчанию. Не разрешено (Not Allowed): Развороты запрещены во всех соединениях, вне зависимости от их валентности. Разрешено только в тупиках (Allowed only at Dead Ends): Развороты запрещены во всех соединениях, кроме тех, у которых имеется только одно смежное ребро (тупик). Разрешено только на пересечениях и в тупиках (Allowed only at Intersections and Dead Ends): Развороты запрещены в соединениях с ровно двумя смежными ребрами, но разрешены на перекрестках (в соединениях с тремя смежными ребрами или более) и в тупиках (соединениях с ровно одним смежным ребром). Зачастую, моделирующие улицы сети имеют избыточные соединения в середине сегментов дороги. Эта опция позволяет запретить развороты транспортных средств в таких местах.	String
Point_Barriers (дополнительно)	Укажите одну или несколько точек, действующих в качестве временных ограничений или представляющих дополнительное время или расстояние, которые могут потребоваться для передвижения по улицам. Например, точечный барьер может быть использован для обозначения упавшего дерева или для ввода времени ожидания на железнодорожном переезде. Инструмент может накладывать до 250 ограничений, точек, добавленных в качестве барьеров. При указании точечных барьеров вы можете задать с помощью атрибутов свойства каждого из них, такие как тип барьера. Для задания свойств точечных барьеров можно использовать следующие атрибуты: Name: имя барьера. BarrierType: указывает, ограничивает ли точечный барьер перемещение полностью или добавляет время или расстояние при его пересечении. Значение этого атрибута указывается одним из следующих целых чисел (используйте числовой код, а не имя в скобках): 0 (Restriction) – запрещает прохождение через барьер. Барьер, действующий как запрещающий, рассматривается как ограничительный точечный барьер. 2 (Added Cost) – прохождение через барьер увеличивает время в пути или расстояние на значение, указанное в полях Additional_Time или Additional_Distance. Этот тип барьера называется барьером дополнительной стоимости. Additional_Time: указывает, какое время пути добавляется при прохождении барьера. Это поле действительно только для барьеров с дополнительной стоимостью, и только если используются единицы измерения времени. Значение этого поля должно быть больше или равно нулю, а его единицы измерения соответствуют заданным в параметре Measurement Units. Additional_Distance: указывает, какое расстояние добавляется при прохождении барьера. Это поле действительно только для барьеров с дополнительной стоимостью, и только если используются единицы измерения расстояния. Значение этого поля должно быть больше или равно нулю, а его единицы измерения соответствуют заданным в параметре Measurement Units.	Feature Set
Line_Barriers (дополнительно)	Укажите одну или несколько линий, которые запрещают передвижение там, где они пересекают улицы. Например, при помощи линейного барьера можно смоделировать маршрут парада или марша протеста, которые препятсвуют движению по нескольким участкам улиц. Линейный барьер может также быстро запретить пересечение нескольких дорог, отделяя, таким образом, возможный маршрут от нежелательных участков уличной сети. Инструмент имеет ограничение числа улиц, которые можно запретить с помощью параметра Line Barriers. Хотя лимита на число линий, которые можно использовать как барьеры, нет, общее число улиц, пересекаемых всеми линиями, не должно превышать 500. При указании линейных барьеров вы можете задать с помощью атрибута свойство имени для каждого из них. Name: имя барьера.	Feature Set
Polygon_Barriers (дополнительно)	Укажите полигоны, которые либо полностью запрещают передвижение, либо пропорционально масштабируют время или расстояние, необходимое для передвижения по улицам, пересекаемым полигоном. Сервис имеет ограничение числа улиц, которые можно запретить с помощью параметра Polygon Barriers. Хотя лимита на число полигонов, которые можно использовать как барьеры, нет, общее число улиц, пересекаемых всеми полигонами, не должно превышать 2,000. При указании полигональных барьеров вы можете задать с помощью атрибутов свойства каждого из них, такие как тип барьера. Для задания свойств полигональных барьеров можно использовать следующие атрибуты: Name: имя барьера. BarrierType: указывает, ограничивает ли барьер перемещение полностью или масштабирует время или расстояние при прохождении по нему. Значение поля указывается одним из следующих целых чисел (используйте числовой код, а не имя в скобках): 0 (Restriction) – запрещает прохождение через любую часть барьера. Этот барьер называется запрещающим полигональным барьером, поскольку он запрещает перемещение по пересекаемым улицам. Одним из применений этого типа барьеров является моделирование наводнений, покрывающих улицы, и перемещение по ним становится невозможным. 1 (Scaled Cost) – масштабирует время или расстояние, необходимое для перемещения по соответствующим улицам на коэффициент, указанный в поле ScaledTimeFactor или ScaledDistanceFactor. Если улицы частично покрыты барьером, время в пути или расстояние будет соответственно разделены, а затем масштабированы. Например, коэффициент 0,25 означает, что ожидаемое время перемещения по соответствующим улицам в четыре раза меньше обычного. Коэффициент 3,0 означает, что ожидаемое время перемещения будет в три раза дольше обычного. Этот тип барьера называется полигональным барьером масштабируемой стоимости. Он может использоваться для моделирования погодных условий, из-за которых скорость перемещения в указанных регионах снижается. ScaledTimeFactor: это коэффициент, на который умножается время езды по улицам, пересекающимся с барьером. Это поле действительно только для барьеров с масштабированной стоимостью, и только если используются единицы измерения времени. Значение поля должно быть больше нуля. ScaledDistanceFactor: это коэффициент, на который умножается длина пути по улицам, пересеченным барьером. Этот атрибут действителен только для барьеров с масштабированной стоимостью, и только если используются единицы измерения расстояния. Значение атрибута должно быть больше нуля.	Feature Set
Use_Hierarchy (дополнительно)	Укажите, должна ли использоваться иерархия при нахождении кратчайшего пути между остановками. Отмечена (Истина) (Checked (True)): Использовать иерархию при нахождении маршрутов. Когда используется иерархия, инструмент предпочитает улицы более высокого порядка (такие как скоростные автострады) улицам более низкого порядка (таким как местные дороги), и может использоваться для моделирования предпочтения водителей передвигаться по автострадам, а не местным дорогам, даже если это удлиняет путь. Особенно это относится к тем случаям, когда нужно определить маршруты к удаленным местам, поскольку водители предпочитают использовать в дальних поездках скоростные автострады без светофоров, перекрестков и поворотов. Использование иерархии ускоряет вычисления, особенно в случае протяжённых маршрутов, поскольку инструмент может определить лучший маршрут из сравнительно небольшого поднабора улиц. Не отмечена (Ложь) (Unchecked (False)): Не использовать иерархию при нахождении маршрутов. Если иерархия не используется, инструмент перебирает при определении маршрута все улицы и не отдает предпочтение улицам более высокого порядка. Этот вариант обычно используется при нахождении коротких маршрутов в пределах города. Инструмент автоматически начинает использовать иерархию, если расстояние по прямой между пунктами обслуживания и точками спроса превышает 50 миль (80.46 км), даже если в этом параметре указано иное.	Boolean
Restrictions (дополнительно)	Укажите, какие ограничения должны учитываться инструментом при нахождении наилучшего маршрута. Ограничение представляет собой предпочтение или требование во время поездки. В большинстве случаев, ограничения приводят к запрету проезда по дорогам, но они также могут указывать, избегать дорогу или наоборот, предпочесть ее. Например, использование ограничения Избегать платных дорог приведет к тому, что платные дороги будут использоваться, только если это абсолютно необходимо для посещения остановки. Ограничение по высоте (Height Restriction) позволяет прокладывать маршрут в обход всех объектов с пролетами, меньшими, чем высота транспортного средства. Если транспортное средство перевозит коррозионные вещества, применение ограничения Any Hazmat Prohibited (Вредные вещества запрещены) предотвратит перевозку таких материалов по тем дорогам, по которым это запрещено. Ниже приводится список доступных ограничений и их краткое описание. Примечание: Использование некоторых ограничений требует ввода дополнительных значений. Это значение должно быть связано с именем ограничения и определенным параметром, предназначенным для его работы. Вы можете идентифицировать такие ограничения по их названиям, отображающимся под столбцом AttributeName в параметре Attribute Parameter Values. Поле ParameterValue следует использовать в параметре Attribute Parameter Values для правильного использования ограничения при поиске доступных дорог. Примечание: Некоторые ограничения поддерживаются только в определенных странах; их доступность по регионам указана в списке ниже. Кроме доступности ограничений по регионам, можно проверить его доступность в определенной стране по таблице в разделе Список стран на веб-странице Покрытие данными для сервисов сетевого анализа. Если для страны указано значение Yes в столбце Logistics Attribute, ограничение в этой стране поддерживается и доступно для региона. Если вы задаете имена ограничений, которые недоступны в стране, где находятся инциденты, сервис игнорирует их. Сервис также игнорирует ограничения чье значение параметра Использование ограничений находится в пределах от 0 до 1 (см. свойство Значения параметра атрибутов). Он запрещает все ограничения, чье значение параметра Использование ограничения больше 0. Инструмент поддерживает следующие ограничения: Any Hazmat Prohibited (Вредные вещества запрещены) – в маршрут не включаются дороги, по которым запрещена перевозка любых видов опасных веществ. Доступность: Выберите страны в Северной Америке и Европе Avoid Carpool Roads (Избегать дорог для пассажирских перевозок) – в маршрут не будут включаться дороги, предназначенные исключительно для пассажирских перевозок (автобусы и т.д.). Доступность: Все страны Avoid Express Lanes (Избегать скоростных полос) – в маршрут не будут включаться дороги, предназначенные для скоростного передвижения. Доступность: Все страны Avoid Ferries (Избегать паромных переправ) – в маршруте не будут использоваться паромные переправы. Доступность: Все страны Avoid Gates (Избегать ворот) – в маршрут не будут включаться дороги, на которых имеются ворота для въезда по пропуску или охраняемые въезды. Доступность: Все страны Avoid Limited Access Roads (Избегать дорог с ограниченным доступом) – в маршрут не будут включаться дороги с ограниченным доступом. Доступность: Все страны Avoid Private Roads (Избегать частных дорог) – в маршрут не будут включаться частные дороги. Доступность: Все страны Avoid Toll Roads (Избегать платных дорог) – в маршруте не будут использоваться платные дороги. Доступность: Все страны Avoid Unpaved Roads (Избегать дорог без покрытия) – в маршрут не будут включаться дороги без покрытия (например, грунтовые, с гравийным покрытием и т.д.). Доступность: Все страны Axle Count Restriction (Ограничение по числу осей) в маршрут не будут включаться дороги, на которых запрещены грузовики с указанным числом осей. Число осей задается параметром Number of Axles. Доступность: Выберите страны в Северной Америке и Европе Driving a Bus (На автобусе) – в маршрут не будут включаться дороги, по которым запрещено движение автобусов. Использование этого ограничения также позволяет учитывать в маршруте дороги с односторонним движением. Доступность: Все страны Driving a Delivery Vehicle (Автотранспорт для доставки) – в маршрут не будут включаться дороги, по которым запрещено движение автотранспорта для доставки. Использование этого ограничения также позволяет учитывать в маршруте дороги с односторонним движением. Доступность: Все страны Driving a Taxi (На такси) – в маршрут не будут включаться дороги, по которым запрещено движение такси. Использование этого ограничения также позволяет учитывать в маршруте дороги с односторонним движением. Доступность: Все страны Driving a Truck (На грузовике) – в маршрут не будут включаться дороги, по которым запрещено движение грузовиков. Использование этого ограничения также позволяет учитывать в маршруте дороги с односторонним движением. Доступность: Все страны Driving a Automobile (На автомобиле) – в маршрут не будут включаться дороги, по которым запрещено движение автомобилей. Использование этого ограничения также позволяет учитывать в маршруте дороги с односторонним движением. Доступность: Все страны Driving an Emergency Vehicle (Аварийно-спасательный автомобиль) – в маршрут не будут включаться дороги, по которым запрещено движение аварийно-спасательных автомобилей. Использование этого ограничения также позволяет учитывать в маршруте дороги с односторонним движением. Доступность: Все страны Height Restriction (Ограничение по высоте) – в маршрут не будут включаться дороги, по которым запрещено движение автомобилей больше разрешенной высоты. Высота транспортного средства задается параметром Vehicle Height (в метрах). Доступность: Выберите страны в Северной Америке и Европе Kingpin to Rear Axle Length Restriction (Ограничение по ширине заноса задней оси) – в маршрут не будут включаться дороги, по которым запрещено движение всех грузовиков с шириной заноса задней оси больше разрешенной. Это значение задается параметром Vehicle Kingpin to Rear Axle Length (метры). Доступность: Выберите страны в Северной Америке и Европе Length Restriction (Ограничение по длине) – в маршрут не будут включаться дороги, по которым запрещено движение автомобилей больше разрешенной длины. Длина транспортного средства задается параметром Vehicle Length (в метрах). Доступность: Выберите страны в Северной Америке и Европе Riding a Motorcycle (На мотоцикле) – в маршрут не будут включаться дороги, по которым запрещено движение мотоциклов. Использование этого ограничения также позволяет учитывать в маршруте дороги с односторонним движением. Доступность: Все страны Roads Under Construction Prohibited (Ремонт дороги) – в маршрут не будут включаться ремонтируемые дороги. Доступность: Все страны Semi or Tractor with One or More Trailers Prohibited (Запрет тягачей с одним или более трейлерами) – в маршрут не будут включаться дороги, на которых запрещено движение тягачей с одним или более трейлерами. Доступность: Выберите страны в Северной Америке и Европе Single Axle Vehicles Prohibited (Запрет одноосных транспортных средств) – в маршрут не будут включаться дороги, на которых запрещены одноосные транспортные средства. Доступность: Выберите страны в Северной Америке и Европе Tandem Axle Vehicles Prohibited (Запрет транспортных средств со сдвоенными осями) – в маршрут не будут включаться дороги, на которых запрещены транспортные средства со сдвоенными осями. Доступность: Выберите страны в Северной Америке и Европе Through Traffic Prohibited (Запрет сквозного проезда) – в маршрут не включаются дороги, по которым запрещен сквозной (не локальный) проезд. Доступность: Все страны Truck with Trailers Restriction (Грузовик с прицепом) – в маршрут не будут включаться дороги, на которых запрещены грузовики с прицепом. Число прицепов задается параметром Number of Trailers on Truck. Доступность: Выберите страны в Северной Америке и Европе Use Preferred Hazmat Routes (Использовать маршруты для вредных веществ) – маршрут пройдет по дорогам, которые предназначены для перевозки опасных веществ. Доступность: Выберите страны в Северной Америке и Европе Use Preferred Truck Routes (Использовать маршруты для грузовиков) – маршруты будут, по возможности, проходить по дорогам, которые предназначены для грузовиков, например, по дорогам, которые являются частью национальной дорожной сети, как указано в National Surface Transportation Assistance Act для США, или по дорогам, которые предназначены для грузовиков в штатах или провинциях, или по дорогам, которые предпочитают водители. Доступность: Выберите страны в Северной Америке и Европе Walking (Пешеходные) – в маршрут не будут включаться дороги, по которым запрещено пешее перемещение. Доступность: Все страны Weight Restriction (Ограничение по весу) – в маршрут не будут включаться дороги, по которым запрещено движение автомобилей больше разрешенной массы. Вес транспортного средства задается параметром Vehicle Weight (в килограммах). Доступность: Выберите страны в Северной Америке и Европе Weight per Axle Restriction (Ограничение по нагрузке на ось) – в маршрут не будут включаться дороги, по которым запрещено движение автомобилей с нагрузкой на ось больше разрешенной. Нагрузка на ось задается параметром Vehicle Weight per Axle (в килограммах). Доступность: Выберите страны в Северной Америке и Европе Width Restriction (Ограничение по ширине) – в маршрут не будут включаться дороги, по которым запрещено движение автомобилей больше разрешенной ширины. Ширина транспортного средства задается параметром Vehicle Width (в метрах). Доступность: Выберите страны в Северной Америке и Европе	String
Attribute_Parameter_Values (дополнительно)	Укажите дополнительные значения, требуемые для некоторых ограничений, такие как вес транспортного средства для ограничения по весу (Weight Restriction). Вы можете использовать этот параметр, чтобы указать, является ли движение по дорогам, для которых установлено это ограничение, запрещенным, нежелательным или предпочтительным. Если ограничение означает нежелательность или предпочтительность использования дороги, вы можете дополнительно указать с помощью этого параметра степень нежелательности или предпочтительности. Например, вы можете установить для платных дорог правило никогда их не использовать, по возможности избегать или наоборот, отдавать им предпочтение. Если вы задаете параметр Значения атрибутивного параметра (Attribute Parameter Values) из класса пространственных объектов, имена полей класса пространственных объектов должны соответствовать следующим: AttributeName: указывает имя ограничения. ParameterName: указывает имя параметра, связанного с ограничением. В зависимости от целей ограничения, оно может иметь одно или несколько значений поля ParameterName. ParameterValue: значение для ParameterName, используемое инструментом при оценке ограничения. Параметр Значения атрибутивного параметра (Attribute Parameter Values) зависит от параметра Ограничения (Restrictions). Поле ParameterValue применяется, только если значением параметра Ограничения (Restrictions) является имя ограничения. В параметре Значения атрибутивного параметра (Attribute Parameter Values) каждое ограничение (AttributeName) содержит значение поля ParameterName, Использование ограничения (Restriction Usage), определяющее запрет, нежелательность или предпочтительность использования дорог, для которых установлено ограничение, а также степень нежелательности или предпочтительности использования дорог. Поле Использование ограничения (Restriction Usage) ParameterName может иметь одно из следующих строковых значений или эквивалентных числовых значений, указанных в скобках: PROHIBITED (-1) – Передвижение по дорогам, имеющим это ограничение, полностью запрещено. AVOID_HIGH (5) – Крайне маловероятно, что инструмент включит в маршрут дороги с этим ограничением. AVOID_MEDIUM (2) – Маловероятно, что инструмент включит в маршрут дороги с этим ограничением. AVOID_LOW (1.3) – Достаточно маловероятно, что инструмент включит в маршрут дороги с этим ограничением. PREFER_LOW (0.8) – Достаточно вероятно, что инструмент включит в маршрут дороги с этим ограничением. PREFER_MEDIUM (0.5) – Вероятно, что инструмент включит в маршрут дороги с этим ограничением. PREFER_HIGH (0.2) – Очень вероятно, что инструмент включит в маршрут дороги с этим ограничением. Как правило для поля Использование ограничения (Restriction Usage) используется значение по умолчанию, PROHIBITED, если ограничение связано с характеристиками транспортного средства, например его высотой. Однако в некоторых случаях значение поля Использование ограничения (Restriction Usage) будет зависеть от ваших предпочтений при выборе маршрута. Например, для ограничения Избегать платных дорог (Avoid Toll Roads) параметр Использование ограничения (Restriction Usage) имеет по умолчанию значение AVOID_MEDIUM. Это означает, что, при наличии данного ограничения инструмент будет по возможности избегать использования платных дорог при построении маршрута. Значение AVOID_MEDIUM также указывает, насколько важно избегать использования платных дорог при поиске лучшего маршрута: это ограничение имеет средний приоритет. При выборе AVOID_LOW исключение платных дорог из маршрута будет иметь меньшее значение, а при выборе AVOID_HIGH – большее, поэтому сервис будет создавать более длинные маршруты, чтобы по возможности избежать использования платных дорог. При выборе PROHIBITED использование платных дорог будет полностью запрещено, и сервис не сможет включать их в маршрут. Следует помнить, что в некоторых случаях целью анализа является прокладка маршрута в обход платных дорог, а в других случаях проезд по платным дорогам может быть предпочтителен, поскольку время, потраченное на движение, более ценно, чем деньги, уплаченные за проезд. В последнем случае для параметра Использование ограничения (Restriction Usage) следует выбрать значения PREFER_LOW, PREFER_MEDIUM или PREFER_HIGH. Чем выше предпочтительность, тем в большей степени маршрут будет проходить по дорогам с этим ограничением.	Record Set
Route_Shape (дополнительно)	Укажите тип объектов маршрута, получаемых на выходе инструмента. Параметр может быть задан с помощью одного из следующих значений: Истинная форма (True Shape): Возврат точной геометрии выходного маршрута, на основе исходных улиц. Прямая линия (Straight Line): Возврат прямой линии между двумя остановками. Ни одна: Не возвращать геометрию маршрутов. Это значение можно использовать (и быстро получать результаты) в тех случаях, когда нужно определить только общую продолжительность или время пути маршрута. Когда параметр Форма маршрута (Route Shape) имеет значение Истинная форма (True Shape), генерализацией формы маршрута можно дополнительно управлять, выбирая значение параметра Допуск упрощения линии маршрута (Route Line Simplification Tolerance). Независимо от выбранного значения параметра Геометрия маршрута (Route Shape), лучший маршрут определяется всегда на основе минимальной продолжительности или протяженности пути, а не на основе расстояния по прямой между остановками. Это значит, что изменяются только формы маршрута, а не исходные улицы, которые перебирает инструмент при нахождении маршрута.
Route_Line_Simplification_Tolerance (дополнительно)	Определяет степень упрощения геометрии выходных линий маршрутов, направлений и маршрутных листов. Инструмент игнорирует этот параметр, если значение параметра Форма маршрута (Route Shape) отличается от Истинная форма (True Shape). При упрощении сохраняются важнейшие точки на маршруте, например, повороты и перекрестки, составляющую основную форму маршрута, а остальные точки удаляются. Указываемое вами расстояние упрощения является максимальным допустимым смещением упрощенной линии от исходной. Упрощение линии сокращает количество вершин в геометрии маршрута. Это ускоряет работу инструмента.	Linear unit
Populate_Route_Edges (дополнительно)	Укажите, должен ли инструмент создавать путевой лист для каждого маршрута. Путевой лист представляет собой отдельные объекты-улицы или другие объекты, по которым проходит маршрут. Выходной слой Route Edges обычно используется для просмотра улиц, наиболее и наименее посещаемых данным маршрутом. Отмечена (Истина) (Checked (True)): Создать путевой лист. Выходной слой Route Edges заполняется линейными объектами. Не отмечена (Ложь) (Unchecked (False)): Не создавать путевой лист. Выходной слой Route Edges возвращается, но не содержит объектов.
Populate_Directions (дополнительно)	Укажите, должен ли инструмент создавать путевой лист для каждого маршрута. Отмечена (Истина) (Checked (True)): Будет создан путевой лист, настроенный в соответствии со значениями параметров Язык путевого листа (Directions Language), Имя стиля путевого листа (Directions Style Name) и Единицы расстояния путевого листа (Directions Distance Units). Не отмечена (Ложь) (Unchecked (False)): Путевой лист не создается, инструмент возвращает пустой слой Directions.	Boolean
Directions_Language (дополнительно)	Укажите язык, на котором должен создаваться путевой лист. Этот параметр используется, только если параметр Заполнить путевой лист (Populate Directions) отмечен или имеет значение Истина (True). Значениями параметра могут быть следующие двух- или пятисимвольные коды языка: ar – Арабский de – Немецкий en – Английский es – Испанский et – Эстонский fr – Французский he – Иврит it – Итальянский ja – Японский ko – Корейский lt – Литовский lv – Латышский nl – Нидерландский pl – Польский pt-BR – Португальский (Бразилия) pt-PT – Португальский (Португалия) ru – Русский sv – Шведский zh-CN – Упрощенный китайский Если указан неподдерживаемый код языка, инструмент возвращает путевой лист на английском языке, являющемся языком по умолчанию.	String
Directions_Distance_Units (дополнительно)	Укажите единицы измерения для отображения расстояний в путевом листе. Этот параметр используется, только если параметр Заполнить путевой лист (Populate Directions) отмечен или имеет значение Истина (True). Мили Километры Метры Футы Ярды Морские мили	String
Directions_Style_Name (дополнительно)	Укажите имя стиля форматирования для путевого листа. Этот параметр используется, только если параметр Заполнить путевой лист (Populate Directions) отмечен или имеет значение Истина (True). Параметр может принимать следующие значения: NA Desktop: Создает готовый для печати путевой лист от поворота к повороту. NA Navigation: Создает путевой лист со всеми поворотами для автомобильного навигационного устройства.	String

Пример кода

Пример расчета Размещение-Распределение

В следующем скрипте Python показано, как использовать инструмент FindRoutes в скрипте.

import arcpy
import time
import datetime
import sys

username = "<your user name>"
password = "<your password>"
FindRoute_service = "http://logistics.arcgis.com/arcgis/services;World/Route;{0};{1}".format(username, password)

#Add the geoprocessing service as a toolbox. Use an alias when importing
arcpy.ImportToolbox(FindRoute_service, "agol")

#Set the variables to call the tool
stops = r'C:/data/Inputs.gdb/Stops'
output_routes = r'C:/data/Results.gdb/Routes'
output_route_edges = r'C:/data/Results.gdb/Route_Edges'
output_directions = r'C:/data/Results.gdb/Directions'
output_stops = r'C:/data/Results.gdb/Stops'

#Call the tool
result = arcpy.agol.FindRoutes(stops, "Minutes",
                                Reorder_Stops_to_Find_Optimal_Routes=True,
                                Preserve_Terminal_Stops="Preserve First",
                                Time_of_Day=datetime.datetime(2014, 2, 10, 8, 0, 0))

#Check the status of the result object every 0.5 seconds 
#until it has a value of 4(succeeded) or greater 
while result.status < 4:
    time.sleep(0.5)

#print any warning or error messages returned from the tool
result_severity = result.maxSeverity
if result_severity == 2:
    print "An error occured when running the tool"
    print result.getMessages(2)
    sys.exit(2)
elif result_severity == 1:
    print "Warnings were returned when running the tool"
    print result.getMessages(1)
    
#Get the output routes  and save to a local geodatabase
result.getOutput(1).save(output_routes)
result.getOutput(2).save(output_route_edges)
result.getOutput(3).save(output_directions)
result.getOutput(4).save(output_stops)

Параметры среды

Этот инструмент не использует параметры среды геообработки