VehicleRoutingProblem

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

Класс ArcPy, предназначенный для выполнения анализа задачи выбора маршрута транспорта.

Обсуждение

Анализ задачи выбора маршрута транспорта находит лучшие маршруты для парка транспортных средств.

Более подробно о решении проблем выбора маршрута транспортного средства

Синтаксис

 VehicleRoutingProblem (in_network, {version})
ПараметрОписаниеТип данных
in_network

The network dataset or service that will be used for the network analysis. The argument can be specified using one of the following options:

To use a network dataset, the network must have at least one travel mode.

To use a portal URL, you must be signed in to the portal with an account that has routing privileges.

When using ArcGIS Online or an ArcGIS Enterprise portal whose routing services are configured usingArcGIS Online as the in_network, solving the analysis will consume credits and will be subject to certain limits, such as on the number of allowed inputs. Learn more about credit consumption and analysis limits in network analysis.

String
version

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

Обновленный объект схемы VehicleRoutingProblem был представлен в ArcGIS Pro 2.7 для повышения удобства и более точного соответствия схеме слоев VRP, появившихся в ArcGIS Pro 2.6.

Рекомендуется использовать для всех новых анализов схему версии Two, если возможно. Однако схема версии Two в настоящий момент не поддерживается для URL портала для источников сетевых данных. Если в анализе будет использоваться URL портала для источников сетевых данных или скрипт должен быть совместим с версиями ПО до ArcGIS Pro 2.7, используйте схему версии One.

По умолчанию применяется схема версии One.

Object

Свойства

СвойствоОписаниеТип данных
allowAutoRelocate
(чтение и запись)

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

Даже если значение False, входные данные без полей местоположений или с незаполненными полями местоположений будут расположены в процессе расчета.

По умолчанию – True.

Это свойство влияет на расположение всех входных типов. Для изменения этого свойства для отдельных входных типов используйте метод setLocateSettingsOverrides.

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

При задании этого свойства возникнет ошибка, если сетевой источник данных - ArcGIS Online, портал ArcGIS Enterprise, который не поддерживает использование сетевого полей местоположений, или портал, работающий под управлением ArcGIS Enterprise более ранней версии, чем 11.0.

Boolean
allowSaveLayerFile
(чтение и запись)

Указывает, разрешается ли сохранение результата анализа в виде файла слоя, используя метод saveAsLayerFile получившегося объекта. Значение True указывает, что вы можете сохранить файл слоя. Значение False указывает, что вы не можете сохранить файл слоя. Значение по умолчанию True, если в анализе используется набор сетевых данных, и False при использовании сервиса портала. Сохранение файла слоя может замедлить анализ, если в анализе используется сервис портала.

Boolean
allowSaveRouteData
(чтение и запись)

Указывает, разрешается ли сохранение результата анализа в файл .zip, используя метод saveRouteData получившегося объекта. Значение True указывает, что вы можете сохранить данные маршрута. Значение False указывает, что вы не можете сохранить данные маршрута. Значение по умолчанию True, если в анализе используется набор сетевых данных, и False при использовании сервиса портала. Сохранение данных маршрута может замедлить анализ, если в анализе используется сервис портала.

Boolean
defaultDate
(чтение и запись)

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

DateTime
directionsDistanceUnits
(чтение и запись)

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

Object
directionsLanguage
(чтение и запись)

Язык, на котором будет отображаться выходной текст с указаниями пошаговых направлений. Свойство возвращается и устанавливается в виде строки с использованием одного из двух- или пятизначных кодов языков, представляющих поддерживаемые языки путевых листов. Список доступных языков путевых листов можно получить с помощью функции arcpy.nax.ListDirectionsLanguages. Значение по умолчанию - en (English) или язык активного в данный момент языкового пакета. Свойство применимо, только если свойство returnDirections имеет значение True.

String
directionsStyle
(чтение и запись)

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

Значение по умолчанию равно Desktop.

