Feld zu Analyse-Layer hinzufügen (Network Analyst)

Zusammenfassung

Fügt einem Sublayer eines Netzwerkanalyse-Layers ein Feld hinzu.

Verwendung

  • Das Werkzeug wird in der Regel zusammen mit dem Werkzeug Standorte hinzufügen verwendet, um Felder von den Eingabe-Features auf die Sublayer zu übertragen. Um beispielsweise ein Feld namens UniqueID aus den Eingabe-Features in den Sublayer "Einrichtungen" des Einzugsgebiets-Layers zu übertragen, fügen Sie zunächst mit diesem Werkzeug das Feld UniqueID zum Sublayer "Einrichtungen" hinzu. Verwenden Sie anschließend die Feldzuordnungen im Werkzeug Standorte hinzufügen, um Eingabewerte für das Feld UniqueID anzugeben.

  • Allen Sublayern der Netzwerkanalyse-Layer können Felder hinzugefügt werden.

Parameter

BeschriftungErläuterungDatentyp
Eingabe-Netzwerkanalyse-Layer

Der Netzwerkanalyse-Layer, dem das neue Feld hinzugefügt wird.

Network Analyst Layer
Sublayer

Der Sublayer des Netzwerkanalyse-Layers, dem das neue Feld hinzugefügt wird.

String
Feldname

Der Name des Felds, das dem ausgewählten Sublayer des Netzwerkanalyse-Layers hinzugefügt wird.

String
Feldtyp

Gibt den für die Erstellung des neuen Feldes verwendeten Feldtyp an.

  • TextDer Feldtyp ist "Text". Felder des Typs "Text" unterstützen eine Zeichenfolge.
  • Float (32-Bit-Gleitkomma)Der Feldtyp ist "Float". Felder des Typs "Float" unterstützen Bruchzahlen zwischen -3,4E38 und 1,2E38.
  • Double (64-Bit-Gleitkomma)Der Feldtyp ist "Double". Felder des Typs "Double" unterstützen Bruchzahlen zwischen -2,2E308 und 1,8E308.
  • Short (16-Bit-Integer)Der Feldtyp ist "Short". Felder des Typs "Short" unterstützen ganze Zahlen zwischen -32.768 und 32.767.
  • Long (32-Bit-Integer)Der Feldtyp ist "Long". Felder des Typs "Long" unterstützen ganze Zahlen zwischen -2.147.483.648 und 2.147.483.647.
  • DatumDer Feldtyp ist "Date". Felder des Typs "Date" unterstützen Datums- und Uhrzeitwerte.
  • Blob (Binärdaten)Der Feldtyp ist "BLOB". BLOB-Felder unterstützen Daten, die als lange Abfolge von binären Zahlen gespeichert sind. Sie benötigen ein spezielles Programm zum Laden und Anschauen oder eine Anwendung eines Drittanbieters, um Objekte in ein BLOB-Feld zu laden bzw. den Inhalt in einem BLOB-Feld anzuzeigen.
  • GUID (Globally Unique Identifier)Der Feldtyp ist "GUID". In GUID-Feldern werden Zeichenfolgen aus 36 Zeichen gespeichert (ähnlich denen in der Registrierung), die in geschweifte Klammern eingeschlossen sind.
  • Big Integer (64-Bit-Ganzzahl)Der Feldtyp ist "Big Integer". Felder des Typs "Big Integer" unterstützen ganze Zahlen zwischen -(253) und 253.
  • Nur ZeitDer Feldtyp ist "Nur Zeit". Felder des Typs "Nur Zeit" unterstützen Uhrzeitwerte ohne Datumswert.
  • Nur DatumDer Feldtyp ist "Nur Datum". Felder des Typs "Nur Datum" unterstützen Datumswerte ohne Uhrzeitwerte.
  • ZeitstempelversatzDer Feldtyp ist "Zeitstempelversatz". Felder des Typs "Zeitstempelversatz" unterstützen ein Datum, eine Uhrzeit und einen Versatz vom UTC-Wert.
String
Signifikante Stellen (Precision)
(optional)
Vorversion:

Dieser Parameter wird nicht mehr unterstützt und lediglich aus Gründen der Abwärtskompatibilität beibehalten.

Long
Dezimalstellen (Scale)
(optional)
Vorversion:

Dieser Parameter wird nicht mehr unterstützt und lediglich aus Gründen der Abwärtskompatibilität beibehalten.

Long
Feldlänge
(optional)

Die Länge des Feldes. Dadurch wird die maximal zulässige Anzahl von Zeichen für jeden Datensatz des Feldes festgelegt. Wenn keine Feldlänge angegeben ist, beträgt diese 255 Zeichen.

Die Feldlänge gilt nur für Textfelder.

Long
Feldaliasname
(optional)

Der alternative Name für das Feld. Dieser Name dient als Beschreibung für kryptische Feldnamen. Dieser Parameter gilt nur für Geodatabases.

