Añadir campo a la capa de análisis (Network Analyst)

Resumen

Agrega un campo a una subcapa de una capa de análisis de red.

Uso

  • La herramienta se utiliza típicamente con la herramienta Agregar ubicaciones para transferir campos desde las entidades de entrada a las subcapas. Por ejemplo, para transferir un campo denominado UniqueID desde las entidades de entrada a la subcapa Instalaciones de la capa de Área de servicio, utilice esta herramienta para agregar primero el campo UniqueID a la subcapa Instalaciones. A continuación, utilice las asignaciones de campos de la herramienta Agregar ubicaciones para proporcionar valores de entrada para el campo UniqueID.

  • Los campos se pueden agregar a cualquiera de las subcapas de las capas de análisis de red.

Parámetros

EtiquetaExplicaciónTipo de datos
Capa de análisis de red de entrada

La capa de análisis de red a la que se agregará el nuevo campo.

Network Analyst Layer
Subcapa

La subcapa de la capa de análisis de red a la que se agregará el nuevo campo.

String
Nombre de campo

El nombre del campo que se agregará a la subcapa especificada de la capa de análisis de red.

String
Tipo de campo

Especifica el tipo de campo que se utilizará en la creación del nuevo campo.

  • TextoEl tipo de campo será texto. Los campos de texto admiten una cadena de caracteres.
  • Flotante (punto flotante de 32 bits)El tipo de campo será flotante. Los campos flotantes admiten números fraccionarios entre -3,4E38 y 1,2E38.
  • Doble (punto flotante de 64 bits)El tipo de campo será doble. Los campos dobles admiten números fraccionarios entre -2,2E308 y 1,8E308.
  • Corto (entero de 16 bits)El tipo de campo será corto. Los campos cortos admiten números enteros entre -32.768 y 32.767.
  • Largo (entero de 32 bits)El tipo de campo será largo. Los campos largos admiten números enteros entre -2.147.483.648 y 2.147.483.647.
  • FechaEl tipo de campo será fecha. Los campos de fecha admiten fecha y hora.
  • Blob (datos binarios)El tipo de campo será BLOB. Los campos BLOB admiten datos almacenados como una secuencia larga de números binarios. Necesita un cargador o un visor personalizado, o una aplicación de terceros, para cargar elementos en un campo BLOB o para visualizar el contenido de un campo BLOB.
  • GUID (identificador único a nivel mundial)El tipo de campo será GUID. Los campos GUID almacenan cadenas de texto de estilo de registro que están compuestas por 36 caracteres encerrados entre paréntesis.
  • Entero grande (entero de 64 bits)El tipo de campo será entero grande. Los campos de números enteros grandes admiten números enteros entre -(253) y 253
  • Solo horaEl tipo de campo será solo hora. Los campos de solo hora admiten valores de hora sin valor de fecha.
  • Solo fechaEl tipo de campo será solo fecha. Los campos de solo fecha admiten valores de fecha sin valores de hora.
  • Desfase de marca de tiempoEl tipo de campo será desfase de marca de tiempo. Los campos de desplazamiento de fecha y hora admiten un valor de fecha, hora y desplazamiento con respecto a UTC.
String
Precisión del campo
(Opcional)
Heredado:

Este parámetro está obsoleto y solo se mantiene para ofrecer compatibilidad con versiones anteriores.

Long
Escala del campo
(Opcional)
Heredado:

Este parámetro está obsoleto y solo se mantiene para ofrecer compatibilidad con versiones anteriores.

Long
Longitud del campo
(Opcional)

La longitud del campo. Esto establece el número máximo de caracteres permitidos para cada registro del campo. Si no se indica la longitud del campo, se utilizará una longitud de 255.

La longitud de campo solo se aplica a los campos de texto.

Long
Alias del campo
(Opcional)

El nombre alternativo del campo. Este nombre se utiliza para describir los nombres de campo crípticos. Este parámetro solo se aplica a geodatabases.

String
Permitir campos nulos
(Opcional)

Especifica si el campo puede contener valores nulos. Los valores nulos son diferentes de los campos vacíos o cero y solo son compatibles con los campos de una geodatabase.

  • Activado: el campo puede contener valores nulos. Esta es la opción predeterminada.
  • Desactivado: el campo no puede contener valores nulos.

Boolean

Salida derivada

EtiquetaExplicaciónTipo de datos
Subcapa de entrada actualizada

La capa de análisis de red actualizada.

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})
NombreExplicaciónTipo de datos
in_network_analysis_layer

La capa de análisis de red a la que se agregará el nuevo campo.

Network Analyst Layer
sub_layer

