Zusammenfassung
Fügt einem Sublayer eines Netzwerkanalyse-Layers ein Feld hinzu.
Verwendung
Das Werkzeug wird meistens zusammen mit dem Werkzeug Standorte hinzufügen verwendet, um Felder von den Eingabe-Features auf die Sublayer zu übertragen. Wenn Sie beispielsweise ein Feld mit dem Namen UniqueID von den Eingabe-Features in den Sublayer "Facilities" des Layers "Service Area" übertragen möchten, verwenden Sie zuerst dieses Werkzeug, um dem Sublayer "Facilities" das Feld UniqueID hinzuzufügen; anschließend verwenden Sie die Feldzuordnungen im Werkzeug Standorte hinzufügen, um Eingabewerte für das Feld UniqueID bereitzustellen.
Allen Sublayern der Netzwerkanalyse-Layer können Felder hinzugefügt werden.
Syntax
arcpy.na.AddFieldToAnalysisLayer(in_network_analysis_layer, sub_layer, field_name, field_type, {field_precision}, {field_scale}, {field_length}, {field_alias}, {field_is_nullable})| Parameter | Erklärung | Datentyp |
in_network_analysis_layer | Der Netzwerkanalyse-Layer, dem das neue Feld hinzugefügt wird. | Network Analyst Layer |
sub_layer | Der Sublayer des Netzwerkanalyse-Layers, dem das neue Feld hinzugefügt wird. | String |
field_name | Der Name des Felds, das dem ausgewählten Sublayer des Netzwerkanalyse-Layers hinzugefügt wird. | String |
field_type | Der für die Erstellung des neuen Feldes verwendete Feldtyp.
| String |
field_precision (optional) | Die Anzahl der Ziffern, die im Feld gespeichert werden können. Dabei werden alle Ziffern berücksichtigt, unabhängig davon, auf welcher Seite des Dezimalkommas sie sich befinden. Der Parameterwert ist nur für Zahlenfeldtypen gültig. | Long |
field_scale (optional) | Die Anzahl der Dezimalstellen, die in einem Feld gespeichert werden können. Dieser Parameter wird nur für die Felddatentypen "float" und "double" verwendet. | Long |
field_length (optional) | Die Länge des hinzugefügten Feldes. Dadurch wird die maximal zulässige Anzahl von Zeichen für jeden Datensatz des Feldes festgelegt. Dieser Parameter ist nur für Felder vom Typ "Text" anwendbar. | Long |
field_alias (optional) | Der alternative Name für den Feldnamen. Dieser Name dient als Beschreibung für kryptische Feldnamen. Dieser Parameter gilt nur für Geodatabases. | String |
field_is_nullable (optional) | Gibt an, ob NULL-Werte im Feld enthalten sein dürfen. NULL-Werte unterscheiden sich von Nullfeldern oder leeren Feldern. Sie werden nur für Felder in einer Geodatabase unterstützt.
| Boolean |
Abgeleitete Ausgabe
| Name | Erklärung | Datentyp |
| output_layer | Der aktualisierte Netzwerkanalyse-Layer. | Network Analyst-Layer |
Codebeispiel
Im folgenden Skript für das Python-Fenster wird veranschaulicht, wie dem Sublayer "Facilities" des Netzwerkanalyse-Layers "Service Area" das Feld UniqueID hinzugefügt wird.
arcpy.na.AddFieldToAnalysisLayer("Service Area", "Facilities", "UniqueID",
"LONG")Im folgenden eigenständigen Python-Skript wird veranschaulicht, wie mit der Funktion AddFieldToAnalysisLayer das Feld StationID aus den Eingabe-Features für Feuerwachen in die bei der Einzugsgebiet-Analyse berechneten Polygon-Features für die Einzugsgebiete von 2, 3 und 5 Minuten übertragen wird. Das Feld StationID kann dazu verwendet werden, weitere Attribute in den Feuerwachen-Features mit den Polygon-Features für das Einzugsgebiet zu verbinden.
Ältere Versionen:
Mit der Funktion GetNASublayer kann nach den Sublayern eines Netzwerkanalyse-Layers gesucht werden. Sie wurde in ArcGIS Pro 2.7 eingeführt. In älteren Softwareversionen bestand die beste Möglichkeit, ein Sublayer-Objekt eines Netzwerkanalyse-Layers abzurufen, in der Verwendung der listLayers-Methode des Layer-Objekts der Netzwerkanalyse mit dem Namen des Sublayers als Platzhalter.
# 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))Umgebungen
Lizenzinformationen
- Basic: Ja
- Standard: Ja
- Advanced: Ja