Zusammenfassung
Hiermit wird eine Start-Ziel-Kostenmatrix von mehreren Startpunkten zu mehreren Zielen erstellt. Eine Start-Ziel-Kostenmatrix ist eine Tabelle mit der Fahrzeit und Fahrstrecke von jedem Startpunkt zu jedem Ziel. Des Weiteren werden in dieser Tabelle die Zielpunkte, die mit den einzelnen Startpunkten verbunden sind, anhand der minimalen Zeit oder Entfernung, die für die Fahrt vom Start- zum Zielpunkt erforderlich ist, in aufsteigender Reihenfolge sortiert. Der beste Pfad im Straßennetz wird für jedes Start-Ziel-Paar erkannt und die Reisezeiten und -entfernungen werden als Attribute der Ausgabelinien gespeichert. Bei den Linien handelt es sich aus Performance-Gründen um Geraden, sie speichern aber stets die Fahrzeit und Fahrstrecke im Straßennetz, nicht etwa die geradlinige Entfernung.
Verwendung
Sucht und misst die kostengünstigsten Routen im Netzwerk von mehreren Startpunkten zu mehreren Zielen.
Im Dialogfeld des Werkzeugs sind die verschiedenen optionalen Parameter in die folgenden sechs Kategorien gruppiert, um Ihnen die Verwaltung zu erleichtern:
- Erweiterte Analyse
- Barrieren
- Benutzerdefinierter Reisemodus
- Netzwerk-Dataset
- Netzwerkstandorte
- Ausgabe
- Service-Eigenschaften
Syntax
arcpy.na.GenerateOriginDestinationCostMatrix(Origins, Destinations, Network_Dataset, Output_Geodatabase, Output_Origin_Destination_Lines_Name, Output_Origins_Name, Output_Destinations_Name, {Travel_Mode}, {Time_Units}, {Distance_Units}, {Number_of_Destinations_to_Find}, {Cutoff}, {Time_of_Day}, {Time_Zone_for_Time_of_Day}, {Point_Barriers}, {Line_Barriers}, {Polygon_Barriers}, {Impedance_Attribute}, {Impedance_Attribute_Units}, {Time_Attribute}, {Time_Attribute_Units}, {Distance_Attribute}, {Distance_Attribute_Units}, {UTurn_Policy}, {Use_Hierarchy_in_Analysis}, {Restrictions}, {Attribute_Parameter_Values}, {Accumulate_Attributes}, {Maximum_Snap_Tolerance}, {Feature_Locator_WHERE_Clause}, {Origin_Destination_Line_Shape}, {Maximum_Features_Affected_by_Point_Barriers}, {Maximum_Features_Affected_by_Line_Barriers}, {Maximum_Features_Affected_by_Polygon_Barriers}, Maximum_Origins, Maximum_Destinations, {Force_Hierarchy_Beyond_Distance}, {Save_Output_Network_Analysis_Layer}, {Overrides})| Parameter | Erklärung | Datentyp |
Origins | Legt Positionen fest, die als Startpunkte beim Erstellen der Pfade zu Zielen fungieren. Es können bis zu 200 Startpunkte hinzugefügt werden. Wenn Sie die Startpunkte festlegen, können Sie jeweils deren Eigenschaften anhand von Attributen festlegen, z. B. den Namen oder die Anzahl der vom Startpunkt zu suchenden Ziele. Die Startpunkte können mit den folgenden Attributen angegeben werden: Name: Der Name des Startpunktes. Der Name kann eine eindeutige Kennung für den Startpunkt sein. Der Name ist in den Ausgabelinien (als das Feld OriginName) und in den Ausgabe-Startpunkten (als Name) enthalten und kann verwendet werden, um zusätzliche Informationen aus den Werkzeugausgaben mit den Attributen der Startpunkte zu verbinden. Wenn kein Name angegeben ist, wird in den Ausgabe-Startpunkten automatisch ein eindeutiger Name erstellt, dem "Location" vorangestellt wird. Ein automatisch erstellter Startpunktname ist nicht in den Ausgabelinien enthalten. TargetDestinationCount: Die maximale Anzahl von Zielen, die für den Startpunkt gefunden werden müssen. Wenn kein Wert angegeben wurde, wird der Wert aus dem Parameter Anzahl der zu suchenden Ziele verwendet. Cutoff: Gibt den Wert für die Fahrzeit oder Fahrstrecke an, bei dem die Suche nach Zielen vom Startpunkt aus beendet werden soll. Ziele außerhalb dieses Grenzwertes werden nicht beachtet. Der Wert muss in den vom Parameter Zeiteinheitenangegebenen Einheiten vorliegen, wenn das Impedanzattribut des Reisemodus zeitbasiert ist, oder er muss in den vom Parameter Entfernungseinheiten angegebenen Einheiten vorliegen, wenn das Impedanzattribut des Reisemodus entfernungsbasiert ist. Wenn kein Wert angegeben wurde, wird der Wert aus dem Parameter Grenzwert verwendet. CurbApproach: Gibt die Richtung an, in der ein Fahrzeug vom Startpunkt wegfährt. Der Feldwert wird als eine der nachfolgenden Ganzzahlen angegeben (verwenden Sie nicht den Namen in Klammern, sondern den numerischen Code):
Die Eigenschaft CurbApproach ist für die Verwendung sowohl in Ländern mit Rechtsverkehr (Deutschland) als auch in Ländern mit Linksverkehr (Großbritannien) konzipiert. Stellen Sie sich zunächst einen Stopp auf der linken Seite eines Fahrzeugs vor. Es befindet sich stets auf der linken Seite, egal ob das Fahrzeug auf der linken oder rechten Seite der Straße fährt. Was sich abhängig von den nationalen Verkehrsregeln ändern kann, ist Ihre Entscheidung, aus welcher Richtung Sie sich dem Stopp nähern, so dass es sich entweder links oder rechts vom Fahrzeug befindet. Wenn Sie beispielsweise einen Stopp erreichen und sich keine Fahrspur zwischen dem Fahrzeug und dem Stopp befinden soll, wählen Sie in den USA die rechte Seite des Fahrzeugs (1), in Großbritannien hingegen die linke Seite des Fahrzeugs (2) aus. | Feature Set |
Destinations | Legt Positionen fest, die als Endpunkte beim Erstellen der Pfade von Startpunkten fungieren. Es können bis zu 200 Ziele hinzugefügt werden. Bei der Angabe von Zielen können Sie mithilfe von Attributen deren jeweilige Eigenschaften, z. B. den Namen, festlegen. Die Ziele können mit den folgenden Attribute angegeben werden: Name: Der Name des Ziels. Der Name kann eine eindeutige Kennung für das Ziel sein. Der Name ist in den Ausgabelinien (als das Feld DestinationName) und in den Ausgabe-Zielen (als Name) enthalten und kann verwendet werden, um zusätzliche Informationen aus den Werkzeugausgaben mit den Attributen der Ziele zu verbinden. Wenn kein Name angegeben ist, wird in den Ausgabe-Zielen automatisch ein eindeutiger Name erstellt, dem "Location" vorangestellt wird. Ein automatisch erstellter Zielname ist nicht in den Ausgabelinien enthalten. CurbApproach: Gibt die Richtung an, aus der ein Fahrzeug am Ziel ankommt. Der Feldwert wird als eine der nachfolgenden Ganzzahlen angegeben (verwenden Sie nicht den Namen in Klammern, sondern den numerischen Code):
Die Eigenschaft CurbApproach ist für die Verwendung sowohl in Ländern mit Rechtsverkehr (Deutschland) als auch in Ländern mit Linksverkehr (Großbritannien) konzipiert. Stellen Sie sich zunächst einen Stopp auf der linken Seite eines Fahrzeugs vor. Es befindet sich stets auf der linken Seite, egal ob das Fahrzeug auf der linken oder rechten Seite der Straße fährt. Was sich abhängig von den nationalen Verkehrsregeln ändern kann, ist Ihre Entscheidung, aus welcher Richtung Sie sich dem Stopp nähern, so dass es sich entweder links oder rechts vom Fahrzeug befindet. Wenn Sie beispielsweise einen Stopp erreichen und sich keine Fahrspur zwischen dem Fahrzeug und dem Stopp befinden soll, wählen Sie in den USA die rechte Seite des Fahrzeugs (1), in Großbritannien hingegen die linke Seite des Fahrzeugs (2) aus. | Feature Set |
Network_Dataset | Das Netzwerk-Dataset, für das die Analyse ausgeführt wird. Netzwerk-Datasets stellen meist Straßennetze dar; es kann sich dabei jedoch auch um andere Transportnetze handeln. Das Netzwerk-Dataset muss mindestens über ein zeitbasiertes und ein entfernungsbasiertes Kostenattribut verfügen. | Network Dataset Layer |
Output_Geodatabase | Der Ausgabe-Workspace. Dieser Workspace muss bereits vorhanden sein. | Workspace |
Output_Origin_Destination_Lines_Name | Der Name der Ausgabe-Feature-Class, in der die Linien zum Verbinden der Start- und Zielpunkte gespeichert sind. Ausgabe des Werkzeugs "Start-Ziel-Kostenmatrix erstellen" beschreibt das Schema dieser Ausgabe-Feature-Class. | String |
Output_Origins_Name | Der Name der Ausgabe-Feature-Class mit Startpunkten. Ausgabe des Werkzeugs "Start-Ziel-Kostenmatrix erstellen" beschreibt das Schema dieser Ausgabe-Feature-Class. | String |
Output_Destinations_Name | Der Name der Ausgabe-Feature-Class mit Zielpunkten. Ausgabe des Werkzeugs "Start-Ziel-Kostenmatrix erstellen" beschreibt das Schema dieser Ausgabe-Feature-Class. | String |
Travel_Mode (optional) | Wählen Sie den Transportmodus für die Analyse aus. CUSTOM kann immer ausgewählt werden. Um andere Namen für Reisemodi anzuzeigen, müssen sie in dem Netzwerk-Dataset vorhanden sein, das im Parameter Network_Dataset angegeben wurde. (Die Funktion arcpy.na.GetTravelModes stellt ein Wörterbuch der Reisemodusobjekte bereit, die in einem Netzwerk-Dataset konfiguriert wurden, und die Eigenschaft name gibt den Namen eines Reisemodusobjekts zurück.) Ein Reisemodus wird in einem Netzwerk-Dataset definiert und stellt Override-Werte für Parameter bereit, die zusammen Reisemodi wie Auto, Lkw, Fußgänger und usw. modellieren. Wenn Sie hier einen Reisemodus auswählen, müssen Sie keine Werte für die folgenden Parameter angeben, die von Werten überschrieben werden, die im Netzwerk-Dataset angegeben wurden:
| String |
Time_Units (optional) | Gibt die Einheiten zum Messen und Melden der gesamten Fahrzeit oder Fahrstrecke zwischen jedem Start-Ziel-Paar an. Die folgenden Optionen sind verfügbar:
| String |
Distance_Units (optional) | Gibt die Einheiten zum Messen und Melden der gesamten Reisestrecke zwischen jedem Start-Ziel-Paar an. Die folgenden Optionen sind verfügbar:
| String |
Number_of_Destinations_to_Find (optional) | Gibt die maximale Anzahl der Ziele an, die pro Startpunkt gesucht werden sollen. Wenn für diesen Parameter kein Wert angegeben wird, enthält die Ausgabe-Matrix Reisekosten von jedem Startpunkt zu jedem Ziel. Einzelne Startpunkte können eigene Werte aufweisen (als TargetDestinationCount-Feld angegeben), die den Parameterwert Anzahl der zu suchenden Ziele außer Kraft setzen. | Long |
Cutoff (optional) | Geben Sie den Wert für die Fahrzeit oder Fahrstrecke an, bei dem die Suche nach Zielen von einem angegebenen Startpunkt beendet werden soll. Ziele außerhalb dieses Grenzwertes werden nicht beachtet. Einzelne Startpunkte können eigene Werte aufweisen (als Cutoff-Feld angegeben), die den Parameterwert Grenzwert außer Kraft setzen. Der Wert muss in den vom Parameter Zeiteinheitenangegebenen Einheiten vorliegen, wenn das Impedanzattribut Ihres Reisemodus zeitbasiert ist, oder in den vom Parameter Entfernungseinheiten angegebenen Einheiten, wenn das Impedanzattribut Ihres Reisemodus entfernungsbasiert ist. Wenn kein Wert angegeben wurde, erzwingt das Werkzeug beim Suchen nach Zielen keine Beschränkung der Fahrzeit oder Fahrstrecke. | Double |
Time_of_Day (optional) | Gibt die Uhrzeit und das Datum für den Beginn der Routen an. Wenn das Netzwerk-Dataset Live- oder historische Verkehrsdaten enthält, führt die Angabe eines Zeitpunktes zu einer genaueren Schätzung der Fahrzeit zwischen den Stopps, da die Fahrzeiten von den Verkehrsbedingungen abhängen, die zu dieser Zeit herrschen. Mit dem Parameter Zeitzone für Uhrzeit wird angegeben, ob sich die Uhrzeit und das Datum auf UTC oder die Zeitzone, in der sich die Einrichtung oder der Stopp befindet, bezieht. Das Werkzeug ignoriert diesen Parameter, wenn die Option Maßeinheiten nicht auf eine zeitbasierte Einheit festgelegt ist. | Date |
Time_Zone_for_Time_of_Day (optional) | Gibt die Zeitzone des Parameters Zeitpunkt an.
| String |
Point_Barriers (optional) | Legt Punkt-Barrieren fest, die in zwei Typen unterteil sind: Punkt-Barrieren für Einschränkungen und Punkt-Barrieren für Zusatzkosten. Sie schränken das Passieren von Punkten oder Hinzufügen von Impedanz zu Punkten im Netzwerk vorübergehend ein. Die Punkt-Barrieren werden durch ein Feature-Set definiert und anhand der Attributwerte, die Sie für die Punkt-Features angeben, wird festgelegt, ob es sich um Punkt-Barrieren für Einschränkungen oder Punkt-Barrieren für Zusatzkosten handelt. Die Felder in der Attributtabelle sind unten aufgelistet und beschrieben. ObjectID: Das vom System verwaltete ID-Feld. Shape: Das Geometriefeld, das die geographische Position des Netzwerkanalyse-Objekts angibt. Name: Der Name der Barriere. BarrierType: Gibt an, ob die Barriere die Reise völlig beschränkt oder Kosten beim Passieren der Barriere hinzufügt. Es gibt zwei Optionen:
Verwenden Sie den Wert 0 für "Einschränkung" und den Wert 2 für "Zusatzkosten" Additional_Time: Gibt die zusätzliche Fahrzeit an, die durch das Passieren der Barriere entsteht. Dieses Feld gilt nur für Barrieren vom Typ "Zusatzkosten" und ausschließlich für zeitbasierte Maßeinheiten. Dieser Feldwert muss größer oder gleich Null sein, und seine Einheiten werden vom Parameter Maßeinheiten vorgegeben. Additional_Distance: Gibt die zusätzliche Strecke an, die durch das Passieren der Barriere entsteht. Dieses Feld gilt nur für Barrieren vom Typ "Zusatzkosten" und ausschließlich für entfernungsbasierte Maßeinheiten. Der Feldwert muss größer oder gleich Null sein, und seine Einheiten werden vom Parameter Maßeinheiten vorgegeben. | Feature Set |
Line_Barriers (optional) | Gibt Linien-Barrieren an, für die das Passieren vorübergehend eingeschränkt ist. Die Linien-Barrieren werden durch ein Feature-Set definiert. Die Felder in der Attributtabelle sind unten aufgelistet und beschrieben. ObjectID: Das vom System verwaltete ID-Feld. Shape: Das Geometriefeld, das die geographische Position des Netzwerkanalyse-Objekts angibt. Name: Der Name der Barriere. | Feature Set |
Polygon_Barriers (optional) | Legt Polygon-Barrieren fest, die in zwei Typen unterteil sind: Punkt-Barrieren für Einschränkungen und Punkt-Barrieren für skalierte Kosten. Sie schränken das Passieren oder Skalieren der Impedanz für die Teile des Netzwerks ein, die sie abdecken. Die Polygon-Barrieren werden durch ein Feature-Set definiert und anhand der Attributwerte, die Sie für die Polygon-Features angeben, wird festgelegt, ob es sich um Punkt-Barrieren für Einschränkungen oder Punkt-Barrieren für skalierte Kosten handelt. Die Felder in der Attributtabelle sind unten aufgelistet und beschrieben. ObjectID: Das vom System verwaltete ID-Feld. Shape: Das Geometriefeld, das die geographische Position des Netzwerkanalyse-Objekts angibt. Name: Der Name der Barriere. BarrierType: Gibt an, ob die Barriere die Reise völlig beschränkt oder die Kosten für das Passieren der Barriere skaliert. Es gibt zwei Optionen:
Verwenden Sie den Wert 0 für "Einschränkung" und den Wert 1 für "Kostenfaktor". ScaledTimeFactor: Um diesen Faktor erhöht sich die Fahrzeit durch die Straßen, die von der Barriere abgeschnitten werden. Dieses Feld gilt nur für Barrieren vom Typ "Kostenfaktor" und ausschließlich für zeitbasierte Maßeinheiten. Der Feldwert muss größer 0 sein. ScaledDistanceFactor: Um diesen Faktor erhöht sich die Strecke durch die Straßen, die von der Barriere abgeschnitten werden. Dieses Attribut gilt nur für Barrieren vom Typ "Kostenfaktor" und ausschließlich für entfernungsbasierte Maßeinheiten. Der Attributwert muss größer als null sein. | Feature Set |
Impedance_Attribute (optional) | Das Kostenattribut, das in der Analyse als Impedanz verwendet wird. | String |
Impedance_Attribute_Units (optional) | Die Einheiten des vom Parameter Impedanzattribut angegebenen Netzwerkimpedanzattributs. Dieser Parameter dient lediglich zur Information und kann nicht geändert werden, ohne das Netzwerk-Dataset direkt zu ändern. Eine Änderung ist zudem nicht erforderlich, da die Einheitenkonvertierungen zwischen den Maßeinheiten und dem Kostenattribut automatisch durchgeführt werden. Der Wert dieses Parameters wird überschrieben, wenn Reisemodus auf einen anderen Wert als Benutzerdefiniert festgelegt wird. | String |
Time_Attribute (optional) | Definiert das Netzwerkkostenattribut, das bei einem zeitbasierten Wert für Maßeinheiten verwendet werden soll. Wenn der Wert für Maßeinheiten von den Einheiten des hier definierten Kostenattributs abweicht, wird die erforderliche Zeiteinheitenkonvertierung vom Werkzeug durchgeführt. Anders ausgedrückt, die Zeiteinheiten des Standard-Grenzwertes und des Netzwerkkostenattributs müssen nicht identisch sein. Der Wert dieses Parameters wird überschrieben, wenn Reisemodus (Travel_Mode in Python) auf einen anderen Wert als Benutzerdefiniert festgelegt wird. | String |
Time_Attribute_Units (optional) | Die Einheiten des Zeitattributs. Sie können die Zeitattributeinheiten explizit festlegen, es empfiehlt sich jedoch, keine Eingabe oder "#" weiterzugeben und die Einheiten vom Solver bestimmen zu lassen. Der Wert dieses Parameters wird überschrieben, wenn Travel_Mode auf einen anderen Wert als CUSTOM festgelegt wird. | String |
Distance_Attribute (optional) | Definiert das Netzwerkkostenattribut, das bei einem entfernungsbasierten Wert für Maßeinheiten verwendet werden soll. Wenn der Wert für Maßeinheiten von den Einheiten des hier definierten Kostenattributs abweicht, wird die erforderliche Umrechnung der Entfernungseinheiten vom Werkzeug durchgeführt. Anders ausgedrückt, die Maßeinheiten und die Entfernungseinheiten des Netzwerkkostenattributs müssen nicht identisch sein. Der Wert dieses Parameters wird überschrieben, wenn Reisemodus (Travel_Mode in Python) auf einen anderen Wert als Benutzerdefiniert festgelegt wird. | String |
Distance_Attribute_Units (optional) | Die Einheiten des Entfernungsattributs. Sie können die Entfernungsattributeinheiten explizit festlegen, es empfiehlt sich jedoch, keine Eingabe oder "#" weiterzugeben und die Einheiten vom Solver bestimmen zu lassen. Der Wert dieses Parameters wird überschrieben, wenn Travel_Mode auf einen anderen Wert als CUSTOM festgelegt wird. | String |
UTurn_Policy (optional) | Die Wendenregel an Knoten. Das Zulassen von Wenden bedeutet, dass der Solver an einem Knoten wenden und auf der gleichen Straße wieder zurückführen kann. Da diese Knoten Straßenkreuzungen und Sackgassen darstellen können, kann es sein, dass verschiedene Fahrzeuge an manchen Knoten wenden können und an anderen wiederum nicht. Dies hängt davon ab, ob der Knoten eine Kreuzung oder eine Sackgasse darstellt. Zu diesem Zweck wird der Wendenregel-Parameter implizit angegeben, indem die Anzahl der mit der Kreuzung verbundenen Kanten bzw. Straßen angegeben wird, was als Valenz der Knoten bezeichnet wird. Die zulässigen Werte für diesen Parameter sowie eine Beschreibung der jeweiligen Bedeutung in Bezug auf die Valenz der Knoten sind unten aufgelistet.
Der Wert dieses Parameters wird überschrieben, wenn Reisemodus (Travel_Mode in Python) auf einen anderen Wert als "Benutzerdefiniert" festgelegt wird. | String |
Use_Hierarchy_in_Analysis (optional) | Geben Sie an, ob beim Suchen der kürzesten Routen zwischen Punkten die Hierarchie verwendet werden soll.
Der Parameter wird nicht verwendet, wenn ein Hierarchie-Attribut nicht für das Netzwerk-Dataset definiert ist, das zum Durchführen der Analyse verwendet wird. In solchen Fällen verwenden Sie "#" als Parameterwert. Sie können den Parameter Force_Hierarchy_Beyond_Distance verwenden, um die Verwendung der Hierarchie durch den Solver zu erzwingen, selbst wenn für Use_Hierarchy_in_Analysis False festgelegt ist. Dieser Parameter wird ignoriert, es sei denn, Travel_Mode ist auf CUSTOM festgelegt. Beim Modellieren eines benutzerdefinierten Fußgängermodus wird empfohlen, die Hierarchie auszuschalten, da sie für motorisierte Fahrzeuge vorgesehen ist. | Boolean |
Restrictions [restriction,...] (optional) | Gibt an, welche Netzwerkrestriktionsattribute bei der Berechnung beachtet werden. Der Wert dieses Parameters wird überschrieben, wenn Reisemodus (Travel_Mode in Python) auf einen anderen Wert als "Benutzerdefiniert" festgelegt wird. | String |
Attribute_Parameter_Values (optional) | Gibt die Parameterwerte für die Netzwerkattribute an, die über Parameter verfügen. Über zwei der Spalten im Datensatz werden Parameter eindeutig identifiziert und über eine weitere Spalte wird der Parameterwert angegeben. Der Wert dieses Parameters wird überschrieben, wenn Reisemodus (Travel_Mode in Python) auf einen anderen Wert als "Benutzerdefiniert" festgelegt wird. Der Datensatz für Attributparameterwerte weist verknüpfte Attribute auf. Die Felder in der Attributtabelle sind unten aufgelistet und beschrieben. ObjectID: Das vom System verwaltete ID-Feld. AttributeName: Der Name des Netzwerkattributs, dessen Attributparameter durch die Tabellenzeile festgelegt wird. ParameterName: Der Name des Attributparameters, dessen Wert durch die Tabellenzeile festgelegt wird. (Parameter des Typs "Objekt" können mit diesem Werkzeug nicht aktualisiert werden.) ParameterValue: Der Wert, den Sie für den Attributparameter festlegen möchten. Wenn kein Wert angegeben ist, wird der Attributparameterwert auf NULL festgelegt. | Record Set |
Accumulate_Attributes [attribute,...] (optional) | Liste der Kostenattribute, die während der Analyse akkumuliert werden sollen. Diese Akkumulationsattribute dienen ausschließlich zu Referenzzwecken. Der Solver verwendet nur das vom Parameter Zeitattribut (Time_Attribute in Python) oder Entfernungsattribut (Distance_Attribute in Python) angegebene Kostenattribut zum Berechnen der kürzesten Wege. Für jedes akkumulierte Kostenattribut wird den vom Solver ausgegebenen Routen das Feld "Total_[Attribut]" hinzugefügt. | String |
Maximum_Snap_Tolerance (optional) | Die maximale Fangtoleranz ist die weiteste Entfernung, in der Network Analyst bei der Positionierung oder Neupositionierung eines Punktes im Netzwerk sucht. Es wird nach geeigneten Kanten oder Knoten gesucht und der Punkt wird an der nächstgelegenen Kante bzw. am nächstgelegenen Knoten gefangen. Wenn keine geeignete Position innerhalb der maximale Fangtoleranz gefunden wird, wird das Objekt als nicht verortet gekennzeichnet. | Linear unit |
Feature_Locator_WHERE_Clause (optional) | Ein SQL-Ausdruck zur Auswahl einer Teilmenge von Quell-Features, wodurch die Netzwerkelemente eingeschränkt werden, auf denen Stopps gesucht werden können. Die Syntax für diesen Parameter besteht aus zwei Teilen. Der erste Teil ist der Name der Quell-Feature-Class (gefolgt von einem Leerzeichen), der zweite Teil der SQL-Ausdruck. Um einen SQL-Ausdruck für zwei oder mehr Quell-Feature-Classes zu schreiben, verwenden Sie ein Semikolon als Trennzeichen. Beispiel: Wenn Sie sicherstellen möchten, dass Einrichtungen nicht auf eingeschränkt befahrbaren Straßen platziert werden, schreiben Sie einen SQL-Ausdruck wie den folgenden, um diese Quell-Features auszuschließen: "Streets" "FUNC_CLASS not in('1', '2')". Beachten Sie, dass Barrieren die WHERE-Klausel des Feature-Locators beim Laden ignorieren. | String |
Origin_Destination_Line_Shape (optional) | Die aus einer Start-Ziel-Kostenmatrix resultierenden Linien können entweder mit geradliniger Geometrie oder ohne jegliche Geometrie dargestellt werden. In beiden Fällen wird die Route stets entlang des Straßennetzes berechnet, indem die Fahrzeit oder Fahrstrecke minimiert und nicht etwa die geradlinige Entfernung zwischen Start- und Zielpunkten verwendet wird.
| String |
Maximum_Features_Affected_by_Point_Barriers (optional) | Schränkt die Anzahl der Features ein, die von Punkt-Barrieren betroffen sind. Ein NULL-Wert gibt an, dass kein Grenzwert vorhanden ist. | Long |
Maximum_Features_Affected_by_Line_Barriers (optional) | Schränkt die Anzahl der Features ein, die von Linien-Barrieren betroffen sind. Ein NULL-Wert gibt an, dass kein Grenzwert vorhanden ist. | Long |
Maximum_Features_Affected_by_Polygon_Barriers (optional) | Schränkt die Anzahl der Features ein, die von Polygon-Barrieren betroffen sind. Ein NULL-Wert gibt an, dass kein Grenzwert vorhanden ist. | Long |
Maximum_Origins | Beschränkt die Anzahl der Startpunkte, die der Start-Ziel-Kostenmatrix-Analyse hinzugefügt werden können. Mithilfe dieses Parameters können Sie den bei der Berechnung stattfindenden Verarbeitungsaufwand steuern. Sie können diesem Parameter z. B. für die kostenlose Version des Service, den Sie erstellen, einen niedrigen Wert zuweisen und für die kostenpflichtige Subskriptionsversion des Service einen höheren Wert verwenden. Ein NULL-Wert gibt an, dass kein Grenzwert vorhanden ist. | Long |
Maximum_Destinations | Beschränkt die Anzahl der Ziele, die der Start-Ziel-Kostenmatrix-Analyse hinzugefügt werden können. Mithilfe dieses Parameters können Sie den bei der Berechnung stattfindenden Verarbeitungsaufwand steuern. Sie können diesem Parameter z. B. für die kostenlose Version des Service, den Sie erstellen, einen niedrigen Wert zuweisen und für die kostenpflichtige Subskriptionsversion des Service einen höheren Wert verwenden. Ein NULL-Wert gibt an, dass kein Grenzwert vorhanden ist. | Long |
Force_Hierarchy_Beyond_Distance (optional) | Gibt die Entfernung an, nach der der Solver beim Suchen von Routen die Hierarchie auch dann erzwingt, wenn sie nicht aktiviert wurde. Die Einheiten dieses Parameters entsprechen denen im Parameter Entfernungsattributeinheiten. Die Suche von Routen zwischen Stopps, die weit entfernt liegen, bei Verwendung der Netzwerkhierarchie ist in der Regel weniger verarbeitungsintensiv als die Suche derselben Routen ohne Verwendung der Hierarchie. Mithilfe dieses Parameters können Sie den bei der Berechnung stattfindenden Verarbeitungsaufwand steuern. Ein NULL-Wert gibt an, dass die Hierarchie nie erzwungen und der Wert des Parameters Hierarchie bei Analyse verwenden immer berücksichtigt wird. Wenn das Eingabe-Netzwerk-Dataset keine Hierarchie unterstützt, führt die Angabe eines Wertes für diesen Parameter zu einem Fehler. In diesem Fall muss ein NULL-Wert verwendet werden. Dieser Parameter ist nur aktiviert, wenn das Netzwerk-Dataset ein Hierarchie-Attribut enthält. | Double |
Save_Output_Network_Analysis_Layer (optional) |
Es werden in jedem Fall Feature-Classes mit den Ergebnissen zurückgegeben. Ein Serveradministrator möchte jedoch evtl. auch einen Netzwerkanalyse-Layer ausgeben, um einen Debugging-Vorgang für die Einrichtung und Ergebnisse des Werkzeugs mit den Network Analyst-Steuerelementen in der ArcGIS Desktop-Umgebung durchzuführen. Dies kann den Debugging-Prozess deutlich vereinfachen. In ArcGIS Desktop befindet sich der Standardausgabespeicherort für den Netzwerkanalyse-Layer im Scratch-Ordner. Sie können den Speicherort des Scratch-Ordners festlegen, indem Sie den Wert der Geoverarbeitungsumgebung arcpy.env.scratchFolder auswerten. Der Ausgabe-Netzwerkanalyse-Layer wird als LYR-Datei gespeichert, deren Name mit _ags_gpna beginnt, gefolgt von einer alphanumerischen GUID. | Boolean |
Overrides (optional) | Legen Sie zusätzliche Einstellungen fest, die das Verhalten des Solvers beim Suchen von Lösungen für die Netzwerkanalyseprobleme beeinflussen können. Der Wert dieses Parameters muss in JavaScript Object Notation (JSON) angegeben werden. Ein gültiger Wert hat beispielsweise das Format: {"overrideSetting1" : "value1", "overrideSetting2" : "value2"}. Der Name der Override-Einstellung wird immer in doppelten Anführungszeichen angegeben. Die Werte können eine Zahl, ein boolescher Wert oder eine Zeichenfolge sein. Der Standardwert für diesen Parameter ist kein Wert, was darauf hinweist, dass keine Solver-Einstellungen überschrieben werden. Overrides sind erweiterte Einstellungen, die nur nach sorgfältiger Analyse der abgerufenen Ergebnisse vor und nach Anwendung der Einstellungen verwendet werden sollten. Eine Liste der unterstützten Override-Einstellungen und ihrer akzeptierten Werte erhalten Sie beim technischen Support von Esri. | string |
Abgeleitete Ausgabe
| Name | Erklärung | Datentyp |
| Solve_Succeeded | Ermittelt, ob der Service die Start-Ziel-Kostenmatrix erfolgreich erstellt hat. | Boolesch |
| Output_Origin_Destination_Lines | Die resultierenden Routen von den Start- zu den Zielpunkten. | Feature-Set |
| Output_Origins | Die an der Analyse beteiligten Startpunkte. | Feature-Set |
| Output_Destinations | Die an der Analyse beteiligten Zielpunkte. | Feature-Set |
| Output_Network_Analysis_Layer | Netzwerkanalyse-Layer mit in den Werkzeugparametern konfigurierten Eigenschaften, der für weitere Analysen oder zum Debuggen in der Karte verwendet werden kann. | Datei |
Codebeispiel
GenerateOriginDestinationCostMatrix – Beispiel 1 (Python-Fenster)
Ausführen des Werkzeugs mit den erforderlichen Parametern.
origins = arcpy.FeatureSet()
origins.load("Warehouses")
destinations = arcpy.FeatureSet()
destinations.load("Stores")
arcpy.na.GenerateOriginDestinationCostMAtrix(origins, destinations, "ParisMultimodal_ND")
GenerateOriginDestinationCostMatrix – Beispiel 2 (eigenständiges Python-Skript)
Mit dem folgenden Python-Skript wird veranschaulicht, wie Sie das Werkzeug in einem eigenständigen Skript verwenden.
# Name: GenerateOriginDestinationCostMatrix_Workflow.py
# Description: Find and measure the least-cost paths along the network from multiple
# origins to multiple destinations.
# Requirements: Network Analyst Extension
#Import system modules
import arcpy
from arcpy import env
try:
#Check out the Network Analyst extension license
arcpy.CheckOutExtension('Network')
#Set environment settings
env.workspace = 'C:/arcgis/ArcTutor/Network Analyst/Tutorial/Paris.gdb'
env.overwriteOutput = True
#Set local variables
inOrigins = 'Analysis/Warehouses'
inDestinations = 'Analysis/Stores'
inNetworkDataset = 'Transportation/ParisMultimodal_ND'
outGeodatabase = 'C:/arcgis/ArcTutor/Network Analyst/Tutorial/Output.gdb'
# Run GenerateODCostMatrix
arcpy.na.GenerateOriginDestinationCostMatrix(inOrigins, inDestinations, inNetworkDataset, outGeodatabase,
Cutoff=10, Origin_Destination_Line_Shape='STRAIGHT_LINES')
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 occured on line %i' % tb.tb_lineno
print str(e)
Umgebungen
Lizenzinformationen
- Basic: Erfordert Network Analyst
- Standard: Erfordert Network Analyst
- Advanced: Erfordert Network Analyst