Standorte hinzufügen (Network Analyst)

Zusammenfassung

Fügt einem Netzwerkanalyse-Layer Eingabe-Features oder Datensätze hinzufügt. Die Eingaben werden bestimmten Sublayern, z. B. Stopps und Barrieren, hinzugefügt. Wenn der Netzwerkanalyse-Layer ein Netzwerk-Dataset als Netzwerkdatenquelle referenziert, werden die Netzwerkstandorte der Eingaben vom Werkzeug berechnet, es sei denn, über die Eingaben werden vorab berechnete Netzwerkstandortfelder zugeordnet.

Weitere Informationen zur Suche nach Analyseeingaben im Netzwerk mithilfe des Werkzeugs Standorte hinzufügen

Verwendung

  • Beim Verorten von Eingaben werden der Reisemodus des Netzwerkanalyse-Layers und vorhandene Barrieren berücksichtigt. Daher empfiehlt es sich, vor dem Laden anderer Analyseeingaben den Reisemodus für die Analyse festzulegen und Barrieren zu laden.

  • Für die Parameter Suchtoleranz, Suchkriterien und Suchabfrage werden 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 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.

  • Wenn der Analyse-Layer einen Portal-Service referenziert, werden die Standortfelder erst beim Berechnen der Analyse berechnet. Für diese Layer fügt das Werkzeug Standorte hinzufügen die Eingaben dem Analyse-Layer hinzu, ohne dass Standortfelder berechnet werden. Demzufolge gelten einige Werkzeugparameter für diese Layer nicht und werden im Bereich Geoverarbeitung ausgeblendet bzw. in Python ignoriert.

Parameter

BeschriftungErläuterungDatentyp
Eingabe-Netzwerkanalyse-Layer

Der Netzwerkanalyse-Layer, dem die Netzwerkanalyse-Objekte hinzugefügt werden.

Network Analyst Layer
Sublayer

Der Name des Sublayers des Netzwerkanalyse-Layers, dem die Netzwerkanalyse-Objekte hinzugefügt werden.

String
Eingabepositionen

Die Feature-Class oder Tabelle, die die Positionen, die dem Netzwerkanalyse-Layer hinzugefügt werden sollen, enthält.

Table View
Feldzuordnung
(optional)

Die Zuordnung zwischen den Eingabefeldern des Netzwerkanalyse-Sublayers, dem Standorte hinzugefügt werden, und den Feldern in den Eingabedaten oder angegebenen Konstanten.

Eingabe-Sublayer des Netzwerkanalyse-Layers weisen eine Reihe von Eingabefeldern auf, die zum Ändern oder Steuern des Analyseverhaltens ausgefüllt werden können. Wenn Sie dem Sublayer Standorte hinzufügen, können Sie diesen Parameter verwenden, um diesen Feldern im Sublayer Feldwerte aus der Eingabetabelle zuzuordnen. Daneben können Sie den einzelnen Eigenschaften anhand von Feldzuordnungen auch konstante Standardwerte zuweisen.

Wenn weder der Feld- noch der Standardwert für eine Eigenschaft angegeben werden, enthalten die resultierenden Netzwerkanalyse-Objekte NULL-Werte für diese Eigenschaft.

Eine vollständige Liste der Eingabefelder für jeden Sublayer aller Netzwerkanalyse-Layer finden Sie in der Dokumentation zu den einzelnen Layern. Sie können zum Beispiel die Eingabefelder des Sublayers "Stopps" des Routen-Layers untersuchen.

Wenn die Daten, die geladen werden, auf Grundlage des für die Analyse verwendeten Netzwerk-Datasets und Reisemodus vorab berechnete Netzwerkstandorte oder Standortbereiche enthalten, wählen Sie die Option Netzwerkstandortfelder verwenden im Dropdown-Menü aus. Das Hinzufügen von Netzwerkanalyse-Objekten mithilfe von Netzwerkstandortfeldern ist schneller als das Laden durch die Geometrie.

Weitere Informationen zu Netzwerkstandortfeldern

Hinweis:

Von ArcGIS Online und einigen ArcGIS Enterprise-Portalen wird die Verwendung von Netzwerkstandortfeldern nicht unterstützt. Bei Netzwerkanalyse-Layern, für die eines dieser Portale als Netzwerkdatenquelle verwendet wird, werden alle Eingaben zum Zeitpunkt der Berechnung verortet und alle zugeordneten Standortfelder werden ignoriert.

