Standorte berechnen (Network Analyst)

Zusammenfassung

Verortet Eingabe-Features in einem Netzwerk und fügt den Eingabe-Features Felder zum Beschreiben der Netzwerkstandorte hinzu. Mit dem Werkzeug werden die Netzwerkstandorte von Eingaben neu berechnet und in einem Network Analyst-Workflow zur Verbesserung der Analyseleistung zum Zeitpunkt der Berechnung verwendet. Mit dem Werkzeug werden die berechneten Netzwerkstandorte der Eingaben in Feldern in den Eingabedaten gespeichert.

Weitere Informationen zur Suche nach Features in einem Netzwerk

Weitere Informationen zum Vorabberechnen von Netzwerkstandorten

Verwendung

  • Mit diesem Werkzeug werden die berechneten Netzwerkstandorte standardmäßig in verschiedenen Feldern mit Netzwerkstandortfeldnamen gespeichert, die von allen Network Analyst-Workflows erkannt werden. Sie können die Namen der Felder, in denen die berechneten Netzwerkstandorte gespeichert werden, jedoch ändern. Wenn Sie dies tun und die vorab berechneten Netzwerkstandorte in einem Workflow verwenden, ordnen Sie die nicht standardmäßigen Standortfelder mithilfe der Feldzuordnung den entsprechenden Netzwerkstandorteigenschaften zu.

    Es gibt nur einen Grund, warum Feldnamen geändert werden sollten, nämlich wenn in einer Feature-Class separate Standortfelder für andere Netzwerke oder Reisemodi gespeichert werden sollen. Andernfalls verwenden Sie immer die Standardfeldnamen.

    Mithilfe der Parameter Quell-ID-Feld, Quell-OID-Feld, Prozent entlang des Feldes, Seite des Kantenfeldes, Feld für verortete X-Koordinate, Feld für verortete Y-Koordinate, Feld "Abstand von Feature", Feld für verortete Z-Koordinate und Feld "Standortbereiche" können andere Feldnamen angegeben werden.

  • Mit diesem Werkzeug werden lediglich die Netzwerkstandorte von Eingaben mithilfe eines Netzwerk-Datasets berechnet. Netzwerkstandorte für einen Netzwerkanalyseservice können damit nicht berechnet werden.

  • Wenn es sich bei den Eingabe-Features um einen Sublayer eines Netzwerkanalyse-Layers handelt, werden für die Parameter Suchtoleranz, Suchkriterien und Suchabfrage je nach den im Eingabe-Netzwerkanalyse-Layer gespeicherten Standorteigenschaften automatisch Werte angegeben. Wenn der Netzwerkanalyse-Layer für den ausgewählten Sublayer Overrides für Standorteinstellungen enthält, werden diese Einstellungen verwendet. Andernfalls werden die Standardstandorteinstellungen des Netzwerkanalyse-Layers verwendet.

    Weitere Informationen zu Standorteinstellungen eines Netzwerkanalyse-Layers

  • Wenn es sich bei den Eingabe-Features um einen Sublayer eines Netzwerkanalyse-Layers handelt und Sie den Wert des Parameters Suchtoleranz, Suchkriterien oder Suchabfrage ändern, werden beim Ausführen des Werkzeugs für den ausgewählten Sublayer die Overrides für Standorteinstellungen des Netzwerkanalyse-Layers aktualisiert. Durch Speichern dieser Standorteinstellungen im Netzwerkanalyse-Layer wird sichergestellt, dass beim automatischen Neuverorten zum Zeitpunkt der Berechnung dieselben Standorteinstellungen verwendet werden, die Sie bei der ursprünglichen Berechnung der Netzwerkstandorte verwendet haben.

Parameter

BeschriftungErläuterungDatentyp
Eingabe-Features

Die Eingabe-Features, für die die Netzwerkstandorte berechnet werden.

Für Linien- und Polygon-Features werden nur Geodatabase-Feature-Classes unterstützt, da die Netzwerkstandortinformationen in einem BLOB-Feld gespeichert werden.

Table View
Eingabe-Analysenetzwerk
(optional)

Das Netzwerk-Dataset, das zum Berechnen der Standorte verwendet werden soll.

Dieser Parameter ist erforderlich, es sei denn, es wird ein Sublayer eines Netzwerkanalyse-Layers als Eingabe-Features verwendet. In diesem Fall wird der Parameter ausgeblendet und automatisch auf das Netzwerk-Dataset festgelegt, das vom Netzwerkanalyse-Layer referenziert wird.

Network Dataset Layer
Suchtoleranz
(optional)

Die maximale Suchentfernung, die beim Verorten der Eingabe-Features im Netzwerk verwendet werden soll. Features, die sich außerhalb der Suchtoleranz befinden, bleiben unverortet. Der Parameter umfasst einen Wert und Einheiten.

Die Standardeinstellung ist 5.000 Meter.

