Zusammenfassung
Das Werkzeug Start-Ziel-Kostenmatrix erstellen erstellt eine Start-Ziel-Kostenmatrix von mehreren Startpunkten zu mehreren Zielen. 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.
Vorsicht:
Aktuelle Informationen zu diesem Werkzeug finden Sie in der aktuellen Version dieses Themas in der Webhilfe. Auf ArcGIS Online gibt es regelmäßige Funktionsaktualisierungen für Services dieser Art, deshalb kann die installierte Hilfe veraltet sein.
Informationen zur Ausgabe des Werkzeugs "Start-Ziel-Kostenmatrix erstellen"
Abbildung
Verwendung
Die Werkzeuge in der Sammlung "Einsatzbereite Werkzeuge" sind ArcGIS Online-Geoverarbeitungsservices, die gehostete Daten und Analysefunktionen von ArcGIS Online verwenden.
Wird für den Parameter Maßeinheiten ein zeitbasierter Wert eingegeben, ermittelt das Werkzeug die nächstgelegenen Einrichtungen basierend auf der Fahrzeit. Analog dazu ermittelt das Werkzeug die Fahrstrecke, wenn die angegebenen Maßeinheiten entfernungsbasiert sind.
Zur erfolgreichen Ausführung des Werkzeugs sind mindestens ein Startpunkt und ein Ziel anzugeben. Sie können bis zu 1000 Startpunkte und 1000 Zielpunkte laden.
Sie können bis zu 250 Punkt-Barrieren hinzufügen. Sie können beliebig viele Linien- oder Polygon-Barrieren hinzufügen, wobei die Linien-Barrieren nicht mehr als 500 Straßen-Features und die Polygon-Barrieren nicht mehr als 2000 Features schneiden dürfen.
Um eine schnellere Lösungsfindung als bei genauen Routen zu erzielen, können Sie die Straßenhierarchie verwenden, doch das Ergebnis dürfte dann eher suboptimal sein.
Unabhängig davon, ob der Parameter Hierarchie verwenden aktiviert ist (Wahr), wird die Hierarchie immer verwendet, wenn die geradlinige Entfernung zwischen zwei Stopps 50 Meilen (80,46 Kilometer) überschreitet.
Die geradlinige Entfernung zwischen Start-Ziel-Paaren darf nicht größer sein als 50 Meilen (80,46 Kilometer), wenn der Reisemodus auf den Typ "Gehen" oder auf Benutzerdefiniert gesetzt ist und die Einschränkung Gehen verwendet wird.
Ist ein Eingabepunkt von der nächsten passierbaren Straße weiter als 12,42 Meilen (20 Kilometer) entfernt, wird der Punkt aus der Analyse ausgeschlossen.
Durch das Verwenden dieses Service werden Credits verbraucht. Weitere Informationen finden Sie unter Übersicht zu Credits.
Syntax
GenerateOriginDestinationCostMatrix(Origins, Destinations, {Travel_Mode}, {Time_Units}, {Distance_Units}, {Analysis_Region}, {Number_of_Destinations_to_Find}, {Cutoff}, {Time_of_Day}, {Time_Zone_for_Time_of_Day}, Point_Barriers, Line_Barriers, Polygon_Barriers, {UTurn_at_Junctions}, {Use_Hierarchy}, {Restrictions}, {Attribute_Parameter_Values}, {Impedance}, Origin_Destination_Line_Shape, {Save_Output_Network_Analysis_Layer}, {Overrides}, {Time_Impedance}, {Distance_Impedance}, {Output_Format})| Parameter | Erklärung | Datentyp |
Origins | Gibt die Startpunkte an, bei denen die Fahrten zu den Zielen beginnen. Sie können insgesamt bis zu 1000 Startpunkte hinzufügen. Bei der Angabe der Startpunkte können Sie mithilfe der folgenden Attribute deren jeweilige Eigenschaften, darunter Name und die Anzahl der vom Startpunkt zu suchenden Ziele, festlegen: 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. Damit können zusätzliche Informationen aus den Werkzeugausgaben mit den Attributen der Startpunkte verbunden werden. Wenn kein Name angegeben ist, wird automatisch ein eindeutiger Name erstellt, dem "Location" vorangestellt wird. TargetDestinationCount Die maximale Anzahl von Zielen, die für den Ursprung gesucht werden soll. Wenn kein Wert angegeben wurde, wird der Wert aus dem Parameter Anzahl der zu suchenden Ziele verwendet. In diesem Feld können Sie für jeden Ursprung eine andere Anzahl der zu suchenden Ziele angeben. Mithilfe dieses Feldes sind Sie beispielsweise in der Lage, die drei nächstgelegene Ziele eines Startpunktes und die zwei nächstgelegene Ziele eines anderen Startpunktes zu suchen. Cutoff Der Impedanzwert, an dem die Suche nach Zielen ausgehend von einem angegebenen Startpunkt beendet wird. Dieses Attribut ermöglicht die Angabe eines anderen Grenzwertes für jedes Ziel. Mit diesem Attribut können Sie beispielsweise angeben, dass nach Zielen gesucht wird, die maximal fünf Minuten Fahrzeit von einem Startpunkt entfernt liegen, sowie nach Zielen, die maximal acht Minuten Fahrzeit von einem anderen Startpunkt entfernt liegen. Die Einheiten für die Grenzwerte entsprechen denen Ihres Impedanzattributs. 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):
Das Attribut 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 Startpunkt 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 vom Startpunkt wegfahren, sodass er sich entweder links oder rechts vom Fahrzeug befindet. Wenn sich beispielsweise bei der Abfahrt keine Fahrspur zwischen Fahrzeug und Startpunkt befinden soll, wählen Sie in Deutschland 1 (Rechte Seite des Fahrzeugs), in Großbritannien hingegen 2 (Linke Seite des Fahrzeugs) aus. Bearing Die Richtung, in die sich ein Punkt bewegt. Die Einheit ist Grad und wird im Uhrzeigersinn von geographisch Nord gemessen. Dieses Feld wird in Verbindung mit dem Feld BearingTol verwendet. Peilungsdaten werden normalerweise automatisch von einem mobilen Gerät gesendet, das mit einem GPS-Empfänger ausgestattet ist. Sie sollten möglichst Peilungsdaten einbeziehen, wenn Sie eine sich bewegende Eingabeposition laden, beispielsweise einen Fußgänger oder ein Fahrzeug. Durch die Verwendung dieses Feldes kann verhindert werden, dass Positionen falschen Kanten zugewiesen werden, was auftreten kann, wenn er sich zufällig in der Nähe einer Kreuzung oder einer Überführung befindet. Mithilfe der Peilung kann das Werkzeug einfacher ermitteln, auf welcher Straßenseite sich der Punkt befindet. Weitere Informationen über Peilung und Peilungstoleranz BearingTol Anhand des Peilungstoleranzwertes wird ein Bereich mit zulässigen Peilungswerten erstellt, wenn Punkte über das Feld Bearing auf einer Kante bewegt werden. Wenn sich der Wert des Feldes Bearing innerhalb des Bereichs der zulässigen Werte befindet, die über die Peilungstoleranz auf einer Kante generiert werden, kann der Punkt dort als Netzwerkstandort hinzugefügt werden. Andernfalls wird der nächstgelegene Punkt an der übernächsten Kante ausgewertet. Die Einheiten sind in Grad und der Standardwert ist 30. Der Wert muss größer als 0 und kleiner als 180 sein. Der Wert 30 bedeutet, dass beim Hinzufügen eines Netzwerkstandortes auf einer Kante durch Network Analyst auf beiden Seiten der Kante (links und rechts) und in beiden Digitalisierrichtungen der Kante ein zulässiger Peilungswertebereich in einem Winkel von 15 Grad generiert wird. Weitere Informationen über Peilung und Peilungstoleranz NavLatency Dieses Feld wird nur im Berechnungsprozess verwendet, wenn Bearing und BearingTol ebenfalls Werte enthalten. Die Eingabe eines NavLatency-Wertes ist jedoch optional, selbst wenn in Bearing und BearingTol Werte enthalten sind. NavLatency gibt an, wie viel Zeit voraussichtlich zwischen dem Senden von GPS-Informationen von einem sich bewegenden Fahrzeug zu einem Server und dem Empfang der verarbeiteten Route durch das Navigationsgerät des Fahrzeugs vergeht. Die Zeiteinheiten von NavLatency sind identisch mit den Einheiten, die von der Eigenschaft timeUnits des Analyseobjekts angegeben werden. | Feature Set |
Destinations | Gibt die Endpunktpositionen an, bei denen die mit den Startpunkten beginnenden Fahrten enden. Sie können insgesamt bis zu 1000 Zielpunkte hinzufügen. Bei der Angabe der Ziele können Sie mithilfe der folgenden Attribute deren jeweilige Eigenschaften wie den Namen festlegen: 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 automatisch ein eindeutiger Name erstellt, dem "Location" vorangestellt wird. 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):
Das Attribut 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 Startpunkt 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 vom Startpunkt wegfahren, sodass er sich entweder links oder rechts vom Fahrzeug befindet. Wenn sich beispielsweise bei der Abfahrt keine Fahrspur zwischen Fahrzeug und Startpunkt befinden soll, wählen Sie in Deutschland 1 (Rechte Seite des Fahrzeugs), in Großbritannien hingegen 2 (Linke Seite des Fahrzeugs) aus. Bearing Die Richtung, in die sich ein Punkt bewegt. Die Einheit ist Grad und wird im Uhrzeigersinn von geographisch Nord gemessen. Dieses Feld wird in Verbindung mit dem Feld BearingTol verwendet. Peilungsdaten werden normalerweise automatisch von einem mobilen Gerät gesendet, das mit einem GPS-Empfänger ausgestattet ist. Sie sollten möglichst Peilungsdaten einbeziehen, wenn Sie eine sich bewegende Eingabeposition laden, beispielsweise einen Fußgänger oder ein Fahrzeug. Durch die Verwendung dieses Feldes kann verhindert werden, dass Positionen falschen Kanten zugewiesen werden, was auftreten kann, wenn er sich zufällig in der Nähe einer Kreuzung oder einer Überführung befindet. Mithilfe der Peilung kann das Werkzeug einfacher ermitteln, auf welcher Straßenseite sich der Punkt befindet. Weitere Informationen über Peilung und Peilungstoleranz BearingTol Anhand des Peilungstoleranzwertes wird ein Bereich mit zulässigen Peilungswerten erstellt, wenn Punkte über das Feld Bearing auf einer Kante bewegt werden. Wenn sich der Wert des Feldes Bearing innerhalb des Bereichs der zulässigen Werte befindet, die über die Peilungstoleranz auf einer Kante generiert werden, kann der Punkt dort als Netzwerkstandort hinzugefügt werden. Andernfalls wird der nächstgelegene Punkt an der übernächsten Kante ausgewertet. Die Einheiten sind in Grad und der Standardwert ist 30. Der Wert muss größer als 0 und kleiner als 180 sein. Der Wert 30 bedeutet, dass beim Hinzufügen eines Netzwerkstandortes auf einer Kante durch Network Analyst auf beiden Seiten der Kante (links und rechts) und in beiden Digitalisierrichtungen der Kante ein zulässiger Peilungswertebereich in einem Winkel von 15 Grad generiert wird. Weitere Informationen über Peilung und Peilungstoleranz NavLatency Dieses Feld wird nur im Berechnungsprozess verwendet, wenn Bearing und BearingTol ebenfalls Werte enthalten. Die Eingabe eines NavLatency-Wertes ist jedoch optional, selbst wenn in Bearing und BearingTol Werte enthalten sind. NavLatency gibt an, wie viel Zeit voraussichtlich zwischen dem Senden von GPS-Informationen von einem sich bewegenden Fahrzeug zu einem Server und dem Empfang der verarbeiteten Route durch das Navigationsgerät des Fahrzeugs vergeht. Die Zeiteinheiten von NavLatency sind identisch mit den Einheiten, die von der Eigenschaft timeUnits des Analyseobjekts angegeben werden. | Feature Set |
Travel_Mode (optional) | Die Transportmethode für die Modellierung in der Analyse. Reisemodi werden in ArcGIS Online verwaltet und können vom Administrator Ihrer Organisation konfiguriert werden, um die Workflows Ihrer Organisation widerzuspiegeln. Sie müssen den Namen eines Reisemodus angeben, der von Ihrer Organisation unterstützt wird. Um eine Liste der Namen von unterstützten Reisemodi abzurufen, verwenden Sie dieselbe GIS-Serververbindung wie für den Zugriff auf das Werkzeug. Führen Sie dann das Werkzeug GetTravelModes in der Toolbox "Utilities" aus. Das Werkzeug GetTravelModes fügt der Anwendung die Tabelle "Unterstützte Reisemodi" hinzu. Jeder Wert im Feld Travel Mode Name aus der Tabelle "Unterstützte Reisemodi" kann als Eingabe angegeben werden. Sie können auch den Wert aus dem Feld Travel Mode Settings als Eingabe festlegen. Dadurch wird die Ausführungsdauer des Werkzeugs verkürzt, da die Einstellungen nicht basierend auf dem Namen des Reisemodus gesucht werden müssen. Der Standardwert Benutzerdefiniert ermöglicht Ihnen das Konfigurieren eines eigenen Reisemodus mithilfe der benutzerdefinierten Reisemodusparameter (Wenden an Kreuzungen, Hierarchie verwenden, Beschränkungen, Attributparameterwerte und Impedanz). Die Standardwerte des benutzerdefinierten Reisemodusparameters modellieren die Fahrt mit dem Auto. Sie können auch Benutzerdefiniert auswählen und die oben aufgeführten benutzerdefinierten Reisemodusparameter festlegen, um einen Fußgänger mit schneller Gehgeschwindigkeit zu modellieren oder einen Lkw, der eine bestimmte Höhe, ein bestimmtes Gewicht oder eine bestimmte Gefahrgutfracht hat. Probieren Sie bei Bedarf verschiedene Einstellungen aus, um die gewünschten Analyseergebnisse zu erhalten. Wenn Sie Ihre Analyseeinstellungen festgelegt haben, sollten Sie mit dem Administrator Ihrer Organisation zusammenarbeiten, um diese Einstellungen als Teil eines neuen oder vorhandenen Reisemodus zu speichern. Auf diese Weise können alle Benutzer in Ihrer Organisation die Analyse erneut mit denselben Einstellungen ausführen. Vorsicht:Durch Auswahl von Benutzerdefiniert werden die von Ihnen festgelegten benutzerdefinierten Reisemodusparameter in die Analyse einbezogen. Wenn Sie einen anderen als den von Ihrer Organisation definierten Reisemodus angeben, kann dies dazu führen, dass alle Werte, die Sie für die Parameter des benutzerdefinierten Reisemodus festgelegt haben, ignoriert werden; das Werkzeug überschreibt sie mit den Werten aus dem angegebenen Reisemodus. | 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 Fahrstrecke zwischen jedem Start-Ziel-Paar an. Die folgenden Optionen sind verfügbar:
| String |
Analysis_Region (optional) | Die zu analysierende Region. Wird für diesen Parameter kein Wert angegeben, ermittelt das Werkzeug anhand der Position der Eingabepunkte den Namen der Region automatisch. Die Angabe des Regionsnamens ist nur erforderlich, wenn die automatische Erkennung des Regionsnamens für Ihre Eingaben nicht korrekt ist. Geben Sie zur Angabe der Region einen der folgenden Werte an:
Ältere Versionen:Die folgenden Regionsnamen werden nicht mehr unterstützt und werden in zukünftigen Versionen entfernt. Wenn Sie einen der veralteten Regionsnamen angeben, weist das Werkzeug automatisch einen unterstützten Regionsnamen für Ihre Region zu.
| String |
Number_of_Destinations_to_Find (optional) | Die maximale Anzahl von Zielen, die pro Startpunkt gesucht werden. 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) | Der Wert für die Fahrzeit oder Fahrstrecke, bei dem die Suche nach Zielen von einem angegebenen Startpunkt aus beendet wird. 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. Wenn das Impedanzattribut Ihres Reisemodus zeitbasiert ist, muss der Wert in den vom Parameter Zeiteinheitenangegebenen Einheiten vorliegen und, wenn das Impedanzattribut Ihres Reisemodus entfernungsbasiert ist, in den vom Parameter Entfernungseinheiten angegebenen Einheiten. Wenn kein Wert angegeben wurde, erzwingt das Werkzeug beim Suchen nach Zielen keine Beschränkung der Fahrzeit oder Fahrstrecke. | Double |
Time_of_Day (optional) | Die Uhrzeit und das Datum für den Beginn der Routen. Wenn Sie den Reisemodus "Fahren" modellieren und das aktuelle Datum und die aktuelle Uhrzeit als Wert für diesen Parameter angeben, verwendet das Werkzeug Live-Verkehrsbedingungen, um die besten Routen zu suchen. Die gesamte Fahrzeit hängt dann von den Verkehrsbedingungen ab. Die Angabe einer Uhrzeit führt zu genaueren Routen und zu einer genaueren Schätzung der Fahrzeiten, 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 | Verwenden Sie diesen Parameter, um einen oder mehrere Punkte anzugeben, die als vorübergehende Beschränkungen dienen bzw. die für das Passieren der betreffenden Straßen zusätzlich veranschlagte Zeit oder Entfernung anzeigen. Mit einer Punkt-Barriere kann beispielsweise ein umgestürzter Baum auf einer Straße oder eine Zeitverzögerung wegen des Halts an einem Bahnübergang angezeigt werden. Mit dem Werkzeug können maximal 250 Punkte als Barrieren hinzugefügt werden. Bei der Angabe von Punkt-Barrieren können Sie mithilfe der folgenden Attribute deren jeweilige Eigenschaften, darunter Name und Barrierentyp, festlegen: Name Der Name der Barriere. BarrierType Gibt an, ob die Punkt-Barriere den Verkehr vollständig beschränkt oder ob beim Überschreiten der Barriere ein Mehraufwand an Zeit oder Entfernung entsteht. Der Wert für dieses Attribut wird als eine der nachfolgenden Ganzzahlen angegeben (verwenden Sie nicht den Namen in Klammern, sondern den numerischen Code):
Additional_Time Die zusätzliche Fahrzeit, die durch das Passieren der Barriere anfällt. Dieses Feld gilt nur für Barrieren für Zusatzkosten und nur, wenn der für die Analyse verwendete Reisemodus ein zeitbasiertes Impedanzattribut verwendet. Dieser Feldwert muss größer oder gleich Null sein, und seine Einheiten werden vom Parameter Maßeinheiten vorgegeben. Additional_Distance Die zusätzliche Entfernung, die durch das Passieren der Barriere anfällt. Dieses Feld gilt nur für Barrieren für Zusatzkosten und nur, wenn der für die Analyse verwendete Reisemodus ein entfernungsbasiertes Impedanzattribut verwendet. Der Feldwert muss größer oder gleich Null sein, und seine Einheiten werden vom Parameter Maßeinheiten vorgegeben. Additional_Cost Die zusätzlichen Kosten, die durch das Passieren der Barriere anfallen. Dieses Feld gilt nur für Barrieren für Zusatzkosten und nur, wenn der für die Analyse verwendete Reisemodus ein Impedanzattribut verwendet, das weder zeitbasiert noch entfernungsbasiert ist. FullEdge Gibt an, wie Punkt-Barrieren für Beschränkungen bei der Analyse auf die Kantenelemente angewendet werden. Der Feldwert wird als eine der nachfolgenden Ganzzahlen angegeben (verwenden Sie nicht den Namen in Klammern, sondern den numerischen Code):
CurbApproach Gibt die Verkehrsrichtung an, die von der Barriere betroffen ist. Der Feldwert wird als eine der nachfolgenden Ganzzahlen angegeben (verwenden Sie nicht den Namen in Klammern, sondern den numerischen Code):
Da Knoten Punkte sind und keine Seite haben, wirken sich Barrieren für Knoten auf alle Fahrzeuge aus, unabhängig vom Attribut "CurbApproach". Das Attribut 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 eine Einrichtung 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 der Einrichtung nähern, sodass sie sich entweder links oder rechts vom Fahrzeug befindet. Wenn Sie beispielsweise eine Einrichtung erreichen möchten, ohne dass sich eine Fahrspur zwischen dem Fahrzeug und der Einrichtung befindet, wählen Sie in Deutschland 1 (Rechte Seite des Fahrzeugs), in Großbritannien hingegen 2 (Linke Seite des Fahrzeugs) aus. Bearing Die Richtung, in die sich ein Punkt bewegt. Die Einheit ist Grad und wird im Uhrzeigersinn von geographisch Nord gemessen. Dieses Feld wird in Verbindung mit dem Feld BearingTol verwendet. Peilungsdaten werden normalerweise automatisch von einem mobilen Gerät gesendet, das mit einem GPS-Empfänger ausgestattet ist. Sie sollten möglichst Peilungsdaten einbeziehen, wenn Sie eine sich bewegende Eingabeposition laden, beispielsweise einen Fußgänger oder ein Fahrzeug. Durch die Verwendung dieses Feldes kann verhindert werden, dass Positionen falschen Kanten zugewiesen werden, was auftreten kann, wenn er sich zufällig in der Nähe einer Kreuzung oder einer Überführung befindet. Mithilfe der Peilung kann das Werkzeug einfacher ermitteln, auf welcher Straßenseite sich der Punkt befindet. Weitere Informationen über Peilung und Peilungstoleranz BearingTol Anhand des Peilungstoleranzwertes wird ein Bereich mit zulässigen Peilungswerten erstellt, wenn Punkte über das Feld Bearing auf einer Kante bewegt werden. Wenn sich der Wert des Feldes Bearing innerhalb des Bereichs der zulässigen Werte befindet, die über die Peilungstoleranz auf einer Kante generiert werden, kann der Punkt dort als Netzwerkstandort hinzugefügt werden. Andernfalls wird der nächstgelegene Punkt an der übernächsten Kante ausgewertet. Die Einheiten sind in Grad und der Standardwert ist 30. Der Wert muss größer als 0 und kleiner als 180 sein. Der Wert 30 bedeutet, dass beim Hinzufügen eines Netzwerkstandortes auf einer Kante durch Network Analyst auf beiden Seiten der Kante (links und rechts) und in beiden Digitalisierrichtungen der Kante ein zulässiger Peilungswertebereich in einem Winkel von 15 Grad generiert wird. Weitere Informationen über Peilung und Peilungstoleranz NavLatency Dieses Feld wird nur im Berechnungsprozess verwendet, wenn Bearing und BearingTol ebenfalls Werte enthalten. Die Eingabe eines NavLatency-Wertes ist jedoch optional, selbst wenn in Bearing und BearingTol Werte enthalten sind. NavLatency gibt an, wie viel Zeit voraussichtlich zwischen dem Senden von GPS-Informationen von einem sich bewegenden Fahrzeug zu einem Server und dem Empfang der verarbeiteten Route durch das Navigationsgerät des Fahrzeugs vergeht. Die Zeiteinheiten von NavLatency sind identisch mit den Einheiten, die von der Eigenschaft timeUnits des Analyseobjekts angegeben werden. | Feature Set |
Line_Barriers | Verwenden Sie diesen Parameter, um eine oder mehrere Linien anzugeben, die das Überfahren von Linien, die Straßen überschneiden, verbieten. Mit einer Linien-Barriere kann beispielsweise eine Parade oder Demonstration modelliert werden, die den Verkehr über mehrere Straßenzüge hinweg blockiert. Mit einer Linien-Barriere können außerdem schnell mehrere Straßen abgeriegelt werden, um unerwünschte Teile des Straßennetzes aus den möglichen Routen auszuschließen. Die Anzahl der Straßen, die mithilfe des Werkzeugparameters Linien-Barrieren beschränkt werden können, ist begrenzt. Es gibt zwar keine Begrenzung für die Anzahl der Linien, die Sie als Linien-Barrieren angeben können, doch die Gesamtzahl der Straßen, die von allen Linien überschnitten werden, darf 500 nicht überschreiten. Bei der Angabe von Linien-Barrieren können Sie mithilfe der folgenden Attribute die Eigenschaften "Name" und "Barrierentyp" festlegen: Name Der Name der Barriere. | Feature Set |
Polygon_Barriers | Verwenden Sie diesen Parameter, um Polygone anzugeben, die den Verkehr entweder vollständig beschränken oder für die mehr Zeit oder eine längere Strecke für das Durchfahren der von den Polygonen überschnittenen Straßen veranschlagt wird. Der Service begrenzt die Anzahl der Straßen, die Sie mithilfe des Parameters Polygon-Barrieren beschränken können. Es gibt zwar keine Begrenzung für die Anzahl der Polygone, die Sie als Polygon-Barrieren angeben können, doch die Gesamtzahl der Straßen, die von allen Polygonen überschnitten werden, darf 2.000 nicht überschreiten. Bei der Angabe der Polygon-Barrieren können Sie mithilfe der folgenden Attribute deren jeweilige Eigenschaften, darunter Name und Barrierentyp, festlegen: Name Der Name der Barriere. BarrierType Gibt an, ob die Barriere den Verkehr vollständig beschränkt oder ob beim Passieren der Barriere Mehrkosten (in Form von Zeit oder Entfernung) entstehen. Der Feldwert wird als eine der nachfolgenden Ganzzahlen angegeben (verwenden Sie nicht den Namen in Klammern, sondern den numerischen Code):
ScaledTimeFactor Um diesen Faktor erhöht sich die Fahrzeit durch die Straßen, die von der Barriere abgeschnitten werden. Der Feldwert muss größer 0 sein. Dieses Feld gilt nur für Barrieren für Kostenfaktoren und nur, wenn der für die Analyse verwendete Reisemodus ein Impedanzattribut verwendet, das zeitbasiert ist. ScaledDistanceFactor Um diesen Faktor erhöht sich die Strecke durch die Straßen, die von der Barriere abgeschnitten werden. Der Feldwert muss größer 0 sein. Dieses Feld gilt nur für Barrieren für Kostenfaktoren und nur, wenn der für die Analyse verwendete Reisemodus ein Impedanzattribut verwendet, das entfernungsbasiert ist. ScaledCostFactor Um diesen Faktor erhöhen sich die Kosten für die Straßen, die sich mit der Barriere schneiden. Der Feldwert muss größer 0 sein. Dieses Feld gilt nur für Barrieren für Kostenfaktoren und nur, wenn der für die Analyse verwendete Reisemodus ein Impedanzattribut verwendet, das weder zeitbasiert noch entfernungsbasiert ist. | Feature Set |
UTurn_at_Junctions (optional) | Gibt die Wendenregel an Knoten an. 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. Um dies zu berücksichtigen, wird der Parameter "Wendenregel" implizit durch die Anzahl der mit der Kreuzung verbundenen Kanten angegeben. Diese Anzahl wird als Valenz der Knoten bezeichnet. Die zulässigen Werte für diesen Parameter sowie eine Beschreibung der jeweiligen Bedeutung in Bezug auf die Valenz der Knoten sind unten aufgelistet.
Dieser Parameter wird ignoriert, es sei denn, Reisemodus ist auf Benutzerdefiniert festgelegt. | String |
Use_Hierarchy (optional) | Gibt an, ob beim Suchen der kürzesten Wege zwischen Stopps die Hierarchie verwendet wird.
Das Werkzeug verwendet die Hierarchie automatisch, wenn die geradlinige Entfernung zwischen Einrichtungen und Bedarfspunkten 50 Meilen (80,46 km) überschreitet, selbst wenn dieser Parameter deaktiviert bzw. in Python auf False festgelegt wurde. Dieser Parameter wird ignoriert, es sei denn, Reisemodus ist auf Benutzerdefiniert festgelegt. Beim Modellieren eines benutzerdefinierten Fußgängermodus wird empfohlen, die Hierarchie auszuschalten, da sie für motorisierte Fahrzeuge vorgesehen ist. | Boolean |
Restrictions (optional) | Die Beschränkungen, die bei der Ermittlung der besten Routen vom Werkzeug berücksichtigt werden. Einschränkungen sind Präferenzen oder Anforderungen eines Fahrers. In den meisten Fällen führen Einschränkungen dazu, dass Straßen unzulässig werden. Wird beispielsweise die Beschränkung "Mautstraßen vermeiden" verwendet, enthält die berechnete Route nur dann Mautstraßen, wenn das Befahren solcher Straßen zum Erreichen eines Ereignisses oder einer Einrichtung notwendig ist. Mit Höheneinschränkung können sämtliche Abstände unterhalb der Fahrzeughöhe vermieden werden. Wenn Sie korrosive Materialien mit dem Fahrzeug transportieren, wird mit der Beschränkung "Gefahrgut verboten" vermieden, dass diese Materialien auf Straßen transportiert werden, die für Gefahrguttransporte als unzulässig markiert sind. Hinweis:Die von Ihnen für diesen Parameter eingegebenen Werte werden ignoriert, es sei denn, Reisemodus ist auf Benutzerdefiniert festgelegt. Hinweis:Bei manchen Beschränkungen muss ein zusätzlicher Wert angegeben werden, damit sie verwendet werden können. Dieser Wert muss mit dem Namen der Beschränkung und einem beschränkungsspezifischen Parameter verknüpft werden. Sie erkennen diese Art von Beschränkungen daran, dass ihr Name in der Spalte "AttributeName" des Parameters Attributparameterwerte aufgeführt wird. Um die ordnungsgemäße Verwendung der Beschränkung bei der Ermittlung passierbarer Straßen sicherzustellen, muss im Parameter Attributparameterwerte das Feld ParameterValue angegeben werden. Hinweis:Manche Einschränkungen werden nicht in allen Ländern unterstützt; ihre Verfügbarkeit nach Regionen wird nachfolgend aufgelistet. Anhand der Länderliste auf der Webseite Gebietsabdeckung der Netzwerkanalyse [engl.] können Sie herausfinden, welche dieser Beschränkungen in einem bestimmten Land verfügbar sind. Steht in der Spalte "Logistics Attribute" der Wert Yes, so wird die Beschränkung mit begrenzter regionaler Verfügbarkeit in diesem Land unterstützt. Wenn Sie Namen von Einschränkungen angeben, die in dem Land, in dem sich Ihre Ereignisse und Aufträge befinden, nicht verfügbar sind, werden die ungültigen Einschränkungen vom Service ignoriert. Der Service ignoriert außerdem Beschränkungen, wenn der Wert für den Attributparameter Verwendung von Beschränkungen zwischen 0 und 1 liegt (siehe Parameter Attributparameterwert). Beschränkungen aller Art sind unzulässig, wenn der Wert des Parameters Verwendung von Beschränkungen größer als 0 ist. Das Werkzeug unterstützt die folgenden Einschränkungen:
Ältere Versionen:Das Beschränkungsattribut "Lieferwagen" ist nicht mehr verfügbar. Der Service ignoriert diese Beschränkung, da sie ungültig ist. Ähnliche Ergebnisse erzielen Sie, wenn Sie das Beschränkungsattribut "Lkw" zusammen mit dem Beschränkungsattribut "Für Lkw eingeschränkte Straßen vermeiden" verwenden. | String |
Attribute_Parameter_Values (optional) | Verwenden Sie diesen Parameter, um zusätzliche erforderliche Werte für ein Attribut oder eine Beschränkung anzugeben, z. B. ob das Fahren auf beschränkten Straßen durch die Beschränkung untersagt, vermieden oder bevorzugt wird. Wenn aufgrund der Einschränkung Straßen vermieden oder bevorzugt werden sollen, können Sie den Grad der Vermeidung bzw. Bevorzugung mit diesem Parameter genauer angeben. Sie können beispielsweise auswählen, mautpflichtige Straßen grundsätzlich nicht zu verwenden, soweit als möglich zu meiden oder zu bevorzugen. Hinweis:Die von Ihnen für diesen Parameter eingegebenen Werte werden ignoriert, es sei denn, Reisemodus ist auf Benutzerdefiniert festgelegt. Wenn Sie den Parameter Attributparameterwerte aus einer Feature-Class angeben, müssen die Feldnamen in der Feature-Class mit den folgenden Feldern übereinstimmen:
Der Parameter Attributparameterwerte hängt vom Parameter Beschränkungen ab. Das Feld ParameterValue ist nur zutreffend, wenn als Name der Einschränkung der Wert für den Parameter Einschränkungen angegeben wird. In Attributparameterwerte verfügt jede Beschränkung (als AttributeName aufgelistet) über einen Wert für das Feld ParameterName und "Verwendung von Beschränkungen", womit angegeben wird, ob das Fahren auf Straßen, die mit der Beschränkung verknüpft sind, nicht zugelassen, vermieden oder bevorzugt wird. Auch der Grad, in dem diese Straßen vermieden oder bevorzugt werden sollen, wird angegeben. Dem ParameterName für "Verwendung von Beschränkungen" kann einer der folgenden Zeichenfolgenwerte oder der ihm entsprechende numerische Wert in Klammern zugewiesen werden:
In den meisten Fällen können Sie für die Verwendung der Beschränkung den Standardwert PROHIBITED verwenden, wenn die Beschränkung von einer Fahrzeugeigenschaft wie der Fahrzeughöhe abhängig ist. In einigen Fällen hängt der Wert für "Verwendung von Beschränkungen" jedoch von den Routing-Voreinstellungen ab. Bei der Beschränkung "Mautstraßen vermeiden " etwa ist der Standardwert für das Attribut "Verwendung von Beschränkungen" die Einstellung "AVOID_MEDIUM". Dies bedeutet, dass das Werkzeug bei Verwendung dieser Einschränkung versucht, Mautstraßen nach Möglichkeit zu meiden. AVOID_MEDIUM weist außerdem darauf hin, wie wichtig es ist, Mautstraßen bei der Ermittlung der optimalen Route zu meiden. Dies hat eine mittlere Priorität. Durch Auswahl von "AVOID_LOW" wird der Vermeidung von Mautstraßen geringere Bedeutung beigemessen. Durch Auswahl von "AVOID_HIGH" hingegen wird der Vermeidung eine höhere Bedeutung zugeordnet, wodurch die Akzeptanz für die Erstellung von längeren Routen steigt, damit Mautstraßen vermieden werden können. Bei der Auswahl von "PROHIBITED" ist das Befahren von Mautstraßen grundsätzlich unzulässig, sodass eine Route auch nicht teilweise Mautstraßen enthalten kann. Bedenken Sie dabei, dass für einige Benutzer das Vermeiden bzw. Umgehen von Mautstraßen und damit der Mautgebühr das Ziel darstellt. Andere Fahrer bevorzugen dahingegen die Fahrt auf Mautstraßen, da sie der Vermeidung von Verkehrsverzögerungen mehr Bedeutung beimessen als der Bezahlung von Mautgebühren. Im letzteren Fall würden Sie "PREFER_LOW", "PREFER_MEDIUM" oder "PREFER_HIGH" als Wert für "Verwendung von Beschränkungen" auswählen. Je höher die Prioritätseinstellung, desto mehr versucht das Werkzeug, das Fahren auf Straßen, die dieser Einschränkung zugeordnet sind, zu meiden. | Record Set |
Impedance (optional) | Gibt die Impedanz an. Dieser Wert repräsentiert den Aufwand bzw. die Kosten für Fahrten entlang von Straßensegmenten oder anderen Teilen des Verkehrsnetzes. Die Fahrzeit stellt eine Impedanz dar: ein Auto benötigt auf einer leeren Straße möglicherweise nur eine Minute für einen Kilometer. Die Fahrzeiten können sich je nach Reisemodus ändern: Ein Fußgänger benötigt für diesen Kilometer möglicherweise mehr als 20 Minuten. Daher ist es wichtig, die richtige Impedanz für den modellierten Reisemodus zu wählen. Auch die Fahrstrecke kann eine Impedanz sein; die Länge einer Straße in Kilometern kann als Impedanz angesehen werden. Die Reiseentfernung ist in diesem Sinne für alle Modi dieselbe – ein Kilometer ist für einen Fußgänger dasselbe wie für ein Auto. (Was sich ändern kann, sind die Wege, auf denen die verschiedenen Reisemodi absolviert werden können, was sich auf die Entfernung zwischen Punkten auswirkt – und das wird durch die Reisemodus-Einstellungen modelliert.) Vorsicht:Der von Ihnen für diesen Parameter eingegebene Wert wird ignoriert, es sei denn, Reisemodus ist auf Benutzerdefiniert festgelegt, was dem Standardwert entspricht. Ihnen stehen folgende Impedanzwerte zur Auswahl:
Wenn Sie eine zeitbasierte Impedanz auswählen, z. B. TravelTime, TruckTravelTime, Minutes, TruckMinutes oder WalkTime, muss der Parameter Maßeinheiten auf einen zeitbasierten Wert gesetzt werden. Bei Auswahl einer entfernungsbasierten Impedanz, z. B. Meilen oder Kilometer, müssen die Maßeinheiten entfernungsbasiert sein. Ältere Versionen:Die Impedanzwerte Fahrzeit, LKW-Zeit, Gehzeit und Fahrstrecke werden nicht mehr unterstützt und werden in einer zukünftigen Version entfernt. Wenn Sie einen dieser Werte einsetzen, verwendet das Werkzeug den Parameter Zeitimpedanz für zeitbasierte Werte und den Parameter Entfernungsimpedanz für entfernungsbasierte Werte. | String |
Origin_Destination_Line_Shape | 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 |
Save_Output_Network_Analysis_Layer (optional) | Gibt an, ob die Analyseeinstellungen als Netzwerkanalyse-Layer-Datei gespeichert werden. Auch wenn Sie diese Datei in einer ArcGIS Desktop-Anwendung wie ArcMap öffnen, können Sie nicht direkt mit dieser Datei arbeiten. Sie wird vielmehr an den technischen Support von Esri gesandt, wo die Qualität der vom Werkzeug zurückgelieferten Ergebnisse beurteilt wird.
| Boolean |
Overrides (optional) | Zusätzliche Einstellungen, 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. Für eine Liste der unterstützten Override-Einstellungen und ihrer akzeptierten Werte wenden Sie sich an den technischen Support von Esri. | string |
Time_Impedance (optional) | Die zeitbasierte Impedanz ist ein Wert, der für die Fahrzeit entlang von Straßensegmenten oder anderen Teilen des Verkehrsnetzes steht. Hinweis:Wenn die Impedanz für den Reisemodus, wie sie durch den Parameter Impedanz angegeben ist, zeitbasiert ist, müssen die Werte der Parameter Zeitimpedanz und Impedanz identisch sein. Andernfalls gibt der Service einen Fehler zurück. | String |
Distance_Impedance (optional) | Die entfernungsbasierte Impedanz ist ein Wert, der für die Fahrstrecke entlang von Straßensegmenten oder anderen Teilen des Verkehrsnetzes steht. Hinweis:Wenn die Impedanz für den Reisemodus, wie sie durch den Parameter Impedanz angegeben ist, entfernungsbasiert ist, müssen die Werte der Parameter Entfernungsimpedanz und Impedanz identisch sein. Andernfalls gibt der Service einen Fehler zurück. | String |
Output_Format (optional) | Gibt das Format an, in dem die Ausgabe-Features erstellt werden. Ihnen stehen folgende Formate zur Auswahl:
Wenn ein dateibasiertes Ausgabeformat wie JSON-Datei oder GeoJSON-Datei angegeben wird, werden der Anzeige keine Ausgaben hinzugefügt, da Anwendungen wie ArcMap oder ArcGIS Pro den Inhalt der Ergebnisdatei nicht darstellen können. Stattdessen wird die Ergebnisdatei in ein temporäres Verzeichnis auf Ihrem Computer heruntergeladen. In ArcGIS Pro lässt sich der Speicherort der heruntergeladenen Datei aus dem Wert für den Parameter Ausgabe-Ergebnisdatei ermitteln, der im entsprechenden Eintrag zur Ausführung des Werkzeugs im Geoverarbeitungsverlauf Ihres Projekts enthalten ist. In ArcMap lässt sich der Speicherort der Datei über die Option Speicherort kopieren im Kontextmenü des Parameters Ausgabe-Ergebnisdatei ermitteln, der im entsprechenden Eintrag zur Ausführung des Werkzeugs im Fenster Geoverarbeitungsergebnisse enthalten ist. | 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 | Dieser Parameter bietet Zugriff auf die Linien, welche die Ursprünge mit den Zielen verbinden. | Feature Set |
| Output_Origins | Dieser Parameter stellt Informationen zu den in der Analyse verwendeten Ursprüngen bereit, z. B. die Gesamtzahl an Zielen, die von einem angegebenen Ursprung aus erreicht wurden, oder die Ursprünge, die nicht in die Analyse einbezogen werden konnten. | Feature Set |
| Output_Destinations | Dieser Parameter stellt Informationen zu den in der Analyse verwendeten Zielen bereit, z. B. die Gesamtzahl an Ursprüngen, die von einem angegebenen Ziel aus erreicht wurden, oder die Ziele, die nicht in die Analyse einbezogen werden konnten. | Feature Set |
| Output_Network_Analysis_Layer | Der Netzwerkanalyse-Layer mit in den Werkzeugparametern konfigurierten Eigenschaften, der für weitere Analysen oder zum Debuggen in der Karte verwendet werden kann. | Datei |
| Output_Result_File | Eine .zip-Datei mit den Analyseergebnissen, die mindestens eine Datei für jede Ausgabe enthält. Das Format der einzelnen Dateien wird durch den Parameter Ausgabeformat angegeben. | Datei |
Codebeispiel
Das folgende Python-Skript veranschaulicht, wie das Werkzeug Generate Origin Destination Cost Matrix in einem Skript verwendet wird.
"""This example shows how to generate a matrix of travel times between origins and destinations."""
import sys
import time
import arcpy
username = "<your user name>"
password = "<your password>"
od_service = "https://logistics.arcgis.com/arcgis/services;World/OriginDestinationCostMatrix;{0};{1}".format(username, password)
# Add the geoprocessing service as a toolbox.
# Check https://pro.arcgis.com/en/pro-app/2.6/arcpy/functions/importtoolbox.htm for
# other ways in which you can specify credentials to connect to a geoprocessing service.
arcpy.ImportToolbox(od_service)
# Set the variables to call the tool
origins = "C:/data/Inputs.gdb/Warehouses"
destinations = "C:/data/Inputs.gdb/Stores"
output_od_lines = "C:/data/Results.gdb/ODLines"
# Call the tool
result = arcpy.GenerateOriginDestinationCostMatrix_OriginDestinationCostMatrix(origins,
destinations,
Origin_Destination_Line_Shape="Straight Line")
arcpy.AddMessage("Running the analysis with result ID: {}".format(result.resultID))
# Check the status of the result object every 1 second until it has a
# value of 4 (succeeded) or greater
while result.status < 4:
time.sleep(1)
# print any warning or error messages returned from the tool
result_severity = result.maxSeverity
if result_severity == 2:
arcpy.AddError("An error occured when running the tool")
arcpy.AddError(result.getMessages(2))
sys.exit(2)
elif result_severity == 1:
arcpy.AddWarning("Warnings were returned when running the tool")
arcpy.AddWarning(result.getMessages(1))
# Save the lines connecting origins to destinations in a geodatabase
result.getOutput(1).save(output_od_lines)Im folgenden Beispiel wird eine Start-Ziel-Kostenmatrix-Analyse mit einem benutzerdefinierten Reisemodus durchgeführt.
"""This example shows how to perform an origin-destination cost matrix analysis using a custom travel mode
that models trucks carrying wide load."""
import sys
import time
import json
import arcpy
username = "<your user name>"
password = "<your password>"
od_service = "https://logistics.arcgis.com/arcgis/services;World/OriginDestinationCostMatrix;{0};{1}".format(username, password)
# Add the geoprocessing service as a toolbox.
arcpy.ImportToolbox(od_service)
# Set the variables to call the tool
origins = "C:/data/Inputs.gdb/Warehouses"
destinations = "C:/data/Inputs.gdb/Stores"
output_od_lines = "C:/data/Results.gdb/ODLines"
# Change Vehicle Width attribute parameter value to 4.5 (about 15 feet) for the Trucking Time travel mode
# used for the analysis
portal_url = "https://www.arcgis.com"
arcpy.SignInToPortal(portal_url, username, password)
travel_mode_list = arcpy.na.GetTravelModes(portal_url)
tt = travel_mode_list["Trucking Time"]
tt_json = str(tt)
tt_dict = json.loads(tt_json)
tt_dict["restrictionAttributeNames"].append("Width Restriction")
for attr_param in tt_dict["attributeParameterValues"]:
if attr_param['attributeName'] == 'Width Restriction' and attr_param['parameterName'] == 'Vehicle Width (meters)':
attr_param['value'] = 4.5
travel_mode = json.dumps(tt_dict)
# Call the tool
result = arcpy.GenerateOriginDestinationCostMatrix_OriginDestinationCostMatrix(origins, destinations,
Travel_Mode=travel_mode,
Origin_Destination_Line_Shape="Straight Line")
# Check the status of the result object every 1 second until it has a
# value of 4 (succeeded) or greater
while result.status < 4:
time.sleep(1)
# print any warning or error messages returned from the tool
result_severity = result.maxSeverity
if result_severity == 2:
arcpy.AddError("An error occured when running the tool")
arcpy.AddError(result.getMessages(2))
sys.exit(2)
elif result_severity == 1:
arcpy.AddWarning("Warnings were returned when running the tool")
arcpy.AddWarning(result.getMessages(1))
# Save the lines connecting origins to destinations in a geodatabase
result.getOutput(1).save(output_od_lines)