Network Analyst Class FieldMap
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.

Der Standardwert für diesen Parameter wird 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 beim Hinzufügen von Standorten zu Sublayern mit Linien- oder Polygongeometrie wie Linien-Barrieren und Polygon-Barrieren nicht verwendet.

Dieser Parameter wird nicht verwendet, wenn beim Hinzufügen von Standorten vorhandene Netzwerkstandortfelder verwendet werden.

Vorversion:

Dieser Parameter wird nicht verwendet, wenn die Netzwerkdatenquelle des Netzwerkanalyse-Layers ein Portal ist, auf dem eine Version von ArcGIS Enterprise älter als 11.0 ausgeführt wird.

Linear Unit
Sortierfeld
(optional)

Das Feld, in dem die Netzwerkanalyse-Objekte sortiert werden, wenn sie dem Netzwerkanalyse-Layer hinzugefügt werden. Standardmäßig ist dies das Feld ObjectID in der Eingabe-Feature-Class oder der Eingabetabelle.

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

Der Standardwert für diesen Parameter wird 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.

Dieser Parameter wird nicht verwendet, wenn beim Hinzufügen von Standorten vorhandene Netzwerkstandortfelder verwendet werden.

Dieser Parameter wird nicht verwendet, wenn die Netzwerkdatenquelle des Netzwerkanalyse-Layers ArcGIS Online ist.

Vorversion:

Dieser Parameter wird nicht verwendet, wenn die Netzwerkdatenquelle des Netzwerkanalyse-Layers ein Portal ist, auf dem eine Version von ArcGIS Enterprise älter als 11.0 ausgeführt wird.

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
An vorhandene Standorte anhängen
(optional)

Gibt an, ob neue Netzwerkanalyse-Objekte an vorhandene Objekte angehängt werden sollen.

  • Aktiviert: Die neuen Netzwerkanalyse-Objekte werden an die bestehenden Objekte im ausgewählten Sublayer angehängt. Dies ist die Standardeinstellung.
  • Deaktiviert: Die vorhandenen Netzwerkanalyse-Objekte werden gelöscht und durch die neuen Objekte ersetzt.
Boolean
An Netzwerk fangen
(optional)

Gibt an, ob die Eingaben an ihren berechneten Netzwerkstandorten gefangen oder an ihrer ursprünglichen geographischen Position dargestellt werden.

Wenn Sie in der Analyse mit "CurbApproach" steuern möchten, welche Straßenseite ein Fahrzeug benutzen muss, um sich einer Position zu nähern, dann dürfen Sie die Eingaben nicht an ihren Netzwerkstandorten fangen. Verwenden Sie alternativ einen Fangversatz, um sicherzustellen, dass der Punkt klar und deutlich auf einer Straßenseite bleibt.

Der Parameter wird beim Hinzufügen von Standorten zu Sublayern mit Linien- oder Polygongeometrie wie Linien-Barrieren und Polygon-Barrieren nicht verwendet.

Dieser Parameter wird nicht verwendet, wenn die Netzwerkdatenquelle des Eingabe-Netzwerkanalyse-Layers ein Portal-Service ist.

  • Deaktiviert: Die Geometrien der Netzwerkstandorte werden an ihren Netzwerkstandorten gefangen.
  • Deaktiviert: Die Geometrien der Netzwerkstandorte basieren auf den Geometrien der Eingabe-Features. Dies ist die Standardeinstellung.
Boolean
Fangversatz
(optional)

Ein Versatzabstand, der beim Fangen eines Punktes im Netzwerk angewendet wird. Ein Fangversatz von 0 bedeutet, dass der Punkt lagegleich mit dem Netzwerk-Feature (üblicherweise eine Linie) gefangen wird. Wenn der Punkt nicht auf dem Netzwerk-Feature liegen soll, geben Sie einen Fangversatz ein. Der Versatz bezieht sich auf die ursprüngliche Punktposition. Wenn sich der ursprüngliche Punkt also auf der linken Seite befunden hat, ist die neue Position nach links versetzt. Wenn er sich ursprünglich auf der rechten Seite befunden hat, ist die neue Position nach rechts versetzt.

Die Standardeinstellung ist 5 Meter. Dieser Parameter wird jedoch ignoriert, wenn An Netzwerk fangen deaktiviert ist.