Object
distanceUnits
(чтение и запись)

Единицы, используемые для расстояния перемещения в выходных данных анализа. Независимо от единиц измерения в стоимостных атрибутах набора сетевых данных выходные данные будут трансформированы в единицы, заданные в этом свойстве. Возвращается свойство и задается в качестве значения в перечислении DistanceUnits. По умолчанию – DistanceUnits.Kilometers.

Object
excessTransitFactor
(чтение и запись)

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

Возвращается свойство и задается в качестве участвующего в перечислении Importance. По умолчанию – Importance.Medium.

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

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

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

Object
ignoreInvalidLocations
(чтение и запись)

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

Boolean
networkDataSource
(только чтение)

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

String
overrides
(чтение и запись)

Примечание:

Это свойство только для внутреннего использования.

String
returnDirections
(чтение и запись)

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

Boolean
returnStopShapes
(чтение и запись)

Если задано значение True, механизм расчета создает точки выходных остановок. Если задано значение False, выходные остановки будут возвращены в табличном формате. По умолчанию – False.

Этот параметр не применяется и игнорируется, когда в анализе используется схема версии VehicleRoutingProblemSchemaVersion.Two.

Прежние версии:

Сервисы маршрутизации, основанные на порталах, работающих под управлением версий ArcGIS Enterprise старше 10.8, не поддерживают возврат стоп-форм. Метод возвращает исключение ValueError, если для returnStopShapes вы задали True, а сервис не поддерживает эту опцию.

Boolean
routeShapeType
(чтение и запись)

Тип формы, создаваемой для отображения выходных маршрутов. Маршруты всегда вычисляются вдоль сети, но вы можете отобразить их геометриями, не отражающими кривые сети. Возвращается свойство и задается в качестве значения в перечислении RouteShapeType. По умолчанию – RouteShapeType.TrueShapeWithMeasures.

Object
searchQuery
(чтение и запись)

Прежние версии:
Это свойство было заменено свойством searchSources, которое было введено в ArcGIS Pro 3.0. Свойство searchQuery продолжает работать для обеспечения обратной совместимости с существующими скриптами, но вместо него в новых сценариях рекомендуется использовать свойство searchSources.

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

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

Например, значение [["Streets", "ROAD_CLASS <> 3"], ["Streets_ND_Junctions", ""]] задает выражение SQL для класса объектов источника Streets и отсутствие выражения для класса объектов источника Streets_ND_Junctions.

Если сетевой источник не включен в список, он рассматривается, как не имеющий запроса. Значение [["Streets", "ROAD_CLASS <> 3"]] эквивалентно [["Streets", "ROAD_CLASS <> 3"], ["Streets_ND_Junctions", ""]].

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

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

Более подробно о синтаксисе SQL см. Справочник по SQL для выражений запросов, применяемых в ArcGIS.

При задании этого свойства возникнет ошибка, если сетевой источник данных - портал ArcGIS Online или портал, работающий под управлением ArcGIS Enterprise более ранней версии, чем 11.0.

List
searchSources
(чтение и запись)

При размещении входных данных в сети это свойство задает список используемых сетевых источников и, дополнительно, запрос на ограничение поиска поднабора объектов в классе исходных объектов.

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

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

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

Запросы полезны, если вы не хотите находить объекты, которые могут не подходить для сетевого положения. Например, если вы не хотите искать съезды с автомагистралей, можно задать запрос, исключающий их. Для корректного синтаксиса компонента запроса см. Основы SQL для выражений запроса, применяемых в ArcGIS. Пустая строка "" означает отсутствие запроса для определенного источника.

