FindClosestFacilities (ClosestFacility)
Zusammenfassung
Sucht eine oder mehrere Einrichtungen, die anhand der Fahrzeit oder Fahrstrecke am nächsten an einem Ereignis liegen, und gibt die besten Routen, Wegbeschreibungen zwischen Ereignis und ausgewählter Einrichtung sowie eine Kopie der gewählten Einrichtungen 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 ausfindig machen.
Beim Suchen der nächstgelegenen Einrichtungen können Sie festlegen, wie viele ermittelt werden sollen, und ob die Fahrtrichtung zu oder weg von diesen Einrichtungen sein soll. Sie können auch die Uhrzeit angeben, um die Fahrzeit basierend auf der aktuellen oder voraussichtlichen Verkehrslage für die jeweilige Uhrzeit und das Datum zu ermitteln. Mit dem 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.
Bild
Verwendung
-
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 eine Einrichtung und ein Ereignis anzugeben. Sie können bis zu 1,000 Einrichtungen und 1,000 Ereignisse angeben; für jedes Ereignis werden bis zu 100 nächstgelegene Einrichtungen angezeigt. Daher kann das Werkzeug bei jeder Berechnung bis zu 100,000 nächstgelegene Einrichtungen ermitteln.
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.
Zur Beschleunigung der Lösungsfindung können Sie zwar die Straßenhierarchie verwenden, doch das Ergebnis dürfte dann eher suboptimal sein.
Unabhängig davon, ob der Parameter "Hierarchie verwenden" aktiviert ist (True), wird die Hierarchie immer verwendet, wenn die geradlinige Entfernung zwischen zwei Features, die für Ereignisse oder Einrichtungen stehen, 50 Meilen (80,46 km) überschreitet.
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.
Syntax
| Parameter | Erläuterung | Datentyp |
Incidents |
Geben Sie ein oder mehrere Ereignisse an (bis zu 1,000). Von diesen Positionen aus sucht das Werkzeug nach den nahe gelegenen Positionen. 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: 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 |
Geben Sie eine oder mehrere Einrichtungen an (bis zu 1,000). Dies sind die Positionen, nach denen bei der Ermittlung der nächstgelegenen Position gesucht wird. 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 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):
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:
| String |
Analysis_Region (optional) |
Geben Sie die zu analysierende Region an. Wird für diesen Parameter kein Wert angegeben, ermittelt das Werkzeug anhand der Position der Eingabepunkte den Namen der Region automatisch. Es wird jedoch empfohlen, den Namen der Region anzugeben, um die Werkzeugausführung zu beschleunigen. Geben Sie zur Angabe der Region einen der folgenden Werte an:
| 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. Das Werkzeug kann für jedes Ereignis bis zu 100 Einrichtungen ermitteln. | Long |
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. Feuerwehren verwenden im Allgemeinen den Wert "Einrichtung zu Ereignis" für den Parameter, da es hier darauf ankommt, wie lange es dauert, von der Feuerwache (Einrichtung) zum Einsatzort (Ereignis) zu fahren. Ein Einzelhandelsgeschäft (Einrichtung) ist eher daran interessiert, wie lange die Käufer (Ereignisse) brauchen, um den Laden zu erreichen. Daher wählen Läden für gewöhnlich die Option "Ereignis zur Einrichtung". | String |
Use_Hierarchy (optional) | Geben Sie an, ob beim Suchen der besten Route zwischen der Einrichtung und dem Ereignis die Hierarchie verwendet werden soll.
Das Werkzeug verwendet die Hierarchie automatisch, wenn die geradlinige Entfernung zwischen Einrichtungen und Ereignissen 80 km überschreitet, selbst wenn Sie eingestellt haben, dass die Hierarchie von diesem Parameter nicht verwendet werden soll. | Boolean |
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. Die Angabe einer Uhrzeit führt 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. | Date |
Time_of_Day_Usage (optional) |
Gibt an, ob der Wert des Parameters Uhrzeit die Ankunfts- oder Abfahrtzeit für die Routen darstellt.
| String |
UTurn_at_Junctions (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.
| String |
Point_Barriers (optional) |
Geben Sie einen oder mehrere Punkte an, die als Zeitbeschränkungen dienen bzw. die 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 von Attributen deren jeweilige Eigenschaften, darunter Name oder Barrierentyp, festlegen. Für die Punkt-Barrieren können folgende Attribute angegeben werden: 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: – 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 an, wie viel Entfernung durch das Passieren der Barriere hinzugefügt wird. Dieses Feld gilt nur für Barrieren vom Typ "Zusatzkosten" und ausschließlich für entfernungsbasierte Maßeinheiten. Dieser Feldwert muss größer oder gleich Null sein, und seine Einheiten werden vom Parameter "Maßeinheiten" vorgegeben. | Feature Set |
Line_Barriers (optional) |
Geben Sie eine oder mehr Linien an, 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 wird zwar keine Begrenzung für die Anzahl der Linien genannt, 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 des folgenden Attributs für jede eine Eigenschaft "Name" festlegen: Name: Der Name der Barriere. | Feature Set |
Polygon_Barriers (optional) |
Geben Sie Polygone an, die entweder den Verkehr 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 wird zwar keine Begrenzung für die Anzahl der Polygone genannt, 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 von Polygon-Barrieren können Sie mithilfe von Attributen deren jeweilige Eigenschaften, darunter Name oder Barrierentyp, festlegen. Für die Polygon-Barrieren können folgende Attribute angegeben werden: Name: Der Name der Barriere. BarrierType: Gibt an, ob die Barriere den Verkehr vollständig beschränkt oder ob beim Durchfahren der Barriere ein Mehraufwand an Zeit oder Entfernung entsteht. 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 überschnitten 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 zurückgelegte Entfernung durch die Straßen, die von der Barriere überschnitten 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 |
Restrictions (optional) |
Geben Sie an, welche Beschränkungen von dem Werkzeug bei der Ermittlung der besten Routen zwischen Ereignissen und Einrichtungen berücksichtigt werden sollen. 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, sie können jedoch auch dazu führen, dass sie vermieden oder bevorzugt werden. Wird beispielsweise die Beschränkung "Mautstraßen vermeiden" verwendet, enthält die berechnete Route Mautstraßen nur dann, wenn das Befahren solcher Straßen zum Erreichen eines Ereignisses oder einer Einrichtung absolut 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 Einschränkung "Gefahrgut verboten" vermieden, dass diese Materialien auf Straßen transportiert werden, die für solche Transporte als unzulässig markiert sind. Nachfolgend finden Sie eine Liste der verfügbaren Einschränkungen und eine kurze Beschreibung.  Hinweis:Bei manchen Einschränkungen muss ein zusätzlicher Wert für den gewünschten Zweck angegeben werden. Dieser Wert muss mit dem Namen der Einschränkung und einem spezifischen Parameter, der für diese Einschränkung gilt, verknüpft werden. Sie können solche Einschränkungen anhand ihres Namens in der Spalte "AttributeName" unter dem Parameter "Attributparameterwerte" identifizieren. Um die ordnungsgemäße Verwendung der Einschränkung bei der Ermittlung passierbarer Straßen sicherzustellen, sollte das Feld "ParameterValue" im Parameter "Attributparameterwerte" angegeben werden. Hinweis:Manche Einschränkungen werden nicht in allen Ländern unterstützt; ihre Verfügbarkeit nach Regionen wird nachfolgend aufgelistet. Welche der in manchen Regionen oder Ländern nur begrenzt anwendbaren Einschränkungen in einem bestimmten Land gültig sind, können Sie mit einem Blick auf folgende Webseite herausfinden: Website "Datenausdehnung für Netzwerkanalyse-Services"[engl.]. Dort ist eine Tabelle mit einer Länderliste aufgeführt. Steht in der Logistics Attribute Spalte eines Landes der Wert Yes, so wird die Einschrä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 Einschränkungen, deren Parameterwert für die Verwendung von Beschränkungen zwischen 0 und 1 liegt (siehe der Parameter "Attributparameterwert"). Er unterbindet alle Einschränkungen, bei denen 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) | Geben Sie zusätzliche erforderliche Werte für Einschränkungen an, z. B. das Gewicht eines Fahrzeugs für die Gewichtseinschränkung. Außerdem können Sie mit dem Attributparameter angeben, ob aufgrund von Einschränkungen das Fahren auf Straßen, auf denen die Einschränkung gilt, unzulässig ist bzw. 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 sogar sehr zu bevorzugen. Wenn Sie den Parameter Attributparameterwerte aus einer Feature-Class angeben, müssen die Feldnamen in der Feature-Class mit den nachfolgend beschriebenen Feldern übereinstimmen: AttributeName: Listet den Namen der Einschränkung auf. ParameterName: Listet den Namen des mit der Einschränkung verknüpften Parameters auf. Eine Einschränkung kann abhängig von der geplanten Verwendung einen oder mehrere ParameterName-Feldwerte enthalten. ParameterValue: Der Wert für den vom Werkzeug verwendeten "ParameterName" bei der Auswertung der Beschränkung. "Attributparameterwerte" hängt vom Parameter "Einschrä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 Einschränkung (als "AttributeName" aufgelistet) über einen Wert für das Feld "ParameterName", eine Verwendung von Einschränkungen, mit der angegeben wird, ob von der Einschränkung das Fahren auf Straßen, die mit der Einschränkung verknüpft sind, nicht zugelassen, vermieden oder bevorzugt wird, und der Grad, in dem diese Straßen vermieden oder bevorzugt werden sollen. "ParameterName" der Verwendung von Einschrä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 "Restriction Usage" 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 die Verwendung der Einschränkung jedoch von den bevorzugten Verbindungen ab. Für die Einschränkung "Avoid Toll Roads" etwa ist der Standardwert für den Parameter "Verwendung von Einschrä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 zugeordnet, durch Auswahl von AVOID_HIGH hingegen wird der Vermeidung eine höhere Bedeutung zugeordnet, wodurch die Erstellung einer längeren Route zur Vermeidung von Mautstraßen für den Service akzeptabler wird. Bei der Auswahl von PROHIBITED ist das Befahren von Mautstraßen völlig unzulässig, wobei eine Route keinesfalls einen Teil einer Mautstraße enthalten kann. Beachten Sie, dass für einige Personen das Ziel darin besteht, Mautstraßen zu vermeiden und zu verhindern und damit auch die Bezahlung von Mautgebühren zu vermeiden, und dass andere hingegen Mautstraßen bevorzugen, da sie der Vermeidung von hohem Verkehrsaufkommen mehr Bedeutung zumessen als der Bezahlung von Mautgebühren. Im letzteren Fall würden Sie PREFER_LOW, PREFER_MEDIUM oder PREFER_HIGH als Wert für "Verwendung der Einschränkung" 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 |
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 Geometrie von Ausgabelinien für Routen und Wegbeschreibungen vereinfachen möchten. Dieser Parameter wird vom Werkzeug ignoriert, wenn für den Parameter Routen-Shape nicht "Echtes Shape" 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. | 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. Bei der Angabe des Parameterwertes ist einer der folgenden aus zwei oder fünf Zeichen bestehenden Sprachcodes zu verwenden:
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 dafür "True" festgelegt 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 dafür "True" festgelegt wurde. Der Parameter kann mit den folgenden Werten angegeben werden:
| 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 |
Codebeispiel
Mit dem folgenden Python-Skript wird veranschaulicht, wie Sie das Werkzeug "FindClosestFacilities" in einem Skript verwenden.
import arcpy
import time
import sys
username = "<your user name>"
password = "<your password>"
cf_service = "http://logistics.arcgis.com/arcgis/services;World/ClosestFacility;{0};{1}".format(username, password)
#Add the geoprocessing service as a toolbox. Use an alias when importing
arcpy.ImportToolbox(cf_service, "agol")
#Set the variables to call the tool
facilities = r"C:/data/Inputs.gdb/Stores"
incidents = r"C:/data/Inputs.gdb/Customers"
output_routes = "C:/data/Results.gdb/Routes"
output_directions = "C:/data/output/Results.gdb/Directions"
#Call the tool
result = arcpy.agol.FindClosestFacilities(incidents, facilities, "Minutes", "", 2)
#Check the status of the result object every 0.5 seconds
#until it has a value of 4(succeeded) or greater
while result.status < 4:
time.sleep(0.5)
#print any warning or error messages returned from the tool
result_severity = result.maxSeverity
if result_severity == 2:
print "An error occured when running the tool"
print result.getMessages(2)
sys.exit(2)
elif result_severity == 1:
print "Warnings were returned when running the tool"
print result.getMessages(1)
#Get the output routes and save to a local geodatabase
result.getOutput(0).save(output_routes)
result.getOutput(1).save(output_directions)