Der Parameter wird beim Hinzufügen von Standorten zu Sublayern mit Linien- oder Polygongeometrie wie Linien-Barrieren und Polygon-Barrieren nicht verwendet.

Dieser Parameter wird nicht verwendet, wenn die Netzwerkdatenquelle des Eingabe-Netzwerkanalyse-Layers ein Portal-Service ist.

Linear Unit
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.

Der Standardwert für diesen Parameter wird 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.

Dieser Parameter wird nicht verwendet, wenn beim Hinzufügen von Standorten vorhandene Netzwerkstandortfelder verwendet werden.

Dieser Parameter wird nicht verwendet, wenn die Netzwerkdatenquelle des Netzwerkanalyse-Layers ArcGIS Online ist.

Vorversion:

Dieser Parameter wird nicht verwendet, wenn die Netzwerkdatenquelle des Netzwerkanalyse-Layers ein Portal ist, auf dem eine Version von ArcGIS Enterprise älter als 11.0 ausgeführt wird.

Value Table
Automatisches Neupositionieren zum Zeitpunkt der Berechnung zulassen
(optional)

Gibt an, ob Eingaben mit vorhandenen Netzwerkstandortfeldern zum Zeitpunkt der Berechnung automatisch neu verortet werden können, um gültige, routenfähige Standortfelder für die Analyse zu gewährleisten.

  • Aktiviert: Punkte auf eingeschränkten Netzwerkelementen und von Barrieren betroffene Punkte werden zum Zeitpunkt der Berechnung am nächstgelegenen routenfähigen Standort neu verortet. Dies ist die Standardeinstellung.
  • Deaktiviert: Netzwerkstandortfelder werden zum Zeitpunkt der Berechnung unverändert verwendet, auch wenn die Punkte nicht erreichbar sind und dies dazu führen kann, dass bei der Berechnung Fehler auftreten.

Der Standardwert für diesen Parameter wird 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.

Auch wenn das automatische Neuverorten zum Zeitpunkt der Berechnung nicht zulässig ist, werden Eingaben ohne Standortfelder oder mit unvollständigen Standortfeldern zum Zeitpunkt der Berechnung verortet.

Dieser Parameter wird nicht verwendet, wenn die Netzwerkdatenquelle des Netzwerkanalyse-Layers ArcGIS Online ist.

Dieser Parameter wird nicht verwendet, wenn die Netzwerkdatenquelle des Netzwerkanalyse-Layers ein ArcGIS Enterprise-Portal ist, für das die Verwendung von Netzwerkstandortfeldern nicht unterstützt wird.

Vorversion:

Dieser Parameter wird nicht verwendet, wenn die Netzwerkdatenquelle des Netzwerkanalyse-Layers ein Portal ist, auf dem eine Version von ArcGIS Enterprise älter als 11.0 ausgeführt wird.

Boolean

Abgeleitete Ausgabe

BeschriftungErläuterungDatentyp
Aktualisierter Eingabe-Netzwerkanalyse-Layer

Der aktualisierte Netzwerkanalyse-Layer.

Network Analyst Layer

arcpy.management.AddLocations(in_network_analysis_layer, sub_layer, in_table, {field_mappings}, {search_tolerance}, {sort_field}, {search_criteria}, {match_type}, {append}, {snap_to_position_along_network}, {snap_offset}, {exclude_restricted_elements}, {search_query}, {allow_auto_relocate})
NameErläuterungDatentyp
in_network_analysis_layer

Der Netzwerkanalyse-Layer, dem die Netzwerkanalyse-Objekte hinzugefügt werden.

Network Analyst Layer
sub_layer

Der Name des Sublayers des Netzwerkanalyse-Layers, dem die Netzwerkanalyse-Objekte hinzugefügt werden.

String
in_table

Die Feature-Class oder Tabelle, die die Positionen, die dem Netzwerkanalyse-Layer hinzugefügt werden sollen, enthält.

Table View
field_mappings
(optional)

Die Zuordnung zwischen den Eingabefeldern des Netzwerkanalyse-Sublayers, dem Standorte hinzugefügt werden, und den Feldern in den Eingabedaten oder angegebenen Konstanten.

