Zusammenfassung
Legt Netzwerkeinzugsgebiete um Einrichtungen fest. Bei einem Einzugsgebiet handelt es sich um einen Bereich, der alle Straßen umfasst, die innerhalb einer festgelegten Entfernung oder Fahrzeit von einer oder mehreren Einrichtungen aus erreicht werden können. So umfasst beispielsweise das 10-Minuten-Einzugsgebiet einer Einrichtung alle Straßen, die innerhalb von zehn Minuten von dieser Einrichtung aus erreicht werden können.
Einzugsgebiete werden üblicherweise zur Visualisierung und Messung der Erreichbarkeit verwendet. So lässt sich beispielsweise mithilfe eines Fahrzeitpolygons von drei Minuten um einen Lebensmittelladen feststellen, welche Anwohner den Laden innerhalb von drei Minuten erreichen können und daher wahrscheinlich dort einkaufen.
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 über die Ausgabe des Werkzeugs "Einzugsgebiete generieren"
Abbildung
Verwendung
Die Werkzeuge in der Sammlung "Einsatzbereite Werkzeuge" sind ArcGIS Online-Geoverarbeitungsservices, die gehostete Daten und Analysefunktionen von ArcGIS Online verwenden.
Das Werkzeug erstellt Fahrzeitgebiete, wenn der Wert für den Parameter "Unterbrechungswerte" auf eine Zeiteinheit festgelegt ist. Analog dazu erstellt das Werkzeug Fahrentfernungsgebiete, wenn der Wert für den Parameter "Unterbrechungswerte" auf eine Entfernungseinheit festgelegt ist.
Zur erfolgreichen Ausführung des Werkzeugs müssen Sie mindestens eine Einrichtung angeben. Sie können bis zu 1.000 Einrichtungen 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 2.000 Features schneiden dürfen.
Unabhängig davon, ob der Parameter "Hierarchie verwenden" aktiviert ist (True), wird die Hierarchie immer verwendet, wenn der größte Unterbrechungswert 240 Minuten bzw. 240 Meilen (386,24 km) überschreitet. Wenn die Ausgabe-Einzugsgebiete einander weder überlappen noch generalisiert sind, verringert sich diese Grenze auf 15 Minuten und 15 Meilen (24,14 km).
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.
Beim Gehen dürfen Fahrzeiten nicht mehr als 9 Stunden (540 Minuten) oder 5 Stunden (300 Minuten) für alle anderen Reisemodi betragen.
Beim Gehen dürfen Reisestrecken nicht mehr als 27 Meilen (43,45 Kilometer) oder 300 Meilen (482,80 Kilometer) für alle anderen Reisemodi betragen.
Bei der Erstellung von detaillierten Polygonen darf die Gehzeit nicht mehr als 5 Stunden (300 Minuten) betragen. Für alle anderen Reisemodi darf die Fahrzeit nicht mehr als 15 Minuten betragen.
Bei der Erstellung von detaillierten Polygonen darf die Reisestrecke für alle Reisemodi, einschließlich Gehen, nicht mehr als 15 Meilen (24,14 Kilometer) betragen.
Bei der Erstellung von Einzugsgebietslinien darf die Gehzeit nicht mehr als 5 Stunden (300 Minuten) betragen. Für alle anderen Reisemodi darf die Fahrzeit nicht mehr als 15 Minuten betragen.
Bei der Erstellung von Einzugsgebietslinien darf die Reisestrecke für alle anderen Reisemodi, einschließlich Gehen, nicht mehr als 15 Meilen (24,14 Kilometer) betragen.
Die Entfernung für "Polygon kürzen" darf 500 Meter nicht überschreiten.
Durch das Verwenden dieses Service werden Credits verbraucht. Weitere Informationen finden Sie unter Übersicht zu Credits.
Syntax
arcpy.agolservices.GenerateServiceAreas(Facilities, Break_Values, Break_Units, {Analysis_Region}, {Travel_Direction}, Time_of_Day, Use_Hierarchy, {UTurn_at_Junctions}, {Polygons_for_Multiple_Facilities}, {Polygon_Overlap_Type}, {Detailed_Polygons}, {Polygon_Trim_Distance}, Polygon_Simplification_Tolerance, {Point_Barriers}, {Line_Barriers}, {Polygon_Barriers}, {Restrictions}, {Attribute_Parameter_Values}, {Time_Zone_for_Time_of_Day}, {Travel_Mode}, {Impedance}, {Save_Output_Network_Analysis_Layer}, {Overrides}, {Time_Impedance}, {Distance_Impedance}, {Polygon_Detail}, {Output_Type}, {Output_Format})| Parameter | Erklärung | Datentyp |
Facilities | Die Eingabepositionen, um die herum Einzugsgebiete generiert werden. Sie können bis zu 1.000 Einrichtungen laden. Das Feature-Set für Einrichtungen weist eine zugeordnete Attributtabelle auf. Die Felder der Attributtabelle werden im Folgenden beschrieben. ObjectID Das vom System verwaltete ID-Feld. Name Der Name der Einrichtung. Ist kein Name angegeben, wird zum Zeitpunkt der Berechnung automatisch ein Name erstellt. Ist der Parameter "Polygone für mehrere Einrichtungen" auf "Überlappen" oder "Nicht überlappen" gesetzt, sind alle Felder aus den Eingabe-Einrichtungen in den Ausgabepolygonen enthalten. Das ObjectID-Feld der Eingabe-Einrichtungen wird in das FacilityOID-Feld der Ausgabe-Polygone übertragen. Breaks Gibt die Ausdehnung des Einzugsgebiets an, die pro Einrichtung berechnet werden soll. Dieses Attribut ermöglicht die Angabe eines anderen Einzugsgebiet-Unterbrechungswertes für jede Einrichtung. Bei zwei Einrichtungen können Sie beispielsweise für die erste Einrichtung 5-Minuten- und 10-Minuten-Einzugsgebiet-Polygone und für die andere Einrichtung 6-Minuten-, 9-Minuten- und 12-Minuten-Einzugsgebiet-Polygone generieren. Trennen Sie mehrere Unterbrechungswerte durch ein Leerzeichen, und verwenden Sie bei den numerischen Werten einen Punkt als Dezimaltrennzeichen, auch wenn das Gebietsschema des Computers ein anderes Dezimaltrennzeichen vorgibt. Beispielsweise gibt der Wert 5.5 10 15.5 drei Unterbrechungswerte um die Einrichtung herum an. AdditionalTime Die Zeit, die in der Einrichtung verbracht wird, welche die Ausdehnung des für die jeweilige Einrichtung berechneten Einzugsgebiets verringert. Der Standardwert ist 0. Wenn Sie beispielsweise Einzugsgebiete berechnen, die die Reaktionszeit der Feuerwache darstellen, kann in der Eigenschaft AdditionalTime die Reaktionszeit jeder Feuerwache gespeichert werden, d. h. die Zeit, die ein Trupp zum Anlegen der Schutzausrüstung und Verlassen der Feuerwache benötigt. Angenommen Feuerwache 1 hat eine Reaktionszeit von einer Minute und Feuerwache 2 hat eine Reaktionszeit von drei Minuten. Wenn ein 5-Minuten-Einzugsgebiet für beide Feuerwachen berechnet wird, ist das tatsächliche Einzugsgebiet der Feuerwache 1 ein 4-Minuten-Einzugsgebiet (da eine der fünf Minuten für die Reaktionszeit anfällt). Dementsprechend weist Feuerwache 2 ein Einzugsgebiet von nur zwei Minuten von der Feuerwache auf. AdditionalDistance Die zusätzliche Strecke, die zurückgelegt wurde, um die Einrichtung zu erreichen, bevor das Einzugsgebiet berechnet wird. Dieses Attribut verringert die Ausdehnung des Einzugsgebiets, das für die gegebene Einrichtung berechnet wird. Der Standardwert ist 0. Im Allgemeinen befindet sich eine Einrichtung (z. B. ein Filialstandort) nicht direkt an einer Straße, sondern etwas abseits davon. Dieser Attributwert kann verwendet werden, um die Entfernung zwischen der tatsächlichen Position der Einrichtung und seiner Position an der Straße zu modellieren, wenn es wichtig ist, diese Entfernung in die Berechnung der Einzugsgebiete für die Einrichtung einzubeziehen. AdditionalCost Die zusätzlich in der Einrichtung entstandenen Kosten, welche die Ausdehnung des für die jeweilige Einrichtung berechneten Einzugsgebiets verringert. Der Standardwert ist 0. Verwenden Sie diesen Attributwert, wenn der Reisemodus für die Analyse ein Impedanzattribut aufweist, das weder zeit- noch entfernungsbasiert ist. Die Einheiten für die Attributwerte werden als unbekannte Einheiten interpretiert. CurbApproach Gibt die Richtung an, in der ein Fahrzeug bei der Einrichtung ankommt bzw. von ihr 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 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. Ihre Entscheidung, aus welcher Richtung sich das Fahrzeug der Einrichtung nähert, damit diese sich entweder links oder rechts vom Fahrzeug befindet, ist dabei abhängig von den nationalen Verkehrsregeln. 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, welche Kosten 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 anfallen. Die Einheiten von NavLatency entsprechen denen des Impedanzattributs. | Feature Set |
Break_Values | Gibt die Größe und Anzahl von Einzugsgebiet-Polygonen an, die für die einzelnen Einrichtungen generiert werden sollen. Die Einheiten werden vom Wert für "Unterbrechungseinheiten" bestimmt. Es können mehrere Polygonunterbrechungen festgelegt werden, um konzentrische Einzugsgebiete für jede Einrichtung zu erstellen. Wenn Sie zum Beispiel 2-, 3- und 5-Meilen-Einzugsgebiete für die einzelnen Einrichtungen ermitteln möchten, geben Sie 2 3 5 ein (die Werte mit einem Leerzeichen getrennt), und stellen Sie "Unterbrechungseinheiten" auf "Meilen" ein. Die Anzahl der Unterbrechungswerte, die Sie festlegen können, ist nicht begrenzt. Die maximale Größe für den Unterbrechungswert darf das Äquivalent von 300 Minuten oder 300 Meilen (482,80 km) nicht überschreiten. Bei der Erstellung detaillierter Polygone ist die Größe des Einzugsgebietes auf höchstens 15 Minuten und 15 Meilen (24,14 km) beschränkt. | String |
Break_Units | Gibt die Einheiten für den Parameter Unterbrechungswerte an. Mit den für diesen Parameter gewählten Einheiten legen Sie fest, ob das Werkzeug Einzugsgebiete durch Messen der Entfernung oder Fahrzeit erstellen soll. Zum Messen der Fahrzeit wählen Sie eine Zeiteinheit. Zum Messen der Entfernung wählen Sie eine Entfernungseinheit. Von Ihrer Eingabe ist außerdem abhängig, in welchen Einheiten das Werkzeug die resultierende Gesamtfahrzeit oder -strecke zurückgibt. Folgende Optionen stehen zur Verfügung:
| String |
Analysis_Region (optional) | Die Region, in der die Analyse durchgeführt werden soll. 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 |
Travel_Direction (optional) | Gibt an, ob die zum Generieren der Einzugsgebiet-Polygone verwendete Reiserichtung zu der Einrichtung hin oder von der Einrichtung weg führt.
Durch die Reiserichtung kann sich die Form der Polygone ändern, da die Impedanzen auf gegenüberliegenden Straßenseiten unterschiedlich sein oder Richtungsbeschränkungen, z. B. Einbahnstraßen, vorliegen können. Die auszuwählende Richtung hängt von der Art der Einzugsgebiet-Analyse ab. Das Einzugsgebiet für einen Pizza-Lieferservice sollte beispielsweise von der Einrichtung weg erstellt werden, wobei das Einzugsgebiet für ein Krankenhaus zur Einrichtung hin erstellt werden sollte. | String |
Time_of_Day | Die Abfahrtszeit von oder die Ankunftszeit bei den Einrichtungen. Die Interpretation dieses Wertes hängt davon ab, ob die Fahrt zu der Einrichtung hin oder von der Einrichtung weg führt.
Mit dem Parameter Zeitzone für Uhrzeit können Sie angeben, ob sich die Uhrzeit und das Datum auf UTC oder die Zeitzone, in der sich die Einrichtung befindet, bezieht. Durch wiederholtes Berechnen der gleichen Analyse mit unterschiedlichen Werten für die Uhrzeit können Sie ermitteln, wie sich die Reichweite einer Einrichtung im zeitlichen Verlauf ändert. Beispiel: Das Einzugsgebiet von 5 Minuten um eine Feuerwache ist in den frühen Morgenstunden relativ groß, wird während der morgendlichen Hauptverkehrszeit kleiner, nimmt dann am späteren Vormittag wieder zu usw. | Date |
Use_Hierarchy | Gibt an, ob beim Suchen der besten Route zwischen der Einrichtung und dem Ereignis die Hierarchie verwendet wird.
Unabhängig davon, ob der Parameter Hierarchie verwenden aktiviert ist (True), wird die Hierarchie immer verwendet, wenn der größte Unterbrechungswert 240 Minuten bzw. 240 Meilen (386,24 km) überschreitet. | Boolean |
UTurn_at_Junctions (optional) | Gibt an, ob Wenden an Kreuzungen im Einzugsgebiet erlaubt oder verboten ist. Zum besseren Verständnis der Parameterwerte sollten Sie sich mit der folgenden Terminologie vertraut machen: ein Knoten ist ein Punkt, an dem ein Straßenabschnitt endet und potenziell mit einem oder mehreren anderen Segmenten verbunden ist; ein Pseudo-Knoten ist ein Punkt, an dem genau zwei Straßen miteinander verbunden sind; eine Kreuzung ist ein Punkt, an dem drei oder mehr Straßen zusammentreffen; und eine Sackgasse ist ein Punkt, an dem ein Straßenabschnitt endet, ohne mit einem weiteren verbunden zu sein.
| String |
Polygons_for_Multiple_Facilities (optional) | Gibt an, wie Einzugsgebiet-Polygone generiert werden, wenn die Analyse mehrere Einrichtungen umfasst.
Bei der Verwendung von "Überlappen" bzw. "Nicht überlappen" sind alle Felder aus den Eingabe-Einrichtungen in den Ausgabepolygonen enthalten, außer dass Werte aus dem ObjectID-Feld in das FacilityOID-Feld der Ausgabepolygone übertragen werden. Beim Zusammenführen nach Unterbrechungswert ist das FacilityOID-Feld NULL, und die Eingabefelder sind nicht in der Ausgabe enthalten. | String |
Polygon_Overlap_Type (optional) | Gibt an, ob konzentrische Einzugsgebiet-Polygone als Scheiben oder als Ringe erstellt werden. Diese Option ist nur anwendbar, wenn mehrere Unterbrechungswerte für die Einrichtungen angegeben werden.
| String |
Detailed_Polygons (optional) | Ältere Versionen:Die Verwendung dieses Parameters wird nicht mehr empfohlen. Um detaillierte Polygone zu generieren, legen Sie für den Parameter Polygondetail den Wert Hoch fest. Gibt die Option zum Erstellen detaillierter oder generalisierter Polygone an.
Das Werkzeug unterstützt die Erzeugung detaillierter Polygone nur dann, wenn der größte im Parameter Unterbrechungswerte angegebene Wert kleiner oder gleich 15Minuten oder 15 Meilen (24,14 Kilometer) ist. | Boolean |
Polygon_Trim_Distance (optional) | Die Entfernung, innerhalb der die Einzugsgebiet-Polygone gekürzt werden. Dies ist nützlich, wenn die Suche nach Einzugsgebieten an Stellen mit einem kaum vorhandenen Straßennetz durchgeführt wird und das Einzugsgebiet keine große Flächen ohne Straßen-Features abdecken soll. Der Standardwert beträgt 100 Meter. Kein Wert oder der Wert 0 für diesen Parameter gibt an, dass die Einzugsgebiet-Polygone nicht gekürzt wird. Bei Verwendung von Hierarchie wird dieser Parameterwert ignoriert. | Linear Unit |
Polygon_Simplification_Tolerance | Das Maß, in dem die Polygongeometrie vereinfacht wird. Bei einer Vereinfachung werden kritische Stützpunkte eine Polygons beibehalten, um seine wesentliche Form zu definieren; die übrigen Stützpunkte werden entfernt. Die von Ihnen angegebene Vereinfachungsentfernung ist der maximale Versatz, um den die Grenzen des vereinfachtem Polygons von jenen des ursprünglichen Polygons abweichen dürfen. Durch Vereinfachung eines Polygons wird die Anzahl der Stützpunkte und meist auch die Darstellungszeit verringert. | Linear Unit |
Point_Barriers (optional) | 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 vom Typ "Zusatzkosten". 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 vom Typ "Zusatzkosten". 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 vom Typ "Zusatzkosten". 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 kann sowohl in Ländern mit Rechtsverkehr (Deutschland) als auch in Ländern mit Linksverkehr (Großbritannien) verwendet werden. 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. Um beispielsweise eine Einrichtung zu erreichen, 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, welche Kosten 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 anfallen. Die Einheiten von NavLatency entsprechen denen des Impedanzattributs. | Feature Set |
Line_Barriers (optional) | 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 (optional) | 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 vom Typ "Kostenfaktoren". 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 vom Typ "Kostenfaktoren". 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 vom Typ "Kostenfaktoren". | Feature Set |
Restrictions [Restrictions,...] (optional) | Die Verkehrseinschränkungen, die vom Werkzeug bei der Ermittlung der Einzugsgebiete 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:
| 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 "Verwendung von Beschränkungen" den Standardwert "PROHIBITED" verwenden, wenn die Einschränkung von einer Fahrzeugeigenschaft, wie z. B. der Hö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 |
Time_Zone_for_Time_of_Day (optional) | Gibt die Zeitzone oder -zonen des Parameters Zeitpunkt an.
Unabhängig von der eingestellten Zeitzone für Uhrzeit müssen sich alle Einrichtungen in derselben Zeitzone befinden, wenn für Uhrzeit ein anderer Wert als 0 angegeben ist und unter Polygone für mehrere Einrichtungen angegeben wurde, dass zusammengeführte oder nicht überlappende Polygone erstellt werden sollen. | String |
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 |
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.
Wenn Sie eine zeitbasierte Impedanz auswählen, z. B. TravelTime, TruckTravelTime, Minutes, TruckMinutes oder WalkTime, muss der Parameter Unterbrechungseinheiten auf einen zeitbasierten Wert gesetzt werden. Bei Auswahl einer entfernungsbasierten Impedanz, z. B. Meilen oder Kilometer, müssen die Unterbrechungseinheiten 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 |
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 |
Polygon_Detail (optional) | Gibt die Detaillierungsebene der Ausgabepolygone an.
Wenn die Analyse ein Stadtgebiet mit einem gitterähnlichen Straßennetz abdeckt, ist der Unterschied zwischen generalisierten und standardmäßigen Polygonen minimal. Bei Gebirgs- und Landstraßen zeigen standardmäßige und detaillierte Polygone jedoch weitaus genauere Ergebnisse als generalisierte Polygone. Das Werkzeug unterstützt die Erzeugung von Polygonen mit hoher Genauigkeit nur dann, wenn der größte im Parameter Unterbrechungswerte angegebene Wert kleiner oder gleich 15Minuten oder 15 Meilen (24,14 Kilometer) ist. | String |
Output_Type (optional) | Gibt den Ausgabetyp an, der generiert werden soll. Die Ausgabe für das Einzugsgebiet kann aus Linien-Features bestehen, die die innerhalb der Grenzwerte erreichbaren Straßen darstellen, oder aus den Polygon-Features, die diese Linien enthalten (das erreichbare Gebiet).
| String |
Output_Format (optional) | Gibt das Format an, in dem die Ausgabe-Features erstellt werden.
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 |
| Service_Areas | Bietet Zugriff auf Polygon-Features, welche die Gebiete darstellen, die von den Eingabepositionen aus mit einer angegebenen Fahrzeit oder Fahrstrecke bzw. mit angegebenen Reisekosten erreicht werden können. | Feature-Set |
| Solve_Succeeded | Gibt an, ob die Berechnung der Einzugsgebiet-Analyse erfolgreich war. | Boolean |
| 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_Facilities | Dieser Parameter bietet Zugriff auf die Attribute der Einrichtungen, die in der Einzugsgebiet-Analyse verwendet werden. Sie können die Attribute aus diesem Datentyp verwenden (z. B. das Feld Status), um zu ermitteln, warum eine Einrichtung nicht in der Analyse verwendet wurde. | Feature-Set |
| Output_Service_Area_Lines | Dieser Parameter enthält die resultierenden Einzugsgebiete als lineare Features und deckt die Straßen oder Netzwerkkanten ab, die innerhalb der angegebenen Zeit-, Entfernungs- oder sonstigen Reisekostengrenzwerte erreicht werden können. Linien können ein Einzugsgebiet genauer angeben als Polygone, da Einzugsgebiet-Analysen dann auf Messungen entlang der Netzwerklinien basieren. | Feature-Set |
| 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 Service Areas in einem Skript verwendet wird.
"""This example shows how to generate 5, 10, 15 minute drive time areas around facilities."""
import sys
import time
import arcpy
# Change the username and password applicable to your own ArcGIS Online account
username = "<your user name>"
password = "<your password>"
sa_service = "https://logistics.arcgis.com/arcgis/services;World/ServiceAreas;{0};{1}".format(username, password)
# Add the geoprocessing service as a toolbox.
# Check https://pro.arcgis.com/en/pro-app/arcpy/functions/importtoolbox.htm for
# other ways in which you can specify credentials to connect to a geoprocessing service.
arcpy.ImportToolbox(sa_service)
# Set the variables to call the tool
facilities = "C:/data/Inputs.gdb/Stores"
output_service_areas = "C:/data/Results.gdb/StoreServiceAreas"
# Call the tool
result = arcpy.GenerateServiceAreas_ServiceAreas(facilities, "5 10 15", "Minutes")
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))
# Store the output drive time polygons to a geodatabase
result.getOutput(0).save(output_service_areas)Im folgenden Beispiel wird die Einzugsgebiet-Analyse mit einem benutzerdefinierten Reisemodus durchgeführt.
"""This example shows how to perform a service area 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>"
sa_service = "https://logistics.arcgis.com/arcgis/services;World/ServiceAreas;{0};{1}".format(username, password)
# Add the geoprocessing service as a toolbox.
arcpy.ImportToolbox(sa_service)
# Set the variables to call the tool
facilities = "C:/data/Inputs.gdb/Stores"
output_service_areas = "C:/data/Results.gdb/StoreServiceAreas"
# 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.GenerateServiceAreas_ServiceAreas(facilities, "5 10 15", "Minutes", Travel_Mode=travel_mode)
# 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))
# Store the output drive time polygons to a geodatabase
result.getOutput(0).save(output_service_areas)