Mit der Network Analyst-Lizenz verfügbar.
Zusammenfassung
Sucht ein oder mehrere Einrichtungen, die unter Berücksichtigung der Fahrzeit, Fahrstrecke oder anderer Kosten am nächsten an einem Ereignis liegen, und gibt die beste Route, ausgewählte Einrichtung und eine Wegbeschreibung vom Ereignis zur Einrichtung aus. Mit diesem Werkzeug können Sie beispielsweise das nächste Krankenhaus bei einem Unfall, den nächsten Polizeiwagen bei einem Sachschaden oder das nächste Geschäft in der Nähe einer Kundenadresse suchen.
Beim Suchen der nächstgelegenen Einrichtungen können Sie festlegen, wie viele Einrichtungen ermittelt werden sollen und ob die Fahrtrichtung zu oder weg von diesen Einrichtungen sein soll. Wenn das Netzwerk-Dataset Verkehrsfunktionen unterstützt, können Sie auch die Uhrzeit angeben, um die Fahrzeit für die jeweilige Uhrzeit und das Datum zu berücksichtigen. Mit diesem Werkzeug können Sie zum Beispiel nach Krankenhäusern im Umkreis von 15 Minuten Fahrzeit von einer Unfallstelle zu einer bestimmten Tageszeit suchen. Krankenhäuser, die aufgrund der Verkehrsbedingungen in mehr als 15 Minuten erreicht werden, werden nicht in das Ergebnis einbezogen.
Verwendung
Im Dialogfeld des Werkzeugs sind die verschiedenen optionalen Parameter in die folgenden sechs Kategorien gruppiert, um Ihnen die Verwaltung zu erleichtern:
- Erweiterte Analyse
- Barrieren
- Benutzerdefinierter Reisemodus
- Netzwerk-Dataset
- Netzwerkstandorte
- Ausgabe
- Service-Funktionen
Informationen über die Ausgabe des Werkzeugs "Nächstgelegene Einrichtungen suchen"
Syntax
FindClosestFacilities_na (Incidents, Facilities, Measurement_Units, Network_Dataset, Output_Geodatabase, Output_Routes_Name, Output_Directions_Name, Output_Closest_Facilities_Name, {Number_of_Facilities_to_Find}, {Default_Cutoff}, {Travel_Direction}, {Time_of_Day}, {Time_of_Day_Usage}, {Time_Zone_for_Time_of_Day}, {UTurn_Policy}, {Point_Barriers}, {Line_Barriers}, {Polygon_Barriers}, {Time_Attribute}, {Time_Attribute_Units}, {Distance_Attribute}, {Distance_Attribute_Units}, {Use_Hierarchy_in_Analysis}, {Restrictions}, {Attribute_Parameter_Values}, {Accumulate_Attributes}, {Maximum_Snap_Tolerance}, {Feature_Locator_WHERE_Clause}, {Route_Shape}, {Route_Line_Simplification_Tolerance}, {Populate_Directions}, {Directions_Language}, {Directions_Distance_Units}, {Directions_Style_Name}, {Maximum_Features_Affected_by_Point_Barriers}, {Maximum_Features_Affected_by_Line_Barriers}, {Maximum_Features_Affected_by_Polygon_Barriers}, {Maximum_Facilities}, {Maximum_Facilities_to_Find}, {Maximum_Incidents}, {Force_Hierarchy_Beyond_Distance}, {Save_Output_Network_Analysis_Layer}, {Travel_Mode})
Parameter | Erläuterung | Datentyp |
Incidents | Mit diesem Werkzeug werden die nächstgelegenen Einrichtungen von Ereignissen bestimmt, und dieser Parameter gibt diese Ereignisse an. Es ist mindestens ein Ereignis erforderlich, um eine Analyse zu berechnen. Bei der Angabe der Ereignisse können Sie deren jeweilige Eigenschaften, darunter Name oder Durchführungszeit, mithilfe von Attributen festlegen. Für die Ereignisse können folgende Attribute angegeben werden: OBJECTID – Das vom System verwaltete ID-Feld. SHAPE – Das Geometriefeld, das die geographische Position des Ereignisses angibt. Name – Der Name des Ereignisses. Der Name wird in der Wegbeschreibung verwendet. Wenn kein Name angegeben ist, wird in den Ausgaberouten und -wegbeschreibungen automatisch ein eindeutiger Name generiert, dem "Location" vorangestellt wird. ID – Eine eindeutige Kennung für das Ereignis. Die Kennung ist in den Ausgaberouten (Feld "IncidentID") angegeben und kann die Verknüpfung zusätzlicher Informationen aus den Ausgaberouten (z. B. die gesamte Fahrzeit oder Strecke) mit Attributen aus den Ereignissen oder umgekehrt erleichtern. Wenn die ID nicht angegeben wird, generiert der Service automatisch eine eindeutige Kennung für jedes Ereignis. AdditionalTime – Die Zeit, die am Ereignis verbracht wird. Sie wird zur Gesamtzeit der Route hinzugefügt. Die Einheiten für diesen Attributwert werden vom Parameter "Maßeinheiten" angegeben. Der Attributwert wird nur dann in die Analyse einbezogen, wenn die Maßeinheiten zeitbasiert sind. Der Standardwert ist 0. Wenn Sie die nächstgelegenen Feuerwachen von Brandereignissen suchen, um Reaktionszeiten abzuschätzen, kann im Attribut "AdditionalTime" die Zeit gespeichert werden, die Feuerwehrmänner benötigen, um ihre Ausrüstung am Ort des Ereignisses anzuschließen und mit der Feuerbekämpfung zu beginnen. AdditionalDistance – Die zusätzlich gefahrene Zeit bei dem Ereignis. Sie wird zur Gesamtstrecke der Route hinzugefügt. Die Einheiten für diesen Attributwert werden vom Parameter "Maßeinheiten" angegeben. Der Attributwert wird nur dann in die Analyse einbezogen, wenn die Maßeinheiten entfernungsbasiert sind. Der Standardwert ist 0. Im Allgemeinen befindet sich die Position eines Ereignisses (z. B. ein Haus) nicht direkt auf der Straße, sondern etwas davon zurückgesetzt. Dieser Attributwert kann verwendet werden, um die Entfernung zwischen der tatsächlichen Position des Ereignisses und seiner Position an der Straße zu modellieren, wenn es wichtig ist, diese Entfernung in die gesamte Fahrstrecke einzubeziehen. CurbApproach – Gibt die Richtung an, in der ein Fahrzeug beim Ereignis ankommt bzw. von ihm wegfährt. Der Feldwert wird als eine der nachfolgenden Ganzzahlen angegeben (verwenden Sie nicht den Namen in Klammern, sondern den numerischen Code):
Die Eigenschaft "CurbApproach" ist für die Verwendung sowohl in Ländern mit Rechtsverkehr (USA) als auch in Ländern mit Linksverkehr (Großbritannien) konzipiert. Stellen Sie sich zunächst ein Ereignis auf der linken Seite eines Fahrzeugs vor. Es befindet sich stets auf der linken Seite, egal ob das Fahrzeug auf der linken oder rechten Seite der Straße fährt. Was sich abhängig von den nationalen Verkehrsregeln ändern kann, ist Ihre Entscheidung, aus welcher Richtung Sie sich dem Ereignis nähern, sodass es sich entweder links oder rechts vom Fahrzeug befindet. Wenn Sie beispielsweise ein Ereignis erreichen möchten, ohne dass sich eine Fahrspur zwischen dem Fahrzeug und dem Ereignis befindet, wählen Sie in den USA die rechte Seite des Fahrzeugs (1), in Großbritannien hingegen die linke Seite des Fahrzeugs (2) aus. | Feature Set |
Facilities | Mit diesem Werkzeug werden die nächstgelegenen Einrichtungen von Ereignissen gesucht, und dieser Parameter gibt diese Einrichtungen an. Es ist mindestens eine Einrichtung erforderlich, um eine Analyse durchzuführen. Bei der Angabe der Einrichtungen können Sie deren jeweilige Eigenschaften, darunter Name oder Durchführungszeit, mithilfe von Attributen festlegen. Für die Einrichtungen können folgende Attribute angegeben werden: Name – Der Name der Einrichtung. Der Name wird in der Wegbeschreibung verwendet. Wenn kein Name angegeben ist, wird in den Ausgaberouten und -wegbeschreibungen automatisch ein eindeutiger Name generiert, dem "Location" vorangestellt wird. ID – Eine eindeutige Kennung für die Einrichtung. Die Kennung wird in den Ausgaberouten (Feld "FacilityID") und den ausgegebenen nächstgelegenen Einrichtungen (Feld "FacilityID") angegeben. Das Feld "FacilityID" kann verwendet werden, um zusätzliche Informationen aus den Ausgaberouten (z. B. die gesamte Fahrzeit oder Strecke) mit Attributen aus den Einrichtungen zu verknüpfen. Wenn die ID nicht angegeben wird, generiert der Service automatisch eine eindeutige Kennung für jede Einrichtung. AdditionalTime – Die Zeit, die an der Einrichtung verbracht wird. Sie wird zur Gesamtzeit der Route hinzugefügt. Die Einheiten für diesen Attributwert werden vom Parameter "Maßeinheiten" angegeben. Der Attributwert wird nur dann in die Analyse einbezogen, wenn die Maßeinheiten zeitbasiert sind. Der Standardwert ist 0. Wenn Sie Feuerwachen suchen, die Brandereignissen am nächsten liegen, kann in "AdditionalTime" die Zeit gespeichert werden, die eine Mannschaft normalerweise zum Anlegen der Schutzausrüstung und Verlassen der Wache benötigt. AdditionalDistance – Die zusätzlich gefahrene Zeit bei der Einrichtung. Sie wird zur Gesamtstrecke der Route hinzugefügt. Die Einheiten für diesen Attributwert werden vom Parameter "Maßeinheiten" angegeben. Der Attributwert wird nur dann in die Analyse einbezogen, wenn die Maßeinheiten entfernungsbasiert sind. Der Standardwert ist 0. Im Allgemeinen befindet sich eine Einrichtung (z. B. eine Feuerwache) nicht direkt an einer Straße, sondern etwas davon zurückgesetzt. Mit "AdditionalDistance" kann die Entfernung zwischen dem tatsächlichen Standort der Einrichtung und seiner Position an der Straße modelliert werden, wenn es wichtig ist, diese Entfernung in die gesamte Fahrstrecke einzubeziehen. CurbApproach – Gibt die Richtung an, in der ein Fahrzeug bei der Einrichtung ankommt und von ihr wegfährt. Der Feldwert wird als eine der nachfolgenden Ganzzahlen angegeben (verwenden Sie nicht den Namen in Klammern, sondern den numerischen Code):
Die Eigenschaft "CurbApproach" wurde für die Verwendung sowohl in Ländern mit Rechtsverkehr (USA) 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 den USA die rechte Seite des Fahrzeugs (1), in Großbritannien hingegen die linke Seite des Fahrzeugs (2) aus. | Feature Set |
Measurement_Units | Geben Sie die Einheiten zum Messen und Melden der gesamten Fahrzeit oder Fahrstrecke für die Ausgaberouten an. Das Werkzeug sucht die nächstgelegene Einrichtung, indem die Fahrzeit oder Fahrstrecke für Straßen gemessen wird. Mit den für diesen Parameter gewählten Einheiten legen Sie fest, ob das Werkzeug die Fahrstrecke oder Fahrzeit misst, um die nächstgelegene Einrichtung zu suchen. Zum Messen der Fahrzeit wählen Sie eine Zeiteinheit. Zum Messen der Entfernung wählen Sie eine Entfernungseinheit. Von Ihrer Eingabe ist auch abhängig, in welchen Einheiten das Werkzeug die resultierende Gesamtfahrzeit oder -entfernung zurückgibt. Die folgenden Optionen sind verfügbar:
Ob im Werkzeug das im Parameter Zeitattribut oder Entfernungsattribut angegebene Netzwerkkostenattribut verwendet wird, hängt davon ab, ob die ausgewählten Maßeinheiten zeit- oder entfernungsbasiert sind. Wenn der Wert Maßeinheiten von den Einheiten des entsprechenden zeit- oder entfernungsbasierten Kostenattributs abweicht, wird die erforderliche Einheitenumrechnung vom Werkzeug durchgeführt. | String |
Network_Dataset | Das Netzwerk-Dataset, für das die Analyse ausgeführt wird. Netzwerk-Datasets stellen meist Straßennetze dar, es kann sich dabei jedoch auch um andere Transportnetze handeln. Das Netzwerk-Dataset muss mindestens über ein zeitbasiertes und ein entfernungsbasiertes Kostenattribut verfügen. | Network Dataset Layer |
Output_Geodatabase | Der Ausgabe-Workspace. Dieser Workspace muss bereits vorhanden sein. Der standardmäßige Ausgabe-Workspace ist in_memory. | Workspace |
Output_Routes_Name | Der Name der Ausgabe-Feature-Class, die Routen oder die Linien, die Ereignisse mit ihren nächstgelegenen Einrichtungen verbinden, enthält. Diese Feature-Class enthält als Attribut auch die Gesamtkosten der Fahrt von den Ereignissen zu den nächstgelegenen Einrichtungen. Im Hilfethema Ausgabe von "Nächstgelegene Einrichtungen suchen" wird das Schema dieser Ausgabe-Feature-Class beschrieben. | String |
Output_Directions_Name | Der Name der Ausgabe-Feature-Class mit einer Wegbeschreibung. Im Hilfethema Ausgabe von "Nächstgelegene Einrichtungen suchen" wird das Schema dieser Ausgabe-Feature-Class beschrieben. | String |
Output_Closest_Facilities_Name | Der Name der Ausgabe-Feature-Class mit den nächstgelegenen Einrichtungen. Im Hilfethema Ausgabe von "Nächstgelegene Einrichtungen suchen" wird das Schema dieser Ausgabe-Feature-Class beschrieben. | String |
Number_of_Facilities_to_Find (optional) | Geben Sie die Anzahl der nächstgelegenen Einrichtungen an, die pro Ereignis gesucht werden sollen. Dies ist vor allem in Situationen wie z. B. einem Brand nützlich, wenn möglicherweise mehrere Feuerwehrfahrzeuge von unterschiedlichen Feuerwachen benötigt werden. Sie können beispielsweise angeben, dass die drei Feuerwachen ermittelt werden sollen, die einem Brand am nächsten gelegen sind. Wenn Sie über dieses Werkzeug einen Service einrichten und die Ressourcennutzung wie die Verarbeitungszeit auf dem Server begrenzen möchten, beschränken Sie mit dem Parameter Maximale Anzahl zu suchender Einrichtungen die maximale Anzahl an Einrichtungen, die ein Benutzer unter Anzahl der zu suchenden Einrichtungen eingeben kann. | Long |
Default_Cutoff (optional) | Geben Sie den Wert für die Fahrzeit oder Fahrstrecke an, bei dem die Suche nach Einrichtungen für ein angegebenes Ereignis beendet werden soll. Wenn beim Suchen der nächstgelegenen Krankenhäuser von einem Unfallort aus ein Grenzwert von 15 Minuten festgelegt wird, bedeutet dies, dass das Werkzeug nach Krankenhäusern in einem Umkreis innerhalb von 15 Minuten Entfernung vom Unfallort sucht. Wenn sich das nächstgelegene Krankenhaus 17 Minuten entfernt befindet, werden in den Ausgaberouten keine Routen zurückgegeben. Ein Grenzwert ist insbesondere beim Suchen nach mehreren Einrichtungen nützlich. Die Einheiten für diesen Parameter werden vom Parameter Maßeinheiten angegeben. | Double |
Travel_Direction (optional) | Geben Sie an, ob bei der Suche nach der nächstgelegenen Einrichtung die Route vom Ereignis zur Einrichtung oder von der Einrichtung zum Ereignis gemessen werden soll.
Bei der Verwendung dieser Parameterwerte können unterschiedliche Einrichtungen gefunden werden, da die Fahrzeit bei einigen Straßen je nach Fahrtrichtung und Beschränkungen durch Einbahnstraßen unterschiedlich sein kann. So kann eine Einrichtung zum Beispiel 10 Minuten Fahrzeit vom Ereignis entfernt sein, wenn die Fahrt vom Ereignis zur Einrichtung erfolgt, jedoch 15 Minuten Fahrzeit entfernt, wenn die Fahrt von der Einrichtung zum Ereignis erfolgt. Wenn Sie einen Wert für "Uhrzeit" festlegen, können von "Einrichtung zu Ereignis" und "Ereignis zur Einrichtung" aufgrund des Verkehrsaufkommens ebenfalls verschiedene Ergebnisse zurückgegeben werden. | String |
Time_of_Day (optional) |
Gibt die Uhrzeit und das Datum für den Beginn oder das Ende der Routen an. Der Wert wird abhängig vom Wert für den Parameter Zeitabhängige Nutzung als Startzeit oder Endzeit für die Route verwendet. Wenn Sie das aktuelle Datum und die aktuelle Uhrzeit als Wert für diesen Parameter angeben, verwendet das Werkzeug Live-Verkehrsbedingungen, um die nächstgelegenen Einrichtungen zu suchen. Die gesamte Fahrzeit hängt dann von den Verkehrsbedingungen ab. Wenn das Netzwerk-Dataset Live- oder historische Verkehrsdaten enthält, führt die Angabe einer Uhrzeit zu einer genaueren Schätzung der Fahrzeit zwischen dem Ereignis und der Einrichtung, da die Fahrzeiten von den Verkehrsbedingungen abhängen, die zu dieser Zeit herrschen. Mit dem Parameter Time Zone for Time of Day wird angegeben, ob sich die Uhrzeit und das Datum auf UTC oder die Zeitzone, in der sich die Einrichtung oder das Ereignis befindet, bezieht. Unabhängig von der Einstellung Time Zone for Time of Day werden die folgenden Regeln vom Werkzeug durchgesetzt, wenn sich die Einrichtungen und Ereignisse in mehreren Zeitzonen befinden:
| Date |
Time_of_Day_Usage (optional) | Gibt an, ob der Wert des Parameters Uhrzeit die Ankunfts- oder Abfahrtzeit für die Routen darstellt.
| String |
Time_Zone_for_Time_of_Day (optional) | Gibt die Zeitzone des Parameters Uhrzeit an.
Unabhängig von der Einstellung Time Zone for Time of Day werden die folgenden Regeln vom Werkzeug durchgesetzt, wenn sich die Einrichtungen und Ereignisse in mehreren Zeitzonen befinden:
| String |
UTurn_Policy (optional) | Die Wendenregel an Knoten. Das Zulassen von Wenden bedeutet, dass der Solver an einem Knoten wenden und auf der gleichen Straße wieder zurückführen kann. Da diese Knoten Straßenkreuzungen und Sackgassen darstellen können, kann es sein, dass verschiedene Fahrzeuge an manchen Knoten wenden können und an anderen wiederum nicht. Dies hängt davon ab, ob der Knoten eine Kreuzung oder eine Sackgasse darstellt. Zu diesem Zweck wird der Wendenregel-Parameter implizit angegeben, indem die Anzahl der mit der Kreuzung verbundenen Kanten angegeben wird, was als Valenz der Knoten bezeichnet wird. Die zulässigen Werte für diesen Parameter sowie eine Beschreibung der jeweiligen Bedeutung in Bezug auf die Valenz der Knoten sind unten aufgelistet.
Der Wert dieses Parameters wird überschrieben, wenn Reisemodus (Travel_Mode in Python) auf einen anderen Wert als "Benutzerdefiniert" festgelegt wird. | String |
Point_Barriers (optional) | Legt Punkt-Barrieren fest, die in zwei Typen unterteil sind: Punkt-Barrieren für Einschränkungen und Punkt-Barrieren für Zusatzkosten. Sie schränken das Passieren von Punkten oder Hinzufügen von Impedanz zu Punkten im Netzwerk vorübergehend ein. Die Punkt-Barrieren werden durch ein Feature-Set definiert und anhand der Attributwerte, die Sie für die Punkt-Features angeben, wird festgelegt, ob es sich um Punkt-Barrieren für Einschränkungen oder Punkt-Barrieren für Zusatzkosten handelt. Die Felder in der Attributtabelle sind unten aufgelistet und beschrieben. ObjectID: Das vom System verwaltete ID-Feld. Shape: Das Geometriefeld, das die geographische Position des Netzwerkanalyse-Objekts angibt. Name: Der Name der Barriere. BarrierType: Gibt an, ob die Barriere Reise völlig beschränkt oder Kosten beim Passieren der Barriere hinzufügt. Es gibt zwei Optionen:
Verwenden Sie den Wert 0 für "Einschränkung" und den Wert 2 für "Zusatzkosten" Additional_Time: Gibt die zusätzliche Fahrzeit an, die durch das Passieren der Barriere entsteht. Dieses Feld gilt nur für Barrieren vom Typ "Zusatzkosten" und ausschließlich für zeitbasierte Maßeinheiten. Dieser Feldwert muss größer oder gleich Null sein, und seine Einheiten werden vom Parameter "Maßeinheiten" vorgegeben. Additional_Distance: Gibt die zusätzliche Strecke an, die durch das Passieren der Barriere entsteht. Dieses Feld gilt nur für Barrieren vom Typ "Zusatzkosten" und ausschließlich für entfernungsbasierte Maßeinheiten. Der Feldwert muss größer oder gleich Null sein, und seine Einheiten werden vom Parameter "Maßeinheiten" vorgegeben. | Feature Set |
Line_Barriers (optional) |
Gibt Linien-Barrieren an, für die das Passieren vorübergehend eingeschränkt ist. Die Linien-Barrieren werden durch ein Feature-Set definiert. Die Felder in der Attributtabelle sind unten aufgelistet und beschrieben. ObjectID: Das vom System verwaltete ID-Feld. Shape: Das Geometriefeld, das die geographische Position des Netzwerkanalyse-Objekts angibt. Name: Der Name der Barriere. | Feature Set |
Polygon_Barriers (optional) | Legt Polygon-Barrieren fest, die in zwei Typen unterteil sind: Punkt-Barrieren für Einschränkungen und Punkt-Barrieren für skalierte Kosten. Sie schränken das Passieren oder Skalieren der Impedanz für die Teile des Netzwerks ein, die sie abdecken. Die Polygon-Barrieren werden durch ein Feature-Set definiert und anhand der Attributwerte, die Sie für die Polygon-Features angeben, wird festgelegt, ob es sich um Punkt-Barrieren für Einschränkungen oder Punkt-Barrieren für skalierte Kosten handelt. Die Felder in der Attributtabelle sind unten aufgelistet und beschrieben. ObjectID: Das vom System verwaltete ID-Feld. Shape: Das Geometriefeld, das die geographische Position des Netzwerkanalyse-Objekts angibt. Name: Der Name der Barriere. BarrierType: Gibt an, ob die Barriere Reise völlig beschränkt oder die Kosten für das Passieren der Barriere skaliert. Es gibt zwei Optionen:
Verwenden Sie den Wert 0 für "Einschränkung" und den Wert 1 für "Kostenfaktor". ScaledTimeFactor: Um diesen Faktor erhöht sich die Fahrzeit durch die Straßen, die von der Barriere abgeschnitten werden. Dieses Feld gilt nur für Barrieren vom Typ "Kostenfaktor" und ausschließlich für zeitbasierte Maßeinheiten. Der Feldwert muss größer 0 sein. ScaledDistanceFactor: Um diesen Faktor erhöht sich die Strecke durch die Straßen, die von der Barriere abgeschnitten werden. Dieses Attribut gilt nur für Barrieren vom Typ "Kostenfaktor" und ausschließlich für entfernungsbasierte Maßeinheiten. Der Attributwert muss größer als null sein. | Feature Set |
Time_Attribute (optional) | Definiert das Netzwerkkostenattribut, das bei einem zeitbasierten Wert für Maßeinheiten verwendet werden soll. Wenn der Wert für Maßeinheiten von den Einheiten des hier definierten Kostenattributs abweicht, wird die erforderliche Zeiteinheitenkonvertierung vom Werkzeug durchgeführt. Anders ausgedrückt, die Zeiteinheiten des Standard-Grenzwertes und des Netzwerkkostenattributs müssen nicht identisch sein. Der Wert dieses Parameters wird überschrieben, wenn Reisemodus (Travel_Mode in Python) auf einen anderen Wert als Benutzerdefiniert festgelegt wird. | String |
Time_Attribute_Units (optional) | Die Einheiten des Zeitattributs. Sie können die Zeitattributeinheiten explizit festlegen, es empfiehlt sich jedoch, keine Eingabe oder "#" weiterzugeben und die Einheiten vom Solver bestimmen zu lassen. Der Wert dieses Parameters wird überschrieben, wenn Travel_Mode auf einen anderen Wert als CUSTOM festgelegt wird. | String |
Distance_Attribute (optional) | Definiert das Netzwerkkostenattribut, das bei einem entfernungsbasierten Wert für Maßeinheiten verwendet werden soll. Wenn der Wert für Maßeinheiten von den Einheiten des hier definierten Kostenattributs abweicht, wird die erforderliche Umrechnung der Entfernungseinheiten vom Werkzeug durchgeführt. Anders ausgedrückt, die Maßeinheiten und die Entfernungseinheiten des Netzwerkkostenattributs müssen nicht identisch sein. Der Wert dieses Parameters wird überschrieben, wenn Reisemodus (Travel_Mode in Python) auf einen anderen Wert als Benutzerdefiniert festgelegt wird. | String |
Distance_Attribute_Units (optional) | Die Einheiten des Entfernungsattributs. Sie können die Entfernungsattributeinheiten explizit festlegen, es empfiehlt sich jedoch, keine Eingabe oder "#" weiterzugeben und die Einheiten vom Solver bestimmen zu lassen. Der Wert dieses Parameters wird überschrieben, wenn Travel_Mode auf einen anderen Wert als CUSTOM festgelegt wird. | String |
Use_Hierarchy_in_Analysis (optional) | Geben Sie an, ob beim Suchen der kürzesten Routen zwischen Punkten die Hierarchie verwendet werden soll.
Der Parameter wird nicht verwendet, wenn ein Hierarchie-Attribut nicht für das Netzwerk-Dataset definiert ist, das zum Durchführen der Analyse verwendet wird. In solchen Fällen verwenden Sie "#" als Parameterwert. Sie können den Parameter Force_Hierarchy_Beyond_Distance verwenden, um die Verwendung der Hierarchie durch den Solver zu erzwingen, selbst wenn für Use_Hierarchy_in_Analysis False festgelegt ist. Dieser Parameter wird ignoriert, es sei denn, Travel_Mode ist auf CUSTOM festgelegt. Beim Modellieren eines benutzerdefinierten Fußgängermodus wird empfohlen, die Hierarchie auszuschalten, da sie für motorisierte Fahrzeuge vorgesehen ist. | Boolean |
Restrictions [restriction,...] (optional) | Gibt an, welche Netzwerkrestiktionsattribute bei der Berechnung beachtet werden. Der Wert dieses Parameters wird überschrieben, wenn Reisemodus (Travel_Mode in Python) auf einen anderen Wert als "Benutzerdefiniert" festgelegt wird. | String |
Attribute_Parameter_Values (optional) | Gibt die Parameterwerte für die Netzwerkattribute an, die über Parameter verfügen. Der Datensatz hat zwei Spalten, die miteinander arbeiten, um Parameter eindeutig zu identifizieren, und eine weitere Spalte, die den Parameterwert angibt. Der Wert dieses Parameters wird überschrieben, wenn Reisemodus (Travel_Mode in Python) auf einen anderen Wert als "Benutzerdefiniert" festgelegt wird. Der Datensatz für Attributparameterwerte weist verknüpfte Attribute auf. Die Felder in der Attributtabelle sind unten aufgelistet und beschrieben. ObjectID: Das vom System verwaltete ID-Feld. AttributeName: Der Name des Netzwerkattributs, dessen Attributparameter durch die Tabellenzeile festgelegt wird. ParameterName: Der Name des Attributparameters, dessen Wert durch die Tabellenzeile festgelegt wird. (Parameter des Typs "Objekt" können mit diesem Werkzeug nicht aktualisiert werden.) ParameterValue: Der Wert, den Sie für den Attributparameter festlegen möchten. Wenn kein Wert angegeben ist, wird der Attributparameterwert auf Null festgelegt. | Record Set |
Accumulate_Attributes [attribute,...] (optional) | Liste der Kostenattribute, die während der Analyse akkumuliert werden sollen. Diese Akkumulationsattribute dienen ausschließlich zu Referenzzwecken. Der Solver verwendet nur das vom Parameter Zeitattribut (Time_Attribute in Python) oder Entfernungsattribut (Distance_Attribute in Python) angegebene Kostenattribut zum Berechnen der kürzesten Wege. Für jedes akkumulierte Kostenattribut wird den vom Solver ausgegebenen Routen ein Total_[Attribute]-Feld hinzugefügt. | String |
Maximum_Snap_Tolerance (optional) | Die maximale Fangtoleranz ist die weiteste Entfernung, in der Network Analyst bei der Positionierung oder Neupositionierung eines Punktes im Netzwerk sucht. Es wird nach geeigneten Kanten oder Knoten gesucht und der Punkt wird an der nächstgelegenen Kante bzw. am nächstgelegenen Knoten gefangen. Wenn keine geeignete Position innerhalb der maximale Fangtoleranz gefunden wird, wird das Objekt als nicht verortet gekennzeichnet. | Linear unit |
Feature_Locator_WHERE_Clause (optional) | Ein SQL-Ausdruck zur Auswahl einer Teilmenge von Quell-Features, wodurch die Netzwerkelemente eingeschränkt werden, auf denen Einrichtungen gesucht werden können. Die Syntax für diesen Parameter besteht aus zwei Teilen. Der erste Teil ist der Name der Quell-Feature-Class (gefolgt von einem Leerzeichen), der zweite Teil der SQL-Ausdruck. Um einen SQL-Ausdruck für zwei oder mehr Quell-Feature-Classes zu schreiben, verwenden Sie ein Semikolon als Trennzeichen. Beispiel: Wenn Sie sicherstellen möchten, dass Einrichtungen nicht auf eingeschränkt befahrbaren Straßen platziert werden, schreiben Sie einen SQL-Ausdruck wie den folgenden, um diese Quell-Features auszuschließen: "Streets" "FUNC_CLASS not in('1', '2')". Beachten Sie, dass Barrieren die WHERE-Klausel des Feature-Locators beim Laden ignorieren. | String |
Route_Shape (optional) | Geben Sie den Typ der Routen-Features an, die vom Werkzeug ausgegeben werden. Der Parameter kann mit einem der folgenden Werte angegeben werden:
Wenn für den Parameter Routen-Shape die Einstellung "Echtes Shape" festgelegt wurde, kann die Generalisierung des Routen-Shapes mit den entsprechenden Werten für die Parameter "Vereinfachungstoleranz für Routenlinien" weiter gesteuert werden. Unabhängig von dem für den Parameter Routen-Shape gewählten Wert wird die optimale Route immer bestimmt, indem die Fahrzeit oder Fahrstrecke minimiert wird, nie durch die geradlinige Strecke zwischen Ereignissen und Einrichtungen. Dies bedeutet, dass sich nur die Routen-Shapes und nicht die zugrunde liegenden Straßen, die beim Ermitteln der Route berücksichtigt werden, unterscheiden. | String |
Route_Line_Simplification_Tolerance (optional) | Geben Sie an, wie stark Sie die Routengeometrie vereinfachen möchten. Dieser Parameter wird vom Werkzeug ignoriert, wenn für den Parameter Route_Shape nicht TRUE_LINES_WITH_MEASURES oder TRUE_LINES_WITHOUT_MEASURES festgelegt wurde. Bei der Vereinfachung werden kritische Punkte auf einer Route beibehalten, wie Übergänge an Kreuzungen, um das wesentliche Shape der Route zu definieren, und andere Punkte entfernt. Die angegebene Vereinfachungsentfernung stellt den maximal zulässigen Versatz dar, den die vereinfachte Linie von der ursprünglichen Linie abweichen kann. Durch die Vereinfachung einer Linie wird die Anzahl der Stützpunkte in der Routengeometrie reduziert. Dadurch wird die Ausführungszeit des Werkzeugs verbessert. Der Wert dieses Parameters wird überschrieben, wenn Reisemodus (Travel_Mode in Python) auf einen anderen Wert als "Benutzerdefiniert" festgelegt wird. | Linear unit |
Populate_Directions (optional) | Geben Sie an, ob vom Werkzeug Wegbeschreibungen für die einzelnen Routen generiert werden sollen.
| Boolean |
Directions_Language (optional) | Geben Sie an, in welcher Sprache Wegbeschreibungen generiert werden sollen. Dieser Parameter wird nur verwendet, wenn der Parameter Wegbeschreibungen füllen aktiviert oder dafür "True" festgelegt wurde. Die verfügbaren Sprachen für Wegbeschreibungen hängen von den ArcGIS-Sprachpaketen ab, die Sie auf dem Computer installiert haben. Die Werte werden in Sprachcodes aus zwei oder fünf Zeichen eingegeben, z. B. en für Englisch oder zh-CN für vereinfachtes Chinesisch. Wenn ein nicht unterstützter Sprachcode angegeben wird, werden die Wegbeschreibungen in der Standardsprache Englisch ausgegeben. | String |
Directions_Distance_Units (optional) | Geben Sie die Einheiten für das Anzeigen der Fahrstrecke in den Wegbeschreibungen an. Dieser Parameter wird nur verwendet, wenn der Parameter Wegbeschreibungen füllen aktiviert oder auf True gesetzt wurde.
| String |
Directions_Style_Name (optional) | Geben Sie den Namen des Formatierungsstils für die Wegbeschreibung an. Dieser Parameter wird nur verwendet, wenn der Parameter Wegbeschreibungen füllen aktiviert oder auf True gesetzt wurde. Der Parameter kann mit den folgenden Werten angegeben werden:
| String |
Maximum_Features_Affected_by_Point_Barriers (optional) | Schränkt die Anzahl der Features ein, die von Punkt-Barrieren betroffen sind. Mithilfe dieses Parameters können Sie den bei der Berechnung stattfindenden Verarbeitungsaufwand steuern. Sie können diesem Parameter z. B. für eine kostenlose Version des Service, den Sie erstellen, einen niedrigen Wert zuweisen und für eine kostenpflichtige Subskriptionsversion des Service einen höheren Wert verwenden. Ein NULL-Wert gibt an, dass kein Grenzwert vorhanden ist. | Long |
Maximum_Features_Affected_by_Line_Barriers (optional) |
Schränkt die Anzahl der Features ein, die von Linien-Barrieren betroffen sind. Mithilfe dieses Parameters können Sie den bei der Berechnung stattfindenden Verarbeitungsaufwand steuern. Sie können diesem Parameter z. B. für eine kostenlose Version des Service, den Sie erstellen, einen niedrigen Wert zuweisen und für eine kostenpflichtige Subskriptionsversion des Service einen höheren Wert verwenden. Ein NULL-Wert gibt an, dass kein Grenzwert vorhanden ist. | Long |
Maximum_Features_Affected_by_Polygon_Barriers (optional) |
Schränkt die Anzahl der Features ein, die von Polygon-Barrieren betroffen sind. Mithilfe dieses Parameters können Sie den bei der Berechnung stattfindenden Verarbeitungsaufwand steuern. Sie können diesem Parameter z. B. für eine kostenlose Version des Service, den Sie erstellen, einen niedrigen Wert zuweisen und für eine kostenpflichtige Subskriptionsversion des Service einen höheren Wert verwenden. Ein NULL-Wert gibt an, dass kein Grenzwert vorhanden ist. | Long |
Maximum_Facilities (optional) | Schränkt die Anzahl der Einrichtungen ein, die der Analyse der nächstgelegenen Einrichtung hinzugefügt werden können. Mithilfe dieses Parameters können Sie den bei der Berechnung stattfindenden Verarbeitungsaufwand steuern. Sie können diesem Parameter z. B. für eine kostenlose Version des Service, den Sie erstellen, einen niedrigen Wert zuweisen und für eine kostenpflichtige Subskriptionsversion des Service einen höheren Wert verwenden. Ein NULL-Wert gibt an, dass kein Grenzwert vorhanden ist. | Long |
Maximum_Facilities_to_Find (optional) | Schränkt die Anzahl der Einrichtungen ein, die der Benutzer vom Service suchen lassen kann. Mithilfe dieses Parameters können Sie den bei der Berechnung stattfindenden Verarbeitungsaufwand steuern. Sie können diesem Parameter z. B. für eine kostenlose Version des Service, den Sie erstellen, einen niedrigen Wert zuweisen und für eine kostenpflichtige Subskriptionsversion des Service einen höheren Wert verwenden. Ein NULL-Wert gibt an, dass kein Grenzwert vorhanden ist. | Long |
Maximum_Incidents (optional) | Schränkt die Anzahl der Ereignisse ein, die der Analyse der nächstgelegenen Einrichtung hinzugefügt werden können. Mithilfe dieses Parameters können Sie den bei der Berechnung stattfindenden Verarbeitungsaufwand steuern. Sie können diesem Parameter z. B. für eine kostenlose Version des Service, den Sie erstellen, einen niedrigen Wert zuweisen und für eine kostenpflichtige Subskriptionsversion des Service einen höheren Wert verwenden. Ein NULL-Wert gibt an, dass kein Grenzwert vorhanden ist. | Long |
Force_Hierarchy_Beyond_Distance (optional) | Gibt die Entfernung an, nach der der Solver beim Suchen nächstgelegener Einrichtungen die Hierarchie auch dann erzwingt, wenn sie nicht aktiviert wurde. Die Einheiten dieses Parameters entsprechen denen im Parameter Entfernungsattributeinheiten. Die Suche von nächstgelegenen Einrichtungen, die weit entfernt liegen, bei Verwendung der Netzwerkhierarchie ist in der Regel weniger verarbeitungsintensiv als die Suche derselben nächstgelegenen Einrichtungen ohne Verwendung der Hierarchie. Mithilfe dieses Parameters können Sie den bei der Berechnung stattfindenden Verarbeitungsaufwand steuern. Ein NULL-Wert gibt an, dass die Hierarchie nie erzwungen und der Wert des Parameters Hierarchie bei Analyse verwenden immer berücksichtigt wird. Wenn das Eingabe-Netzwerk-Dataset keine Hierarchie unterstützt, führt die Angabe eines Wertes für diesen Parameter zu einem Fehler. In diesem Fall muss ein NULL-Wert verwendet werden. | Double |
Save_Output_Network_Analysis_Layer (optional) |
Es werden in jedem Fall Feature-Classes mit Routen und Wegbeschreibungen zurückgegeben. Ein Serveradministrator möchte jedoch evtl. auch einen Netzwerkanalyse-Layer ausgeben, um einen Debugging-Vorgang für die Einrichtung und Ergebnisse des Werkzeugs mit den Network Analyst-Steuerelementen in der ArcGIS for Desktop-Umgebung durchzuführen. Dies kann den Debugging-Prozess deutlich vereinfachen. In ArcGIS for Desktop befindet sich der Standardausgabespeicherort für den Netzwerkanalyse-Layer im Scratch-Ordner. Sie können den Speicherort des Scratch-Ordners festlegen, indem Sie den Wert der Geoverarbeitungsumgebung arcpy.env.scratchFolder auswerten. Der Ausgabe-Netzwerkanalyse-Layer wird als LYR-Datei gespeichert, deren Name mit _ags_gpna beginnt, gefolgt von einer alphanumerischen GUID. | Boolean |
Travel_Mode (optional) | Wählen Sie den Transportmodus für die Analyse aus. CUSTOM kann immer ausgewählt werden. Um andere Namen für Reisemodi anzuzeigen, müssen sie in dem Netzwerk-Dataset vorhanden sein, das im Parameter Network_Dataset angegeben wurde. (Die Funktion arcpy.na.GetTravelModes stellt ein Wörterbuch der Reisemodusobjekte bereit, die in einem Netzwerk-Dataset konfiguriert wurden, und die Eigenschaft name gibt den Namen eines Reisemodusobjekts zurück.) Ein Reisemodus wird in einem Netzwerk-Dataset definiert und stellt Override-Werte für Parameter bereit, die zusammen Reisemodi wie Auto, Lkw, Fußgänger und usw. modellieren. Wenn Sie hier einen Reisemodus auswählen, müssen Sie keine Werte für die folgenden Parameter angeben, die von Werten überschrieben werden, die im Netzwerk-Dataset angegeben wurden:
| String |
Codebeispiel
FindClosestFacilities – Beispiel 1
Ausführen des Werkzeugs mit den erforderlichen Parametern.
import arcpy
incidents = arcpy.FeatureSet()
incidents.load("Stores")
facilities = arcpy.FeatureSet()
facilities.load("Warehouses")
arcpy.na.FindClosestFacilities(incidents, facilities, "Minutes",
"Streets_ND", "in_memory", "Routes",
"Directions", "CLosestFacilities",
Number_of_Facilities_to_Find=1)
FindClosestFacilities – Beispiel 2 (eigenständiges Python-Skript)
Das folgende eigenständige Python-Skript veranschaulicht, wie mit "FindClosestFacilities" die nächstgelegenen Geschäfte bei einem Lagerhaus ermittelt werden können. Sie können das Skript ändern, damit andere Eingaben verwendet werden, um beispielsweise den nächstgelegenen Rettungswagen bei einem Unfall oder das nächstgelegene Arbeitsteam für eine ausgefallene Stromleitung zu ermitteln.
# Name: FindClosestFacilities_Workflow.py
# Description: For each store, find the closest warehouse. The output will show
# the routes between stores and warehouses, driving directions,
# and the subset of warehouses that were closest to stores.
# Requirements: Network Analyst Extension
#Import system modules
import arcpy
from arcpy import env
try:
#Check out the Network Analyst extension license
arcpy.CheckOutExtension("Network")
#Set environment settings
env.workspace = r'C:\arcgis\ArcTutor\Network Analyst\Tutorial\Paris.gdb'
env.overwriteOutput = True
#Set local variables
inNetworkDataset = r'Transportation\ParisMultimodal_ND'
inIncidents = r'Analysis\Stores'
inFacilities = r'Analysis\Warehouses'
outGeodatabase = r'C:\arcgis\ArcTutor\Network Analyst\Tutorial\Output.gdb'
outRoutes = "Routes"
outDirections = "Directions"
outClosestFacilities = "ClosestFacilities"
measurement_units = "Minutes"
# Run FindClosestFacilities. Choose to find only the closest facility.
arcpy.na.FindClosestFacilities(inIncidents, inFacilities, measurement_units,
inNetworkDataset, outGeodatabase, outRoutes,
outDirections, outClosestFacilities,
Number_of_Facilities_to_Find=1)
print "Script completed successfully"
except Exception as e:
# If an error occurred, print line number and error message
import traceback, sys
tb = sys.exc_info()[2]
print "An error occured on line %i" % tb.tb_lineno
print str(e)
Umgebung
Lizenzierungsinformationen
- ArcGIS for Desktop Basic: Erfordert Network Analyst
- ArcGIS for Desktop Standard: Erfordert Network Analyst
- ArcGIS for Desktop Advanced: Erfordert Network Analyst