La subcapa de la capa de análisis de red a la que se agregará el nuevo campo.

String
field_name

El nombre del campo que se agregará a la subcapa especificada de la capa de análisis de red.

String
field_type

Especifica el tipo de campo que se utilizará en la creación del nuevo campo.

  • LONGEl tipo de campo será largo. Los campos largos admiten números enteros entre -2.147.483.648 y 2.147.483.647.
  • TEXTEl tipo de campo será texto. Los campos de texto admiten una cadena de caracteres.
  • FLOATEl tipo de campo será flotante. Los campos flotantes admiten números fraccionarios entre -3,4E38 y 1,2E38.
  • DOUBLEEl tipo de campo será doble. Los campos dobles admiten números fraccionarios entre -2,2E308 y 1,8E308.
  • SHORTEl tipo de campo será corto. Los campos cortos admiten números enteros entre -32.768 y 32.767.
  • DATEEl tipo de campo será fecha. Los campos de fecha admiten fecha y hora.
  • BLOBEl tipo de campo será BLOB. Los campos BLOB admiten datos almacenados como una secuencia larga de números binarios. Necesita un cargador o un visor personalizado, o una aplicación de terceros, para cargar elementos en un campo BLOB o para visualizar el contenido de un campo BLOB.
  • GUIDEl tipo de campo será GUID. Los campos GUID almacenan cadenas de texto de estilo de registro que están compuestas por 36 caracteres encerrados entre paréntesis.
  • BIGINTEGEREl tipo de campo será entero grande. Los campos de números enteros grandes admiten números enteros entre -(253) y 253
  • TIMEONLYEl tipo de campo será solo hora. Los campos de solo hora admiten valores de hora sin valor de fecha.
  • DATEONLYEl tipo de campo será solo fecha. Los campos de solo fecha admiten valores de fecha sin valores de hora.
  • TIMESTAMPOFFSETEl tipo de campo será desfase de marca de tiempo. Los campos de desplazamiento de fecha y hora admiten un valor de fecha, hora y desplazamiento con respecto a UTC.
String
field_precision
(Opcional)
Heredado:

Este parámetro está obsoleto y solo se mantiene para ofrecer compatibilidad con versiones anteriores.

Long
field_scale
(Opcional)
Heredado:

Este parámetro está obsoleto y solo se mantiene para ofrecer compatibilidad con versiones anteriores.

Long
field_length
(Opcional)

La longitud del campo. Esto establece el número máximo de caracteres permitidos para cada registro del campo. Si no se indica la longitud del campo, se utilizará una longitud de 255.

La longitud de campo solo se aplica a los campos de texto.

Long
field_alias
(Opcional)

El nombre alternativo del campo. Este nombre se utiliza para describir los nombres de campo crípticos. Este parámetro solo se aplica a geodatabases.

String
field_is_nullable
(Opcional)

Especifica si el campo puede contener valores nulos. Los valores nulos son diferentes de los campos vacíos o cero y solo son compatibles con los campos de una geodatabase.

  • NULLABLEEl campo puede contener valores nulos. Esta es la opción predeterminada.
  • NON_NULLABLEEl campo no puede contener valores nulos.
Boolean

Salida derivada

NombreExplicaciónTipo de datos
output_layer

La capa de análisis de red actualizada.

Network Analyst Layer

Muestra de código

Ejemplo 1 de AddFieldToAnalysisLayer (ventana de Python)

En la siguiente secuencia de comandos de la ventana de Python muestra cómo agregar un campo UniqueID a la subcapa Instalaciones de la capa de análisis de red de Área de servicio.

arcpy.na.AddFieldToAnalysisLayer("Service Area", "Facilities", "UniqueID",
                                    "LONG")
Ejemplo 2 de AddFieldToAnalysisLayer (flujo de trabajo)

En la siguiente secuencia de comandos de Python independiente se muestra cómo se puede utilizar la función AddFieldToAnalysisLayer para transferir el campo StationID desde las entidades de estación de bomberos de entrada hasta las entidades poligonales de área de servicio a 2, 3 y 5 minutos calculadas a partir de un análisis del área de servicios. El campo StationID se puede utilizar para unir otros atributos de las entidades de estación de bomberos con las entidades poligonales de área de servicio.

Heredado:

La función GetNASublayer se puede utilizar para recuperar las subcapas de una capa de análisis de red. Se introdujo en ArcGIS Pro 2.7. En versiones de software anteriores, la mejor forma de recuperar un objeto de subcapa de una capa de análisis de red era utilizar el método listLayers del objeto de análisis de red Layer utilizando el nombre de subcapa como comodín.

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