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

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

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

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

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

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

Параметры

ПодписьОписаниеТип данных
Входной слой сетевого анализа

Слой сетевого анализа, к которому будет добавлено новое поле.

Network Analyst Layer
Подслой

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

String
Имя поля

Имя поля, добавляемого в указанный подслой слоя сетевого анализа.

String
Тип поля

Определяет тип поля, который будет применен к создаваемому полю.

  • TextТип поля будет Текст. Текстовые поля поддерживают строку символов.
  • С плавающей точкой (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-значное целое число)Типом поля будет большое целочисленное. Поля типа большое целое поддерживают целые числа в диапазоне от -(253) до 253
  • Только времяТипом поля будет только время. Поля только для времени поддерживают значения времени без значения даты.
  • Только датаТипом поля будет только дата. Поля только для даты поддерживают значения даты без значений времени.
  • Сдвиг метки времениТипом поля будет сдвиг метки времени. Поля сдвига метки времени поддерживают дату, время и сдвиг от значения UTC.
String
Разрядность поля
(Дополнительный)
Прежние версии:

Этот параметр является устаревшим и поддерживается только для обратной совместимости.

Long
Точность поля
(Дополнительный)
Прежние версии:

Этот параметр является устаревшим и поддерживается только для обратной совместимости.

Long
Длина поля
(Дополнительный)

Длина поля Устанавливает максимально возможное количество знаков для каждой записи в поле. Если длина поля не указана, будет использоваться длина 255.

Длина поля применяется только к текстовым полям.

Long
Псевдоним поля
(Дополнительный)

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

String
Поле может содержать значения null
(Дополнительный)

Определяет, может ли поле содержать значения null. Пустые (NULL) значения отличаются от 0 или пустых полей и поддерживаются только для полей в базе геоданных.

  • Отмечено - поле может содержать значения null. Используется по умолчанию.
  • Не отмечено – значения null для поля недопустимы.

Boolean

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

ПодписьОписаниеТип данных
Обновленный входной подслой

Обновленный слой сетевого анализа.

Network Analyst Layer

arcpy.management.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Типом поля будет большое целочисленное. Поля типа большое целое поддерживают целые числа в диапазоне от -(253) до 253
  • TIMEONLYТипом поля будет только время. Поля только для времени поддерживают значения времени без значения даты.
  • DATEONLYТипом поля будет только дата. Поля только для даты поддерживают значения даты без значений времени.
  • TIMESTAMPOFFSETТипом поля будет сдвиг метки времени. Поля сдвига метки времени поддерживают дату, время и сдвиг от значения UTC.
String
field_precision
(Дополнительный)
Прежние версии:

Этот параметр является устаревшим и поддерживается только для обратной совместимости.

Long
field_scale
(Дополнительный)
Прежние версии:

Этот параметр является устаревшим и поддерживается только для обратной совместимости.

Long
field_length
(Дополнительный)

Длина поля Устанавливает максимально возможное количество знаков для каждой записи в поле. Если длина поля не указана, будет использоваться длина 255.

Длина поля применяется только к текстовым полям.

Long
field_alias
(Дополнительный)

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

String
field_is_nullable
(Дополнительный)

Определяет, может ли поле содержать значения null. Пустые (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:
    #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"
    impedance = "TravelTime"
    default_break_values = "2 3 5"
    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.MakeServiceAreaLayer(network, layer_name,
                                                    impedance, "",
                                                    default_break_values)

    #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)))