ServiceAreaResult

Сводка

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

Описание

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

Свойства

ВладениеОбъяснениеТип данных
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 Pro как запись настроек анализа или для визуализации результатов. Файл слоя также можно открыть в ArcGIS Desktop.

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

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

searchCursor (output_type, field_names, {where_clause})

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

solverMessages (severity)

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

Методы

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

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

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

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

Число строк.

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

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

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

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

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

Object
output_features

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

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

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

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

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

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

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

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

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

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

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

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

Object
field_names
[field_names,...]

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

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

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

  • SHAPE@XYКортеж x, y координат центроида объекта.
  • SHAPE@XYZКортеж x, y, z координат центроида объекта.
  • SHAPE@JSON Строка Esri JSON, представляющая геометрию.
  • SHAPE@WKBСтандартное двоичное (well-known binary, WKB) представление для геометрии OGC. Он обеспечивает портативное представление значения геометрии в виде непрерывного потока байтов.
  • SHAPE@WKTСтандартное текстовое (well-known text, WKT) представление для геометрии OGC. Он обеспечивает портативное представление значения геометрии в виде текстовой строки.
  • SHAPE@Объект geometry (геометрия) для пространственного объекта.

Токены SHAPE@XY и SHAPE@XYZ поддерживаются только точечными выходными типами. Значения x, y и z, возвращаемые при использовании токенов SHAPE@XY и SHAPE@XYZ, находятся в пространственной привязке источника сетевых данных, использованного для анализа.

String
where_clause

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

(Значение по умолчанию — 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".']]