Например, значение [["Streets", "ROAD_CLASS <> 3"], ["Streets_ND_Junctions", ""]] указывает, что входные данные могут располагаться как в источниках Streets, так и в Streets_ND_Junctions. Выражение SQL для исходного класса пространственных объектов Streets запрещает входным данным находиться на улицах, где поле ROAD_CLASS имеет значение 3. Для исходного класса пространственных объектов Streets_ND_Junctions запрос не используется. Значение [["Streets", "ROAD_CLASS <> 3"]] указывает, что для поиска местоположений следует использовать только исходный класс пространственных объектов Streets, и не следует использовать Streets_ND_Junctions. Дополнительно, запрос применяется к Streets.

Это свойство влияет на расположение всех входных типов. Для изменения этого свойства для отдельных входных типов используйте метод setLocateSettingsOverrides.

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

При задании этого свойства возникнет ошибка, если сетевой источник данных - портал ArcGIS Online или портал, работающий под управлением ArcGIS Enterprise более ранней версии, чем 11.0.

String
searchTolerance
(чтение и запись)

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

Это свойство влияет на расположение всех входных типов. Для изменения этого свойства для отдельных входных типов используйте метод setLocateSettingsOverrides.

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

Прежние версии:

При задании этого свойства возникнет ошибка, если сетевой источник данных - портал или портал, работающий под управлением ArcGIS Enterprise более ранней версии, чем 11.0.

Double
searchToleranceUnits
(чтение и запись)

Единицы измерения для свойства searchTolerance. Возвращается свойство и задается в качестве значения в перечислении DistanceUnits. По умолчанию – DistanceUnits.Meters.

Это свойство влияет на расположение всех входных типов. Для изменения этого свойства для отдельных входных типов используйте метод setLocateSettingsOverrides.

Прежние версии:

При задании этого свойства возникнет ошибка, если сетевой источник данных - портал или портал, работающий под управлением ArcGIS Enterprise более ранней версии, чем 11.0.

Object
spatiallyClusterRoutes
(чтение и запись)

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

По умолчанию – True.

Boolean
timeUnits
(чтение и запись)

Единицы, используемые для времени перемещения в выходных данных анализа. Независимо от единиц измерения в стоимостных атрибутах набора сетевых данных выходные данные будут трансформированы в единицы, заданные в этом свойстве. Возвращается свойство и задается в качестве значения в перечислении TimeUnits. По умолчанию – TimeUnits.Minutes.

Object
timeWindowFactor
(чтение и запись)

Определяет ранги значения для временных окон.

Возвращается свойство и задается в качестве участвующего в перечислении Importance. По умолчанию – Importance.Medium.

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

Если задано значение Importance.Medium, соблюдается баланс между сокращением времени в пути и соблюдением временных окон при прибытии.

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

Object
timeZoneForTimeFields
(чтение и запись)

Показывает, выражаются ли значения во временных полях в локальном местном времени входных местоположений или во всемирном координированном времени (UTC). Возвращается свойство и задается в качестве участвующего в перечислении TimeZoneUsage. По умолчанию – TimeZoneUsage.LocalTimeAtLocations.

Object
travelMode
(чтение и запись)

Режим передвижения, используемый для анализа.

Задача выбора маршрута транспорта (VRP) выполняется только с импедансом на основе времени, поэтому доступны только режимы передвижения с импедансом на основе времени.

Значение возвращается и устанавливается как объект 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})

Задает входные объекты, которые будут участвовать в анализе.

setLocateSettingsOverrides (input_type, {search_sources}, {allow_auto_relocate}, {search_tolerance}, {search_tolerance_units})

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

Используя этот метод, вы можете переопределить значения свойств searchSources, allowAutoRelocate, searchTolerance и searchToleranceUnits для назначенного входного класса.

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

solve ()

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

Методы

addFields (input_type, field_description)
ПараметрОписаниеТип данных
input_type

The type of input to which the fields should be added.

