Добавить поле к слою анализа (Network Analyst)

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

Позволяет добавить поле в подслой слоя сетевого анализа.

Использование

• Это инструмент, как правило, используется вместе с инструментом Добавить положения для переноса полей из входных объектов в подслои. Например, если необходимо перенести поле с именем UniqueID из входных объектов в подслой Пункты обслуживания слоя Область обслуживания, используйте этот инструмент, чтобы сначала добавить поле UniqueID в подслой Пункты обслуживания. Затем воспользуйтесь сопоставлением полей в инструменте Добавить положения для предоставления входных значений для поля UniqueID.

• Поля можно добавлять в любой подслой слоев сетевого анализа.

Параметры

Диалог

Подпись	Описание	Тип данных
Входной слой сетевого анализа	Слой сетевого анализа, к которому будет добавлено новое поле.	Network Analyst Layer
Подслой	Подслой слоя сетевого анализа, к которому будет добавлено новое поле.	String
Имя поля	Имя поля, добавляемого в указанный подслой слоя сетевого анализа.	String
Тип поля	Определяет тип поля, который будет применен к создаваемому полю. Текст—Тип поля будет Текст. Текстовые поля поддерживают строку символов. С плавающей точкой (32-разрядное с плавающей точкой)—Тип поля будет С плавающей точкой. Поля типа С плавающей точкой поддерживают дробные числа от -3.4E38 до 1.2E38. Двойной точности (64-разрядное с плавающей точкой)—Тип поля будет Двойной точности. Поля типа Двойной точности поддерживают дробные числа от -2.2E308 до 1.8E308. Короткое целое (16-разрядное целочисленное)—Тип поля будет Короткое целое. Поля типа Короткое целое поддерживают целые числа от -32 768 до 32 767. Длинное целое (32-разрядное целочисленное)—Тип поля будет Длинное целое. Поля типа Длинное целое поддерживают целые числа от -2 147 483 648 до 2 147 483 647. Date—Типом поля будет Дата. Поля даты поддерживают значения даты и времени. BLOB (большой двоичный объект)—Тип поля будет BLOB. Поле BLOB поддерживает данные, хранящиеся в виде длинной последовательности двоичных чисел. Необходимо использовать пользовательский загрузчик или вьюер, или приложение сторонних производителей для загрузки элементов в поле типа BLOB или просмотра его содержимого. GUID (глобальный уникальный идентификатор)—Типом поля будет GUID. В полях GUID хранятся строки в стиле реестра, состоящие из 36 символов, заключенных в фигурные скобки. Большое целочисленное (64-разрядное целое число)—Типом поля будет большое целое. Поля типа Big integer поддерживают целые числа в диапазоне от -(2^53) до 2^53. Только время—Типом поля будет только время. Поля только для времени поддерживают значения времени без значений дат. Только дата—Типом поля будет только дата. Поля только для даты поддерживают значения даты без значений времени. Сдвиг метки времени—Типом поля будет сдвиг метки времени. Поля сдвига метки времени поддерживают дату, время и сдвиг от значения UTC.	String
Разрядность поля (Дополнительный)	Прежние версии: Этот параметр является устаревшим и поддерживается только для обратной совместимости.	Long
Точность поля (Дополнительный)	Прежние версии: Этот параметр является устаревшим и поддерживается только для обратной совместимости.	Long
Длина поля (Дополнительный)	Длина поля Устанавливает максимально возможное количество знаков для каждой записи в поле. Если длина поля не указана, будет использоваться длина 255. Длина поля применяется только к текстовым полям.	Long
Псевдоним поля (Дополнительный)	Альтернативное имя для поля. Это имя используется для описания непонятных имен полей. Данный параметр применяется только к базам геоданных.	String
Поле может содержать значения null (Дополнительный)	Определяет, может ли поле содержать пустые значения. Пустые (NULL) значения отличаются от 0 или пустых полей и поддерживаются только для полей в базе геоданных. Отмечено - поле может содержать значения null. Это значение по умолчанию Не отмечено – значения null для поля недопустимы.	Boolean

Производные выходные данные