Eingabe-Sublayer des Netzwerkanalyse-Layers weisen eine Reihe von Eingabefeldern auf, die zum Ändern oder Steuern des Analyseverhaltens ausgefüllt werden können. Wenn Sie dem Sublayer Standorte hinzufügen, können Sie diesen Parameter verwenden, um diesen Feldern im Sublayer Feldwerte aus der Eingabetabelle zuzuordnen. Daneben können Sie den einzelnen Eigenschaften anhand von Feldzuordnungen auch konstante Standardwerte zuweisen.

Wenn weder der Feld- noch der Standardwert für eine Eigenschaft angegeben werden, enthalten die resultierenden Netzwerkanalyse-Objekte NULL-Werte für diese Eigenschaft.

Eine vollständige Liste der Eingabefelder für jeden Sublayer aller Netzwerkanalyse-Layer finden Sie in der Dokumentation zu den einzelnen Layern. Sie können zum Beispiel die Eingabefelder des Sublayers "Stopps" des Routen-Layers untersuchen.

Zum Angeben des Parameterwertes wird ein NAClassFieldMappings -Objekt verwendet, das aus der NAClassFieldMappings-Class abgerufen wurde. Das NAClassFieldMappings-Objekt ist eine Sammlung von NAClassFieldMap-Objekten, die Sie in die Lage versetzt, die Standardwerte festzulegen oder einen Feldnamen aus den Eingabe-Features für die Eigenschaften des Netzwerkanalyse-Objekts zuzuordnen. Wenn die Daten, die geladen werden, Netzwerkstandorte oder Standortbereiche auf Grundlage des für die Analyse verwendeten Netzwerk-Datasets enthalten, müssen Sie die Netzwerkstandortfelder aus den Eingabe-Features den Netzwerkstandorteigenschaften zuordnen. Die Angabe der Netzwerkstandortfelder in den Feldzuordnungen entspricht der Verwendung der Option Netzwerkstandortfelder verwenden im Werkzeugdialogfeld.

Weitere Informationen zu Netzwerkstandortfeldern

Hinweis:

Von ArcGIS Online und einigen ArcGIS Enterprise-Portalen wird die Verwendung von Netzwerkstandortfeldern nicht unterstützt. Bei Netzwerkanalyse-Layern, für die eines dieser Portale als Netzwerkdatenquelle verwendet wird, werden alle Eingaben zum Zeitpunkt der Berechnung verortet und alle zugeordneten Standortfelder werden ignoriert.

Network Analyst Class FieldMap
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.

Der Standardwert für diesen Parameter wird 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 beim Hinzufügen von Standorten zu Sublayern mit Linien- oder Polygongeometrie wie Linien-Barrieren und Polygon-Barrieren nicht verwendet.

Dieser Parameter wird nicht verwendet, wenn beim Hinzufügen von Standorten vorhandene Netzwerkstandortfelder verwendet werden.

Vorversion:

Dieser Parameter wird nicht verwendet, wenn die Netzwerkdatenquelle des Netzwerkanalyse-Layers ein Portal ist, auf dem eine Version von ArcGIS Enterprise älter als 11.0 ausgeführt wird.

Linear Unit
sort_field
(optional)

Das Feld, in dem die Netzwerkanalyse-Objekte sortiert werden, wenn sie dem Netzwerkanalyse-Layer hinzugefügt werden. Standardmäßig ist dies das Feld ObjectID in der Eingabe-Feature-Class oder der Eingabetabelle.

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

Der Standardwert für diesen Parameter wird 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.

Dieser Parameter wird nicht verwendet, wenn beim Hinzufügen von Standorten vorhandene Netzwerkstandortfelder verwendet werden.

Dieser Parameter wird nicht verwendet, wenn die Netzwerkdatenquelle des Netzwerkanalyse-Layers ArcGIS Online ist.

Vorversion:

Dieser Parameter wird nicht verwendet, wenn die Netzwerkdatenquelle des Netzwerkanalyse-Layers ein Portal ist, auf dem eine Version von ArcGIS Enterprise älter als 11.0 ausgeführt wird.

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
append
(optional)

Gibt an, ob neue Netzwerkanalyse-Objekte an vorhandene Objekte angehängt werden sollen.

  • APPENDDie neuen Netzwerkanalyse-Objekte werden an die bestehenden Objekte im ausgewählten Sublayer angehängt. Dies ist die Standardeinstellung.
  • CLEARDie vorhandenen Netzwerkanalyse-Objekte werden gelöscht und durch die neuen Objekte ersetzt.