Wenn es sich bei den Eingabe-Features um einen Sublayer eines Netzwerkanalyse-Layers handelt, wird der Standardwert für diesen Parameter anhand der im Eingabe-Netzwerkanalyse-Layer gespeicherten Standorteigenschaften ermittelt. Wenn der Netzwerkanalyse-Layer für den ausgewählten Sublayer Overrides für Standorteinstellungen enthält, werden diese Einstellungen verwendet. Andernfalls werden die Standardstandorteinstellungen des Netzwerkanalyse-Layers verwendet. Wenn für diesen Parameter ein nicht standardmäßiger Wert festgelegt wird, werden die Overrides für Standorteinstellungen des Netzwerkanalyse-Layers für den ausgewählten Sublayer aktualisiert.

Der Parameter wird nicht für die Berechnung der Standorte für Linien- oder Polygon-Features verwendet.

Linear Unit
Suchkriterien
(optional)

Die Kanten- und Knotenquellen im Netzwerk-Dataset, die beim Verorten von Eingaben im Netzwerk gesucht werden. Wenn das Netzwerk-Dataset beispielsweise separate Feature-Classes referenziert, die Straßen und Gehwege darstellen, können Sie die Eingaben auf Straßen, aber nicht auf Gehwegen verorten.

Im Folgenden werden die verfügbaren Auswahlmöglichkeiten an Fang-Typen für die einzelnen Netzwerkquellen aufgeführt:

  • Keine: Der Punkt wird nicht auf Elementen in dieser Netzwerkquelle verortet.
  • Shape: Der Punkt wird auf dem nächstgelegenen Punkt eines Elements in dieser Netzwerkquelle verortet.
  • Mitte: Diese Option wird nicht mehr unterstützt und verhält sich wie Shape.
  • Ende: Diese Option wird nicht mehr unterstützt und verhält sich wie Shape.

Mit dem Standardwert wird festgelegt, dass in allen Netzwerkquellen verortet wird. Eine Ausnahme bilden Knoten vom Typ "Override", die durch Ausführen des Werkzeugs Netzelemente reduzieren erstellt wurden, und Systemknoten.

Wenn es sich bei den Eingabe-Features um einen Sublayer eines Netzwerkanalyse-Layers handelt, wird der Standardwert für diesen Parameter anhand der im Eingabe-Netzwerkanalyse-Layer gespeicherten Standorteigenschaften ermittelt. Wenn der Netzwerkanalyse-Layer für den ausgewählten Sublayer Overrides für Standorteinstellungen enthält, werden diese Einstellungen verwendet. Andernfalls werden die Standardstandorteinstellungen des Netzwerkanalyse-Layers verwendet. Wenn für diesen Parameter ein nicht standardmäßiger Wert festgelegt wird, werden die Overrides für Standorteinstellungen des Netzwerkanalyse-Layers für den ausgewählten Sublayer aktualisiert.

Value Table
Die nächstgelegene in allen Klassen suchen
(optional)

Vorversion:
Dieser Parameter wird nicht mehr unterstützt und lediglich aus Gründen der Abwärtskompatibilität beibehalten. Eingaben werden immer mit der nächstgelegenen Netzwerkquelle unter allen für die Verortung verwendeten Quellen abgeglichen, was dem Parameterwert MATCH_TO_CLOSEST oder True entspricht.

Boolean
Quell-ID-Feld
(optional)

Der Name des Feldes, das erstellt oder aktualisiert werden soll und mit der ID der Quell-Feature-Class des Netzwerk-Datasets für den berechneten Netzwerkstandort des Eingabe-Features gefüllt wird. Der Standardwert ist SourceID.

Der Parameter wird nicht für die Berechnung der Standorte für Linien- oder Polygon-Features verwendet.

Verwenden Sie diesen Parameter nicht, wenn es sich bei den Eingabe-Features um einen Sublayer eines Netzwerkanalyse-Layers handelt. Netzwerkstandorte in einem Sublayer müssen in Standortfeldern mit den Standardnamen gespeichert werden, da sie sonst beim Berechnen des Layers nicht verwendet werden.

Field
Quell-OID-Feld
(optional)

Der Name des Feldes, das erstellt oder aktualisiert werden soll und mit dem Feldwert ObjectID der Quell-Feature-Class des Netzwerk-Datasets für den berechneten Netzwerkstandort des Eingabe-Features gefüllt wird. Der Standardwert ist SourceOID.

Der Parameter wird nicht für die Berechnung der Standorte für Linien- oder Polygon-Features verwendet.

Verwenden Sie diesen Parameter nicht, wenn es sich bei den Eingabe-Features um einen Sublayer eines Netzwerkanalyse-Layers handelt. Netzwerkstandorte in einem Sublayer müssen in Standortfeldern mit den Standardnamen gespeichert werden, da sie sonst beim Berechnen des Layers nicht verwendet werden.

Field
Prozent entlang des Feldes
(optional)

Der Name des zu erstellenden oder zu aktualisierenden Feldes, mit dem der Prozentsatz des berechneten Netzwerkstandorts entlang des Netzwerkelements, an dem der Standort sich befand, beschrieben wird. Der Standardwert ist PosAlong.

