Standorte hinzufügen (Network Analyst Tools)

Zusammenfassung

Fügt einem Netzwerkanalyse-Layer Eingabe-Features oder Datensätze hinzu. 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

Dieses Werkzeug wird in der Regel als Teil eines Netzwerkanalyse-Workflows verwendet.

Weitere Informationen zum Netzwerkanalyse-Layer-Workflow
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 der Parameter 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.
Obwohl dieses Werkzeug in einem Python-Skript verwendet werden kann, empfiehlt es sich für die Durchführung von Netzwerkanalysen in Python, stattdessen die Solver-Klassen im Modul zu arcpy.nax verwenden.

Weitere Informationen zum Durchführen von Netzwerkanalysen in Python

Beschriftung	Erläuterung	Datentyp
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. Legacy: Dieser Parameter wird nicht verwendet, wenn die Netzwerkdatenquelle des Netzwerkanalyse-Layers ein Portal ist, auf dem eine ArcGIS Enterprise-Version ausgeführt wird, die älter als 11.0 ist.	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. Achtung: Bei einer Waste-Collection-Analyse schlägt der Berechnungsvorgang fehl, wenn sich Stopps an Knoten befinden. Konfigurieren Sie diesen Parameter nicht, um das Auffinden von Knotenquellen zu ermöglichen, wenn Sie einem Waste-Collection-Layer Stopps hinzufügen. 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. Legacy: Dieser Parameter wird nicht verwendet, wenn die Netzwerkdatenquelle des Netzwerkanalyse-Layers ein Portal ist, auf dem eine ArcGIS Enterprise-Version ausgeführt wird, die älter als 11.0 ist. Spalten der Wertetabelle: Source—The edge and junction sources in the network dataset. Snap Type—Specifies the snap type options for each network source. None—The point will not locate on elements in this network source. Shape—The point will locate on the closest point of an element in this network source. Middle—This option is deprecated and behaves the same as Shape. End—This option is deprecated and behaves the same as Shape.	Value Table
Die nächstgelegene in allen Klassen suchen (Optional)	Legacy: 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. Aktiviert—Eingaben werden mit der nächstgelegenen Netzwerkquelle unter allen für die Verortung verwendeten Quellen abgeglichen. Deaktiviert—Diese Option wird nicht mehr unterstützt und lediglich aus Gründen der Abwärtskompatibilität beibehalten. Eingaben werden mit der nächstgelegenen Netzwerkquelle unter allen für die Verortung verwendeten Quellen abgeglichen.	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. Aktiviert—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)	Legacy: 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. Aktiviert—Analyseeingaben werden in eingeschränkten Netzwerkelementen nicht verortet. Deaktiviert—Diese Option wird nicht mehr unterstützt und lediglich aus Gründen der Abwärtskompatibilität beibehalten. Analyseeingaben werden in eingeschränkten Netzwerkelementen nicht verortet.	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. Legacy: Dieser Parameter wird nicht verwendet, wenn die Netzwerkdatenquelle des Netzwerkanalyse-Layers ein Portal ist, auf dem eine ArcGIS Enterprise-Version ausgeführt wird, die älter als 11.0 ist. Spalten der Wertetabelle: Name—The edge and junction sources in the network dataset. Query—The query for each network source.	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. 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. Legacy: Dieser Parameter wird nicht verwendet, wenn die Netzwerkdatenquelle des Netzwerkanalyse-Layers ein Portal ist, auf dem eine ArcGIS Enterprise-Version ausgeführt wird, die älter als 11.0 ist. 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.	Boolean

Abgeleitete Ausgabe

Beschriftung	Erläuterung	Datentyp
Aktualisierter Eingabe-Netzwerkanalyse-Layer	Der aktualisierte Netzwerkanalyse-Layer.	Network Analyst Layer

arcpy.na.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})