Boolean
snap_to_position_along_network
(optional)

Gibt an, ob die Eingaben an ihren berechneten Netzwerkstandorten gefangen oder an ihrer ursprünglichen geographischen Position dargestellt werden.

Wenn Sie in der Analyse mit "CurbApproach" steuern möchten, welche Straßenseite ein Fahrzeug benutzen muss, um sich einer Position zu nähern, dann dürfen Sie die Eingaben nicht an ihren Netzwerkstandorten fangen. Verwenden Sie alternativ einen Fangversatz, um sicherzustellen, dass der Punkt klar und deutlich auf einer Straßenseite bleibt.

Der Parameter wird beim Hinzufügen von Standorten zu Sublayern mit Linien- oder Polygongeometrie wie Linien-Barrieren und Polygon-Barrieren nicht verwendet.

Dieser Parameter wird nicht verwendet, wenn die Netzwerkdatenquelle des Eingabe-Netzwerkanalyse-Layers ein Portal-Service ist.

  • NO_SNAPDie Geometrien der Netzwerkstandorte basieren auf den Geometrien der Eingabe-Features. Dies ist die Standardeinstellung.
  • SNAPDie Geometrien der Netzwerkstandorte werden an ihren Netzwerkstandorten gefangen.
Boolean
snap_offset
(optional)

Ein Versatzabstand, der beim Fangen eines Punktes im Netzwerk angewendet wird. Ein Fangversatz von 0 bedeutet, dass der Punkt lagegleich mit dem Netzwerk-Feature (üblicherweise eine Linie) gefangen wird. Wenn der Punkt nicht auf dem Netzwerk-Feature liegen soll, geben Sie einen Fangversatz ein. Der Versatz bezieht sich auf die ursprüngliche Punktposition. Wenn sich der ursprüngliche Punkt also auf der linken Seite befunden hat, ist die neue Position nach links versetzt. Wenn er sich ursprünglich auf der rechten Seite befunden hat, ist die neue Position nach rechts versetzt.

Die Standardeinstellung ist 5 Meter. Dieser Parameter wird jedoch ignoriert, wenn snap_to_position_along_network auf NO_SNAP festgelegt ist.

Der Parameter wird beim Hinzufügen von Standorten zu Sublayern mit Linien- oder Polygongeometrie wie Linien-Barrieren und Polygon-Barrieren nicht verwendet.

Dieser Parameter wird nicht verwendet, wenn die Netzwerkdatenquelle des Eingabe-Netzwerkanalyse-Layers ein Portal-Service ist.

Linear Unit
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.

Der Standardwert für diesen Parameter wird 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.

Dieser Parameter wird nicht verwendet, wenn beim Hinzufügen von Standorten vorhandene Netzwerkstandortfelder verwendet werden.

Dieser Parameter wird nicht verwendet, wenn die Netzwerkdatenquelle des Netzwerkanalyse-Layers ArcGIS Online ist.

Vorversion:

Dieser Parameter wird nicht verwendet, wenn die Netzwerkdatenquelle des Netzwerkanalyse-Layers ein Portal ist, auf dem eine Version von ArcGIS Enterprise älter als 11.0 ausgeführt wird.

Value Table
allow_auto_relocate
(optional)

Gibt an, ob Eingaben mit vorhandenen Netzwerkstandortfeldern zum Zeitpunkt der Berechnung automatisch neu verortet werden können, um gültige, routenfähige Standortfelder für die Analyse zu gewährleisten.

  • ALLOWPunkte auf eingeschränkten Netzwerkelementen und von Barrieren betroffene Punkte werden zum Zeitpunkt der Berechnung am nächstgelegenen routenfähigen Standort neu verortet. Dies ist die Standardeinstellung.
  • NO_ALLOWNetzwerkstandortfelder werden zum Zeitpunkt der Berechnung unverändert verwendet, auch wenn die Punkte nicht erreichbar sind und dies dazu führen kann, dass bei der Berechnung Fehler auftreten.

Der Standardwert für diesen Parameter wird 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.

Auch wenn das automatische Neuverorten zum Zeitpunkt der Berechnung nicht zulässig ist, werden Eingaben ohne Standortfelder oder mit unvollständigen Standortfeldern zum Zeitpunkt der Berechnung verortet.