Der Parameter wird nicht für die Berechnung der Standorte für Linien- oder Polygon-Features verwendet.

Verwenden Sie diesen Parameter nicht, wenn es sich bei den Eingabe-Features um einen Sublayer eines Netzwerkanalyse-Layers handelt. Netzwerkstandorte in einem Sublayer müssen in Standortfeldern mit den Standardnamen gespeichert werden, da sie sonst beim Berechnen des Layers nicht verwendet werden.

Field
Seite des Kantenfeldes
(optional)

Der Name des Feldes, das erstellt oder aktualisiert werden soll, mit dem die Seite der Netzwerkkante beschrieben wird, auf der sich der berechnete Netzwerkstandort befindet. Der Standardwert ist SideOfEdge.

Der Parameter wird nicht für die Berechnung der Standorte für Linien- oder Polygon-Features verwendet.

Verwenden Sie diesen Parameter nicht, wenn es sich bei den Eingabe-Features um einen Sublayer eines Netzwerkanalyse-Layers handelt. Netzwerkstandorte in einem Sublayer müssen in Standortfeldern mit den Standardnamen gespeichert werden, da sie sonst beim Berechnen des Layers nicht verwendet werden.

Field
Feld für verortete X-Koordinate
(optional)

Der Name des zu erstellenden oder mit der X-Koordinate des berechneten Netzwerkstandorts zu aktualisierenden Feldes. Der Standardwert ist SnapX.

Der Parameter wird nicht für die Berechnung der Standorte für Linien- oder Polygon-Features verwendet.

Verwenden Sie diesen Parameter nicht, wenn es sich bei den Eingabe-Features um einen Sublayer eines Netzwerkanalyse-Layers handelt. Netzwerkstandorte in einem Sublayer müssen in Standortfeldern mit den Standardnamen gespeichert werden, da sie sonst beim Berechnen des Layers nicht verwendet werden.

Field
Feld für verortete Y-Koordinate
(optional)

Der Name des zu erstellenden oder mit der Y-Koordinate des berechneten Netzwerkstandorts zu aktualisierenden Feldes. Der Standardwert ist SnapY.

Der Parameter wird nicht für die Berechnung der Standorte für Linien- oder Polygon-Features verwendet.

Verwenden Sie diesen Parameter nicht, wenn es sich bei den Eingabe-Features um einen Sublayer eines Netzwerkanalyse-Layers handelt. Netzwerkstandorte in einem Sublayer müssen in Standortfeldern mit den Standardnamen gespeichert werden, da sie sonst beim Berechnen des Layers nicht verwendet werden.

Field
Feld "Abstand von Feature"
(optional)

Der Name des Feldes, das erstellt oder aktualisiert werden soll, mit dem die Entfernung des ursprünglichen Punkt-Features vom berechneten Netzwerkstandort in Metern beschrieben wird. Der Standardwert ist DistanceToNetworkInMeters.

Der Parameter wird nicht für die Berechnung der Standorte für Linien- oder Polygon-Features verwendet.

Verwenden Sie diesen Parameter nicht, wenn es sich bei den Eingabe-Features um einen Sublayer eines Netzwerkanalyse-Layers handelt. Netzwerkstandorte in einem Sublayer müssen in Standortfeldern mit den Standardnamen gespeichert werden, da sie sonst beim Berechnen des Layers nicht verwendet werden.

Field
Feld für verortete Z-Koordinate
(optional)

Der Name des zu erstellenden oder mit der Z-Koordinate des berechneten Netzwerkstandorts zu aktualisierenden Feldes. Der Standardwert ist SnapZ.

Der Parameter wird nur verwendet, wenn das Eingabe-Netzwerk-Dataset eine Konnektivität auf der Grundlage der Z-Koordinatenwerte der Netzwerkquellen unterstützt.

Der Parameter wird nicht für die Berechnung der Standorte für Linien- oder Polygon-Features verwendet.

Verwenden Sie diesen Parameter nicht, wenn es sich bei den Eingabe-Features um einen Sublayer eines Netzwerkanalyse-Layers handelt. Netzwerkstandorte in einem Sublayer müssen in Standortfeldern mit den Standardnamen gespeichert werden, da sie sonst beim Berechnen des Layers nicht verwendet werden.

Field
Feld "Standortbereiche"
(optional)

Der Name des Feldes, das mit den Standortbereichen der berechneten Netzwerkstandorte für die Linien- oder Polygon-Features erstellt oder aktualisiert werden soll. Der Standardwert ist Locations.

Der Parameter wird nur für die Berechnung von Standorten für Linien- oder Polygon-Features verwendet.

Verwenden Sie diesen Parameter nicht, wenn es sich bei den Eingabe-Features um einen Sublayer eines Netzwerkanalyse-Layers handelt. Netzwerkstandorte in einem Sublayer müssen in Standortfeldern mit den Standardnamen gespeichert werden, da sie sonst beim Berechnen des Layers nicht verwendet werden.

