Ausgabe des Werkzeugs "FindRoutes"

Nach der erfolgreichen Ausführung gibt der Service die besten Routen zwischen den Stopps und den Status zurück, der darauf hinweist, dass die Analyse erfolgreich durchgeführt wurde, indem die folgenden Ausgabeparameter verwendet werden:

output_routes

Verwenden Sie diesen Parameter, um auf die resultierende Route bzw. die resultierenden Routen zwischen den Stopps zuzugreifen.

Nachfolgend finden Sie eine Beschreibung der Felder, die für jede Route zurückgegeben werden:

Feldname	Beschreibung
OID	Eine eindeutige Kennung für die Route. Diese Kennung wird automatisch vom Service erstellt.
Name	Der Name der Route basiert auf dem Feld RouteName der verknüpften Stopps. Wenn das Eingabefeld RouteName null ist, wird der Name aus dem Feld Name der ersten und letzten Stopps abgeleitet.
StopCount	Die Anzahl von Stopps, die der Route zugewiesen sind.
Total_Minutes	Die kumulative Fahrzeit der Route zwischen den Stopps in Minuten.
FirstStopOID	Der ObjectID-Wert des ersten Stopps der Route. Dieses Feld wird häufig verwendet, um Informationen aus Eingabestopps mit Routen zu verbinden.
LastStopOID	Der ObjectID-Wert des letzten Stopps der Route. Dieses Feld wird häufig verwendet, um Informationen aus Eingabestopps mit Routen zu verbinden.
Total_Kilometers	Die kumulative Fahrstrecke der Route zwischen den Stopps in Kilometern.
Total_Miles	Die kumulative Fahrstrecke der Route zwischen den Stopps in Meilen.
Shape_Length	Die Länge der Route in den Einheiten des Raumbezugs, die für die Routengeometrie angegeben wurden. Die Länge wird standardmäßig in Dezimalgrad angegeben, wenn der Parameter env:outSR nicht festgelegt wird.

Hinweis:

Ein zusätzliches Feld mit dem Namen Total_[MeasurementUnits] ist enthalten, wenn der Parameter measurement_units weder Miles, Kilometers, noch Minutes entspricht. Wenn der Parameter measurement_units beispielsweise als Meters angegeben wird, enthält der Parameter output_routes die Felder Total_Meters, Total_Miles, Total_Kilometers und Total_Minutes.

output_directions

Verwenden Sie diesen Parameter, um auf die detaillierte Wegbeschreibung für jede resultierende Route zwischen den Stopps zuzugreifen. Der Parameter enthält die Wegbeschreibung und die Geometrie für das Feature "Wegbeschreibung", das dem Text entspricht. Das Shape für das Feature "Wegbeschreibung" wird über die zugrunde liegenden Straßen ermittelt, die in der Route enthalten sind. Die Feature-Geometrien werden in dem Raumbezug zurückgegeben, der als env:outSR-Parameter festgelegt wurde. Die Features sind leer, wenn der Parameter populate_directions false lautet. Die Parameter directions_language, directions_distance_units, und directions_style_name haben großen Einfluss auf die Wegbeschreibung.

Nachfolgend finden Sie eine Beschreibung der Felder, die für Wegbeschreibungs-Features zurückgegeben werden:

Feldname	Beschreibung
ObjectID	Eine eindeutige Kennung für das Wegbeschreibungs-Feature. Diese Kennung wird automatisch vom Service erstellt.
RouteName	Der Name der Route, auf die sich die Fahraktion bezieht. Dieser Wert ist mit dem Attribut Name des Parameters output_routes identisch.
ArriveTime	Die Uhrzeit, an der die jeweilige Fahraktion initiiert wird. Wenn die Route mehrere Tage umfasst, werden das Datum und die Uhrzeit angezeigt.
Type	Gibt die Art des vom Wegbeschreibungs-Feature dargestellten Manövers oder den Typ des Wegbeschreibungstextes an. Um zu ermitteln, ob Type sich auf einen Manövertyp oder einen Wegbeschreibungszeichenfolgentyp bezieht, müssen Sie den Wert des Feldes SubItemType überprüfen. Type kann beispielsweise verwendet werden, um ein anderes Symbol für einen Wegbeschreibungstext basierend auf dem Manövertyp zuzuweisen oder einen speziellen Formatierungs-Style basierend auf dem Wegbeschreibungszeichenfolgentyp zu verwenden, wenn die Wegbeschreibung in Ihrer Anwendung angezeigt wird. Der Wert Type ist ein ganzzahliger Wert aus der nachfolgend aufgeführten Tabelle "Manövertypen" oder "Wegbeschreibungzeichenfolgentypen". Manövertypen Wert Beschreibung 0 Unbekannt 1 Ankunft an Stopp 2 Geradeaus 3 Links einordnen 4 Rechts einordnen 5 Links abbiegen 6 Rechts abbiegen 7 Scharf links abbiegen 8 Scharf rechts abbiegen 9 Wenden 10 Fähre nehmen 11 Kreisel nehmen 12 In Autobahn einfahren 13 Autobahn verlassen 14 Eine andere Autobahn nehmen 15 Bei der Gabelung geradeaus halten 16 Bei der Gabelung links halten 17 Bei der Gabelung rechts halten 18 Stopp für Abfahrt 19 Routenplanungselement 20 Ende der Fähre 21 Fußgängerbrücke rechts 22 Fußgängerbrücke links 23 Links abbiegen und dann sofort rechts abbiegen 24 Rechts abbiegen und dann sofort links abbiegen 25 Rechts abbiegen und dann sofort rechts abbiegen 26 Links abbiegen und dann sofort links abbiegen Wegbeschreibungzeichenfolgentypen Wert Beschreibung 0 Allgemeiner Wegbeschreibungszeichenfolgentyp 1 Wegbeschreibungszeichenfolgentyp für Abfahrt 2 Wegbeschreibungszeichenfolgentyp für Ankunft 3 Wegbeschreibungszeichenfolgentyp für Länge 4 Wegbeschreibungszeichenfolgentyp für Zeit 5 Wegbeschreibungszeichenfolgentyp für Zeitzusammenfassung 6 Wegbeschreibungszeichenfolgentyp für Zeitfenster 7 Wegbeschreibungszeichenfolgentyp für Verstoßzeit 8 Wegbeschreibungszeichenfolgentyp für Wartezeit 9 Wegbeschreibungszeichenfolgentyp für Durchführungszeit 10 Wegbeschreibungszeichenfolgentyp für geschätzte Ankunft 11 Wegbeschreibungszeichenfolgentyp für kumulative Länge 12 Wegbeschreibungszeichenfolgentyp für Straßenname 13 Wegbeschreibungszeichenfolgentyp für alternative Straße 14 Wegbeschreibungszeichenfolgentyp für Abbiegeschildinformationen 15 Wegbeschreibungszeichenfolgentyp für Hinweisschildinformationen 16 Wegbeschreibungszeichenfolgentyp für Kreuzungsname 17 Wegbeschreibungszeichenfolgentyp für die Nummer auf Ausfahrtschildern
SubItemType	Legt fest, ob das Feld Type sich auf einen ganzzahligen Wert aus der Tabelle "Wegbeschreibungszeichenfolgentypen" oder der Tabelle "Manövertypen" bezieht. Wenn der Wert SubItemType 1 beträgt, bezieht sich Type auf die Werte aus der Tabelle "Manövertypen". Beträgt der Wert SubItemType 2, bezieht sich Type auf die Werte aus der Tabelle "Wegbeschreibungszeichenfolgentypen".
Text	Eine Textbeschreibung der Wegbeschreibungen.
ElaspsedTime	Die verstrichene Zeit zwischen dem Beginn der aktuellen Wegbeschreibung und dem Beginn der nächsten bzw. dem Ende der Route für die letzte Wegbeschreibung in Minuten.
DriveDistance	Die Entfernung zwischen der Position der aktuellen Wegbeschreibung und der nächsten bzw. dem Ende der Route für die letzte Wegbeschreibung. Der Wert wird in den Einheiten angegeben, die durch den Parameter distance_units festgelegt wurden. Dieser Wert ist bei Wegbeschreibungen für Standorte, die mit dem Beginn des nächsten Routenteils identisch sind, 0. Der Wert für DriveDistance ist am Anfang der Route für den Beschreibungstext beispielsweise 0.
Shape_Length	Die Länge des Wegbeschreibungs-Features in den Einheiten des Raumbezugs, der für die Routen angegeben wurde. Die Länge wird standardmäßig in Dezimalgrad angegeben, wenn der Parameter env:outSR nicht festgelegt wird.