Подпись	Описание	Тип данных
Обновленный входной подслой	Обновленный слой сетевого анализа.	Network Analyst Layer

Python

arcpy.na.AddFieldToAnalysisLayer(in_network_analysis_layer, sub_layer, field_name, field_type, {field_precision}, {field_scale}, {field_length}, {field_alias}, {field_is_nullable})

Имя	Описание	Тип данных
in_network_analysis_layer	Слой сетевого анализа, к которому будет добавлено новое поле.	Network Analyst Layer
sub_layer	Подслой слоя сетевого анализа, к которому будет добавлено новое поле.	String
field_name	Имя поля, добавляемого в указанный подслой слоя сетевого анализа.	String
field_type	Определяет тип поля, который будет применен к создаваемому полю. LONG—Тип поля будет Длинное целое. Поля типа Длинное целое поддерживают целые числа от -2 147 483 648 до 2 147 483 647. TEXT—Тип поля будет Текст. Текстовые поля поддерживают строку символов. FLOAT—Тип поля будет С плавающей точкой. Поля типа С плавающей точкой поддерживают дробные числа от -3.4E38 до 1.2E38. DOUBLE—Тип поля будет Двойной точности. Поля типа Двойной точности поддерживают дробные числа от -2.2E308 до 1.8E308. SHORT—Тип поля будет Короткое целое. Поля типа Короткое целое поддерживают целые числа от -32 768 до 32 767. DATE—Типом поля будет Дата. Поля даты поддерживают значения даты и времени. BLOB—Тип поля будет BLOB. Поле BLOB поддерживает данные, хранящиеся в виде длинной последовательности двоичных чисел. Необходимо использовать пользовательский загрузчик или вьюер, или приложение сторонних производителей для загрузки элементов в поле типа BLOB или просмотра его содержимого. GUID—Типом поля будет GUID. В полях GUID хранятся строки в стиле реестра, состоящие из 36 символов, заключенных в фигурные скобки. BIGINTEGER—Типом поля будет большое целое. Поля типа Big integer поддерживают целые числа в диапазоне от -(2^53) до 2^53. TIMEONLY—Типом поля будет только время. Поля только для времени поддерживают значения времени без значений дат. DATEONLY—Типом поля будет только дата. Поля только для даты поддерживают значения даты без значений времени. TIMESTAMPOFFSET—Типом поля будет сдвиг метки времени. Поля сдвига метки времени поддерживают дату, время и сдвиг от значения UTC.	String
field_precision (Дополнительный)	Прежние версии: Этот параметр является устаревшим и поддерживается только для обратной совместимости.	Long
field_scale (Дополнительный)	Прежние версии: Этот параметр является устаревшим и поддерживается только для обратной совместимости.	Long
field_length (Дополнительный)	Длина поля Устанавливает максимально возможное количество знаков для каждой записи в поле. Если длина поля не указана, будет использоваться длина 255. Длина поля применяется только к текстовым полям.	Long
field_alias (Дополнительный)	Альтернативное имя для поля. Это имя используется для описания непонятных имен полей. Данный параметр применяется только к базам геоданных.	String
field_is_nullable (Дополнительный)	Определяет, может ли поле содержать пустые значения. Пустые (NULL) значения отличаются от 0 или пустых полей и поддерживаются только для полей в базе геоданных. NULLABLE—Поле может содержать значения null. Это значение по умолчанию NON_NULLABLE—Поле не может содержать значения null.	Boolean

Производные выходные данные

Имя	Описание	Тип данных
output_layer	Обновленный слой сетевого анализа.	Network Analyst Layer

Пример кода

AddFieldToAnalysisLayer, пример 1 (окно Python)

Следующий скрипт окна Python демонстрирует процедуру добавления поля UniqueID в подслой Пункты обслуживания слоя сетевого анализа Область обслуживания.

arcpy.na.AddFieldToAnalysisLayer("Service Area", "Facilities", "UniqueID",
                                    "LONG")

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

Следующий автономный скрипт Python демонстрирует процесс использования функции AddFieldToAnalysisLayer для переноса поля StationID из входных объектов пожарных частей в объекты полигона зон 2-, 3- и 5-минутной доступности, вычисленные при анализе области обслуживания. Поле StationID может использоваться для объединения атрибутов объектов пожарных частей с объектами полигонов зон обслуживания.

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