Field
Nicht passierbare Teile des Netzwerks ausschließen
(optional)

Vorversion:
Dieser Parameter wird nicht mehr unterstützt und lediglich aus Gründen der Abwärtskompatibilität beibehalten. Analyseeingaben werden in eingeschränkten Netzwerkelementen nicht verortet, was dem Parameterwert EXCLUDE oder True entspricht.

Boolean
Suchabfrage
(optional)

Eine Abfrage, mit der die Suche auf eine Teilmenge der Features innerhalb einer Quell-Feature-Class beschränkt wird. Dies empfiehlt sich, wenn keine Features gesucht werden sollen, die für einen Netzwerkstandort ungeeignet sind. Wenn Sie beispielsweise auf Autobahnauffahrten keine Verortung durchführen möchten, können Sie eine Abfrage definieren, um diese auszuschließen. Für jede Edge- oder Junction-Source-Feature-Class des Netzwerk-Datasets können Sie einen separaten SQL-Ausdruck festlegen.

Auf Netzwerkquellen, die im Bereich Geoverarbeitung nicht ausdrücklich angegeben werden, wird keine Abfrage angewendet.

Standardmäßig wird für keine Quelle eine Abfrage verwendet.

Wenn es sich bei den Eingabe-Features um einen Sublayer eines Netzwerkanalyse-Layers handelt, wird der Standardwert für diesen Parameter anhand der im Eingabe-Netzwerkanalyse-Layer gespeicherten Standorteigenschaften ermittelt. Wenn der Netzwerkanalyse-Layer für den ausgewählten Sublayer Overrides für Standorteinstellungen enthält, werden diese Einstellungen verwendet. Andernfalls werden die Standardstandorteinstellungen des Netzwerkanalyse-Layers verwendet. Wenn für diesen Parameter ein nicht standardmäßiger Wert festgelegt wird, werden die Overrides für Standorteinstellungen des Netzwerkanalyse-Layers für den ausgewählten Sublayer aktualisiert.

Value Table
Reisemodus
(optional)

Der Name des Reisemodus, der verwendet werden soll.

Wenn Sie einen Reisemodus auswählen, werden die Einstellungen des Reisemodus, wie Beschränkungen und Impedanzattribute, beim Berechnen von Netzwerkstandorten berücksichtigt. Wenn beispielsweise die Netzwerkkante, die am nächsten an einem der Eingabepunkte liegt, beim Anwenden des ausgewählten Reisemodus eingeschränkt wird, wird der Punkt vom Werkzeug auf der zweitnächsten Netzwerkkante verortet, die nicht eingeschränkt ist.

Die verfügbaren Reisemodi hängen vom Parameterwert Eingabe-Analysenetzwerk ab.

Wenn ein Sublayer eines Netzwerkanalyse-Layers als Eingabe-Features verwendet wird, wird dieser Parameter ausgeblendet und darf nicht verwendet werden. Beim Berechnen von Netzwerkstandorten wird automatisch der aktuelle Reisemodus des Netzwerkanalyse-Layers verwendet.

String

Abgeleitete Ausgabe

BeschriftungErläuterungDatentyp
Aktualisierte Eingabe-Features

Die aktualisierten Eingabe-Features.

Table View
Network Analyst-Layer

Wenn der Wert des Parameters Eingabe-Features ein Sublayer eines Netzwerkanalyse-Layers ist, wird der übergeordnete Netzwerkanalyse-Layer des Sublayers von diesem abgeleiteten Ausgabeparameter zurückgegeben. Andernfalls wird kein Wert zurückgegeben.

Network Analyst Layer

arcpy.na.CalculateLocations(in_point_features, {in_network_dataset}, {search_tolerance}, {search_criteria}, {match_type}, {source_ID_field}, {source_OID_field}, {position_field}, {side_field}, {snap_X_field}, {snap_Y_field}, {distance_field}, {snap_Z_field}, {location_field}, {exclude_restricted_elements}, {search_query}, {travel_mode})
NameErläuterungDatentyp
in_point_features

Die Eingabe-Features, für die die Netzwerkstandorte berechnet werden.

Für Linien- und Polygon-Features werden nur Geodatabase-Feature-Classes unterstützt, da die Netzwerkstandortinformationen in einem BLOB-Feld gespeichert werden.

Table View
in_network_dataset
(optional)

Das Netzwerk-Dataset, das zum Berechnen der Standorte verwendet werden soll.

Dieser Parameter ist erforderlich, es sei denn, es wird ein Sublayer eines Netzwerkanalyse-Layers als Eingabe-Features verwendet. Geben Sie in diesem Fall für diesen Parameter keinen Wert an oder legen Sie ihn auf das Netzwerk-Dataset fest, das vom Netzwerkanalyse-Layer referenziert wird.

Network Dataset Layer
search_tolerance
(optional)

