FindRoutes

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

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

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

Примечание:

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

Иллюстрация

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

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

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

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

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

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

• Прямолинейное расстояние между любой парой остановок не может быть больше, чем 50 миль (80.46 километров), если параметру Режим передвижения задано значение Пешком (Walking) или Пользовательский (Custom) и используется ограничение Пешком.

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

• Данный инструмент предназначен для работы в ArcGIS Pro, ArcMap, ArcGlobe и ArcScene, но не в ArcCatalog.

Синтаксис

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}, {Travel_Mode}, {Impedance})

Параметр	Объяснение	Тип данных
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 Feet Yards Miles NauticalMiles Seconds Minutes Hours Days	String
Analysis_Region (Дополнительный)	Укажите регион, в котором выполняется анализ. Если значение этого параметра не указано, инструмент автоматически вычислит имя региона на основе местоположения входных точек. Задание имени региона рекомендуется для увеличения скорости работы инструмента. Чтобы задать регион используйте одно из следующих значений: Europe (Европа) Greece (Греция) India (Индия) Japan (Япония) Korea (Корея) MiddleEastAndAfrica (Средний Восток и Африка) NorthAmerica (Северная Америка) Oceania (Океания) SouthAmerica (Южная Америка) SouthEastAsia (Юго-Восточная Азия) Taiwan (Тайвань) Thailand (Таиланд)	String
Reorder_Stops_to_Find_Optimal_Routes (Дополнительный)	Позволяет выбрать посещение остановок в указанном вами порядке или в порядке, определяемом инструментом для минимизации общей протяженности маршрута. Отмечено (True): Порядок остановок соответствует заданному вами порядку. Это является опцией по умолчанию. Порядок посещения остановок можно задать с помощью атрибута Sequence входных объектов-остановок или разрешить определение порядка по ID объектов-остановок. Не отмечено (False): Инструмент определит порядок посещения с минимальной длиной маршрута или временем в пути. Порядок остановок может быть изменен в соответствии с временным окном. Дополнительные параметры позволяют сохранить первую и последнюю остановки, разрешив инструменту изменить порядок промежуточных остановок. Определение оптимального порядка остановок и поиск наилучшего маршрута часто называется задачей по поиску маршрута коммивояжера (TSP).	Boolean
Preserve_Terminal_Stops (Дополнительный)	Когда опция Изменить порядок остановок для нахождения оптимальных маршрутов включена (или 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. Отмечено (True): Маршрут будет начинаться и заканчиваться на первой остановке. Это значение используется по умолчанию. Когда одновременно включены опции Изменить порядок остановок для нахождения оптимальных маршрутов и Возврат в начало (Return to Start) (или True), опция Сохранить конечные остановки (Preserve Terminal Stops) должна быть задана как Сохранить первую. Не отмечено (False): Маршрут не будет начинаться и заканчиваться на первой остановке.	Boolean
Use_Time_Windows (Дополнительный)	Включите эту опцию (или установите значение True), если у каких-либо входных остановок есть временные окна, указывающие, когда маршрут должен прибыть на них. Вы можете добавить временные окна к входным остановкам, введя значения времени в атрибуты TimeWindowStart и TimeWindowEnd. Отмечено (True): Входные остановки имеют временные окна и инструмент должен их учитывать. Не отмечено (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): Развороты запрещены в соединениях с ровно двумя смежными ребрами, но разрешены на перекрестках (в соединениях с тремя смежными ребрами или более) и в тупиках (соединениях с ровно одним смежным ребром). Зачастую, моделирующие улицы сети имеют избыточные соединения в середине сегментов дороги. Эта опция позволяет запретить развороты транспортных средств в таких местах. Этот параметр игнорируется, если только для Режима передвижения (Travel Mode) не выбрано Пользовательский (Custom).	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 (Дополнительный)	Укажите, должна ли использоваться иерархия при нахождении кратчайшего пути между остановками. Отмечено (True): Использовать иерархию при нахождении маршрутов. Когда используется иерархия, инструмент предпочитает улицы более высокого порядка (такие как скоростные автострады) улицам более низкого порядка (таким как местные дороги), и может использоваться для моделирования предпочтения водителей передвигаться по автострадам, а не местным дорогам, даже если это удлиняет путь. Особенно это относится к тем случаям, когда нужно определить маршруты к удаленным местам, поскольку водители предпочитают использовать в дальних поездках скоростные автострады без светофоров, перекрестков и поворотов. Использование иерархии ускоряет вычисления, особенно в случае протяжённых маршрутов, поскольку инструмент может определить лучший маршрут из сравнительно небольшого поднабора улиц. Не отмечено (False): Не использовать иерархию при нахождении маршрутов. Если иерархия не используется, инструмент перебирает при определении маршрута все улицы и не отдает предпочтение улицам более высокого порядка. Этот вариант обычно используется при нахождении коротких маршрутов в пределах города. Инструмент автоматически начинает использовать иерархию, если расстояние по прямой между пунктами обслуживания и точками спроса превышает 50 миль (80,46 км), даже если в этом параметре указано иное. Этот параметр игнорируется, если только для Режима передвижения (Travel Mode) не выбрано Пользовательский (Custom). При моделирования в режиме построения маршрута для пешехода рекомендуется выключить иерархию, поскольку она разработана для построения маршрутов автомобилей.	Boolean
Restrictions (Дополнительный)	Укажите, какие ограничения должны учитываться инструментом при нахождении наилучшего маршрута. Ограничение представляет собой предпочтение или требование во время поездки. В большинстве случаев, ограничения приводят к запрету проезда по дорогам, но они также могут указывать, избегать дорогу или наоборот, предпочесть ее. Например, использование ограничения Избегать платных дорог приведет к тому, что платные дороги будут использоваться, только если это абсолютно необходимо для посещения остановки. Ограничение по высоте позволяет прокладывать маршрут в обход всех объектов с пролетами, меньшими, чем высота транспортного средства. Если транспортное средство перевозит коррозионные вещества, применение ограничения Any Hazmat Prohibited (Вредные вещества запрещены) предотвратит перевозку таких материалов по тем дорогам, по которым это запрещено. Значения, предоставляемые вами для данного параметра игнорируются, за исключением случаев, когда Режим передвижения (Travel Mode) задан как Пользовательский (Custom). Ниже приводится список доступных ограничений и их краткое описание. Примечание: Использование некоторых ограничений требует ввода дополнительных значений. Это значение должно быть связано с именем ограничения и определенным параметром, предназначенным для его работы. Вы можете идентифицировать такие ограничения по их названиям, отображающимся под столбцом 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 (Дополнительный)	Укажите дополнительные значения, требуемые для некоторых ограничений, такие как вес транспортного средства для ограничения по весу. Вы можете использовать этот параметр, чтобы указать, является ли движение по дорогам, для которых установлено это ограничение, запрещенным, нежелательным или предпочтительным. Если ограничение означает нежелательность или предпочтительность использования дороги, вы можете дополнительно указать с помощью этого параметра степень нежелательности или предпочтительности. Например, вы можете установить для платных дорог правило никогда их не использовать, по возможности избегать или наоборот, отдавать им предпочтение. Примечание: Значения, предоставляемые вами для данного параметра игнорируются, за исключением случаев, когда Режим передвижения (Travel Mode) задан как Пользовательский (Custom). Если вы задаете параметр Значения атрибутивного параметра (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 Line Simplification Tolerance). Независимо от выбранного значения параметра Геометрия маршрута (Route Shape), лучший маршрут определяется всегда на основе минимальной продолжительности или протяженности пути, а не на основе расстояния по прямой между остановками. Это значит, что изменяются только формы маршрута, а не исходные улицы, которые перебирает инструмент при нахождении маршрута.	String
Route_Line_Simplification_Tolerance (Дополнительный)	Определяет степень упрощения геометрии выходных линий маршрутов, путевых листов и ребер маршрута. Инструмент игнорирует этот параметр, если значение параметра Форма маршрута отличается от Истинная форма. При упрощении сохраняются важнейшие точки на маршруте, например, повороты и перекрестки, составляющую основную форму маршрута, а остальные точки удаляются. Указываемое вами расстояние упрощения является максимальным допустимым смещением упрощенной линии от исходной. Упрощение линии сокращает количество вершин в геометрии маршрута. Это ускоряет работу инструмента.	Linear unit
Populate_Route_Edges (Дополнительный)	Укажите, должен ли инструмент строить ребра для каждого маршрута. Ребра маршрутов представляют собой отдельные объекты-улицы или другие объекты, по которым проходит маршрут. Выходной слой Ребра маршрута обычно используется для просмотра улиц или других дорог, наиболее и наименее посещаемых данным маршрутом. Отмечено (True): Построить ребра маршрутов. Выходной слой Route Edges заполняется линейными объектами. Не отмечено (False): Не строить ребра маршрутов. Выходной слой Route Edges возвращается, но не содержит объектов.	Boolean
Populate_Directions (Дополнительный)	Укажите, должен ли инструмент создавать путевой лист для каждого маршрута. Отмечено (True): Будет создан путевой лист, настроенный в соответствии со значениями параметров Язык путевого листа, Имя стиля путевого листа и Единицы расстояния путевого листа. Не отмечена (Ложь): Путевой лист не создается, инструмент возвращает пустой слой Directions.	Boolean
Directions_Language (Дополнительный)	Укажите язык, на котором должен создаваться путевой лист. Этот параметр используется, только если параметр Заполнить путевой лист (Populate Directions) отмечен или имеет значение Истина (True). Значениями параметра могут быть следующие двух- или пятисимвольные коды языка: ar – Арабский cs – чешский de – Немецкий en – Английский es – Испанский et – Эстонский fr – Французский he – Иврит it – Итальянский ja – Японский ko – Корейский lt – Литовский lv – Латышский nl – Нидерландский pl – Польский pt-BR – Португальский (Бразилия) pt-PT – Португальский (Португалия) ru – Русский sv – Шведский tr – Турецкий zh-CN – Упрощенный китайский Если указан неподдерживаемый код языка, инструмент возвращает путевой лист на английском языке, являющемся языком по умолчанию.	String
Directions_Distance_Units (Дополнительный)	Укажите единицы измерения для отображения расстояний в путевом листе. Этот параметр используется, только если параметр Заполнить путевой лист включен или задан как True. Miles Kilometers Meters Feet Yards NauticalMiles	String
Directions_Style_Name (Дополнительный)	Укажите имя стиля форматирования для путевого листа. Этот параметр используется, только если параметр Заполнить путевой лист включен или задан как True. Параметр может принимать следующие значения: NA Desktop: Создает готовый для печати путевой лист от поворота к повороту. NA Navigation: Создает путевой лист со всеми поворотами для автомобильного навигационного устройства.	String
Travel_Mode (Дополнительный)	Выберите режим передвижения для модели анализа. На машине – Моделирует перемещение на машине. Он учитывает одностороннее движение, избегает запрещенных поворотов и следует прочим правилам, специфичным для легковых машин. Используется динамическая скорость движения на основе данных трафика, если они доступны. На грузовике – Модель на основе передвижения на грузовике по специальным маршрутам для грузовиков, использующая типичные для них скорости. Она также учитывает одностороннее движение, избегает запрещенных поворотов и т.п. Для моделирования характеристик определенных грузовиков, например высоты и ширины, лучше использовать Пользовательский (Custom) режим передвижения. Пешком – Следует по тропам и дорогам, предназначенным для пешеходов. Пользовательский – это значение используется по умолчанию. Позволяет настроить собственный режим передвижения, используя для этой цели параметры пользовательского режима передвижения (Развороты в соединениях, Использовать иерархию, Ограничения, Значения Параметров атрибутов и Импеданс). Значения по умолчанию для модели параметров пользовательского режима передвижения на легковом автомобиле. Например, можно выбрать Пользовательский и задать указанные выше параметры пользовательского режима передвижения для моделирования быстрой пешей ходьбы или передвижения грузового автомобиля с определенными габаритными (по высоте) и весовыми характеристиками, загруженного определенным опасным грузом. При выборе Пользовательского режима, значения, заданные для его параметров, включаются в анализ. (Выбор других режимов: на машине, на грузовике или пешком, – приводит к тому, что заданные вами значения для пользовательского режима игнорируются; инструмент заменяет их значениями, моделирующими передвижение обычного легкового автомобиля, грузового автомобиля или пешехода.) Для моделирования пользовательского режима передвижения на грузовике необходимо следовать шагам, перечисленным ниже. Выберите Пользовательский (Custom) для Режима перемещения (Travel Mode). Включите (или задайте как True) На грузовике (Driving a Truck) в параметре Ограничения (Restrictions). Включите все другие ограничения, которые помогут смоделировать грузовик. Задайте Значения Параметров атрибутов (Attribute Parameter Values). Здесь можно указать размеры транспортного средства, включая высоту, ширину, длину и специальные значения ограничений, включенных в последнем шаге. Также можно изменить то, будут ли эти ограничения запрещены (никогда не проезжать по дорогам с ограничениями), следует ли их избегать (избегать дорог с ограничениями, при условии, что объезд не очень далеко уходит от дороги) или предпочитать (предпочитать дороги с ограничениями, при условии, что маршрут передвижения по ним не идет слишком далеко от дороги). Задать Развороты в соединениях (UTurn at Junctions) и Использование иерархии (Use Hierarchy). Задайте Импеданс (Impedance) как Время для грузовика (Truck Time) или Расстояние поездки (Travel Distance). Для моделирования передвижения пешком с определенными требованиями к маршруту следуйте процедуре, аналогичной моделированию передвижения на грузовике, но со следующими различиями: Включите (или задайте как True) ограничение Пешком (Walking) (и отключите На грузовике). Включите другие ограничения, например, Избегать лестниц (Avoid Stairways). Отмените другие ограничения. Если необходимо, задайте соответствующие Значения параметров атрибутов, например, скорость передвижения пешком. Задайте Развороты в соединениях как Допускаются (Allowed). Отключите (или задайте как False) Использование иерархии. Задайте Импеданс как Время пешком (Walk Time) или Расстояние поездки.	String
Impedance (Дополнительный)	Задайте импеданс - значение, представляющее затраты или стоимость перемещения вдоль сегментов дорог или других частей транспортной сети. Расстояние перемещения – это импеданс, длина дороги в километрах рассматривается как импеданс. В этом смысле расстояние аналогично для всех режимов – километр останется километром и для пешехода, и для машины. (Что может измениться, так это пути, по которым разрешено перемещаться в различных режимах, что влияет на расстояние между точками и моделируется настройками режима передвижения.) Время передвижения также может быть импедансом. Для того, чтобы проехать милю по пустой дороге, машине может понадобиться минута. Время передвижения может зависеть от режима перемещения: ту же милю пешеход пройдет за 20 минут, – поэтому важно выбрать правильный импеданс для моделируемого режима. Выберите из следующих значений импеданса: Время в пути на машине – Моделирует время перемещения для машины. Это время является динамичным и изменяется в зависимости от транспортных потоков, если доступны данные трафика Это значение используется по умолчанию. Время в пути на грузовике – Моделирует время перемещения для грузовика. Это время является статичным для каждой дороги и не зависит от трафика. Время в пути пешком – Моделирует время перемещения для пешехода. Расстояние поездки – Хранит измерения длин вдоль дорог и путей. Для моделирования расстояния пешком выберите эту опцию и убедитесь, что Пешком (Walking) задано в параметре Ограничение (Restriction). Аналогично, для моделирования расстояния поездки на машине или грузовике выберите здесь Расстояние пути (Travel Distance) и задайте соответствующие ограничения, чтобы транспортное средство перемещалось только по тем дорогам, по которым для разрешено движение. Значение, указанное вами для данного параметра, игнорируется, за исключением случаев, когда Режим передвижения задан как Пользовательский, который является значением по умолчанию. Если вы выбираете Время в пути на машине (Drive Time), Время в пути на грузовике (Truck Time) или Время в пути пешком (Walk Time), параметр Единицы измерения (Measurement Units) должны быть заданы, как связанные со временем; если выбираете Расстояние пути для Импеданса, Единицы измерения должны основываться на расстоянии.	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)

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

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