GetNAClassNames

Сводка

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

Описание

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

Классы сетевого анализа имеют различные характеристики, зависящие от слоя сетевого анализа. Некоторые классы используются для хранения входных данных, используемых в процессе анализа, другие используются для хранения выходных данных, полученных в результате решения задачи сетевого анализа в слое. Классы могут содержать также поля местоположения или диапазоны местоположения, если служат для определения сетевых положений и имеют различную геометрию, такую как точки, линии или полигоны, или не имеют геометрии (другими словами, являются таблицами). Аргументы naclass_edit_type, nalocation_type и shape_type можно использовать для применения дополнительных фильтров к списку классов сетевого анализа. Например, список значений параметра Sub Layer в инструменте Добавить местоположения содержит только те классы сетевого анализа, которые поддерживают режим редактирования ввода, поэтому этот список можно получить, задав значение INPUT аргументу naclass_edit_type.

Синтаксис

GetNAClassNames (network_analyst_layer, {naclass_edit_type}, {nalocation_type}, {shape_type})
ParameterОбъяснениеТип данных
network_analyst_layer

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

Layer
naclass_edit_type

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

  • ANYВключить все классы из слоя сетевого анализа. Это значение используется по умолчанию.
  • INPUTВключить только те классы, которые поддерживают режим ввода в слое сетевого анализа. При использовании этой опции будут включены также классы, которые поддерживают режимы ввода и вывода.
  • OUTPUTВключить только те классы, которые поддерживают режим вывода в слое сетевого анализа. При использовании этой опции будут включены также классы, которые поддерживают режимы ввода и вывода.

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

String
nalocation_type

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

  • ANYВключить все классы из слоя сетевого анализа, независимо от того, поддерживают ли они поля местоположения или нет. Это значение используется по умолчанию.
  • LOCATIONВключить только те классы из слоя сетевого анализа, которые поддерживают поля местоположения или диапазоны местоположения.
  • NOT_LOCATIONВключить только те классы из слоя сетевого анализа, которые не поддерживают поля местоположения или диапазоны местоположения.

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

String
shape_type

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

  • ANYВключить классы всех типов геометрии из слоя сетевого анализа. Это значение используется по умолчанию.
  • POINTВключить только точечные классы из слоя сетевого анализа.
  • LINEВключить только линейные классы из слоя сетевого анализа.
  • POLYGONВключить только полигональные классы из слоя сетевого анализа.
  • NULLВключить только таблицы из слоя сетевого анализа.

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

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

Словарь, ключами которого являются имена классов сетевого анализа, а значениями – имена слоев, ссылающихся на классы сетевого анализа из слоя сетевого анализа.

Пример кода

GetNAClassNames, пример (рабочий процесс)

В этом примере показано, как создать полигоны одно-, двух- и трехминутной области обслуживания для пожарных станций и экспортировать области обслуживания в виде класса пространственных объектов в базу геоданных. Он иллюстрирует использование функции GetNAClassNames для получения входных значений для других функций ArcPy.

# Name: GetNAClassNames_01.py
# Description: Create service areas around fire stations. Use GetNAClassNames
#              to find the names of the Service Area sublayers.
# Requirements: Network Analyst Extension

#Import system modules
import arcpy
from arcpy import env
import os

try:

    #Check out the Network Analyst extension license

    #Set environment settings
    output_dir = "C:/Data"
    #The NA layer's data will be saved to the workspace specified here
    env.workspace = os.path.join(output_dir, "Output.gdb")
    env.overwriteOutput = True

    #Set local variables
    input_gdb = "C:/Data/SanFrancisco.gdb"
    network = os.path.join(input_gdb, "Transportation", "Streets_ND")
    facilities = os.path.join(input_gdb, "Analysis", "FireStations")  
    output_polygons = os.path.join(output_dir, "Output.gdb",
                                                    "FireStationServiceAreas")
    
    #Make a new service area layer
    SA_layer_object = arcpy.na.MakeServiceAreaAnalysisLayer(network,
                                                    "FireStationServiceAreas",
                                                    "Driving Time",
                                                    "FROM_Facilities",
                                                    [1, 2, 3]).getOutput(0)
    
    #Get the network analysis class names from the service area layer
    na_classes = arcpy.na.GetNAClassNames(SA_layer_object)
    
    #Load fire stations as facilities
    arcpy.na.AddLocations(SA_layer_object, na_classes["Facilities"], facilities)
    
    #Solve the service area layer
    arcpy.na.Solve(SA_layer_object)
    
    #Get the polygons sublayer from the service area layer
    polygonsSublayer = SA_layer_object.listLayers(na_classes["SAPolygons"])[0]
    
    #Export the polygons sublayer as a feature class
    arcpy.management.CopyFeatures(polygonsSublayer, output_polygons)
    
    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))

Связанные разделы