output_stops

Verwenden Sie diesen Parameter für den Zugriff auf die Attribute der Stopps, die in der Route aufgesucht werden, und der Stopps, die von keiner der Routen erreicht werden konnten. Bei den Stopps, die erreicht werden konnten, listet die Attributtabelle auf: den Routennamen, der den Stopps zugewiesen ist, die Reihenfolge der Stopps, die Ankunftszeit und weitere Informationen. Bei den Stopps, die nicht erreicht werden konnten, liefert die Attributtabelle Informationen zur Ursache des Problems.

Nachfolgend finden Sie eine Beschreibung der Attribute, die für jeden Stopp zurückgegeben werden:

Feldname	Beschreibung
OID	Eine eindeutige Kennung für den Stopp. Diese Kennung wird automatisch vom Service erstellt.
Name	Der Name des auf der Route liegenden Stopps.
RouteName	Der Name der Route, der der Stopp zugewiesen wird. Eingabestopps, die zum Ausführungszeitpunkt des Werkzeugs denselben Routennamen haben, werden gruppiert und durch eine Route aufgesucht, und der Route wird dieser Name zugewiesen. Wenn für die Eingabestopps mehrere Routennamen vorhanden sind, kann das Werkzeug auch mehrere Routen ausgeben – eine für jeden eindeutigen Routennamen. Wenn kein Name vorhanden ist, gehören alle Stopps derselben Route an.
Sequence	Die Reihenfolge, in der die Stopps durch die zugewiesene Route aufgesucht werden, die im Feld RouteName aufgelistet ist.
TimeWindowStart	Der früheste Zeitpunkt, zu dem die Route den Stopp aufsuchen kann. Die Werte für dieses Feld werden aus dem Feld TimeWindowStart für die Eingabestopps kopiert.
TimeWindowEnd	Der späteste Zeitpunkt, zu dem die Route den Stopp aufsuchen kann. Die Werte für dieses Feld werden aus dem Feld TimeWindowEnd für die Eingabestopps kopiert.
ArriveCurbApproach	Gibt an, auf welcher Seite des Fahrzeugs sich die Bordsteinkante bei der Ankunft am Stopp befindet.
DepartCurbApproach	Gibt an, auf welcher Seite des Fahrzeugs sich die Bordsteinkante bei der Abfahrt vom Stopp befindet.
LocationType	Gibt den Stopp-Typ an. Die Werte für dieses Feld werden aus dem Feld LocationType für die Eingabestopps kopiert.
CurbApproach	Die Richtung, in der ein Fahrzeug den Stopp erreicht bzw. von ihm wegfährt. Die Werte für dieses Feld werden aus dem Feld CurbApproach für die Eingabestopps kopiert.
Status	Gibt an, wie der Stopp in der Analyse bewertet wurde. Mit diesem Feld kann ermittelt werden, welche Stopps keiner Route zugewiesen sind. Die möglichen Werte lauten wie folgt: 0 (OK): Der Stopp wurde im Verkehrsnetzwerk erfolgreich gefunden und analysiert. 1 (Nicht verortet): Eine passierbare Straße befand sich nicht im Umkreis von 12,42 Meilen (20 km) vom Stopp und wurde daher aus der Analyse ausgeschlossen. 4 (Nicht erreicht): Der Stopp konnte aufgrund von Einschränkungen nicht erreicht werden; beispielsweise wurde ein CurbApproach festgelegt, sodass ein Fahrzeug in einer Einbahnstraße in die falsche Richtung fahren muss. 6 (Zeitfensterverletzung): Zeitfenster in der Route können nicht rechtzeitig erreicht werden; die Route kommt zu früh oder zu spät an.
AdditionalTime	Die Zeit, die zur gesamten Routenzeit hinzukommt, wenn dieser Stopp besucht wird. Die Werte für dieses Feld werden aus dem Feld AdditionalTime für die Eingabestopps kopiert. Dieses Feld ist nur enthalten, wenn der Wert für den Parameter Measurement Units zeitbasiert ist.
AdditionalDistance	Die Strecke, die zur gesamten Routenstrecke hinzukommt, wenn dieser Stopp besucht wird. Die Werte für dieses Feld werden aus dem Feld AdditionalDistance für die Eingabestopps kopiert. Dieses Feld ist nur enthalten, wenn der Wert für den Parameter Measurement Units entfernungsbasiert ist.
Cumul_Minutes	Die kumulative Dauer der Route vom Ursprung bis einschließlich zum Stopp in Minuten. Der hier gemeldete Wert ist die kumulative Routenzeit bis zum Stopp, einschließlich aller Zusatzzeiten an dem Stopp und an allen vorherigen Stopps.
ORIG_FID	Die ObjectID des Eingabestopps. Dieses Feld kann verwendet werden, um Attribute aus den Ausgabestopps mit den Eingabestopps oder aus den Eingabestopps mit den Ausgabestopps zu verknüpfen.
Cumul_Kilometers	Die kumulative Entfernung der Route vom Ursprung bis einschließlich zum Stopp in Kilometern. Der hier gemeldete Wert ist die kumulative Routenentfernung bis zum Stopp, einschließlich aller Zusatzentfernungen an dem Stopp und an allen vorherigen Stopps.
Cumul_Miles	Die kumulative Entfernung der Route vom Ursprung bis einschließlich zum Stopp in Meilen. Der hier gemeldete Wert ist die kumulative Routenentfernung bis zum Stopp, einschließlich aller Zusatzentfernungen an dem Stopp und an allen vorherigen Stopps.