Die maximale Suchentfernung, die beim Verorten der Eingabe-Features im Netzwerk verwendet werden soll. Features, die sich außerhalb der Suchtoleranz befinden, bleiben unverortet. Der Parameter umfasst einen Wert und Einheiten.

Die Standardeinstellung ist 5.000 Meter.

Wenn es sich bei den Eingabe-Features um einen Sublayer eines Netzwerkanalyse-Layers handelt, wird der Standardwert für diesen Parameter anhand der im Eingabe-Netzwerkanalyse-Layer gespeicherten Standorteigenschaften ermittelt. Wenn der Netzwerkanalyse-Layer für den ausgewählten Sublayer Overrides für Standorteinstellungen enthält, werden diese Einstellungen verwendet. Andernfalls werden die Standardstandorteinstellungen des Netzwerkanalyse-Layers verwendet. Wenn für diesen Parameter ein nicht standardmäßiger Wert festgelegt wird, werden die Overrides für Standorteinstellungen des Netzwerkanalyse-Layers für den ausgewählten Sublayer aktualisiert.

Der Parameter wird nicht für die Berechnung der Standorte für Linien- oder Polygon-Features verwendet.

Linear Unit
search_criteria
[[Source, SnapType],...]
(optional)

Die Kanten- und Knotenquellen im Netzwerk-Dataset, die beim Verorten von Eingaben im Netzwerk gesucht werden. Wenn das Netzwerk-Dataset beispielsweise separate Feature-Classes referenziert, die Straßen und Gehwege darstellen, können Sie die Eingaben auf Straßen, aber nicht auf Gehwegen verorten.

Der Parameterwert wird als Liste mit geschachtelten Listen angegeben. Die geschachtelten Listen bestehen aus zwei Werten, die den Namen und Fangtyp jeder Netzwerkquelle angeben.

Im Folgenden werden die verfügbaren Auswahlmöglichkeiten an Fang-Typen für die einzelnen Netzwerkquellen aufgeführt:

  • NONE: Der Punkt befindet sich nicht an Elementen in dieser Netzwerkquelle.
  • SHAPE: Der Punkt befindet sich am nächsten Punkt eines Elements in dieser Netzwerkquelle.

Der Parameterwert [["Streets","SHAPE"],["Streets_ND_Junctions","NONE"]] gibt zum Beispiel an, dass die Suche auf dem Shape der Quelle Streets, jedoch nicht auf der Quelle Streets_ND_Junctions verortet wird.

Alle Netzwerkkanten- oder -knotenquellen, die nicht in dieser Liste aufgeführt sind, verwenden den Standard-Fangtyp. Es wird empfohlen, dass Sie alle Netzwerkquellen in der Liste einschließen und den Fangtyp jeweils explizit festlegen.

Vorversion:
Früher wurden von diesem Werkzeug die Fangtypoptionen MIDDLE, END und MIDDLE_END unterstützt. Diese Optionen werden nicht mehr unterstützt und lediglich aus Gründen der Abwärtskompatibilität beibehalten. Wenn eine dieser Optionen angegeben wird, verwendet das Werkzeug für diese Netzwerkquelle automatisch die Option SHAPE.

Mit dem Standardwert wird festgelegt, dass in allen Netzwerkquellen verortet wird. Eine Ausnahme bilden Knoten vom Typ "Override", die durch Ausführen des Werkzeugs Netzelemente reduzieren erstellt wurden, und Systemknoten.

Wenn es sich bei den Eingabe-Features um einen Sublayer eines Netzwerkanalyse-Layers handelt, wird der Standardwert für diesen Parameter anhand der im Eingabe-Netzwerkanalyse-Layer gespeicherten Standorteigenschaften ermittelt. Wenn der Netzwerkanalyse-Layer für den ausgewählten Sublayer Overrides für Standorteinstellungen enthält, werden diese Einstellungen verwendet. Andernfalls werden die Standardstandorteinstellungen des Netzwerkanalyse-Layers verwendet. Wenn für diesen Parameter ein nicht standardmäßiger Wert festgelegt wird, werden die Overrides für Standorteinstellungen des Netzwerkanalyse-Layers für den ausgewählten Sublayer aktualisiert.

Value Table
match_type
(optional)

Vorversion:
Dieser Parameter wird nicht mehr unterstützt und lediglich aus Gründen der Abwärtskompatibilität beibehalten. Eingaben werden immer mit der nächstgelegenen Netzwerkquelle unter allen für die Verortung verwendeten Quellen abgeglichen, was dem Parameterwert MATCH_TO_CLOSEST oder True entspricht.

Boolean
source_ID_field
(optional)

Der Name des Feldes, das erstellt oder aktualisiert werden soll und mit der ID der Quell-Feature-Class des Netzwerk-Datasets für den berechneten Netzwerkstandort des Eingabe-Features gefüllt wird. Der Standardwert ist SourceID.

Der Parameter wird nicht für die Berechnung der Standorte für Linien- oder Polygon-Features verwendet.