Параметр должен быть задан с помощью перечисления VehicleRoutingProblemInputDataType при использовании схемы версии VehicleRoutingProblemSchemaVersion.One или перечисления VehicleRoutingProblemInputDataType2 при использовании схемы версии VehicleRoutingProblemSchemaVersion.Two.

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:

  • Field name—The name of the field that will be added to the input class.
  • Field type—The type of the new field.
  • Field alias—The alternate display name given to the field name.
  • Field length—The length of the field being added. This sets the maximum number of allowable characters for each record of the field. This option is only applicable to fields of type text; the default length is 255.
  • Default value—The default value of the field.
  • Field domain—The geodatabase domain that will be assigned to the field.

Available field types are as follows:

  • TEXT—Any string of characters.
  • FLOAT—Fractional numbers between -3.4E38 and 1.2E38.
  • DOUBLE—Fractional numbers between -2.2E308 and 1.8E308.
  • SHORT—Whole numbers between -32,768 and 32,767.
  • LONG—Whole numbers between -2,147,483,648 and 2,147,483,647.
  • DATE—Date or time.

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

Тип подсчитываемых входных объектов.

Параметр должен быть задан с помощью перечисления VehicleRoutingProblemInputDataType при использовании схемы версии VehicleRoutingProblemSchemaVersion.One или перечисления VehicleRoutingProblemInputDataType2 при использовании схемы версии VehicleRoutingProblemSchemaVersion.Two.

Object
Возвращаемое значение
Тип данныхОписание
Integer

Число строк.

fieldMappings (input_type, {use_location_fields}, {list_candidate_fields})
ПараметрОписаниеТип данных
input_type

The type of input for which the field mappings are returned.

Параметр должен быть задан с помощью перечисления VehicleRoutingProblemInputDataType при использовании схемы версии VehicleRoutingProblemSchemaVersion.One или перечисления VehicleRoutingProblemInputDataType2 при использовании схемы версии VehicleRoutingProblemSchemaVersion.Two.

See descriptions of the fields available for each input type when using the VehicleRoutingProblemSchemaVersion.One schema version or the VehicleRoutingProblemSchemaVersion.Two schema version.

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

Тип входных данных, для которых возвращаются поддерживаемые имена полей.

Параметр должен быть задан с помощью перечисления VehicleRoutingProblemInputDataType при использовании схемы версии VehicleRoutingProblemSchemaVersion.One или перечисления VehicleRoutingProblemInputDataType2 при использовании схемы версии VehicleRoutingProblemSchemaVersion.Two.

See descriptions of the fields available for each input type when using the VehicleRoutingProblemSchemaVersion.One schema version or the VehicleRoutingProblemSchemaVersion.Two schema version.

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.

Параметр должен быть задан с помощью перечисления VehicleRoutingProblemInputDataType при использовании схемы версии VehicleRoutingProblemSchemaVersion.One или перечисления VehicleRoutingProblemInputDataType2 при использовании схемы версии VehicleRoutingProblemSchemaVersion.Two.

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 when using the VehicleRoutingProblemSchemaVersion.One schema version or the VehicleRoutingProblemSchemaVersion.Two schema version.

In addition to regular fields, you can also set the geometry of the input using one of the following geometry tokens:

  • SHAPE@XYA tuple of the feature's centroid x,y coordinates.
  • SHAPE@XYZ
  • SHAPE@JSON The esri JSON string representing the geometry.
  • SHAPE@WKBThe well-known binary (WKB) representation for OGC geometry. It provides a portable representation of a geometry value as a contiguous stream of bytes.
  • SHAPE@WKTThe well-known text (WKT) representation for OGC geometry. It provides a portable representation of a geometry value as a text string.
  • SHAPE@A geometry object for the feature.

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.

Параметр должен быть задан с помощью перечисления VehicleRoutingProblemInputDataType при использовании схемы версии VehicleRoutingProblemSchemaVersion.One или перечисления VehicleRoutingProblemInputDataType2 при использовании схемы версии VehicleRoutingProblemSchemaVersion.Two.

Object
features

The input features to load. This parameter accepts the following input types:

  • Catalog path to a feature class or a table
  • Layer object
  • String representing the name of a layer
  • FeatureSet or RecordSet object

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.

