Сводка
Анализ поиска маршрутов означает определение кратчайшего и быстрейшего способа перемещения между местоположениями. Возможно применение этого инструмента для построения путевых листов посещения нескольких остановок или измерения расстояния или времени перемещения между местоположениями. Каждый раз при запуске инструмент позволяет найти маршруты для одного или нескольких транспортных средств, поэтому, например, можно определить наилучшие маршруты для посещения предназначенных остановок для нескольких водителей или измерить в одном расчете расстояние проезда из дома на работу для многих пассажиров.
Иллюстрация
Использование
- Для поиска маршрутов для нескольких транспортных средств рассмотрите атрибут RouteName, описанный в параметре Остановки. Для поиска маршрутов для нескольких транспортных средств необходимо, чтобы до расчета остановки были сгруппированы в меньшие поднаборы (один для каждого маршрута или транспорта). Маршрут строится для каждого поднабора остановок. (Если необходимо группировать остановки, а также строить маршруты между ними, для оптимизации процесса примените вместо этого инструменты задачи выбора маршрута транспорта.)
В диалоговом окне инструмента есть разнообразные дополнительные параметры, сгруппированные для удобства работы в следующие шесть категорий:
- Расширенный анализ
- Барьеры
- Пользовательский режим передвижения
- Набор сетевых данных
- Сетевые положения
- Выходные данные
- Возможности сервиса
Синтаксис
arcpy.na.FindRoutes(Stops, Measurement_Units, Network_Dataset, Output_Geodatabase, Output_Routes_Name, Output_Route_Edges_Name, Output_Directions_Name, Output_Stops_Name, {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_Policy}, {Point_Barriers}, {Line_Barriers}, {Polygon_Barriers}, {Time_Attribute}, {Time_Attribute_Units}, {Distance_Attribute}, {Distance_Attribute_Units}, {Use_Hierarchy_in_Analysis}, {Restrictions}, {Attribute_Parameter_Values}, {Accumulate_Attributes}, {Maximum_Snap_Tolerance}, {Feature_Locator_WHERE_Clause}, {Route_Shape}, {Route_Line_Simplification_Tolerance}, {Populate_Route_Edges}, {Populate_Directions}, {Directions_Language}, {Directions_Distance_Units}, {Directions_Style_Name}, {Maximum_Features_Affected_by_Point_Barriers}, {Maximum_Features_Affected_by_Line_Barriers}, {Maximum_Features_Affected_by_Polygon_Barriers}, {Maximum_Stops}, {Maximum_Stops_per_Route}, {Force_Hierarchy_Beyond_Distance}, {Save_Output_Network_Analysis_Layer}, {Travel_Mode}, {Time_Zone_for_Time_Windows}, {Overrides}, {Save_Route_Data})| Параметр | Объяснение | Тип данных |
Stops | Этот инструмент строит маршруты между остановками, указанными в данном параметре. Для расчета этого анализа необходимы как минимум две остановки. При указании остановок вы можете задать с помощью атрибутов свойства каждой из них, такие как имя или время обслуживания. Для задания свойств остановок можно использовать следующие атрибуты: OBJECTID – системное поле ID. SHAPE – поле геометрии, определяющее географическое местоположение инцидента. Name – имя остановки. Имя используется в путевом листе. Если имя не указано, в выходных остановках, маршрутах и путевом листе автоматически создается уникальное имя с префиксом Location. RouteName – имя маршрута, для которого назначена остановка. Присвоение различным остановкам одного и того же имени маршрута приводит к группировке остановок, т.е. все они будут включены в один маршрут. Вы можете создавать несколько маршрутов за один раз, присваивая уникальные имена маршрутов различным группам остановок. С помощью этого инструмента вы можете сгруппировать до 150 остановок для каждого маршрута. Sequence – выходные маршруты пройдут по остановкам в том порядке, который задан этим атрибутом. В пределах группы остановок с одинаковым значением имени маршрута, порядковый номер должен быть больше 0, но не должен превышать максимальное число остановок. Кроме того, порядковый номер не должен дублироваться. Если опция Изменить порядок остановок для нахождения оптимального маршрута включена (True), то порядок посещения остановок для маршрутов (за исключением, возможно, первой и последней остановки) будет проигнорирован, чтобы инструмент мог найти последовательность посещения остановок с минимальными временными затратами для каждого маршрута. (Параметры Сохранить порядок остановок и Возврат в начало определяют, будут ли игнорироваться первое и последнее значения последовательности.) AdditionalTime – время, затраченное на остановке, которое добавляется к общему времени маршрута. Единицы измерения для этого атрибута задаются параметром Единицы измерения. Значение атрибута включается в анализ, только когда единицами измерения являются единицы времени. По умолчанию значение равно 0. Обычно расположение остановки, например, дом, находится не на самой улице, а на некотором удалении от проезжей части. Значение этого атрибута может использоваться для учета расстояния между действительным местоположением остановки и ее положением на улице, если имеет смысл включать это расстояние в общую протяженность пути. AdditionalDistance – дополнительное расстояние, пройденное на остановке, которое добавляется к общей протяженности маршрута. Единицы измерения для этого атрибута задаются параметром Единицы измерения. Значение атрибута включается в анализ, только когда единицами измерения являются единицы расстояния. По умолчанию значение равно 0. Обычно расположение остановки, например, дом, находится не на самой улице, а на некотором удалении от проезжей части. Значение этого атрибута может использоваться для учета расстояния между действительным местоположением остановки и ее положением на улице, если имеет смысл включать это расстояние в общую протяженность пути. TimeWindowStart – самое раннее время посещения остановки. Убедитесь, что значение имеет формат даты-времени, например, 8/12/2015 12:15 PM. Задавая начало и окончание временного окна посещения остановки, можно указать, когда именно маршрут достигнет этой остановки. Если параметр Использовать временные окна включен и для Единиц измерения выбрано время, инструмент попытается найти решение, минимизирующее расстояние маршрута и позволяющее посетить остановку в указанное временное окно. При решении задачи, которая охватывает несколько часовых поясов, значения временного окна каждой остановки соответствуют ее часовому поясу. Поле может содержать нулевое значение (null), это означает, что маршрут должен достичь остановки в любое время, до времени заданного параметром TimeWindowEnd. Если параметр TimeWindowEnd также содержит значение null, маршрут может посетить эту остановку в любое время. TimeWindowEnd – самое позднее время посещения остановки. Убедитесь, что значение имеет формат даты-времени, например, 8/12/2015 12:15 PM. Задавая начало и окончание временного окна посещения остановки, можно указать, когда именно маршрут достигнет этой остановки. Если параметр Использовать временные окна включен и для Единиц измерения выбрано время, инструмент попытается найти решение, минимизирующее расстояние маршрута и позволяющее посетить остановку в указанное временное окно. При решении задачи, которая охватывает несколько часовых поясов, значения временного окна каждой остановки соответствуют ее часовому поясу. Поле может содержать пустое значение (null), это означает, что маршрут может прибыть в любое время, после указанного атрибутом TimeWindowStart. Если параметр TimeWindowStart также содержит значение null, маршрут может посетить эту остановку в любое время. CurbApproach – указывает направление, в котором транспортное средство может подъехать или отъехать от остановки. Значение поля указывается одним из следующих целых чисел (используйте числовой код, а не имя в скобках):
Свойство CurbApproach было разработано для работы с обоими типами национальных стандартов дорожного движения: правостороннего (США) и левостороннего (Великобритания). Для начала рассмотрим случай, когда остановка располагается с левой стороны транспортного средства. Это условие должно обязательно выполняться в независимости от того движется транспорт по левой или по правой полосе дороги. Вы можете выбрать, с какой из двух сторон подъехать к остановке, независимо от национального стандарта дорожного движения, т.е. где будет находится точка заказа – справа или слева от транспортного средства. Например, если необходимо подходить к остановке так, чтобы отсутствовала полоса движения между транспортным средством и остановкой, то в США необходимо выбрать правую сторону транспорта (1), а в Великобритании левую сторону (2). | Feature Set |
Measurement_Units | Укажите единицы измерения, которые должны использоваться для измерения и указания общей продолжительности или протяженности пути для выходных маршрутов. Единицы, выбранные для этого параметра, определяют, будет ли инструмент измерять протяженность или продолжительность пути для нахождения наилучшего маршрута. Выберите единицу времени для минимизации времени пути для указанного режима маршрута (например, пешком или на машине). Для минимизации протяженности пути для выбранного типа маршрута выберите единицы расстояния. Выбранные вами единицы инструмент будет использовать также для указания общей продолжительности или протяженности пути в результатах. Можно выбрать следующие варианты:
Инструмент использует сетевой атрибут стоимости, заданный параметром Атрибут времени или параметром Атрибут расстояния, в зависимости от того, какие единицы измерения выбраны: времени или расстояния. Инструмент выполняет необходимые преобразования единиц в том случае, если значение параметра Единицы измерения отличается от единиц соответствующего атрибута стоимости времени или расстояния. | String |
Network_Dataset | Набор сетевых данных, который будет анализироваться. Наборы сетевых данных чаще всего представляют улично-дорожные сети, но могут представлять и другие типы транспортных сетей. Набор сетевых данных должен содержать хотя бы один атрибут стоимости, основанный на времени, и один, основанный на расстоянии. | Network Dataset Layer |
Output_Geodatabase | Выходная рабочая область. Рабочая область должна существовать. Выходная рабочая область по умолчанию – in_memory. | Workspace |
Output_Routes_Name | Имя выходного класса пространственных объектов, содержащего маршруты или линии, соединяющие остановки. Этот класс пространственных объектов содержит также в качестве атрибута общее время или расстояние перемещения. В разделе Выходные данные инструмента Найти маршруты описывается схема этого выходного класса пространственных объектов. | String |
Output_Route_Edges_Name | Имя выходного класса пространственных объектов, содержащего ребра маршрута. Ребра маршрутов представляют собой отдельные объекты-улицы, по которым проходит маршрут. В разделе Выходные данные инструмента Найти маршруты описывается схема этого выходного класса пространственных объектов. | String |
Output_Directions_Name | Имя выходного класса пространственных объектов, содержащего путевой лист. В разделе Выходные данные инструмента Найти маршруты описывается схема этого выходного класса пространственных объектов. | String |
Output_Stops_Name | Имя выходного класса пространственных объектов, содержащего выходные остановки. В разделе Выходные данные инструмента Найти маршруты описывается схема этого выходного класса пространственных объектов. | String |
Reorder_Stops_to_Find_Optimal_Routes (Дополнительный) | Позволяет выбрать посещение остановок в указанном вами порядке или в порядке, определяемом инструментом для минимизации общей протяженности маршрута.
Определение оптимального порядка остановок и поиск наилучшего маршрута часто называется задачей по поиску маршрута коммивояжера (TSP). | Boolean |
Preserve_Terminal_Stops (Дополнительный) | Когда опция Изменить порядок остановок для нахождения оптимальных маршрутов включена (или True), вы можете сохранить начальную или конечную остановку и позволить инструменту изменить порядок посещения остальных остановок. Первая и последняя остановки определяются по значениям атрибута Sequence или, если значения Sequence равны null, по значениям Object ID.
Параметр Сохранить конечные остановки игнорируется, если параметр Изменить порядок остановок не отмечен (или имеет значение False). | String |
Return_to_Start (Дополнительный) | Выберите, должен ли маршрут начинаться и заканчиваться в одном и том же месте. С помощью этой опции можно избежать дублирования первой остановки для ее использования также в качестве конечной. Начало маршрута является остановкой с наименьшим значением атрибута Sequence. Если значения атрибута Sequence являются нулевыми, это будет объект с наименьшим значением Object ID.
| Boolean |
Use_Time_Windows (Дополнительный) | Включите эту опцию (или установите значение True), если у каких-либо входных остановок есть временные окна, указывающие, когда маршрут должен прибыть на них. Вы можете добавить временные окна к входным остановкам, введя значения времени в атрибуты TimeWindowStart и TimeWindowEnd.
Если опция Использовать временные окна отмечена (или она имеет значение True), инструмент будет работать немного дольше, даже если ни у одной из входных остановок нет временных окон, поэтому эту опцию по возможности рекомендуется отключать (задавать для нее значение False). | Boolean |
Time_of_Day (Дополнительный) | Указывает время и дату начала маршрутов. Если наборы сетевых данных, содержат текущие или исторические данные трафика, указание времени суток позволяет более точно оценить время поездки между остановками, поскольку будут учтены условия дорожного движения в конкретный час и день. Параметр Часовой пояс для времени суток определяет, как будут указываться время и дата, в UTC или в часовом поясе, в котором находится остановка. Инструмент игнорирует этот параметр, если в Единицах измерения не выбрано время. | Date |
Time_Zone_for_Time_of_Day (Дополнительный) | Указывает часовой пояс параметра Время суток.
| String |
UTurn_Policy (Дополнительный) | Правила разворота на соединениях. При разрешении разворотов неявно предполагается, что механизм расчета позволяет поворот на соединении и продолжение движения по той же улице в обратную сторону. Учитывая, что соединения представляют собой пересечения улиц и тупики, различные транспортные средства могут разворачиваться на некоторых соединениях, но не на всех – это зависит от того, является ли соединение перекрестком или тупиком. Для соответствия, параметр правил разворотов в неявном виде указывает количество ребер, или улиц, участвующих в соединении, что представляет валентность соединения. Ниже приведены допустимые значения для данного параметра; каждое из них сопровождается описанием значения в терминах валентности соединения.
Значение этого параметра перезаписывается, если для Режима передвижения (Travel_Mode в Python) установлено значение, отличное от Пользовательский.. | String |
Point_Barriers (Дополнительный) | Определяет точечные барьеры, которые разделены на два типа: ограничения и дополнительной стоимости. Они временно ограничивают прохождение по сети или добавляют импеданс к точкам сети. Точечные барьеры задаются набором объектов, а значения атрибута, которые вы указываете для точечных объектов, определяют, являются ли они ограничениями или барьерами дополнительной стоимости. Ниже приведены поля в таблице атрибутов с описанием. ObjectID: Управляемое системой поле ID. Shape: Поле геометрии, показывающее географическое положение объекта сетевого анализа. Name: Имя барьера. BarrierType: Указывает, ограничивает ли барьер перемещение полностью или добавляет стоимость при прохождении через него. Существует две опции:
Используйте значение 0 для Ограничения и 2 для Дополнительной стоимости. Additional_Time: указывает, какое время поездки добавляется при прохождении барьера. Это поле действительно только для барьеров с дополнительной стоимостью, и только если используются единицы измерения времени. Значение этого поля должно быть больше или равно нулю, а его единицы измерения соответствуют заданным в параметре Единицы измерения. Additional_Distance: указывает, какое расстояние добавляется при прохождении барьера. Это поле действительно только для барьеров с дополнительной стоимостью, и только если используются единицы измерения расстояния. Значение этого поля должно быть больше или равно нулю, а его единицы измерения соответствуют заданным в параметре Единицы измерения. | Feature Set |
Line_Barriers (Дополнительный) | Определяет линейные барьеры, которые временно ограничивают прохождение через них. Линейные барьеры определяются набором объектов. Ниже приведены поля в таблице атрибутов с описанием. ObjectID: Управляемое системой поле ID. Shape: Поле геометрии, показывающее географическое положение объекта сетевого анализа. Name: Имя барьера. | Feature Set |
Polygon_Barriers (Дополнительный) | Определяет полигональные барьеры, которые разделены на два типа: ограничения и полигональные барьеры масштабированной стоимости. Они временно ограничивают перемещение или масштабируют импеданс в покрываемых ими частях сети. Полигональные барьеры задаются набором объектов, а значения атрибута, которые вы указываете для полигональных объектов, определяют, являются ли они ограничениями или барьерами дополнительной стоимости. Ниже приведены поля в таблице атрибутов с описанием. ObjectID: Управляемое системой поле ID. Shape: Поле геометрии, показывающее географическое положение объекта сетевого анализа. Name: Имя барьера. BarrierType: Указывает, ограничивает ли барьер перемещение полностью или масштабирует стоимость прохождения через него. Существует две опции:
Используйте значение 0 для Ограничения и 1 для Масштабированной стоимости. ScaledTimeFactor: Это коэффициент, на который умножается время поездки по улицам, пересекающимся с барьером. Это поле действительно только для барьеров с масштабированной стоимостью, и только если используются единицы измерения времени. Значение поля должно быть больше нуля. ScaledDistanceFactor: Это коэффициент, на который умножается длина пути по улицам, пересеченным барьером. Этот атрибут действителен только для барьеров с масштабированной стоимостью, и только если используются единицы измерения расстояния. Значение атрибута должно быть больше нуля. | Feature Set |
Time_Attribute (Дополнительный) | Определяет, какой сетевой атрибут стоимости используется, когда в качестве единиц измерения выбраны единицы времени. Инструмент выполняет необходимые преобразования единиц времени в том случае, если значение параметра Единицы измерения отличается от заданных здесь единиц атрибута стоимости. Другими словами, единицы времени параметра отсечки по умолчанию и сетевого атрибута стоимости не обязательно должны быть одинаковыми. Значение этого параметра перезаписывается, если для Режима передвижения (Travel_Mode в Python) установлено значение не Пользовательский. | String |
Time_Attribute_Units (Дополнительный) | Единицы атрибута времени. Вы можете явно задать единицы атрибута времени, однако рекомендуется оставить это поле пустым или "#" и позволить механизму расчета определить единицы. Значение этого параметра перезаписывается, если для Travel_Mode задано любое значение, отличное от CUSTOM. | String |
Distance_Attribute (Дополнительный) | Определяет, какой сетевой атрибут стоимости используется, когда значением параметра Единицы измерения является единица расстояния. Инструмент выполняет необходимые преобразования единиц расстояния в том случае, если значение параметра Единицы измерения отличается от заданных здесь единиц атрибута стоимости. Другими словами, единицы измерения и единицы расстояния сетевого атрибута стоимости не обязательно должны быть одинаковыми. Значение этого параметра перезаписывается, если для Режима передвижения (Travel_Mode в Python) установлено значение не Пользовательский. | String |
Distance_Attribute_Units (Дополнительный) | Единицы атрибута расстояния. Вы можете явно задать единицы атрибута расстояния, однако рекомендуется оставить это поле пустым или "#" и позволить механизму расчета определить единицы. Значение этого параметра перезаписывается, если для Travel_Mode задано любое значение, отличное от CUSTOM. | String |
Use_Hierarchy_in_Analysis (Дополнительный) | Укажите, должна ли использоваться иерархия при нахождении кратчайшего маршрута между точками.
Параметр не используется, если в наборе сетевых данных, используемом для выполнения анализа, не задан атрибут иерархии. В таких случаях используйте в качестве значения параметра "#". Можно использовать параметр Force_Hierarchy_Beyond_Distance , чтобы механизм расчета принудительно применял иерархию, даже если параметр Use_Hierarchy_in_Analysis задан как False. Этот параметр игнорируется, за исключением случая, когда Travel_Mode задан как CUSTOM. При моделирования в режиме построения маршрута для пешехода рекомендуется выключить иерархию, поскольку она разработана для построения маршрутов автомобилей. | Boolean |
Restrictions [restriction,...] (Дополнительный) | Определяет, какие сетевые атрибуты ограничения будут учитываться во время расчета. Значение этого параметра перезаписывается, если для Режима передвижения (Travel_Mode в Python) установлено значение, отличное от Пользовательский. | String |
Attribute_Parameter_Values (Дополнительный) | Определяет значения параметра для атрибутов сети, имеющих параметры. Набор записей имеет два столбца, которые используются вместе для уникальной идентификации параметров, а также другой столбец, который определяет значение параметра. Значение этого параметра перезаписывается, если для Режима передвижения (Travel_Mode в Python) установлено значение, отличное от Пользовательский.. Набор записей значений параметра атрибута имеет связанные атрибуты. Ниже приведены поля в таблице атрибутов с описанием. ObjectID: Управляемое системой поле ID. AttributeName: Имя сетевого атрибута, чей параметр атрибута задан строкой таблицы. ParameterName: Имя параметра атрибута, чье значение задано строкой таблицы. (Параметры типа объекта не могут быть обновлены с помощью данного инструмента.) ParameterValue: Значение, которое вы хотите задать для параметра атрибута. Если значение не указано, для параметра атрибута устанавливается значение NULL. | Record Set |
Accumulate_Attributes [attribute,...] (Дополнительный) | Список атрибутов стоимости, который будет суммироваться во время анализа. Эти атрибуты накопления служат исключительно для справки; механизм расчета использует только атрибут стоимости, определенный параметром Атрибут времени (Time_Attribute в Python) или Атрибут расстояния (Distance_Attribute в Python), для вычисления кратчайшего пути. Для каждого кумулятивного атрибута стоимости к выходным маршрутам механизма расчета добавляется свойство Total_[attribute]. | String |
Maximum_Snap_Tolerance (Дополнительный) | Максимальный допуск замыкания представляет собой самое дальнее расстояние, которое Network Analyst находится при размещении или повторном размещении точки в сети. Выполняется поиск подходящих ребер или соединений, далее выполняется замыкание точки на ближайший объект. Если подходящее положение не было найдено в пределах максимального допуска замыкания, то объект обозначается, как неразмещенный. | Linear Unit |
Feature_Locator_WHERE_Clause (Дополнительный) | Выражение SQL, используемое для создания поднабора исходных пространственных объектов, определяющего элементы сети, на которых могут быть расположены остановки. Синтаксис данного параметра состоит их двух частей: первая – имя источника класса пространственных объектов (после которого имеется пробел), вторая – выражение SQL. Чтобы записать выражение SQL для двух или более классов пространственных объектов, их необходимо разделить точкой с запятой. Чтобы пункты обслуживания не располагались на шоссе с ограниченным доступом, например, напишите выражение SQL, аналогичное следующему, с целью исключить такие источники объектов: "Streets" "FUNC_CLASS not in('1', '2')". Обратите внимание, что барьеры игнорируют Условие Where локатора объектов во время загрузки. | String |
Route_Shape (Дополнительный) | Укажите тип объектов маршрута, получаемых на выходе инструмента. Параметр может быть задан с помощью одного из следующих значений:
Когда параметр Геометрия маршрута имеет значение Истинная форма, генерализацией формы маршрута можно дополнительно управлять, выбирая значение для параметра Допуск упрощения линии маршрута. Независимо от выбранного значения параметра Геометрия маршрута, лучший маршрут определяется всегда на основе минимальной продолжительности или протяженности пути, а не на основе расстояния по прямой между остановками. Это значит, что изменяются только формы маршрута, а не исходные улицы, которые перебирает инструмент при нахождении маршрута. | String |
Route_Line_Simplification_Tolerance (Дополнительный) | Определяет степень упрощения геометрии маршрута. Инструмент игнорирует этот параметр, если для параметра Route_Shape не было указано TRUE_LINES_WITH_MEASURES или TRUE_LINES_WITHOUT_MEASURES. При упрощении сохраняются важнейшие точки на маршруте, например, повороты и перекрестки, составляющую основную форму маршрута, а остальные точки удаляются. Указываемое вами расстояние упрощения является максимальным допустимым смещением упрощенной линии от исходной. Упрощение линии сокращает количество вершин в геометрии маршрута. Это ускоряет работу инструмента. Значение этого параметра перезаписывается, если для Режима передвижения (Travel_Mode в Python) установлено значение, отличное от Пользовательский.. | Linear Unit |
Populate_Route_Edges (Дополнительный) | Укажите, должен ли инструмент строить ребра для каждого маршрута. Ребра маршрутов представляют собой отдельные объекты-улицы или другие объекты, по которым проходит маршрут. Выходной слой Ребра маршрута обычно используется для просмотра улиц или других дорог, наиболее и наименее посещаемых данным маршрутом.
| Boolean |
Populate_Directions (Дополнительный) | Укажите, должен ли инструмент создавать путевой лист для каждого маршрута.
| Boolean |
Directions_Language (Дополнительный) | Укажите язык, на котором должен создаваться путевой лист. Этот параметр используется, только если параметр Заполнить путевой лист отмечен, или если он задан как True. Список возможных языков для путевого листа зависит от установленных на вашем компьютере языковых пакетов ArcGIS. Значения имеют вид двух– или пятисимвольных кодов языка, например en для английского языка или zh-CN для упрощенного китайского. Если указан неподдерживаемый код языка, инструмент возвращает путевой лист на английском языке, являющемся языком по умолчанию. | String |
Directions_Distance_Units (Дополнительный) | Укажите единицы измерения для отображения расстояний в путевом листе. Этот параметр используется, только если параметр Заполнить путевой лист отмечен, или если он задан как True.
| String |
Directions_Style_Name (Дополнительный) | Укажите имя стиля форматирования для путевого листа. Этот параметр используется, только если параметр Заполнить путевой лист отмечен, или если он задан как True. Параметр может принимать следующие значения:
| String |
Maximum_Features_Affected_by_Point_Barriers (Дополнительный) | Ограничивает количество объектов, на которые влияют точечные барьеры Данный параметр помогает регулировать объем вычислений, необходимый для получения решения. Например, вы можете присвоить низкое значение данному параметру для бесплатной версии созданного вами сервиса, и использовать более высокое значение для версии сервиса с оплачиваемой подпиской. NULL соответствует отсутствию ограничений. | Long |
Maximum_Features_Affected_by_Line_Barriers (Дополнительный) | Ограничивает количество объектов, на которые влияют линейные барьеры Данный параметр помогает регулировать объем вычислений, необходимый для получения решения. Например, вы можете присвоить низкое значение данному параметру для бесплатной версии созданного вами сервиса, и использовать более высокое значение для версии сервиса с оплачиваемой подпиской. NULL соответствует отсутствию ограничений. | Long |
Maximum_Features_Affected_by_Polygon_Barriers (Дополнительный) | Ограничивает количество объектов, на которые влияют полигональные барьеры. Данный параметр помогает регулировать объем вычислений, необходимый для получения решения. Например, вы можете присвоить низкое значение данному параметру для бесплатной версии созданного вами сервиса, и использовать более высокое значение для версии сервиса с оплачиваемой подпиской. NULL соответствует отсутствию ограничений. | Long |
Maximum_Stops (Дополнительный) | Ограничивает количество остановок, которые можно добавить к анализу маршрута. Этот параметр связан с параметром Остановки. Данный параметр помогает регулировать объем вычислений, необходимый для получения решения. Например, вы можете присвоить низкое значение данному параметру для бесплатной версии созданного вами сервиса, и использовать более высокое значение для версии сервиса с оплачиваемой подпиской. NULL соответствует отсутствию ограничений. | Long |
Maximum_Stops_per_Route (Дополнительный) | Ограничивает максимальное количество остановок, которые можно добавить на каждый маршрут при анализе. Остановки предварительно назначены на маршруты при помощи поля RouteName для точек в параметре Остановки. Данный параметр помогает регулировать объем вычислений, необходимый для получения решения. Например, вы можете присвоить низкое значение данному параметру для бесплатной версии созданного вами сервиса, и использовать более высокое значение для версии сервиса с оплачиваемой подпиской. NULL соответствует отсутствию ограничений. | Long |
Force_Hierarchy_Beyond_Distance (Дополнительный) | Определяет расстояние, при превышении которого механизм расчета использует иерархию при поиске маршрутов, даже если она не включена. Единицами измерения этого параметра являются единицы, заданные параметром Единицы атрибута расстояния. Использование иерархии при поиске маршрутов между далеко расположенными остановками позволяет существенно сократить объем вычислений по сравнению с поиском без учета иерархии. Данный параметр помогает регулировать объем вычислений, необходимый для получения решения. Значение NULL определяет отсутствие иерархии, при этом всегда будет учитываться значение параметра Использовать иерархию в анализе. Если входной набор сетевых данных не поддерживает иерархию, то указание значения для данного параметра приведет к ошибке. В этом случае необходимо использовать значение NULL. Этот параметр доступен только тогда, когда набор сетевых данных включает в себя атрибут иерархии. | Double |
Save_Output_Network_Analysis_Layer (Дополнительный) |
В любом случае будут возвращены классы объектов, содержащие результаты. Однако администратор сервера может также выбрать вывод и слоя сетевого анализа, чтобы настройку и результаты работы инструмента можно было отладить с использованием средств управления Network Analyst в среде ArcGIS Desktop. Это намного упрощает процесс отладки. В ArcGIS Desktop выходное местоположение слоя сетевого анализа по умолчанию – это временная папка. Вы можете определить местоположение временной папки по значению arcpy.env.scratchFolder среды геообработки. Выходной слой сетевого анализа хранится в виде LYR-файла, имя которого начинается с _ags_gpna, а затем следует буквенно-числовое значение GUID. | Boolean |
Travel_Mode (Дополнительный) | Выберите режим передвижения для анализа. CUSTOM можно выбрать всегда. Чтобы появились другие режимы, они должны быть представлены в наборе сетевых данных в параметре Network_Dataset. (Функция arcpy.na.GetTravelModes содержит словарь объектов режима движения для класса сетевых объектов, а свойство name возвращает имя объекта режима передвижения.) Если режим определен в наборе сетевых данных и обеспечивает замещение значений параметров для моделирования маршруты передвижения легковых и грузовых автомобилей, пешеходов и других режимы передвижения. Выбрав режим здесь, вам не требуется указывать значения для следующих параметров, которые замещаются значениями, указанными в наборе сетевых данных:
| String |
Time_Zone_for_Time_Windows (Дополнительный) | Указывает часовой пояс для значений временного окна на остановках. Временные окна указываются как часть полей TimeWindowStart и TimeWindowEnd на остановках. Этот параметр применяется, только если отмечена опция Использовать временные окна (или имеет значение True).
| String |
Overrides (Дополнительный) | Задайте дополнительные опции, которые смогут повлиять на выполнение расчета при поиске решений задач сетевого анализа. Для этого параметра должно быть задано значение в формате JavaScript Object Notation (JSON). К примеру, допустимое значение имеет следующий вид: {"overrideSetting1" : "value1", "overrideSetting2" : "value2"}. Замещающее имя всегда заключено в двойные кавычки. Эти значения могут быть числовыми, булевыми или текстовыми. Значение по умолчанию является пустым, что означает отсутствие замещения каких-либо настроек механизма расчета. Замещения – дополнительные настройки, которые должны применяться только по итогам выполнения тщательного анализа результатов, которые будут получены до и после применения таких настроек. Список поддерживаемых настроек замещений для каждого расчета и их доступных значений можно получить, обратившись в службу технической поддержки Esri. | String |
Save_Route_Data (Дополнительный) | Выберите, будут ли выходные данные включать zip-файл, содержащий базу геоданных, в которой хранятся входные и выходные данные анализа в формате, который может быть использован для дальнейшей публикации слоев маршрутов интерактивно в ArcGIS Online или в Portal for ArcGIS. В ArcGIS Desktop выходное местоположение данного выходного файла – это временная папка. Вы можете определить местоположение временной папки, используя значение arcpy.env.scratchFolder среды геообработки.
| Boolean |
Производные выходные данные
| Имя | Объяснение | Тип данных |
| Solve_Succeeded | Определяет, смог ли сервис успешно найти маршруты. | Логические |
| Output_Routes | Итоговый маршрут или маршруты между остановками. | Набор объектов |
| Output_Route_Edges | Отдельные участки дорог, по которым проходит маршрут. | Набор объектов |
| Output_Directions | Подробный путевой лист для каждого итогового маршрута между остановками. Параметр включает путевой лист, а также геометрию объектов путевого листа, соответствующую тексту. | Набор объектов |
| Output_Stops | Атрибуты остановки или остановок, пройденных по маршруту, а также остановок, которые не будут достигнуты с помощью какого-либо маршрута. | Набор объектов |
| Output_Network Analysis_Layer | Слой сетевого анализа со свойствами, как настроенные в параметрах инструмента, который может использоваться для дальнейшего анализа или исправления ошибок на карте. | Файл |
| Output_Route_Data | Файл zip, содержащий всю информацию об определенном маршруте. | Файл |
Пример кода
FindRoutes, пример 1 (окно Python)
Выполните инструмент с использованием обязательных параметров.
stops = arcpy.FeatureSet()
stops.load("Stops")
arcpy.na.FindRoutes(stops, "Miles", "Streets_ND", "in_memory", "Routes",
"RouteEdges", "Directions", "OutStops",
UTurn_Policy="NO_UTURNS")
FindRoutes, пример 2 (автономный скрипт)
Следующий автономный Python скрипт демонстрирует, как использовать инструмент FindRoutes.
# Name: FindRoutes_Workflow.py
# Description: Find the fastest route visting all the stops. The output will
# show the route, driving directions, and how long it took to get
# to each stop.
# Requirements: Network Analyst Extension
#Import system modules
import arcpy
from arcpy import env
try:
#Check out the Network Analyst extension license
arcpy.CheckOutExtension("Network")
#Set environment settings
env.workspace = r'C:\arcgis\ArcTutor\Network Analyst\Tutorial\SanDiego.gdb'
env.overwriteOutput = True
#Set local variables
inNetworkDataset = r'Transportation\Streets_ND'
inStops = r'Analysis\Stops'
outGeodatabase = r'C:\arcgis\ArcTutor\Network Analyst\Tutorial\Output.gdb'
outRoutes = "Routes"
outRouteEdges = "RouteEdges"
outDirections = "Directions"
outStops = "Stops"
measurement_units = "Minutes"
# Run FindRoutes. Reorder the stops to find the fastest route, but maintain
# the first stop as the starting point and the last stop as the end point.
arcpy.na.FindRoutes(inStops, measurement_units, inNetworkDataset,
outGeodatabase, outRoutes, outRouteEdges, outDirections,
outStops, Reorder_Stops_to_Find_Optimal_Routes=True,
Preserve_Terminal_Stops="PRESERVE_BOTH")
print "Script completed successfully"
except Exception as e:
# If an error occurred, print line number and error message
import traceback, sys
tb = sys.exc_info()[2]
print "An error occured on line %i" % tb.tb_lineno
print str(e)
Параметры среды
Информация о лицензиях
- Basic: Требуется Network Analyst
- Standard: Требуется Network Analyst
- Advanced: Требуется Network Analyst