Verwenden Sie diesen Parameter nicht, wenn es sich bei den Eingabe-Features um einen Sublayer eines Netzwerkanalyse-Layers handelt. Netzwerkstandorte in einem Sublayer müssen in Standortfeldern mit den Standardnamen gespeichert werden, da sie sonst beim Berechnen des Layers nicht verwendet werden.

Field
source_OID_field
(optional)

Der Name des Feldes, das erstellt oder aktualisiert werden soll und mit dem Feldwert ObjectID der Quell-Feature-Class des Netzwerk-Datasets für den berechneten Netzwerkstandort des Eingabe-Features gefüllt wird. Der Standardwert ist SourceOID.

Der Parameter wird nicht für die Berechnung der Standorte für Linien- oder Polygon-Features verwendet.

Verwenden Sie diesen Parameter nicht, wenn es sich bei den Eingabe-Features um einen Sublayer eines Netzwerkanalyse-Layers handelt. Netzwerkstandorte in einem Sublayer müssen in Standortfeldern mit den Standardnamen gespeichert werden, da sie sonst beim Berechnen des Layers nicht verwendet werden.

Field
position_field
(optional)

Der Name des zu erstellenden oder zu aktualisierenden Feldes, mit dem der Prozentsatz des berechneten Netzwerkstandorts entlang des Netzwerkelements, an dem der Standort sich befand, beschrieben wird. Der Standardwert ist PosAlong.

Der Parameter wird nicht für die Berechnung der Standorte für Linien- oder Polygon-Features verwendet.

Verwenden Sie diesen Parameter nicht, wenn es sich bei den Eingabe-Features um einen Sublayer eines Netzwerkanalyse-Layers handelt. Netzwerkstandorte in einem Sublayer müssen in Standortfeldern mit den Standardnamen gespeichert werden, da sie sonst beim Berechnen des Layers nicht verwendet werden.

Field
side_field
(optional)

Der Name des Feldes, das erstellt oder aktualisiert werden soll, mit dem die Seite der Netzwerkkante beschrieben wird, auf der sich der berechnete Netzwerkstandort befindet. Der Standardwert ist SideOfEdge.

Der Parameter wird nicht für die Berechnung der Standorte für Linien- oder Polygon-Features verwendet.

Verwenden Sie diesen Parameter nicht, wenn es sich bei den Eingabe-Features um einen Sublayer eines Netzwerkanalyse-Layers handelt. Netzwerkstandorte in einem Sublayer müssen in Standortfeldern mit den Standardnamen gespeichert werden, da sie sonst beim Berechnen des Layers nicht verwendet werden.

Field
snap_X_field
(optional)

Der Name des zu erstellenden oder mit der X-Koordinate des berechneten Netzwerkstandorts zu aktualisierenden Feldes. Der Standardwert ist SnapX.

Der Parameter wird nicht für die Berechnung der Standorte für Linien- oder Polygon-Features verwendet.

Verwenden Sie diesen Parameter nicht, wenn es sich bei den Eingabe-Features um einen Sublayer eines Netzwerkanalyse-Layers handelt. Netzwerkstandorte in einem Sublayer müssen in Standortfeldern mit den Standardnamen gespeichert werden, da sie sonst beim Berechnen des Layers nicht verwendet werden.

Field
snap_Y_field
(optional)

Der Name des zu erstellenden oder mit der Y-Koordinate des berechneten Netzwerkstandorts zu aktualisierenden Feldes. Der Standardwert ist SnapY.

Der Parameter wird nicht für die Berechnung der Standorte für Linien- oder Polygon-Features verwendet.

Verwenden Sie diesen Parameter nicht, wenn es sich bei den Eingabe-Features um einen Sublayer eines Netzwerkanalyse-Layers handelt. Netzwerkstandorte in einem Sublayer müssen in Standortfeldern mit den Standardnamen gespeichert werden, da sie sonst beim Berechnen des Layers nicht verwendet werden.

Field
distance_field
(optional)

Der Name des Feldes, das erstellt oder aktualisiert werden soll, mit dem die Entfernung des ursprünglichen Punkt-Features vom berechneten Netzwerkstandort in Metern beschrieben wird. Der Standardwert ist DistanceToNetworkInMeters.

Der Parameter wird nicht für die Berechnung der Standorte für Linien- oder Polygon-Features verwendet.

Verwenden Sie diesen Parameter nicht, wenn es sich bei den Eingabe-Features um einen Sublayer eines Netzwerkanalyse-Layers handelt. Netzwerkstandorte in einem Sublayer müssen in Standortfeldern mit den Standardnamen gespeichert werden, da sie sonst beim Berechnen des Layers nicht verwendet werden.

Field
snap_Z_field
(optional)

Der Name des zu erstellenden oder mit der Z-Koordinate des berechneten Netzwerkstandorts zu aktualisierenden Feldes. Der Standardwert ist SnapZ.

Der Parameter wird nur verwendet, wenn das Eingabe-Netzwerk-Dataset eine Konnektivität auf der Grundlage der Z-Koordinatenwerte der Netzwerkquellen unterstützt.