See descriptions of the fields available for each input type when using the VehicleRoutingProblemSchemaVersion.One schema version or the VehicleRoutingProblemSchemaVersion.Two schema version.

(Значение по умолчанию — 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
setLocateSettingsOverrides (input_type, {search_sources}, {allow_auto_relocate}, {search_tolerance}, {search_tolerance_units})
ПараметрОписаниеТип данных
input_type

The type of input for which to override default locate settings.

Параметр должен быть задан с помощью перечисления VehicleRoutingProblemInputDataType при использовании схемы версии VehicleRoutingProblemSchemaVersion.One или перечисления VehicleRoutingProblemInputDataType2 при использовании схемы версии VehicleRoutingProblemSchemaVersion.Two.

Locate settings do not apply to table-based inputs and inputs that do not locate on the network. For the vehicle routing problem solver, only orders, depots, and barriers locate on the network and are valid input types for this method. The method returns an error if an inapplicable input type is specified.

Object
search_sources
[[Source, Expression],...]

The list of network sources to be used when locating inputs of the designated type on the network, and, optionally, a query to restrict the search to a subset of the features within a source feature class.

See the documentation for the searchSources property for examples of proper syntax for this parameter.

Specifying a value for this parameter overrides the default searchSources property value for the designated input type.

If this parameter is not specified or is set to None, the searchSources value will be used for this input type.

The method returns an error if this parameter is used and the network data source is ArcGIS Online.

String
allow_auto_relocate

Specifies whether inputs of the designated type with existing network location fields can be automatically relocated at solve time to ensure valid, routable location fields for the analysis. If the value is True, points located on restricted network elements and points affected by barriers will be relocated to the closest routable location. If the value is False, network location fields will be used as is, even if the points are unreachable, and this may cause the solve to fail.

Even if the value is False, inputs with no location fields or incomplete location fields will be located at solve time.

Specifying a value for this parameter overrides the default allowAutoRelocate property value for the designated input type.

If this parameter is not specified or is set to None, the allowAutoRelocate value will be used for this input type.

The method returns an error if the network data source is ArcGIS Online.

The method returns an error if the network data source is an ArcGIS Enterprise portal that does not support using network location fields.

Boolean
search_tolerance

The maximum search distance to use when locating inputs of the designated type on the network.

Specifying a value for this parameter overrides the default searchTolerance property value for the designated input type.

If this parameter is not specified or is set to None, the searchTolerance value will be used for this input type.

The units of this parameter value are set using the search_tolerance_units parameter; however, if no value is set for that parameter, the search_tolerance value will be interpreted in the units specified in the searchToleranceUnits property.

This parameter does not apply to line and polygon barriers; the method will return an error if this parameter is specified when the input_type value is one of these barrier types.

Double
search_tolerance_units

The units of the maximum search distance when locating inputs of the designated type of the network. The parameter is specified using a member of the DistanceUnits enumeration.

Specifying a value for this parameter overrides the default searchToleranceUnits property value for the designated input type.

If this parameter is not specified or is set to None, the searchToleranceUnits will be used for this input type.

The value specified using the search_tolerance parameter is interpreted using these units. If that parameter is not specified, the value of the searchTolerance property will be interpreted using these units for the designated input type only.

This parameter does not apply to line and polygon barriers; the method will return an error if this parameter is specified when the input_type value is one of these barrier types.

Double
solve ()
Возвращаемое значение
Тип данныхОписание
Object

Объект arcpy.nax.VehicleRoutingProblemResult, который можно использовать для доступа к выходным данным и сообщениям механизма расчета.

Пример кода

VehicleRoutingProblem, пример 1

Выполняет анализ задачи выбора маршрута транспорта.

# An example showing how to perform vehicle routing problem analysis using inputs from feature classes and tables.
import arcpy
arcpy.CheckOutExtension("network")

nds = "C:/data/NorthAmerica.gdb/Routing/Routing_ND"
nd_layer_name = "Routing_ND"
input_orders = "C:/data/io.gdb/Orders"
input_depots = "C:/data/io.gdb/Depots"
input_routes = "C:/data/io.gdb/Vehicles"
output_stops = "C:/data/io.gdb/AssignedStops"
output_routes = "C:/data/io.gdb/Routes"
output_directions = "C:/data/io.gdb/Directions"
unassigned_stops = "C:/data/io.gdb/UnassignedStops"

# 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 VehicleRoutingProblem solver object
vrp = arcpy.nax.VehicleRoutingProblem(nd_layer_name)
# Set properties
vrp.travelMode = travel_mode
vrp.distanceUnits = arcpy.nax.DistanceUnits.Miles
vrp.routeShapeType = arcpy.nax.RouteShapeType.TrueShape
vrp.returnDirections = True
vrp.returnStopShapes = True
# Load inputs
vrp.load(arcpy.nax.VehicleRoutingProblemInputDataType.Orders, input_orders)
vrp.load(arcpy.nax.VehicleRoutingProblemInputDataType.Depots, input_depots)
vrp.load(arcpy.nax.VehicleRoutingProblemInputDataType.Routes, input_routes)
# Solve the analysis
result = vrp.solve()

# Export the results to feature classes
if result.solveSucceeded:
    result.export(arcpy.nax.VehicleRoutingProblemOutputDataType.Stops, output_stops)
    result.export(arcpy.nax.VehicleRoutingProblemOutputDataType.Routes, output_routes)
    result.export(arcpy.nax.VehicleRoutingProblemOutputDataType.Directions, output_directions)
    if result.isPartialSolution:
        print("Some of the orders were not assigned.")
        result.export(arcpy.nax.VehicleRoutingProblemOutputDataType.UnassignedStops, unassigned_stops)
else:
    print("Solved failed")
    print(result.solverMessages(arcpy.nax.MessageSeverity.All))
VehicleRoutingProblem, пример 2

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

# An example showing how to perform vehicle routing problem analysis using inputs from feature classes and tables.
import arcpy
arcpy.CheckOutExtension("network")

nds = "C:/data/NorthAmerica.gdb/Routing/Routing_ND"
nd_layer_name = "Routing_ND"
input_orders = "C:/data/io.gdb/Orders"
input_depots = "C:/data/io.gdb/Depots"
input_routes = "C:/data/io.gdb/Vehicles"
output_orders = "C:/data/io.gdb/VisitedOrders"
output_routes = "C:/data/io.gdb/Routes"
output_depots_visits = "C:/data/io.gdb/DepotVisits"

# 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 VehicleRoutingProblem solver object using schema version Two
vrp = arcpy.nax.VehicleRoutingProblem(nd_layer_name, arcpy.nax.VehicleRoutingProblemSchemaVersion.Two)
# Set properties
vrp.travelMode = travel_mode
vrp.distanceUnits = arcpy.nax.DistanceUnits.Miles
vrp.routeShapeType = arcpy.nax.RouteShapeType.TrueShape
vrp.returnDirections = True
# Load inputs
vrp.load(arcpy.nax.VehicleRoutingProblemInputDataType2.Orders, input_orders)
vrp.load(arcpy.nax.VehicleRoutingProblemInputDataType2.Depots, input_depots)
vrp.load(arcpy.nax.VehicleRoutingProblemInputDataType2.Routes, input_routes)
# Solve the analysis
result = vrp.solve()

# Export the results to feature classes
if result.solveSucceeded:
    result.export(arcpy.nax.VehicleRoutingProblemOutputDataType2.Orders, output_orders)
    result.export(arcpy.nax.VehicleRoutingProblemOutputDataType2.Routes, output_routes)
    result.export(arcpy.nax.VehicleRoutingProblemOutputDataType2.DepotVisits, output_depots_visits)
else:
    print("Solve failed")
    print(result.solverMessages(arcpy.nax.MessageSeverity.All))