Name	Erläuterung	Datentyp
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 Klasse `NAClassFieldMappings` 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. Legacy: Dieser Parameter wird nicht verwendet, wenn die Netzwerkdatenquelle des Netzwerkanalyse-Layers ein Portal ist, auf dem eine ArcGIS Enterprise-Version ausgeführt wird, die älter als 11.0 ist.	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. 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. Legacy: 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`. Achtung: Bei einer Waste-Collection-Analyse schlägt der Berechnungsvorgang fehl, wenn sich Stopps an Knoten befinden. Konfigurieren Sie diesen Parameter nicht, um das Auffinden von Knotenquellen zu ermöglichen, wenn Sie einem Waste-Collection-Layer Stopps hinzufügen. 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. Legacy: Dieser Parameter wird nicht verwendet, wenn die Netzwerkdatenquelle des Netzwerkanalyse-Layers ein Portal ist, auf dem eine ArcGIS Enterprise-Version ausgeführt wird, die älter als 11.0 ist. Spalten der Wertetabelle: `Source`—The edge and junction sources in the network dataset. `Snap Type`—Specifies the snap type options for each network source. `NONE`—The point will not locate on elements in this network source. `SHAPE`—The point will locate on the closest point of an element in this network source. `MIDDLE`—This option is deprecated and behaves the same as Shape. `END`—This option is deprecated and behaves the same as Shape.	Value Table
match_type (Optional)	Legacy: 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. `MATCH_TO_CLOSEST`—Eingaben werden mit der nächstgelegenen Netzwerkquelle unter allen für die Verortung verwendeten Quellen abgeglichen. `PRIORITY`—Diese Option wird nicht mehr unterstützt und lediglich aus Gründen der Abwärtskompatibilität beibehalten. Eingaben werden mit der nächstgelegenen Netzwerkquelle unter allen für die Verortung verwendeten Quellen abgeglichen.	Boolean
append (Optional)	Gibt an, ob neue Netzwerkanalyse-Objekte an vorhandene Objekte angehängt werden sollen. `APPEND`—Die neuen Netzwerkanalyse-Objekte werden an die bestehenden Objekte im ausgewählten Sublayer angehängt. Dies ist die Standardeinstellung. `CLEAR`—Die 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. `SNAP`—Die Geometrien der Netzwerkstandorte werden an ihren Netzwerkstandorten gefangen. `NO_SNAP`—Die Geometrien der Netzwerkstandorte basieren auf den Geometrien der Eingabe-Features. Dies ist die Standardeinstellung.	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)	Legacy: 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. `EXCLUDE`—Analyseeingaben werden in eingeschränkten Netzwerkelementen nicht verortet. `INCLUDE`—Diese Option wird nicht mehr unterstützt und lediglich aus Gründen der Abwärtskompatibilität beibehalten. Analyseeingaben werden in eingeschränkten Netzwerkelementen nicht verortet.	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. Legacy: Dieser Parameter wird nicht verwendet, wenn die Netzwerkdatenquelle des Netzwerkanalyse-Layers ein Portal ist, auf dem eine ArcGIS Enterprise-Version ausgeführt wird, die älter als 11.0 ist. Spalten der Wertetabelle: `Name`—The edge and junction sources in the network dataset. `Query`—The query for each network source.	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. 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. Legacy: Dieser Parameter wird nicht verwendet, wenn die Netzwerkdatenquelle des Netzwerkanalyse-Layers ein Portal ist, auf dem eine ArcGIS Enterprise-Version ausgeführt wird, die älter als 11.0 ist. `ALLOW`—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. `NO_ALLOW`—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.	Boolean

Abgeleitete Ausgabe

Name	Erläuterung	Datentyp
output_layer	Der aktualisierte Netzwerkanalyse-Layer.	Network Analyst Layer

Codebeispiel

Tipp:

Obwohl dieses Werkzeug in einem Python-Skript verwendet werden kann, empfiehlt es sich für die Durchführung von Netzwerkanalysen in Python, stattdessen die Solver-Klassen im Modul zu arcpy.nax verwenden. Weitere Informationen zum Durchführen von Netzwerkanalysen in Python

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.

Legacy:

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

Umgebungen

Aktueller Workspace

Lizenzierungsinformationen

Basic: Ja
Standard: Ja
Advanced: Ja

Standorte hinzufügen (Network Analyst Tools)

Zusammenfassung

Verwendung

Parameter

Hinweis:

Legacy:

Achtung:

Legacy:

Legacy:

Legacy:

Legacy:

Legacy:

Abgeleitete Ausgabe

Umgebungen

Lizenzierungsinformationen

Verwandte Themen