Der Parameter wird nicht für die Berechnung der Standorte für Linien- oder Polygon-Features verwendet.

Verwenden Sie diesen Parameter nicht, wenn es sich bei den Eingabe-Features um einen Sublayer eines Netzwerkanalyse-Layers handelt. Netzwerkstandorte in einem Sublayer müssen in Standortfeldern mit den Standardnamen gespeichert werden, da sie sonst beim Berechnen des Layers nicht verwendet werden.

Field
location_field
(optional)

Der Name des Feldes, das mit den Standortbereichen der berechneten Netzwerkstandorte für die Linien- oder Polygon-Features erstellt oder aktualisiert werden soll. Der Standardwert ist Locations.

Der Parameter wird nur für die Berechnung von Standorten für Linien- oder Polygon-Features verwendet.

Verwenden Sie diesen Parameter nicht, wenn es sich bei den Eingabe-Features um einen Sublayer eines Netzwerkanalyse-Layers handelt. Netzwerkstandorte in einem Sublayer müssen in Standortfeldern mit den Standardnamen gespeichert werden, da sie sonst beim Berechnen des Layers nicht verwendet werden.

Field
exclude_restricted_elements
(optional)

Vorversion:
Dieser Parameter wird nicht mehr unterstützt und lediglich aus Gründen der Abwärtskompatibilität beibehalten. Analyseeingaben werden in eingeschränkten Netzwerkelementen nicht verortet, was dem Parameterwert EXCLUDE oder True entspricht.

Boolean
search_query
[[Source, Expression],...]
(optional)

Eine Abfrage, mit der die Suche auf eine Teilmenge der Features innerhalb einer Quell-Feature-Class beschränkt wird. Dies empfiehlt sich, wenn keine Features gesucht werden sollen, die für einen Netzwerkstandort ungeeignet sind. Wenn Sie beispielsweise auf Autobahnauffahrten keine Verortung durchführen möchten, können Sie eine Abfrage definieren, um diese auszuschließen. Für jede Edge- oder Junction-Source-Feature-Class des Netzwerk-Datasets können Sie einen separaten SQL-Ausdruck festlegen.

Der Parameterwert wird als Liste mit geschachtelten Listen angegeben, wobei pro Netzwerkquelle ein Eintrag angelegt wird. Alle inneren Listen bestehen aus zwei Werten, die den Namen der Netzwerkquelle und den SQL-Ausdruck angeben, der als Abfrage für diese Quelle verwendet wird. Eine leere Zeichenfolge, "", gibt an, dass für eine bestimmte Quelle keine Abfrage verwendet wird.

Der Wert [["Streets", "ROAD_CLASS <> 3"], ["Streets_ND_Junctions", ""]] gibt beispielsweise einen SQL-Ausdruck für die Quell-Feature-Class Streets und keinen Ausdruck für die Quell-Feature-Class Streets_ND_Junctions an. Wenn in der Liste eine Netzwerkquelle nicht enthalten ist, wird dies so interpretiert, dass keine Abfrage vorhanden ist. Der Wert [["Streets", "ROAD_CLASS <> 3"]] entspricht [["Streets", "ROAD_CLASS <> 3"], ["Streets_ND_Junctions", ""]].

Weitere Informationen zur SQL-Syntax finden Sie unter SQL-Referenz für in ArcGIS verwendete Abfrageausdrücke.

Standardmäßig wird für keine Quelle eine Abfrage verwendet.

Wenn es sich bei den Eingabe-Features um einen Sublayer eines Netzwerkanalyse-Layers handelt, wird der Standardwert für diesen Parameter anhand der im Eingabe-Netzwerkanalyse-Layer gespeicherten Standorteigenschaften ermittelt. Wenn der Netzwerkanalyse-Layer für den ausgewählten Sublayer Overrides für Standorteinstellungen enthält, werden diese Einstellungen verwendet. Andernfalls werden die Standardstandorteinstellungen des Netzwerkanalyse-Layers verwendet. Wenn für diesen Parameter ein nicht standardmäßiger Wert festgelegt wird, werden die Overrides für Standorteinstellungen des Netzwerkanalyse-Layers für den ausgewählten Sublayer aktualisiert.

Value Table
travel_mode
(optional)

Der Name des Reisemodus, der verwendet werden soll.

Wenn Sie einen Reisemodus auswählen, werden die Einstellungen des Reisemodus, wie Beschränkungen und Impedanzattribute, beim Berechnen von Netzwerkstandorten berücksichtigt. Wenn beispielsweise die Netzwerkkante, die am nächsten an einem der Eingabepunkte liegt, beim Anwenden des ausgewählten Reisemodus eingeschränkt wird, wird der Punkt vom Werkzeug auf der zweitnächsten Netzwerkkante verortet, die nicht eingeschränkt ist.

Die verfügbaren Reisemodi hängen vom Parameterwert in_network_dataset ab.