Функцию GetNASublayer можно использовать для извлечения подслоев слоя сетевого анализа. Она была введена в ArcGIS Pro 2.7. В более ранних версиях программного обеспечения лучшим способом извлечения объекта подслоя слоя сетевого анализа было использование метода listLayers объекта сетевого анализа Layer, использующего имя подслоя в качестве подстановочного знака.

# Name: AddFieldToAnalysisLayer_Workflow.py
# Description: Transfers the Address field from the input fire station
#              features to the 2-,3-, and 5-minute service area polygon features
#              calculated from a service area analysis. The Address field can
#              be used to join other attributes from the fire station features
#              to the service area polygon features.
# Requirements: Network Analyst Extension

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

try:
    #Check out Network Analyst license if available. Fail if the Network Analyst license is not available.
    if arcpy.CheckExtension("network") == "Available":
        arcpy.CheckOutExtension("network")
    else:
        raise arcpy.ExecuteError("Network Analyst Extension license is not available.")
    
    #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")
    layer_name = "FireStationsCoverage"
    travel_mode = "Driving Time"
    cutoffs = [2, 3, 5] #minutes
    field_to_add = "Address"
    field_type = "TEXT"
    facilities = os.path.join(input_gdb, "Analysis", "FireStations")
    search_tolerance = "2 Miles"
    out_featureclass = os.path.join(output_dir, "Output.gdb",
                                                    "FireStationsCoverageArea")

    #Create a new service area analysis layer. For this scenario, the default
    #value for all the remaining parameters statisfies the analysis requirements
    result_object = arcpy.na.MakeServiceAreaAnalysisLayer(network, layer_name,
                                                travel_mode, cutoffs=cutoffs)

    #Get the layer object from the result object. The service area layer can now
    #be referenced using the layer object.
    layer_object = result_object.getOutput(0)

    #Get the names of all the sublayers within the service area layer.
    sublayer_names = arcpy.na.GetNAClassNames(layer_object)
    #Stores the layer names that we will use later
    facilities_layer_name = sublayer_names["Facilities"]
    polygons_layer_name = sublayer_names["SAPolygons"]

    #Add the Address field to the Facilities sublayer of the service area layer.
    #This is done before loading the fire stations as facilities so that the
    #Address values can be transferred from the input features to the
    #Facilities sublayer.
    arcpy.na.AddFieldToAnalysisLayer(layer_object, facilities_layer_name,
                                        field_to_add, field_type)

    #Add the fire station features as Facilities and map the Name and the
    #Address fields from the fire station features to the Name and Address
    #properties on the Facilities sublayer
    field_mappings = arcpy.na.NAClassFieldMappings(layer_object,
                                                    facilities_layer_name)
    field_mappings['Name'].mappedFieldName = "Name"
    field_mappings['Address'].mappedFieldName = "Address"
    arcpy.na.AddLocations(layer_object, facilities_layer_name, facilities,
                          field_mappings, search_tolerance)

    #Solve the service area layer
    arcpy.na.Solve(layer_object)

    #Get the layer objects for all the sublayers within the service area layer
    facilities_sublayer = layer_object.listLayers(facilities_layer_name)[0]
    polygons_sublayer = layer_object.listLayers(polygons_layer_name)[0]

    #Transfer the Address field from the Facilities sublayer to the Polygons
    #sublayer of the service area layer since we wish to export the polygons.
    #The FacilityID field in the Polygons sublayer is related to the ObjectID
    #field in the Facilities sublayer.
    arcpy.management.JoinField(polygons_sublayer, "FacilityID",
                                facilities_sublayer, "ObjectID", field_to_add)

    #Export the Polygons sublayer to a feature class on disk.
    arcpy.management.CopyFeatures(polygons_sublayer, out_featureclass)

    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 occurred on line %i" % tb.tb_lineno)
    print(str(e))

Параметры среды

Текущая рабочая область

Информация о лицензиях

• Basic: Да
• Standard: Да
• Advanced: Да