RouteResult

Сводка

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

Описание

Экземпляры этого класса нельзя создавать напрямую. Но они возвращаются методом solve класса Route.

Свойства

ВладениеОбъяснениеТип данных
isPartialSolution
(только чтение)

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

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

Возвращает True, если выполнение механизма расчета было успешным.

Boolean

Обзор метода

МетодОбъяснение
count (output_type)

Возвращает количество строк для выходного типа.

export (output_type, output_features)

Выходные объекты будут созданы в пространственной привязке набора сетевых данных, используемого для анализа. Если установлен параметр среды arcpy.env.outputCoordinateSystem, выходные объекты будут созданы с указанной системой координат.

Экспортирует результаты анализа в класс пространственных объектов или таблицу.

fieldNames (output_type)

Получает список имен полей, поддерживаемых заданным выходным типом.

saveAsLayerFile (file_name)

Сохраняет результат анализа и настройки в файл слоя. Файл слоя можно открыть в ArcGIS Desktop или в ArcGIS Pro, как запись настроек анализа или для визуализации результатов.

Это метод возвращает исключение RuntimeError, если параметр allowSaveLayerFile объекта-механизма расчета задан как False.

saveRouteData (file_name)

Сохранение результатов анализа в файл .zip. Файл .zip можно использовать для публикации маршрутов из анализа в качестве элементов слоя маршрутов в ArcGIS Online или ArcGIS Enterprise с помощью инструмента Опубликовать как слои маршрутов.

Элементы слоев маршрутов можно использовать в различных приложениях, таких как ArcGIS Navigator для указания маршрутов полевым работникам; на панели Указаний направлений движения приложения Map Viewer для дальнейшей настройки маршрута, содержащегося в слое маршрута; или в ArcGIS Pro для создания нового аналитического слоя маршрута из слоя маршрута.

Выходные объекты будут созданы в пространственной привязке набора сетевых данных, используемого для анализа. Если был установлен параметр среды arcpy.env.outputCoordinateSystem, выходные данные будут созданы в этой пространственной привязке.

Если не удается решить, saveRouteData возвращает исключение RuntimeError.

Это метод возвращает исключение RuntimeError, если параметр allowSaveRouteData объекта-механизма расчета задан как False.

searchCursor (output_type, field_names, {where_clause})

Задает курсор поиска для заданного типа выходных данных. Этот курсор предназначен для считывания строк непосредственно из выходных данных.

solverMessages (severity)

Получает сообщения об ошибках, предупреждениях и информационные сообщения, возвращаемые механизмом расчета.

Методы

count (output_type)
ParameterОбъяснениеТип данных
output_type

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

Параметр должен быть задан с помощью перечисления RouteOutputDataType.

Object
Значение отраженного сигнала
Тип данныхОбъяснение
Integer

Число строк.

Не вызывает исключение.

export (output_type, output_features)
ParameterОбъяснениеТип данных
output_type

Тип выходных данных для экспорта.

Параметр должен быть задан с помощью перечисления RouteOutputDataType.

Object
output_features

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

String
fieldNames (output_type)
ParameterОбъяснениеТип данных
output_type

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

Параметр должен быть задан с помощью перечисления RouteOutputDataType.

Object
Значение отраженного сигнала
Тип данныхОбъяснение
String

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

saveAsLayerFile (file_name)
ParameterОбъяснениеТип данных
file_name

Путь к каталогу выходного файла слоя (.lyr) для записи.

String
saveRouteData (file_name)
ParameterОбъяснениеТип данных
file_name

Полный путь к выходному файлу .zip.

String
searchCursor (output_type, field_names, {where_clause})
ParameterОбъяснениеТип данных
output_type

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

Параметр должен быть задан с помощью перечисления RouteOutputDataType.

Object
field_names
[field_names,...]

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

  • 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.

Токены SHAPE@XY и SHAPE@XYZ поддерживаются только точечными выходными типами.

String
where_clause

Возвращается дополнительное выражение, которое ограничивает записи. Более подробно об условиях WHERE и выражениях SQL см. раздел Справочник по SQL для элементов, используемых в выражениях запросов.

(Значение по умолчанию — None)

String
Значение отраженного сигнала
Тип данныхОбъяснение
Object

Объект SolverResultSearchCursor, считывающий строки выходных данных.

solverMessages (severity)
ParameterОбъяснениеТип данных
severity

Тип возвращаемых сообщений.

Параметр должен быть задан с помощью перечисления MessageSeverity.

Object
Значение отраженного сигнала
Тип данныхОбъяснение
List

Сообщения возвращаются в виде списка списков. Внутренний список содержит два значения. Первое из них - число, соответствующее коду сообщения, а второе - его текст.

Пример списка сообщений, который возвращается в случае ошибки анализа матрицы Источник-Назначение.

[[-2147200995, '0 location(s) in "Destinations" are valid.  Need at least 1 valid location(s).'],
 [30024, 'Solve returned a failure.'],
 [-2147200995, 'Insufficient number of valid locations in "Origins" or "Destinations".']]