Ein arcpy.na.TravelMode-Objekt und eine Zeichenfolge mit der gültigen JSON-Repräsentation eines Reisemodus können ebenfalls als Eingabe für den Parameter verwendet werden.

Wenn ein Sublayer eines Netzwerkanalyse-Layers als Eingabe-Features verwendet wird, legen Sie für diesen Parameter keinen Wert fest. Beim Berechnen von Netzwerkstandorten wird automatisch der aktuelle Reisemodus des Netzwerkanalyse-Layers verwendet.

String

Abgeleitete Ausgabe

NameErläuterungDatentyp
out_point_feature_class

Die aktualisierten Eingabe-Features.

Table View
output_layer

Wenn der Wert des Parameters in_point_features ein Sublayer eines Netzwerkanalyse-Layers ist, wird der übergeordnete Netzwerkanalyse-Layer des Sublayers von diesem abgeleiteten Ausgabeparameter zurückgegeben. Andernfalls wird kein Wert zurückgegeben.

Network Analyst Layer

Codebeispiel

CalculateLocations – Beispiel 1 (Python-Fenster)

Berechnen von Standorten für Punkt-Features

stores = "C:/Data/SanFrancisco.gdb/Analysis/Hospitals/Analysis/Stores"
network = "C:/Data/SanFrancisco.gdb/Transportation/Streets_ND"
arcpy.na.CalculateLocations(stores, network, "5000 Meters",
                            [["Streets", "SHAPE"],
                            ["Streets_ND_Junctions", "NONE"]])
CalculateLocations – Beispiel 2 (Workflow)

Anhand des folgenden Codebeispiels wird gezeigt, wie mit der Funktion CalculateLocations Netzwerkstandorte vorab berechnet werden und wie diese vorab berechneten Netzwerkstandorten in einem arcpy.nax-Workflow verwendet werden.

Der Parameter use_location_fields in der fieldMappings-Methode wird auf "True" festgelegt, um sicherzustellen, dass beim Laden der Analyseeingaben die vorab berechneten Netzwerkstandortfelder verwendet werden. Zudem werden die Netzwerkstandortfelder mit dem Netzwerk-Dataset, dem Reisemodus und den Standorteinstellungen berechnet, die bei der Einzugsgebiets-Analyse verwendet werden, um sicherzustellen, dass die Ergebnisse gültig und konsistent sind.

"""Precalculate network locations with the Calculate Locations
geoprocessing tool, then run a Service Area workflow using
the arcpy.nax solver object. Map the precalculated network
locations using fieldMappings and load.
"""
import arcpy

arcpy.CheckOutExtension("network")

network = "C:/Data/Paris.gdb/Transportation/ParisMultimodal_ND"
input_facilities = "C:/Data/Paris.gdb/Analysis/Stores"
travel_mode = "Driving Time"

# Make a network dataset layer
nd_layer = arcpy.nax.MakeNetworkDatasetLayer(network).getOutput(0)

# Run Calculate Locations to calculate the network locations of
# the points in the input feature class. Use the same network,
# travel mode, and locate settings that will be used in the
# network analysis.
# Set a search_tolerance of 500 meters.
# Use search_criteria to locate only on streets and metro entrances.
# Use search_query to prevent locating on highways (FUNC_CLASS 1)
arcpy.nax.CalculateLocations(
    input_facilities,
    nd_layer,
    search_tolerance="500 Meters",
    search_criteria=[
        ["Streets", "SHAPE"],
        ["Metro_Lines", "NONE"],
        ["Transfer_Stations", "NONE"],
        ["Transfer_Street_Station", "NONE"],
        ["Metro_Entrances", "SHAPE"],
        ["Metro_Stations", "NONE"],
        ["ParisMultimodal_ND_Junctions", "NONE"]
    ],
    search_query=[["Streets", "FUNC_CLASS <> '1'"]],
    travel_mode=travel_mode
)

# Initialize the Service Area solver object
service_area = arcpy.nax.ServiceArea(nd_layer)

# Set the analysis properties. Use the same travel mode and
# locate settings that were used when precalculating the
# network locations
service_area.travelMode = travel_mode
service_area.searchTolerance = 500
service_area.searchToleranceUnits = arcpy.nax.DistanceUnits.Meters
service_area.searchSources = [
    ["Streets", "FUNC_CLASS <> '1'"],
    ["Metro_Entrances", "SHAPE"]
]
service_area.defaultImpedanceCutoffs = [5, 10]

# Construct a field mapping object with network location fields
field_mappings = service_area.fieldMappings(
    arcpy.nax.ServiceAreaInputDataType.Facilities,
    use_location_fields=True
)

# Load the input data using the field mappings
# Location fields are included automatically because
# of the field mappings.
service_area.load(
    arcpy.nax.ServiceAreaInputDataType.Facilities,
    input_facilities,
    field_mappings
)

# Solve the analysis
result = service_area.solve()
print(result.solveSucceeded)

# ...analysis of the results continues...

Lizenzinformationen

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

Verwandte Themen