Краткая информация
Класс ArcPy, предназначенный для выполнения анализа маршрутов.
Обсуждение
Анализ маршрутов позволяет вычислить кратчайший путь вдоль сети между набором остановок.
Синтаксис
Route (in_network)
| Параметр | Описание | Тип данных |
in_network | Набор сетевых данных или сервис, который будет использоваться для сетевого анализа. Аргумент можно задать с помощью пути к каталогу с набором сетевых данных, объекту слоя набора сетевых данных, строки с именем слоя набора сетевых данных или URL-адреса портала для сервиса сетевого анализа. Сеть должна содержать хотя бы один режим перемещения. Для использования URL-адреса портала необходимо выполнить вход на портал под учетной записью с правами на маршрутизацию. Анализ расходует кредиты, если объект использует ArcGIS Online в качестве in_network. Дополнительные сведения см. в разделе Обзор сервисных кредитов. | String |
Свойства
| Свойство | Описание | Тип данных |
| accumulateAttributeNames (чтение и запись) | Список атрибутов стоимости, который будет суммироваться во время анализа. Эти накопившиеся атрибуты могут использоваться только для сведения; алгоритм решения при выполнении анализа использует только атрибут стоимости в соответствии с используемым режимом передвижения. По умолчанию пустой список. | String |
| allowSaveLayerFile (чтение и запись) | Указывает, разрешается ли сохранение результата анализа в виде файла слоя, используя метод saveAsLayerFile получившегося объекта. True означает, что вы можете сохранить файл слоя. False означает, что сохранить нельзя. Значение по умолчанию True, если в анализе используется набор сетевых данных, и False при использовании сервиса портала. Разрешение сохранения файла слоя может замедлить анализ, если в анализе используется сервис портала. | Boolean |
| allowSaveRouteData (чтение и запись) | Указывает, разрешается ли сохранение результата анализа в файл ZIP, используя метод saveRouteData получившегося объекта. True означает, что вы можете сохранить данные маршрута. False означает, что сохранить нельзя. Значение по умолчанию True, если в анализе используется набор сетевых данных, и False при использовании сервиса портала. Разрешение сохранения данных маршрута может замедлить анализ, если в анализе используется сервис портала. | Boolean |
| directionsDistanceUnits (чтение и запись) | Единицы, используемые для расстояния перемещения в выходных пошаговых направлениях. Свойство возвращается и задается в качестве участвующего в перечислении DistanceUnits и применяется, только если значение свойства returnDirections – True. По умолчанию используются единицы измерения атрибута расстояния в режиме перемещения, используемом для анализа. | Object |
| directionsLanguage (чтение и запись) | Язык, на котором будет отображаться выходной текст с указаниями пошаговых направлений. Свойство возвращается и устанавливается в виде строки с использованием одного из двух- или пятизначных кодов языков, представляющих поддерживаемые языки направлений. Список доступных языков направлений можно получить с помощью функции arcpy.nax.ListDirectionsLanguages. Значение по умолчанию - en (English) или язык активного в данный момент языкового пакета. Свойство применимо, только если свойство returnDirections имеет значение True. | String |
| directionsStyle (чтение и запись) | Стиль, который будет использоваться для вывода пошаговых инструкций. Свойство возвращается и задается в качестве участвующего в перечислении DirectionsStyle и применяется, только если значение свойства returnDirections – True. Значение по умолчанию равно Desktop. | Object |
| distanceUnits (чтение и запись) | Единицы, используемые для расстояния перемещения в выходных данных анализа. Независимо от единиц измерения в стоимостных атрибутах набора сетевых данных выходные данные будут трансформированы в единицы, заданные в этом свойстве. Возвращается свойство и задается в качестве значения в перечислении DistanceUnits. По умолчанию – DistanceUnits.Kilometers. | Object |
| findBestSequence (чтение и запись) | Значение False означает, что остановки будут посещаться в порядке, заданном на входе. Значение True означает, что входные остановки должны быть переупорядочены для минимизации общей стоимости передвижения. Этот параметр заменяет задачу поиска кратчайшего пути на задачей движущегося торгового представителя. По умолчанию – False. | Boolean |
| ignoreInvalidLocations (чтение и запись) | Указывает, будут ли игнорироваться неверные входные местоположения. Значение True указывает, что неверные входные местоположения будут игнорироваться, поэтому анализ будет успешным только при использовании допустимых местоположений. Значение False указывает, что недопустимые местоположения не будут проигнорированы и приведут к сбою анализа. Прежние версии:Сервисы маршрутизации на основе портала версий ArcGIS Enterprise старше, чем 10.9, всегда игнорируют некорректные входные местоположения. Метод возвращает исключение ValueError, если для ignoreInvalidLocations вы задали False, а сервис не поддерживает эту опцию. | Boolean |
| networkDataSource (только чтение) | Полный путь каталога к набору сетевых данных, используемому для анализа. | String |
| overrides (чтение и запись) | Задайте дополнительные опции, которые смогут повлиять на выполнение расчета при поиске решений задач сетевого анализа. Значение этого параметра должно быть задано в JavaScript Object Notation (JSON). К примеру, корректным значением является следующее: {"overrideSetting1" : "value1", "overrideSetting2" : "value2"}. Замещающее имя всегда заключено в двойные кавычки. Эти значения могут быть числовыми, булевыми или текстовыми. Значение по умолчанию является пустым, что означает отсутствие замещения каких-либо настроек механизма расчета. Замещения – дополнительные настройки, которые должны применяться только по итогам выполнения тщательного анализа результатов, которые будут получены до и после применения таких настроек. Список поддерживаемых настроек замещений для каждого расчета и их доступных значений можно получить, обратившись в службу технической поддержки Esri. | String |
| preserveFirstStop (чтение и запись) | Если порядок остановок был изменен из-за того, что для свойства findBestSequence задано значение True, значение True этого свойства сохраняет порядок первой остановки. Порядок остальных остановок будет изменен для получения оптимального маршрута. Это может быть полезным, если маршрут начинается из депо или станции. По умолчанию – False. | Boolean |
| preserveLastStop (чтение и запись) | Если порядок остановок был изменен из-за того, что для свойства findBestSequence задано значение True, значение True этого свойства сохраняет порядок первой остановки. Порядок остальных остановок будет изменен для получения оптимального маршрута. Это может быть полезным, если маршрут должен заканчиваться в депо или на станции. По умолчанию – False. | Boolean |
| returnDirections (чтение и запись) | Задает, будут ли создаваться пошаговые направления. True означает, что пошаговые направления будут генерироваться при решении анализа. False означает, что направления генерироваться не будут. Генерирование направлений может замедлить выполнение анализа. Значение по умолчанию равно False. | Boolean |
| returnRouteEdges (чтение и запись) | Определяет, будут ли возвращены ребра маршрутов. Ребра маршрутов – это отдельные сегменты маршрута, указывающие пройденные ребра сети. Значение True означает, что ребра маршрутов будут сохранены и возвращены при решении анализа. Значение False значит, что ребра маршрутов не будут сохраняться. Значением по умолчанию будет True, когда объект Route использует набор сетевых данных, и False, если он использует сервис портала. Возврат ребер маршрута может замедлить анализ, если этот анализ использует сервис портала. | Boolean |
| returnRouteJunctions (чтение и запись) | Указывает, будут ли возвращены соединения сети, пройденные по маршруту. True означает, что узлы маршрутов будут сохранены и возвращены при решении анализа. False означает, что узлы сохраняться не будут. Значением по умолчанию будет True, когда объект Route использует набор сетевых данных, и False, если он использует сервис портала. Сервисы портала не могут возвращать соединения. | Boolean |
| returnRouteTurns (чтение и запись) | Указывает, будут ли возвращены повороты сети, пройденные на маршруте. True означает, что повороты будут сохранены и возвращены при решении анализа. Значение False означает, что повороты сохраняться не будут. Значением по умолчанию будет True, когда объект Route использует набор сетевых данных, и False, если он использует сервис портала. Сервисы портала не могут возвращать повороты. | Boolean |
| returnToStart (чтение и запись) | True означает, что маршрут должен возвратиться в стартовое местоположение в конце маршрута. Значение False означает, что маршрут будет окончен на последней остановке. По умолчанию – False. | Boolean |
| routeShapeType (чтение и запись) | Тип формы, создаваемой для отображения выходных маршрутов. Маршруты всегда вычисляются вдоль сети, но вы можете отобразить их геометриями, не отражающими кривые сети. Возвращается свойство и задается в качестве значения в перечислении RouteShapeType. По умолчанию – RouteShapeType.TrueShapeWithMeasures. | Object |
| searchQuery (чтение и запись) | При размещении входных данных в сети, задает запрос на ограничение поиска поднабора объектов в классе исходных объектов. Эта опция полезна, если вы не хотите находить объекты, которые могут не подходить для сетевого положения. Например, если вы загружаете центроиды полигонов и не хотите размещать их на местных дорогах, можно создать запрос, который будет искать только основные дороги. Дополнительные сведения о способе размещения входных данных в сети Значение параметра указывается в виде списка с вложенными списками. Вложенный список состоит из двух значений, указывающих имя и выражение SQL для всех источников сети. Синтаксис выражения SQL несколько различается в зависимости от типа класса объектов источника сети. Например, если вы выполняете запрос к исходному классу объектов, хранящемуся в файловой или многопользовательской базе геоданных, шейп-файлам, SDC, то имена полей необходимо заключить в двойные кавычки: "CFCC". Если вы выполняете запрос к исходному классу объектов, хранящемуся в персональной базе геоданных, заключите поля в квадратные скобки: [CFCC]. Если запрос для конкретного источника указывать не нужно, используйте "#" в качестве значения для выражения SQL или исключите имя источника и выражение SQL из значения параметра. Если запрос для всех источников сети указывать не нужно, используйте "#" в качестве значения параметра. Например, значение параметра [["Streets","\"CFCC\" = 'A15'"], ["Streets_ND_Junctions",""]] определяет выражение SQL для исходного класса объектов Streets и отсутствие выражения для исходного класса объектов Streets_ND_Junctions. Обратите внимание, что двойные кавычки, окружающие имя поля CFCC, можно проигнорировать, добавив символы обратной косой черты, что позволит избежать ошибки анализа в интерпретаторе Python. По умолчанию запрос не используется. | List |
| searchTolerance (чтение и запись) | Максимальный допуск поиска для расположения входных объектов в сети. Свойство возвращается и устанавливается как число двойной точности, и единицы этого значения доступны через свойство searchToleranceUnits. Значение по умолчанию равно 5000. Дополнительные сведения о способе размещения входных данных в сети | Double |
| searchToleranceUnits (чтение и запись) | Единицы измерения для свойства searchTolerance. Возвращается свойство и задается в качестве значения в перечислении DistanceUnits. По умолчанию – DistanceUnits.Meters. | Object |
| timeOfDay (чтение и запись) | Время суток для использования в анализе. Значение по умолчанию равно None, означающее, что анализ не будет зависеть от времени. | DateTime |
| timeUnits (чтение и запись) | Единицы, используемые для времени перемещения в выходных данных анализа. Независимо от единиц измерения в стоимостных атрибутах набора сетевых данных выходные данные будут трансформированы в единицы, заданные в этом свойстве. Возвращается свойство и задается в качестве значения в перечислении TimeUnits. По умолчанию – TimeUnits.Minutes. | Object |
| timeZone (чтение и запись) | Определяет, будет ли указанное в свойстве timeOfDay время интерпретироваться в местном времени входных местоположений или во всемирном координированном времени (UTC). Свойство возвращается и задается в качестве участвующего в перечислении TimeZoneUsage и применяется, только если значение свойства timeOfDay не равно None. По умолчанию – TimeZoneUsage.LocalTimeAtLocations. | Object |
| timeZoneForTimeWindows (чтение и запись) | Определяет, выражаются ли значения во временных окнах входных остановок в локальном местном времени входных местоположений или во всемирном координированном времени (UTC). Возвращается свойство и задается в качестве участвующего в перечислении TimeZoneUsage. По умолчанию – TimeZoneUsage.LocalTimeAtLocations. | Object |
| travelMode (чтение и запись) | Режим передвижения, используемый для анализа. Значение возвращается и устанавливается как объект arcpy.nax.TravelMode, но оно также может быть установлено с использованием текстового имени режима передвижения или строки, содержащей действительное представление JSON режима передвижения. По умолчанию используется режим передвижения, определенный в наборе сетевых данных, используемом для анализа. | Object |
Обзор метода
| Метод | Описание |
| addFields (input_type, field_description) | Добавляет пользовательские поля к заданному входному классу. Эти поля будут включены в словарь сопоставления полей, созданный методом fieldMappings, и будут также доступны для использования посредством метода insertCursor. |
| count (input_type) | Возвращает количество строк, добавленных к входному типу. |
| fieldMappings (input_type, {use_location_fields}, {list_candidate_fields}) | Создает словарь NAClassFieldMappings, который сопоставляет входной тип с объектами arcpy.nax.NAClassFieldMap, позволяющими вам сопоставлять поля ваших входных данных свойствам механизма расчета. Словарь может использоваться в качестве входных данных аргумента field_mappings метода load. |
| fieldNames (input_type, {use_location_fields}) | Получает список имен полей, поддерживаемых заданным входным типом. |
| insertCursor (input_type, field_names, {append}) | Задает курсор записи для заданного типа выходных данных. Этот курсор предназначен для добавления строк непосредственно во входных данных. |
| load (input_type, features, {field_mappings}, {append}, {max_features}) | Задает входные объекты, которые будут участвовать в анализе. |
| solve () | Выполнения анализа построения маршрутов с помощью свойств, заданных для объекта Route и загруженных входных данных. |
Методы
addFields (input_type, field_description)
| Параметр | Описание | Тип данных |
input_type | The type of input to which the fields should be added. Параметр должен быть задан с помощью перечисления RouteInputDataType. | Object |
field_description [field_description,...] |
The fields and their properties that will be added to the input class. The value should be constructed as a list of lists with each row containing the following items:
Available field types are as follows:
The method will return an error if the field already exists in the table or if any of the field properties are invalid. | List |
count (input_type)
| Параметр | Описание | Тип данных |
input_type | Тип подсчитываемых входных объектов. Параметр должен быть задан с помощью перечисления RouteInputDataType. | Object |
| Тип данных | Описание |
| Integer | Число строк. |
fieldMappings (input_type, {use_location_fields}, {list_candidate_fields})| Параметр | Описание | Тип данных |
input_type | The type of input for which the field mappings are returned. Параметр должен быть задан с помощью перечисления RouteInputDataType. See descriptions of the fields available for each input type | Object |
use_location_fields | Indicates whether network location fields should be included in the returned field mappings dictionary. Network location fields describe the point on the network where an object is located. You can use network location fields to more precisely control how your analysis inputs locate on the network and to save time when calling the solve method because the solver will not have to calculate the location fields from the geometry of the inputs. You can calculate location fields for a feature class using the Calculate Locations tool. Learn more about network location fields and how inputs are located on the network When this argument is set to True, the returned field mappings dictionary will contain network location fields. The default is False; the field mapping dictionary will not include network location fields. (Значение по умолчанию — False) | Boolean |
list_candidate_fields [list_candidate_fields,...] | Use this parameter to map additional, non-default fields from your input data into your analysis inputs. For example, if your input feature class contains a field named MyField, and you want this field to be included in your analysis inputs, pass the MyField field object to the list_candidate_fields parameter. MyField will be included in the returned field mapping dictionary and automatically mapped. When you call the load method using these field mappings, MyField will be included in the analysis inputs along with all the default fields. In many cases, these extra fields will be passed to the analysis output as well. The parameter should be specified as a list of arcpy.Field objects, which can be obtained from a given feature class or table using the arcpy.ListFields function. Learn more about best practices for setting up analysis inputs (Значение по умолчанию — None) | Field |
| Тип данных | Описание |
| Dictionary | Словарь NAClassFieldMappings, в котором ключами являются имена полей, а значениями - объекты arcpy.nax.NAClassFieldMap. |
fieldNames (input_type, {use_location_fields})| Параметр | Описание | Тип данных |
input_type | Тип входных данных, для которых возвращаются поддерживаемые имена полей. Параметр должен быть задан с помощью перечисления RouteInputDataType. See descriptions of the fields available for each input type | Object |
use_location_fields | Определяет, будут ли поля сетевого местоположения включены в возвращаемый список имён полей. Поля местоположения сети описывают точку сети, в которой расположен объект. Вы можете использовать поля местоположения сети для более точного контроля, как входные данные вашего анализа располагаются в сети в целях сохранения времени при вызове метода solve, поскольку механизм решения не будет вычислять поля местоположения из геометрии входных данных. Поле местоположения для класса объектов можно вычислить при помощи инструмента Вычислить местоположения. Дополнительные сведения о полях местоположения сети и способе размещения входных данных в сети Если значение аргумента - True, возвращаемый словарь сопоставления полей будет содержать только поля местоположения в сети. Значение по умолчанию - False; список имён полей не будет содержать поля местоположения в сети. (Значение по умолчанию — False) | Boolean |
| Тип данных | Описание |
| String | Список имен полей, поддерживаемых заданным входным типом. |
insertCursor (input_type, field_names, {append})| Параметр | Описание | Тип данных |
input_type | The type of input into which the cursor can be used to insert rows. Параметр должен быть задан с помощью перечисления RouteInputDataType. | Object |
field_names [field_names,...] | A list of field names of the input type whose values you want to set when inserting rows using the cursor. You can get the names of the fields supported by an input type by using the fieldNames method. See descriptions of the fields available for each input type In addition to regular fields, you can also set the geometry of the input using one of the following geometry tokens:
The SHAPE@XY and SHAPE@XYZ tokens are only supported for point-based input types. When using the SHAPE@XY and SHAPE@XYZ tokens, the x-, y-, and z-values should be specified in the spatial reference of the network data source being used in the analysis. | String |
append | Specifies whether the features being inserted should be appended to the existing set of features for the input type. A value of True indicates that the new features should be appended; the existing features will be preserved. This is the default. A value of False indicates that any existing features for the input type should be deleted and replaced with the features currently being inserted. (Значение по умолчанию — True) | Boolean |
| Тип данных | Описание |
| Object | Объект SolverInsertCursor, который можно использовать для записи объектов. |
load (input_type, features, {field_mappings}, {append}, {max_features})| Параметр | Описание | Тип данных |
input_type | The type of input feature to load. Параметр должен быть задан с помощью перечисления RouteInputDataType. | Object |
features | The input features to load. This parameter accepts the following input types:
For layer inputs, only selected features will be loaded. If a layer has a definition query, only the subset of features visible with the definition query will be loaded. The method also honors the Extent geoprocessing environment; only features in the specified extent will be loaded. | String |
field_mappings | An NAClassFieldMappings dictionary that maps the field names of the input type to arcpy.nax.NAClassFieldMap objects representing the mapping of fields from the input features. Valid input for this parameter can be constructed using the fieldMappings method. If field mappings are not specified, all fields from the input features that have the same name as the supported fields for the input type will be mapped. (Значение по умолчанию — None) | Dictionary |
append | Indicates whether the features being loaded should be appended to the existing set of features for the input type. A value of True indicates that the new features should be appended; the existing features will be preserved. This is useful if you want to load inputs from multiple feature classes or tables to use in a single analysis. This is the default. A value of False indicates that any existing features for the input type should be deleted and replaced with the features currently being loaded. (Значение по умолчанию — True) | Boolean |
max_features | The maximum number of features that can be loaded into the input type. This is useful if you are creating a tool or service and want an error returned if the size of the input exceeds the available resources. The load method will return an arcpy.nax.LimitError if the number of input features exceeds the max_features limit. If a value is not specified, no limit is enforced for the count of the input features. (Значение по умолчанию — None) | Integer |
solve ()
| Тип данных | Описание |
| Object | Объект arcpy.nax.RouteResult, который можно использовать для доступа к выходным данным и сообщениям механизма расчета. |
Пример кода
Выполняет анализ маршрутов с помощью класса объектов для входных остановок.
# An example showing how to perform route analysis using a feature class for input stops.
import arcpy
arcpy.CheckOutExtension("network")
nds = "C:/data/NorthAmerica.gdb/Routing/Routing_ND"
nd_layer_name = "Routing_ND"
input_stops = "C:/data/io.gdb/Stops"
output_routes = "C:/data/io.gdb/Routes"
# Create a network dataset layer and get the desired travel mode for analysis
arcpy.nax.MakeNetworkDatasetLayer(nds, nd_layer_name)
nd_travel_modes = arcpy.nax.GetTravelModes(nd_layer_name)
travel_mode = nd_travel_modes["Driving Time"]
# Instantiate a Route solver object
route = arcpy.nax.Route(nd_layer_name)
# Set properties
route.timeUnits = arcpy.nax.TimeUnits.Minutes
route.travelMode = travel_mode
route.routeShapeType = arcpy.nax.RouteShapeType.TrueShapeWithMeasures
# Load inputs
route.load(arcpy.nax.RouteInputDataType.Stops, input_stops)
# Solve the analysis
result = route.solve()
# Export the results to a feature class
if result.solveSucceeded:
result.export(arcpy.nax.RouteOutputDataType.Routes, output_routes)
else:
print("Solved failed")
print(result.solverMessages(arcpy.nax.MessageSeverity.All))