Hinweis:

Ein zusätzliches Feld mit dem Namen Cumul_[MeasurementUnits] ist enthalten, wenn der Parameter measurement_units weder Miles, Kilometers, noch Minutes entspricht. Wenn der Parameter measurement_units beispielsweise als Meters angegeben wird, enthält der Parameter output_stops die Felder Cumul_Meters, Cumul_Miles, Cumul_Kilometers und Cumul_Minutes.

output_route_edges

Verwenden Sie diesen Parameter, um auf die einzelnen Straßensegmente zuzugreifen, auf denen die Route verläuft.

Nachfolgend finden Sie eine Beschreibung der Attribute, die für jede Routenkante zurückgegeben werden:

Feldname	Beschreibung
OID	Eine eindeutige Kennung für die Routenkante. Diese Kennung wird automatisch vom Service erstellt.
Shape	Das Geometriefeld, das das Shape der Linien angibt.
SourceName	Der Name der Quell-Edge-Feature-Class, aus der die Linie generiert wurde.
SourceOID	Die ObjectID des durchlaufenen Straßen-Features. Die Zusammenfassung der Werte für dieses Feld kann nützliche Informationen liefern, wie z. B. die Anzahl, wie oft ein bestimmtes Straßen-Feature in all den Routen enthalten ist.
RouteEdgeID	Die ID, die die Kante darstellt, aus der sich das Straßen-Feature zusammensetzt. Da pro Straßen-Feature mehrere Kanten vorhanden sein können, kann mit dem Feld SourceOID das durchlaufene Straßen-Feature eindeutig identifiziert werden, und mit dem Feld RouteEdgeID kann die Kante innerhalb des durchlaufenen Straßen-Features eindeutig identifiziert werden.
FromPosition	Gibt an, wo das Ausgabe-RouteEdges-Feature in Bezug auf die Digitalisierrichtung des zugrunde liegenden Straßen-Features beginnt. Der Wert 0 (null) gibt an, dass die Linie am Ausgangspunkt des zugrunde liegenden Straßen-Features beginnt. Der Wert 1 gibt an, dass die Linie am Zielpunkt des zugrunde liegenden Straßen-Features beginnt. Ein Wert zwischen 0 und 1 gibt an, dass die Linie an einem Punkt auf dem zugrunde liegenden Straßen-Feature beginnt. Der Wert 0,25 bedeutet z. B., dass die Linie nach 25 Prozent in Digitalisierrichtung des zugrunde liegenden Straßen-Features beginnt.
ToPosition	Gibt an, wo das Ausgabe-RouteEdges-Feature in Bezug auf die Digitalisierrichtung des zugrunde liegenden Straßen-Features endet. Der Wert 0 (null) gibt an, dass die Linie am Ausgangspunkt des zugrunde liegenden Straßen-Features endet. Der Wert 1 gibt an, dass die Linie am Zielpunkt des zugrunde liegenden Straßen-Features endet. Ein Wert zwischen 0 und 1 gibt an, dass die Linie an einem Punkt auf dem zugrunde liegenden Straßen-Feature endet. Der Wert 0,25 bedeutet z. B., dass die Linie nach 25 Prozent in Digitalisierrichtung des zugrunde liegenden Straßen-Features endet.
RouteID	Kennzeichnet eindeutig die Route, von der die Kante durchlaufen wurde. Der Wert RouteID entspricht einem ObjectID-Wert aus der output_routes-Feature-Class.
Attr_Minutes	Die Fahrzeit des durchlaufenen Teils des zugrunde liegenden Straßen-Features in Minuten.
Attr_Miles	Die Länge des durchlaufenen Teils des zugrunde liegenden Straßen-Features in Meilen.
Attr_Kilometers	Die Länge des durchlaufenen Teils des zugrunde liegenden Straßen-Features in Kilometern.
Cumul_Minutes	Die Fahrzeit der Route vom Ursprung bis zum Ende des durchlaufenen Teils dieses zugrunde liegenden Straßen-Features in Minuten.
Cumul_Miles	Die Länge der Route vom Ursprung bis zum Ende des durchlaufenen Teils dieses zugrunde liegenden Straßen-Features in Meilen.
Cumul_Kilometers	Die Länge der Route vom Ursprung bis zum Ende des durchlaufenen Teils dieses zugrunde liegenden Straßen-Features in Kilometern.
Attr_[Soft Restriction Attribute Name]	Gibt an, ob die durchlaufene Kante das weiche Restriktionsattribut verwendet hat, auf das im Namen dieses Feldes verwiesen wird. 0: Die durchlaufene Kante hat das weiche Restriktionsattribut nicht verwendet. 1: Die durchlaufene Kante hat das weiche Restriktionsattribut verwendet. Wurde beispielsweise die Analyse mit der weichen Beschränkung "Mautstraßen vermeiden" durchgeführt, wird für diese weiche Beschränkung das Feld Attr_Avoid_Toll_Roads erstellt. Mit dem Wert 1 in diesem Feld würden die Mautstraßen in der Route dargestellt werden.
Shape_Length	Die Länge der Routenkante in den Einheiten des Raumbezugs, die für die Routengeometrie angegeben wurden.

solve_succeeded

Verwenden Sie diesen Parameter, um zu ermitteln, ob der Service die Routen erfolgreich ermittelt hat. Die Fehlermeldungen für Ausfall können abgerufen werden, indem eine Anforderung zum Abrufen des Auftragsstatus gesendet wird.