String
Feld erlaubt NULL-Werte
(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.

  • Aktiviert: Das NULL-Werte kann NULL-Werte enthalten. Dies ist die Standardeinstellung.
  • Deaktiviert: Das Feld darf keine NULL-Werte enthalten.

Boolean

Abgeleitete Ausgabe

BeschriftungErläuterungDatentyp
Aktualisierter Eingabe-Sublayer

Der aktualisierte Netzwerkanalyse-Layer.

Network Analyst Layer

arcpy.na.AddFieldToAnalysisLayer(in_network_analysis_layer, sub_layer, field_name, field_type, {field_precision}, {field_scale}, {field_length}, {field_alias}, {field_is_nullable})
NameErläuterungDatentyp
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

Gibt den für die Erstellung des neuen Feldes verwendeten Feldtyp an.

  • LONGDer Feldtyp ist "Long". Felder des Typs "Long" unterstützen ganze Zahlen zwischen -2.147.483.648 und 2.147.483.647.
  • TEXTDer Feldtyp ist "Text". Felder des Typs "Text" unterstützen eine Zeichenfolge.
  • FLOATDer Feldtyp ist "Float". Felder des Typs "Float" unterstützen Bruchzahlen zwischen -3,4E38 und 1,2E38.
  • DOUBLEDer Feldtyp ist "Double". Felder des Typs "Double" unterstützen Bruchzahlen zwischen -2,2E308 und 1,8E308.
  • SHORTDer Feldtyp ist "Short". Felder des Typs "Short" unterstützen ganze Zahlen zwischen -32.768 und 32.767.
  • DATEDer Feldtyp ist "Date". Felder des Typs "Date" unterstützen Datums- und Uhrzeitwerte.
  • BLOBDer Feldtyp ist "BLOB". BLOB-Felder unterstützen Daten, die als lange Abfolge von binären Zahlen gespeichert sind. Sie benötigen ein spezielles Programm zum Laden und Anschauen oder eine Anwendung eines Drittanbieters, um Objekte in ein BLOB-Feld zu laden bzw. den Inhalt in einem BLOB-Feld anzuzeigen.
  • GUIDDer Feldtyp ist "GUID". In GUID-Feldern werden Zeichenfolgen aus 36 Zeichen gespeichert (ähnlich denen in der Registrierung), die in geschweifte Klammern eingeschlossen sind.
  • BIGINTEGERDer Feldtyp ist "Big Integer". Felder des Typs "Big Integer" unterstützen ganze Zahlen zwischen -(253) und 253.
  • TIMEONLYDer Feldtyp ist "Nur Zeit". Felder des Typs "Nur Zeit" unterstützen Uhrzeitwerte ohne Datumswert.
  • DATEONLYDer Feldtyp ist "Nur Datum". Felder des Typs "Nur Datum" unterstützen Datumswerte ohne Uhrzeitwerte.
  • TIMESTAMPOFFSETDer Feldtyp ist "Zeitstempelversatz". Felder des Typs "Zeitstempelversatz" unterstützen ein Datum, eine Uhrzeit und einen Versatz vom UTC-Wert.
String
field_precision
(optional)
Vorversion:

Dieser Parameter wird nicht mehr unterstützt und lediglich aus Gründen der Abwärtskompatibilität beibehalten.

Long
field_scale
(optional)
Vorversion:

Dieser Parameter wird nicht mehr unterstützt und lediglich aus Gründen der Abwärtskompatibilität beibehalten.

Long
field_length
(optional)

Die Länge des Feldes. Dadurch wird die maximal zulässige Anzahl von Zeichen für jeden Datensatz des Feldes festgelegt. Wenn keine Feldlänge angegeben ist, beträgt diese 255 Zeichen.

Die Feldlänge gilt nur für Textfelder.

Long
field_alias
(optional)

Der alternative Name für das Feld. 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.

  • NULLABLEDas Feld kann NULL-Werte enthalten. Dies ist die Standardeinstellung.
  • NON_NULLABLEDas Feld darf keine NULL-Werte enthalten.
Boolean

Abgeleitete Ausgabe

NameErläuterungDatentyp
output_layer

Der aktualisierte Netzwerkanalyse-Layer.

Network Analyst Layer

Codebeispiel

AddFieldToAnalysisLayer – Beispiel 1 (Python-Fenster)

Im folgenden Skript für das Python-Fenster wird veranschaulicht, wie dem Sublayer "Einrichtungen" des Netzwerkanalyse-Layers "Einzugsgebiet" das Feld UniqueID hinzugefügt wird.

arcpy.na.AddFieldToAnalysisLayer("Service Area", "Facilities", "UniqueID",
                                    "LONG")
AddFieldToAnalysisLayer – Beispiel 2 (Workflow)

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 Einzugsgebiets-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.

Vorversion:

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, wobei der Name des Sublayers als Platzhalter verwendet wurde.

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

Lizenzinformationen

  • Basic: Ja
  • Standard: Ja
  • Advanced: Ja

Verwandte Themen