Dieser Parameter wird nicht verwendet, wenn die Netzwerkdatenquelle des Netzwerkanalyse-Layers ArcGIS Online ist.

Dieser Parameter wird nicht verwendet, wenn die Netzwerkdatenquelle des Netzwerkanalyse-Layers ein ArcGIS Enterprise-Portal ist, für das die Verwendung von Netzwerkstandortfeldern nicht unterstützt wird.

Vorversion:

Dieser Parameter wird nicht verwendet, wenn die Netzwerkdatenquelle des Netzwerkanalyse-Layers ein Portal ist, auf dem eine Version von ArcGIS Enterprise älter als 11.0 ausgeführt wird.

Boolean

Abgeleitete Ausgabe

NameErläuterungDatentyp
output_layer

Der aktualisierte Netzwerkanalyse-Layer.

Network Analyst Layer

Codebeispiel

AddLocations – Beispiel 1 (Python-Fenster)

Führen Sie das Werkzeug im Python-Fenster aus, um einem Routenanalyse-Layer mit dem Namen Route Stopps hinzuzufügen.

import arcpy
hospitals = "C:/Data/SanFrancisco.gdb/Analysis/Hospitals"
arcpy.na.AddLocations("Route", "Stops", hospitals)
AddLocations Beispiel 2 (Workflow)

Mit dem folgenden eigenständigen Python-Skript wird veranschaulicht, wie die Funktion AddLocations verwendet werden kann, um Ursprünge und Ziele in einen Start-Ziel-Kostenmatrix-Layer zu laden.

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: AddLocations_Workflow.py
# Description: Calculate a travel time matrix between stores. Use the Add
#               Locations tool to load origins and destinations into an OD Cost
#               Matrix layer. Since the origins and destinations are the same in
#               this case, the origins are first loaded from the stores feature
#               class using geometry, and the destinations are loaded from the
#               origins using network location fields in order to speed up the
#               load times.
# 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 inputs and outputs
    input_gdb = "C:/Data/SanFrancisco.gdb"
    network = os.path.join(input_gdb, "Transportation", "Streets_ND")
    layer_name = "StoreTravelTimeMatrix"
    travel_mode = "Driving Time"
    stores = os.path.join(input_gdb, "Analysis", "Stores")
    search_tolerance = "500 Meters"
    search_query = [["Streets", '"FREEWAY" = 0'], ["Streets_ND_Junctions", ""]]
    output_layer_file = os.path.join(output_dir, layer_name + ".lyrx")

    # Create a new OD cost matrix analysis layer. For this scenario, the default
    # value for all the remaining parameters statisfies the analysis requirements
    result_object = arcpy.na.MakeODCostMatrixAnalysisLayer(
        network, layer_name, travel_mode
    )

    # Get the layer object from the result object. The OD cost matrix layer can
    # now be referenced using the layer object.
    layer_object = result_object.getOutput(0)

    # Get the names of all the sublayers within the OD layer.
    sublayer_names = arcpy.na.GetNAClassNames(layer_object)
    # Store the layer names for later use
    origins_layer_name = sublayer_names["Origins"]
    destinations_layer_name = sublayer_names["Destinations"]

    # Load store features as origins using the geometry of store features.
    # Ensure that the stores are not located on freeways by using a search query.
    arcpy.na.AddLocations(
        layer_object, origins_layer_name, stores, "",
        search_tolerance, search_query=search_query
    )

    # Because we want our origins and destinations to be the same, load the
    # origins as destinations using the network locations fields. Loading using
    # existing network location fields is much faster than loading using geometry
    # because the network locations have already been calculated.
    # Create a field mappings object that supports network location fields using
    # the candidate fields from origins
    origins_sublayer = arcpy.na.GetNASublayer(layer_object, "Origins")
    candidate_fields = arcpy.ListFields(origins_sublayer)
    field_mappings = arcpy.na.NAClassFieldMappings(
        layer_object, destinations_layer_name, True, candidate_fields
    )
    arcpy.na.AddLocations(
        layer_object, destinations_layer_name, origins_sublayer, field_mappings
    )

    # Solve the od cost matrix layer. Halt the execution if there is an
    # invalid location
    arcpy.na.Solve(layer_object, "HALT")

    # Save the solved OD cost matrix layer as a layer file on disk
    layer_object.saveACopy(output_layer_file)

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