

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

# Amazon Location Service – Routen
<a name="routes"></a>

![\[Eine Übersicht über Amazon Location Service Routes.\]](http://docs.aws.amazon.com/de_de/location/latest/developerguide/images/routesV2/route-banner.png)


Mit Amazon Location Service Routes können Sie Reisezeit und Entfernung zwischen mehreren Start- und Endpunkten berechnen, GPS-Tracks von Fahrzeugen visualisieren, die auf Straßen ausgerichtet sind, und Ihre befahrbaren Gebiete besser verstehen. Dies hilft, die Betriebskosten zu senken und das Kundenerlebnis zu verbessern.

## Features
<a name="routes-features"></a>

**Planen Sie einen Routenpfad**  
Berechnen Sie Routen zwischen zwei oder mehr Orten unter Berücksichtigung verschiedener Faktoren wie Entfernung, Zeit und Straßenbeschaffenheit. Sie können sich auch alternative Routen für dieselben Standorte anzeigen lassen.

**Optimierung der Route**  
Optimieren Sie Routen nach Zeit oder Entfernung und wählen Sie die schnellste oder kürzeste Route. Sie können Wegpunkte auch sequenzieren, um das Problem des reisenden Verkäufers zu optimieren.

**Routenanalyse**  
Analysieren Sie Leistungskennzahlen wie Reisezeit, Entfernung oder Anzahl der Stopps, um sicherzustellen, dass die Route Ihren gewünschten Zielen entspricht.

**Servicebereich**  
Definiert das geografische Gebiet, das von einem bestimmten Standort aus bedient werden kann, basierend auf Entfernung oder Zeitlimits.

**Mautkosten**  
Berechnen Sie die Kosten, die mit der Mautinfrastruktur auf Ihrer Route verbunden sind.

**Vermeidungen**  
Beschränken Sie Ihre Routenberechnung, indem Sie Autobahnen, Tunnel, Fähren und Mautstraßen vermeiden.

**Geschwindigkeitsbegrenzungen**  
Finden Sie Geschwindigkeitsbegrenzungen für jeden Abschnitt einer Route heraus und stellen Sie sicher, dass die Fahrer die örtlichen Vorschriften einhalten.

![\[Eine Anwendung, die Routenfunktionen von Amazon Location Service verwendet.\]](http://docs.aws.amazon.com/de_de/location/latest/developerguide/images/routesV2/route-demo.png)


## Anwendungsfälle
<a name="routes-usecases"></a>

**Stellen Sie effiziente Routen und turn-by-turn Wegbeschreibungen bereit**  
Planen Sie Routen von einem beliebigen Startort aus (Adresse, POI oder GPS-Koordinaten) und berechnen Sie den besten Weg zu mehreren Zielen, wobei Sie Fahrzeugabmessungen und Einschränkungen berücksichtigen.  
Weitere Informationen finden Sie unter [Routen berechnen](calculate-routes.md).

**Optimieren Sie die Lieferwege**  
Verwenden Sie die Wegpunktsequenzierung, um das Problem des reisenden Verkäufers zu lösen und die optimale Route zu mehreren Zielen zu berechnen, wodurch Zeit und Entfernung minimiert werden.  
Weitere Informationen finden Sie unter [Wegpunkte optimieren](actions-optimize-waypoints.md).

**Stellen Sie sicher, dass Lieferungen aus dem nächstgelegenen Lagerhaus erfolgen**  
Verwenden Sie Matrix Routing und Waypoint Sequencing, um die schnellste Route von Ihren Lagern zu jedem Kunden zu ermitteln und so die Effizienz zu maximieren und die Kosten zu minimieren.  
Weitere Informationen erhalten Sie unter [Routen berechnen](calculate-routes.md) und [Routenmatrix berechnen](calculate-route-matrix.md).

**Verbessern Sie den Versand von Taxis und Mitfahrgelegenheiten**  
Verwenden Sie Matrix Routing, um das nächstgelegene verfügbare Fahrzeug zu identifizieren und optimale Routen auf der Grundlage des Verkehrsaufkommens in Echtzeit zu berechnen. Dadurch wird sichergestellt, dass das Fahrzeug, das dem Kunden am nächsten ist, effizient erreicht, was sowohl die Kundenzufriedenheit als auch die Unternehmensproduktivität steigert. Machen Sie mehr Fahrten, sparen Sie Kraftstoffkosten und bieten Sie ein erstklassiges Serviceerlebnis.  
Weitere Informationen finden Sie unter [Routen berechnen](calculate-routes.md), [Routenmatrix berechnen](calculate-route-matrix.md) und [Isolinien berechnen](calculate-isolines.md).

**Finden Sie Servicebereiche**  
Verwenden Sie isolierte Routen, um die geografische Reichweite Ihres Unternehmens anhand von Zeit- oder Entfernungsbeschränkungen zu ermitteln. Auf diese Weise kann das Unternehmen potenzielle Kunden identifizieren und Versandpläne erstellen. Gesundheitsdienstleister vor Ort können sicherstellen, dass sie über genügend Personal und Ressourcen verfügen, um alle Patienten innerhalb von 15 Minuten zu erreichen. Isoline hilft dabei, Servicebereiche zu optimieren, termingerechte Lieferungen sicherzustellen und neue Einrichtungen zu finden.  
Weitere Informationen finden Sie unter [Isolinien berechnen](calculate-isolines.md).

**Schnelles GPS-Tracken zu Straßen**  
Richten Sie die GPS-Tracks an Straßen aus und visualisieren Sie Fahrzeugbewegungen, um die Einhaltung von Routen und die Einhaltung gesetzlicher Vorschriften sicherzustellen. Flottenmanager können sehen, ob Fahrzeuge auf den geplanten Routen bleiben, und Abweichungen erkennen. Stellen Sie sicher, dass die Fahrer die Richtlinien befolgen, erkennen Sie Ineffizienzen und stellen Sie sicher, dass die Vorschriften eingehalten werden. Korrigiert GPS-Ungenauigkeiten und Abweichungen und bietet eine realistische Ansicht der Fahrzeugaktivität. Ermöglicht bessere Entscheidungen in Bezug auf Routenoptimierung, Fahrerverhalten und Flottenmanagement.  
Weitere Informationen finden Sie unter [Snap to Roads](snap-to-roads.md).

## APIs
<a name="routes-apis"></a>

Diese Tabelle bietet einen Überblick über die wichtigsten Funktionen von Amazon Location Service APIs für die Routenplanung und standortbasierte Datenverarbeitung. Jede API bietet einzigartige Funktionen wie die Berechnung von Routen, die Optimierung von Wegpunkten und die Erfassung von GPS-Tracks auf Straßen für eine genaue Ortung.


**APIs**  

| API-Name | Beschreibung | Lesen Sie mehr | 
| --- | --- | --- | 
| Routen berechnen | Berechnen Sie eine Reisedistanz, Reisezeit und turn-by-turn Wegbeschreibungen zwischen einem Startpunkt und mehreren Zielen unter Berücksichtigung von Fahrzeugbeschränkungen und Verkehrsdaten in Echtzeit. | [Routen berechnen](calculate-routes.md) | 
| Routenmatrix berechnen | Berechnet die Entfernung und die Zeit der Route zwischen einer Reihe von Startpunkten und einer Reihe von Zielen, wobei der Verkehr in Echtzeit berücksichtigt wird. | [Routenmatrix berechnen](calculate-route-matrix.md) | 
| Isolinien berechnen | Identifizieren Sie anhand Ihrer Reisemodi das geografische Gebiet, das innerhalb einer bestimmten Zeit oder Entfernung erreicht werden kann. | [Isolinien berechnen](calculate-isolines.md) | 
| Optimiere Wegpunkte | Finden Sie die effiziente Reihenfolge, um zu mehreren Zielen zu reisen, reduzieren Sie Reisezeit und Entfernung und berücksichtigen Sie gleichzeitig Faktoren wie Verkehr und Fahrzeugbeschränkungen. | [So optimieren Sie Wegpunkte für eine Route](optimize-waypoints.md) | 
| Snap to Roads | Ordnen Sie die GPS-Spuren dem nächstgelegenen Straßensegment zu, um die Genauigkeit der Fahrzeugortung und Routenvisualisierung zu verbessern. | [Snap to Roads](snap-to-roads.md) | 

# Konzepte für Routen
<a name="routes-concepts"></a>

Die Routenkonzepte in Amazon Location Service bieten ein robustes Framework für die Planung und Optimierung von Reisen, sei es für einfache Navigation oder komplexe Logistik. Routen umfassen verschiedene Komponenten wie Wegpunkte, Etappen, Schritte und Spannweiten, die jeweils zur Granularität und Flexibilität der Routenberechnungen beitragen. Mithilfe der Routes API können Sie Reisedistanzen berechnen, Reisezeiten schätzen und Fahrten mit mehreren Stopps optimieren. Darüber hinaus verbessern Funktionen wie Routengeometrie, Verkehrsinformationen, Geschwindigkeitsbegrenzungen, Mautkosten und flexible Polylinienkodierung die Möglichkeiten zur Visualisierung, Analyse und Betriebseffizienz. Dieser Abschnitt behandelt Terminologie, bewährte Verfahren und detaillierte Nutzungsmuster und führt Sie durch die Implementierung effektiver Routenlösungen für Navigation, Lieferung, Außendienst und mehr.

**Topics**
+ [Terminologie der Routen](routes-terminology.md)
+ [Wo (Herkunft, Ziel, Wegpunkt und Spuren)](concepts-where.md)
+ [Wann (Abfahrt und Ankunft)](concepts-when.md)
+ [Wie (Reisemodus, Vermeidung und Ausschluss)](concepts-how.md)
+ [Verkehrsbewusstsein](concepts-traffic-awareness.md)
+ [Optimieren Sie die Reihenfolge von Routen und Wegpunkten](optimize-route-waypoint.md)
+ [Fahrplan und Hinweise](driver-schedule-notices.md)

# Terminologie der Routen
<a name="routes-terminology"></a>

**Route**  
Eine Route enthält Informationen zur Fahrt von einer Startposition über Wegpunktpositionen zu einem Ziel. Sie umfasst Reisedistanz, Reisezeit, Routengeometrie, Geschwindigkeitsbegrenzungen, Spannweiten und andere Attribute.

**Routenmatrix**  
Eine Matrix, die die Reisedistanz und die Reisezeit von einer Reihe von Startpunkten zu einer Reihe von Zielen darstellt. Sie ist als Eingabe für Routenplanungs- oder Optimierungsanwendungen nützlich.

**Zwischenposition**  
Wegpunkte sind Zwischenstationen auf einer Route vom Startpunkt zum Ziel. Die Route folgt der Reihenfolge der Zwischenstopps, wie in der Anfrage angegeben.

**Bein**  
Eine Etappe steht für die Reise zwischen zwei aufeinanderfolgenden Positionen auf einer Route. Wenn sich die Positionen abseits der Straße befinden, werden sie auf die nächstgelegene Straße verschoben. Eine Route ohne Wegpunkte besteht aus einer einzigen Etappe. Routen mit einem oder mehreren Wegpunkten haben mehrere Etappen, wobei jede Etappe die Reise von einem Wegpunkt zum nächsten darstellt. Bestimmte Etappen, z. B. solche mit Fähren, enthalten spezifische Informationen, die sich auf den jeweiligen Streckentyp beziehen.

**Schritt**  
Eine Etappe ist ein Abschnitt innerhalb einer Etappe, der zusammenfassende Informationen für diesen Teil der Reise enthält. Zu den Arten von Schritten gehören:  
+ **Standardschritte** — Grundlegende Schritte mit menschenlesbaren Anweisungen, geeignet für Webanwendungen, die eine Routenübersicht anzeigen.
+ **Turn-by-Turn Schritte** — Detaillierte Schritte, die für turn-by-turn Anwendungen geeignet sind und detaillierte Anweisungen enthalten.
+ Schritte **vor Reiseantritt** — Schritte, die vor Reiseantritt abgeschlossen werden müssen. Beispiel: Einsteigen in eine Fähre.
+ **Schritte nach der Reise** — Schritte, die nach Erreichen des Reiseendes abgeschlossen werden müssen. Beispiel: Aussteigen auf einer Fähre.

**Span**  
Eine Spannweite stellt einen durchgehenden Abschnitt einer Straße dar, der eine Reihe einheitlicher Attribute aufweist. Entlang einer Route werden immer dann neue Spannweiten erstellt, wenn sich eines der angeforderten Attribute ändert.

**Segment**  
Ein Segment ist ein befahrbarer Teil einer Straße, der in der Regel als lineare Strecke dargestellt wird.

**Routengeometrie**  
Die Routengeometrie stellt den Verlauf einer Route zur Visualisierung, Analyse oder für andere Zwecke dar. Die Geometrie jedes Routenabschnitts kann als komprimierte, kodierte Polylinie oder als einfache Linienfolge dargestellt werden.

**Flexible Polylinie**  
Ein kompaktes, kodiertes Polylinienformat zur Darstellung von Geometrie. Wird zur Begrenzung der Antwortgröße empfohlen und ist für die clientseitige Dekodierung optimiert.

**Einfache Zeilenfolge**  
Ein LineString GeoJSON-Format, das Geometrie darstellt. Dieses Format erzeugt eine größere Antwortnutzlast und ist ein geordnetes Array von Koordinaten, das verwendet werden kann, um Routen auf einer Karte darzustellen.

# Wo (Herkunft, Ziel, Wegpunkt und Spuren)
<a name="concepts-where"></a>

Gibt den Ort für die Routenberechnung an, einschließlich des Anfangs- und Endpunkts der Route sowie der Zwischenstationen (oder Orte, die durchquert werden müssen).


**Gibt an, wo die Route berechnet werden soll**  

| Parameter | Beschreibung | Routen | Routenmatrix | Isolinie | Wegpunkt optimieren | Snap to Road | 
| --- | --- | --- | --- | --- | --- | --- | 
| Herkunft (en) | Startposition der Route. | Ja, mit Optionen | Ja, mit Optionen | Ja, mit Optionen | Ja, mit Optionen | Nein | 
| Zwischenposition | Zwischenpositionen, die entlang der Route berücksichtigt werden müssen. | Ja, mit Optionen | Ja, mit Optionen | Ja, mit Optionen | Ja, mit Optionen | Nein | 
| Reiseziel (e) | Endposition der Route. | Ja, mit Optionen | Ja, mit Optionen | Ja, mit Optionen | Ja, mit Optionen | Nein | 
| Punkte verfolgen | GPS-Trace, die historische Positionsinformationen enthält, die von einem Reisemodus gesendet wurden. Zu diesen Positionen gehören typische GPS-Ungenauigkeiten und Lücken, wenn das Gerät diese Informationen nicht senden oder aufzeichnen konnte. | Nein | Nein | Nein | Nein | Ja, mit Optionen | 

## Konfigurierbare Optionen
<a name="configurable-options"></a>

Bietet Optionen zum Anpassen des Routing-Verhaltens für Wegpunkte, Startpunkte und Ziele.

**Optionen für Wegpunkte**


| Parameter | Beschreibung | Routen | Routen-Matrix | Isolinie | Wegpunkt optimieren | Schnappen Sie sich die Straße | 
| --- | --- | --- | --- | --- | --- | --- | 
| AvoidActionsForDistance | Vermeidet Aktionen für die angegebene Entfernung. Wird normalerweise verwendet, um sicherzustellen, dass Fahrer genügend Zeit haben, um Entscheidungen in der Nähe von Wegpunkten zu treffen. | Ja | Nein | Nein | Nein | Nein | 
| Vermeiden UTurns | Gibt an, ob am Wegpunkt U-Turns erlaubt sind. | Ja | Nein | Nein | Nein | Nein | 
| Heading | GPS-Richtung an der Position des Wegpunkts. | Ja | Nein | Nein | Ja | Nein | 
| Übereinstimmung | Optionen zur Konfiguration der Anpassung der angegebenen Position an das Straßennetz. | Ja, mit Optionen | Nein | Nein | Nein | Nein | 
| SideOfStreet | Gibt die Straßenseite an, die der Position des Wegpunkts entspricht. | Ja, mit Optionen | Nein | Nein | Ja, mit Optionen | Nein | 
| StopDuration | Dauer für den Zwischenstopp an der Wegpunktposition. | Ja | Nein | Nein | Nein | Nein | 
| Position | Längengrad und Breitengrad für den Wegpunkt. | Ja | Nein | Nein | Ja | Nein | 
| PassThrough | Legt fest, ob der Wegpunkt als Stopp behandelt oder durchquert werden soll. | Ja | Nein | Nein | Nein | Nein | 
| Id | Identifikationszeichenfolge für den Wegpunkt. | Nein | Nein | Nein | Ja | Nein | 
| AccessHours | Gibt die Öffnungszeiten für den Besuch des Ziels an. | Nein | Nein | Nein | Ja | Nein | 
| AppointmentTime | Geplanter Termin am Wegpunkt. | Nein | Nein | Nein | Ja | Nein | 
| ServiceDuration | Servicezeit am Wegpunkt, z. B. Dauer eines Termins. | Nein | Nein | Nein | Ja | Nein | 
| Vor | Definiert, welche Wegpunkte nach diesem noch besucht werden müssen. | Nein | Nein | Nein | Ja | Nein | 

**Origin-Optionen**


| Parameter | Beschreibung | Routen | Routen-Matrix | Isolinie | Wegpunkt optimieren | Schnappen Sie sich die Straße | 
| --- | --- | --- | --- | --- | --- | --- | 
| AvoidActionsForDistance | Vermeidet Aktionen für die angegebene Entfernung. | Ja | Ja | Ja | Nein | Nein | 
| Vermeide UTurns | Gibt an, ob Kehrtwenden am Ursprung zulässig sind. | Ja | Nein | Nein | Nein | Nein | 
| Heading | GPS-Richtung an der Ausgangsposition. | Ja | Ja | Ja | Nein | Nein | 
| Übereinstimmung | Optionen zum Abgleichen der Ausgangsposition mit dem Straßennetz. | Ja, mit Optionen | Ja, mit Optionen | Ja, mit Optionen | Nein | Nein | 
| SideOfStreet | Gibt die Straßenseite an, die der Ausgangsposition entspricht. | Ja, mit Optionen | Ja, mit Optionen | Ja, mit Optionen | Nein | Nein | 
| Id | Identifikationszeichenfolge für den Ursprung. | Nein | Nein | Ja | Nein | Nein | 

**Zieloptionen**


| Parameter | Beschreibung | Routen | Routen-Matrix | Isolinie | Wegpunkt optimieren | Schnappen Sie sich die Straße | 
| --- | --- | --- | --- | --- | --- | --- | 
| AvoidActionsForDistance | Vermeidet Aktionen für die angegebene Entfernung am Zielort. | Ja | Ja | Ja | Nein | Nein | 
| Vermeiden UTurns | Gibt an, ob Kehrtwenden am Ziel erlaubt sind. | Ja | Nein | Nein | Nein | Nein | 
| Heading | GPS-Richtung an der Zielposition. | Ja | Ja | Ja | Ja | Nein | 
| Übereinstimmung | Optionen zur Anpassung der Zielposition an das Straßennetz. | Ja, mit Optionen | Ja, mit Optionen | Ja, mit Optionen | Nein | Nein | 
| SideOfStreet | Gibt die Straßenseite an, die der Zielposition entspricht. | Ja, mit Optionen | Ja, mit Optionen | Ja, mit Optionen | Ja, mit Optionen | Nein | 
| StopDuration | Dauer für den Zwischenstopp am Zielort. | Ja | Nein | Nein | Nein | Nein | 
| Id | Identifikationszeichenfolge für das Ziel. | Nein | Nein | Ja | Nein | Nein | 
| AccessHours | Gibt die Zugriffszeiten für den Besuch des Ziels an. | Nein | Nein | Ja | Nein | Nein | 
| AppointmentTime | Geplanter Termin am Zielort. | Nein | Nein | Ja | Nein | Nein | 
| ServiceDuration | Servicezeit am Zielort, z. B. Dauer eines Termins. | Nein | Nein | Ja | Nein | Nein | 

# Wann (Abfahrt und Ankunft)
<a name="concepts-when"></a>

Gibt die Zeit für die Routenberechnung an. Die Zeit bestimmt nicht nur die Zeitstempel für Abfahrt und Ankunft, sondern beeinflusst auch die zu verwendenden Verkehrsdaten.


| Parameter | Beschreibung | Routen | Routenmatrix | Isolinie | Wegpunkt optimieren | Schnappen Sie sich die Straße | 
| --- | --- | --- | --- | --- | --- | --- | 
| Zeit der Abfahrt | Uhrzeit der Abreise vom Origin. Wenn weder die Ankunfts- noch die Abfahrtszeit angegeben sind, werden keine dynamischen Verkehrsinformationen verwendet, und es werden nur Geschwindigkeiten bei freiem Verkehrsfluss angewendet, die auf dem historischen Verkehr basieren. | Ja | Ja | Ja | Ja | Nein | 
| Fahr jetzt ab | Verwendet die aktuelle Uhrzeit als Abfahrtszeit vom Origin. | Ja | Ja | Ja | Nein | Nein | 
| Zeit der Ankunft | Uhrzeit der Ankunft am Zielort. Wenn weder die Ankunfts- noch die Abfahrtszeit angegeben sind, werden keine dynamischen Verkehrsinformationen verwendet, und es werden nur Geschwindigkeiten bei freiem Verkehrsfluss angewendet, die auf dem historischen Verkehr basieren. | Ja | Nein | Ja | Nein | Nein | 

# Wie (Reisemodus, Vermeidung und Ausschluss)
<a name="concepts-how"></a>

Verwenden Sie die folgenden Optionen, um den Reisemodus und die zugehörigen Funktionen anzugeben, die für die Routenberechnung verwendet werden sollen.

**Optionen für den Reisemodus**

Gibt das Transportmittel bei der Berechnung einer Route an. Diese Einstellung beeinflusst die geschätzte Reisegeschwindigkeit, die Straßenkompatibilität und den möglichen Einsatz von Fähren, falls erforderlich.


| Parameter | Beschreibung | Routen | Routenmatrix | Isolinie | Wegpunkt optimieren | Schnappen Sie sich die Straße | 
| --- | --- | --- | --- | --- | --- | --- | 
| Car | Reisemodus mit dem Auto. | Ja, mit Optionen | Ja, mit Optionen | Ja, mit Optionen | Ja | Ja | 
| Roller | Roller-Reisemodus. | Ja, mit Optionen | Ja | Ja, mit Optionen | Ja | Ja | 
| Fußgänger | Reisemodus zu Fuß. | Ja, mit Optionen | Ja | Ja | Ja, mit Optionen | Ja | 
| Lkw | Lkw-Reisemodus. | Ja, mit Optionen | Ja, mit Optionen | Ja, mit Optionen | Ja, mit Optionen | Ja, mit Optionen | 

**Optionen zur Vermeidung, zum Ausschluss und zur Zulassung**

Legt fest, ob ein bestimmter Satz von Features bei der Routenberechnung berücksichtigt, ausgeschlossen oder vermieden werden soll.


| Parameter | Beschreibung | Routen | Routen-Matrix | Isolinie | Wegpunkt optimieren | Schnappen Sie sich die Straße | 
| --- | --- | --- | --- | --- | --- | --- | 
| Vermeidung | Funktionen, die im besten Fall vermieden werden. Wenn der Router keine gültige Route finden kann, wird die Vermeidung ignoriert, und es wird ein Hinweis angezeigt, dass die Vermeidung nicht berücksichtigt werden konnte. | Ja, mit Optionen | Ja, mit Optionen | Ja, mit Optionen | Ja, mit Optionen | Nein | 
| Ausschluss | Funktionen, die strikt ausgeschlossen sind. Wenn der Router mit den Ausschlussoptionen keine gültige Route finden kann, werden keine Routen zurückgegeben. | Ja, mit Optionen | Ja, mit Optionen | Nein | Nein | Nein | 
| Sobald Sie die Details auf dieser Seite überprüft haben, klicken Sie auf | Funktionen, die explizit aktiviert werden müssen. | Ja, mit Optionen | Ja, mit Optionen | Ja, mit Optionen | Ja, mit Optionen | Nein | 

**Liste der Vermeidungsmaßnahmen**

Führt Funktionen auf, die im besten Fall vermieden werden. Wenn der Router keine gültige Route finden kann, wird die Vermeidung ignoriert, und es wird ein Hinweis angezeigt, dass die Vermeidung nicht berücksichtigt werden konnte.


| Parameter | Beschreibung | Routen | Routen-Matrix | Isolinie | Wegpunkt optimieren | Schnappen Sie sich die Straße | 
| --- | --- | --- | --- | --- | --- | --- | 
| Bereiche | Bereiche, die mit Ausnahmen vermieden werden müssen. | Ja, mit Optionen | Ja, mit Optionen | Ja, mit Optionen | Ja, mit Optionen | Nein | 
| Autobahnen mit kontrolliertem Zugang | Hochgeschwindigkeitsstraßen mit begrenzten Zugangspunkten. | Ja | Ja | Ja | Ja | Nein | 
| Auto-Shuttle-Züge | Züge, die Fahrzeuge durch Tunnel transportieren. | Ja | Ja | Ja | Nein | Nein | 
| Schotterstraßen | Unasphaltierte Straßen mit natürlichen Oberflächen. | Ja | Ja | Ja | Ja | Nein | 
| Fähren | Boote, die Fahrzeuge über Gewässer transportieren | Ja | Ja | Ja | Nein | Nein | 
| Bootsfähren | Fähren, die Fahrzeuge auf Schienen transportieren. | Nein | Nein | Ja | Ja | Nein | 
| Schienenfähren | Fähren, die Fahrzeuge auf Schienen transportieren. | Nein | Nein | Ja | Ja | Nein | 
| Saisonale Schließung | Zu bestimmten Jahreszeiten sind die Straßen gesperrt. | Ja | Nein | Ja | Nein | Nein | 
| Tunnel | Unterirdische Gänge für den Fahrzeugverkehr. | Ja | Ja | Ja | Ja | Nein | 
| Mautstraße | Straßen, deren Zufahrt kostenpflichtig ist. | Ja | Ja | Ja | Ja | Nein | 
| Maut-Transponder | Vermeidet Straßen, auf denen Mauttransponder das einzige Zahlungsmittel sind. | Ja | Nein | Ja | Nein | Nein | 
| Kehrtwendungen | Punkte, die es Fahrzeugen ermöglichen, in umgekehrter Richtung abzubiegen. | Ja | Ja | Ja | Ja | Nein | 
| Zonen-Kategorien | Zu vermeidende Zonenkategorien | Ja | Ja | Ja | Nein | Nein | 

**Liste der Ausschlüsse**

Listet Funktionen auf, die strikt ausgeschlossen sind. Wenn der Router mit den Ausschlussoptionen keine gültige Route finden kann, werden keine Routen zurückgegeben.


| Parameter | Beschreibung | Routen | Routen-Matrix | Isolinie | Wegpunkt optimieren | Schnappen Sie sich die Straße | 
| --- | --- | --- | --- | --- | --- | --- | 
| Länder | Ländercode 2 oder Ländercode 3 für Länder, die strikt von der Routenberechnung ausgeschlossen werden sollten. | Ja | Ja | Nein | Ja | Nein | 

**Liste der erlaubten**

Listet Funktionen auf, die für die Routenberechnung explizit aktiviert werden müssen.


| Parameter | Beschreibung | Routen | Routen-Matrix | Isolinie | Wegpunkt optimieren | Schnappen Sie sich die Straße | 
| --- | --- | --- | --- | --- | --- | --- | 
| HOV | Ermöglichen Sie die Nutzung von Fahrzeugspuren mit hoher Belegung für die Routenberechnung. | Ja | Ja | Ja | Nein | Nein | 
| HEISS | Ermöglichen Sie die Verwendung von Mautstraßen mit hoher Belegung für die Routenberechnung. | Ja | Ja | Ja | Nein | Nein | 

# Verkehrsbewusstsein
<a name="concepts-traffic-awareness"></a>

Bestimmt die Art der verkehrsbezogenen Informationen, die bei der Routenberechnung verwendet werden. Bei fließendem Verkehr handelt es sich um Staus, ausgenommen langfristige unfallbedingte Staus. Die Genauigkeit der Verkehrsdaten nimmt mit der Zeit ab, wodurch historische Verkehrsdaten für vergangene Ereignisse zuverlässiger werden.


| Parameter | Beschreibung | Routen | Routenmatrix | Isolinie | Wegpunkt optimieren | Schnapp dir die Straße | 
| --- | --- | --- | --- | --- | --- | --- | 
| Verwendung | Aktivieren oder deaktivieren Sie Verkehrsdaten während der Routenberechnung. Wenn diese Option aktiviert ist `DepartureTime``ArrivalTime`, `DepartNow` werden, sofern, oder nicht angegeben, nur langfristige Schließungen berücksichtigt. Andernfalls, wenn eine Uhrzeit angegeben wird, werden alle Verkehrsdaten berücksichtigt. | Ja | Ja | Ja | Ja | Nein | 
| FlowEventThresholdOverride | Dauer in Sekunden, für die ein Verkehrsfluss-Ereignis als gültig angesehen wird. Verkehrsdaten zum Verkehrsfluss sind zwar gültig, werden aber historischen Verkehrsdaten vorgezogen. | Ja | Ja | Ja | Nein | Nein | 

# Optimieren Sie die Reihenfolge von Routen und Wegpunkten
<a name="optimize-route-waypoint"></a>

## Optimieren Sie das Routing
<a name="optimize-routing"></a>

Optimierungskriterien für die Berechnung einer Route. Dies kann entweder die schnellste Route, gemessen an der Zeit, oder die kürzeste Route, gemessen an der Entfernung, sein.


| Option | Beschreibung | Messung | 
| --- | --- | --- | 
| Schnellste Route | Berechne die schnellste Route und konzentriere dich dabei auf die Minimierung der Reisezeit. Dabei werden die Verkehrsbedingungen, Geschwindigkeitsbegrenzungen und andere Faktoren berücksichtigt. | Zeit | 
| Kürzeste Route | Berechne die kürzeste Route und minimiere die zurückgelegte Entfernung. Dies wird häufig verwendet, wenn die Entfernung der Schlüsselfaktor ist, z. B. die Reduzierung der Kraftstoffkosten oder Emissionen. | Distance | 

## Optimiere den Wegpunkt
<a name="optimize-waypoint"></a>

Optimierungskriterien für die Sequenzierung von Wegpunkten in einer Route. 

# Fahrplan und Hinweise
<a name="driver-schedule-notices"></a>

## Zeitplan für Fahrer
<a name="driver-schedule"></a>

Fahrereinstellungen zur Definition von Arbeits- und Ruhezeiten. Dies ist in vielen Ländern verpflichtend.


| Parameter | Description | Routen | Routen-Matrix | Isolinie | Wegpunkt optimieren | Snap Auf die Straße | 
| --- | --- | --- | --- | --- | --- | --- | 
| Benutzerdefinierte Ruhezyklen | Durch die Fahrdauer definierte Ruhezyklen, denen eine Ruhedauer folgt. Es kann eine beliebige Anzahl solcher Zyklen vorgesehen werden. | Ja, mit Optionen | Nein | Nein | Nein | Nein | 
| Langer Ruhezyklus und kurzer Ruhezyklus | Ruhezyklen, definiert durch kurzen Zyklus und langen Zyklus. Auf eine kurze Fahrdauer folgt eine kurze Ruhefahrdauer. Kurze Fahrten können wiederholt werden, bis eine lange Fahrdauer erreicht ist. Ab diesem Zeitpunkt wird die lange Ruhezeit erzwungen. | Nein | Nein | Nein | Ja, mit Optionen | Nein | 

## Hinweise, Warnungen und Einschränkungen
<a name="notices-warnings-constraints"></a>

Zusätzliche Informationen, die Einblick in Entscheidungen geben, die bei der Routenberechnung getroffen wurden.


| Parameter | Description | Routen | Routen-Matrix | Isolinie | Wegpunkt optimieren | Snap Auf die Straße | 
| --- | --- | --- | --- | --- | --- | --- | 
| Hinweise | Hinweise zur Routenberechnung. Kann auch Auswirkungen auf den Hinweis enthalten, der angibt, ob die Ergebnisse der Routenberechnung unverändert verwendet werden können oder vor der Verwendung manuell überprüft werden müssen. | Ja, mit Einzelheiten | Nein | Nein | Nein | Ja | 
| FailedConstraints | In der Anfrage angegebene Einschränkungen konnten nicht erfüllt werden, was zum Scheitern des Optimierungsproblems führte. | Nein | Nein | Nein | Ja, mit Einzelheiten | Nein | 

# Route APIs
<a name="choose-routes-apis"></a>

Routen bieten Funktionen zur Berechnung optimierter Pfade zwischen Standorten. Diese Funktionen unterstützen Anwendungen, die Logistikplanung, Entfernungsberechnungen und Routenoptimierung erfordern. Benutzer können zur Verbesserung der Genauigkeit auch Ortspunkte an Straßen anbringen. Weitere Informationen finden Sie unter[Amazon Location Service – Routen](routes.md).
+ **CalculateIsolines**: Generiert Isolinien auf der Grundlage von Reisezeit oder Entfernung. Dies ist nützlich für die Definition von Einzugsgebieten oder Erreichbarkeitszonen. Weitere Informationen finden Sie unter. [Isolinien berechnen](calculate-isolines.md)
+ **CalculateRouteMatrix**: Bietet eine Matrix von Entfernungen und Reisezeiten zwischen verschiedenen Start- und Zielorten und unterstützt so die Logistik und Reiseplanung. Weitere Informationen finden Sie unter[Routenmatrix berechnen](calculate-route-matrix.md).
+ **CalculateRoutes**: Berechnet optimierte Routen für die Navigation point-to-point oder die Navigation mit mehreren Stopps, einschließlich anpassbarer Routing-Einstellungen. Weitere Informationen finden Sie unter. [Routen berechnen](calculate-routes.md)
+ **OptimizeWaypoints**: Optimiert die Reihenfolge der Wegpunkte für die effizienteste Reiseroute und minimiert so Entfernung oder Zeit. Weitere Informationen finden Sie unter. [Wegpunkte optimieren](actions-optimize-waypoints.md)
+ **SnapToRoads**: Ordnet die Koordinaten an den nächstgelegenen Straßenwegen an und verbessert so die GPS-Genauigkeit, indem Punkte auf bekannten Straßen erfasst werden. Weitere Informationen finden Sie unter. [Snap to Roads](snap-to-roads.md)

Die folgende Tabelle enthält eine Reihe von Geschäftsanwendungsfällen, die sich am besten mit Routes lösen lassen APIs.


| **Geschäftlicher Bedarf** | **Nützliche API** | **Beispiele** | 
| --- | --- | --- | 
| **Berechne die Reisedistanz und die Reisedauer für einen Start- und einen Zielort**Unterstützt Folgendes: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/location/latest/developerguide/choose-routes-apis.html) | `CalculateRoutes` |  | 
| **Finden Sie die Routenpolylinie für einen Startpunkt und ein Ziel**Unterstützt Folgendes: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/location/latest/developerguide/choose-routes-apis.html) | `CalculateRoutes` |  | 
| **Finden Sie abbiegeweise Routen für einen Start- und ein Zielort**Unterstützt Folgendes: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/location/latest/developerguide/choose-routes-apis.html) | `CalculateRoutes` |  | 
| **Finden Sie eine Route, indem Sie jetzt abreisen**Unterstützt Folgendes: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/location/latest/developerguide/choose-routes-apis.html) | `CalculateRoutes` |  | 
| **Finden Sie eine Route, wenn Sie zu einer bestimmten Zeit abreisen**Unterstützt Folgendes: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/location/latest/developerguide/choose-routes-apis.html) | `CalculateRoutes` |  | 
| **Finden Sie eine Route, wenn Sie zu einer bestimmten Zeit anreisen müssen**Unterstützt Folgendes: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/location/latest/developerguide/choose-routes-apis.html) | `CalculateRoutes` |  | 
| **Finden Sie die kürzesten Strecken**Unterstützt Folgendes: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/location/latest/developerguide/choose-routes-apis.html) | `CalculateRoutes` |  | 
| **Finden Sie die schnellsten Routen**Unterstützt Folgendes: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/location/latest/developerguide/choose-routes-apis.html) | `CalculateRoutes` |  | 
| **Finden Sie alternative Routen**Unterstützt Folgendes: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/location/latest/developerguide/choose-routes-apis.html) | `CalculateRoutes` |  | 
| **Finden Sie verkehrssensitive Routen**Unterstützt Folgendes: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/location/latest/developerguide/choose-routes-apis.html) | `CalculateRoutes` |  | 
| **Finden Sie Strecken mit Umgehungsmöglichkeiten wie Mautgebühren, U-Turn, Fähre, Autobahn, Tunnel und mehr**Unterstützt Folgendes: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/location/latest/developerguide/choose-routes-apis.html) | `CalculateRoutes` |  | 
| **Finden Sie Routen mit benutzerdefinierter Vermeidung, indem Sie eine Polylinie oder ein Polygon passieren**Unterstützt Folgendes: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/location/latest/developerguide/choose-routes-apis.html) | `CalculateRoutes` |  | 
| **Mautkosten berechnen**Unterstützt Folgendes: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/location/latest/developerguide/choose-routes-apis.html) | `CalculateRoutes` | [Mautkosten berechnen](calculate-toll-cost.md) | 
| **Ermitteln Sie die Geschwindigkeitsbegrenzung für eine Straßenspanne auf einer Route**Unterstützt Folgendes: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/location/latest/developerguide/choose-routes-apis.html) | `CalculateRoutes` |  | 
| **Zeichne eine Route auf einer Karte**Unterstützt die Markierung von Wegpunkten. | `GetTile`und `GetStyleDescriptor` mit Rendering-Engine (MapLibre) mit Route berechnen  |  | 
| **Berechnet die Routenmatrix aus Entfernung und Zeit für mehrere Startpunkte und Ziele**Unterstützt Folgendes:[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/location/latest/developerguide/choose-routes-apis.html) | `CalculateRouteMatrix` | [So berechnen Sie eine Routenmatrix aus Entfernung und Zeit für mehrere Startpunkte und Ziele](calculate-route-matrix-distance.md) | 
| **Routenmatrix mit Vermeidung berechnen**Unterstützt Folgendes:[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/location/latest/developerguide/choose-routes-apis.html) | `CalculateRouteMatrix` | [So berechnen Sie die Routenmatrix mit Vermeidung](calculate-route-matrix-with-avoidance.md) | 
| **Berechnet ein Einzugsgebiet auf der Grundlage der Zeit (Isochronen)**Unterstützt Reisemodi wie Lkw, Fußgänger, Auto und Roller.  | `CalculateIsolines` | [So berechnen Sie ein Einzugsgebiet anhand von Zeiträumen](calculate-service-area-based-on-time.md) | 
| **Berechnet ein Einzugsgebiet anhand der Entfernung (Isodistance)**Unterstützt Reisemodi wie Lkw, Fußgänger, Auto und Roller.  | `CalculateIsolines` |  | 
| **Berechne ein Einzugsgebiet mit Ausweichmanövern**Unterstützt Reisemodi wie Lkw, Fußgänger, Auto und Roller.  | `CalculateIsolines` |  | 
|  **Berechnet ein Einzugsgebiet aus umgekehrter Richtung** Unterstützt Reisemodi wie Lkw, Fußgänger, Auto und Roller.  | `CalculateIsolines` |  | 
|  **Berechnet das Einzugsgebiet für verschiedene Zeit- oder Entfernungsbereiche** Unterstützt Reisemodi wie Lkw, Fußgänger, Auto und Roller.  | `CalculateIsolines` |  | 
| **Optimiere Wegpunkte für Routen (Problem mit reisenden Verkäufern)** Unterstützt Reisemodi wie Lkw, Fußgänger, Auto und Roller.  | `OptimizeWaypoint` | [So optimieren Sie Wegpunkte für eine Route](optimize-waypoints.md) | 
| **Optimiere die Wegpunkte für eine Route mit Verkehrsbewusstsein** Unterstützt Reisemodi wie Lkw, Fußgänger, Auto und Roller.  | `OptimizeWaypoint` |  | 
| **Optimieren Sie die Wegpunkte für eine Route mit Angabe der Zugriffszeiten** Unterstützt Reisemodi wie Lkw, Fußgänger, Auto und Roller. | `OptimizeWaypoint` |  | 
| **Ordnen Sie die GPS-Spuren dem Straßennetz zu**Unterstützt Reisemodi wie Lkw, Fußgänger, Auto und Roller. | Einfach auf die Straße  | [So ordnen Sie GPS-Tracks einem Straßennetz zu](how-to-match-gps-traces.md) | 
| **Visualisieren Sie übereinstimmende GPS-Spuren auf einer Karte**Unterstützt Reisemodi wie Lkw, Fußgänger, Auto und Roller. | `GetStyleDescriptor`mit Rendering-Engine (MapLibre) mit Snap to Road  |  | 

# Routen berechnen
<a name="calculate-routes"></a>

Die Routes API berechnet Routen zwischen zwei oder mehr Orten mit oder ohne Umwege für verschiedene Reisemodi wie Auto, LKW, Roller und Fußgänger. Mit dieser API können Sie die Routing-Optionen anpassen und zusätzliche Informationen zur Route anfordern, um spezifische Anforderungen zu erfüllen. Diese API unterstützt die turn-by-turn Navigation und passt Routenberechnungen an, indem Parameter wie die Vermeidung von Mautstraßen, Autobahnen oder Fähren angewendet werden. Die API gibt auch Geschwindigkeitsbegrenzungen und Mautkosten zurück.

Weitere Informationen finden Sie [CalculateRoutes](https://docs.aws.amazon.com/location/latest/APIReference/API_CalculateRoutes.html)in der *Amazon Location Service API-Referenz*.

Beispiele für Anfragen, Antworten, cURL- und CLI-Befehle für diese API finden Sie unter [So verwenden Sie Routen berechnen](https://docs.aws.amazon.com/location/latest/developerguide/calculate-routes-how-to.html).

![\[Eine Übersicht über Amazon Location Service Routes.\]](http://docs.aws.amazon.com/de_de/location/latest/developerguide/images/routesV2/P2P-Turn-by-turn-navigation.gif)


## Anwendungsfälle
<a name="use-cases"></a>
+ **Zeigen Sie geografische Details auf einer Routenkarte an:** Verwenden Sie erweiterte Kartenfunktionen, um detaillierte Routen mit umfangreichen geografischen Informationen zu visualisieren, einschließlich Sehenswürdigkeiten, Gelände und städtischer Infrastruktur. Verbessern Sie die Entscheidungsfindung, indem Sie es Benutzern ermöglichen, klare Routen von ihrem Startpunkt bis zu ihrem Ziel einzusehen. Diese Funktion kann Navigation, Planung und verschiedene Logistikszenarien unterstützen und Routen für Reisemodi wie Autos, Lastwagen, Motorroller und Fußgänger anzeigen. Passen Sie Routen an, indem Sie Elemente wie Vermeidungen oder Mautberechnungen hinzufügen.
+ ** turn-by-turnNavigation anzeigen:** Bieten Sie nahtlose Navigationsunterstützung auf Web- und Mobilgeräten. Benutzer können auf turn-by-turn Wegbeschreibungen zugreifen und so ein effizientes Reisen gewährleisten. Beide Plattformen können Navigationsanweisungen nutzen, um Routen für Privat- oder Geschäftsreisen, einschließlich Geschwindigkeitsbegrenzungen, anzubieten.
+ **Berechnung der Mautkosten entlang von Strecken:** Integrieren Sie Mautkostenberechnungen in die Routenplanung, um genaue Preisschätzungen für Strecken zu erstellen, die mautpflichtige Straßen, Brücken oder Tunnel beinhalten. Zeigen Sie die Mautkosten im Voraus an, damit Fahrer und Planer kostengünstige Entscheidungen treffen und Mautgebühren bei Bedarf vermeiden können.
+ **Stellen Sie sicher, dass Geschwindigkeitsbegrenzungen eingehalten werden:** Integrieren Sie Geschwindigkeitsbegrenzungsdaten, um Fahrern zu helfen, die gesetzlichen Grenzwerte einzuhalten, das Risiko von Bußgeldern zu verringern und sichereres und kraftstoffeffizientes Fahren zu fördern. Auch die Logistik und das Flottenmanagement können von der Überwachung der Einhaltung der Geschwindigkeitsvorgaben in Echtzeit profitieren.
+ **Unterstützung bei Lösungen zur Fracht- und Fahrzeugführung:** Vereinfachen Sie die Beförderung von Fracht und Fahrzeugen, indem Sie Routen, Navigations- und Tracking-Funktionen in Logistikportale integrieren. Planen Sie effizient Routen für mehrere Lieferungen, verfolgen Sie Sendungen in Echtzeit und kontrollieren Sie die Treibstoffkosten durch eine bessere Routenplanung.

## Verstehe die Anfrage
<a name="understanding-request"></a>

**Anmerkung**  
 Für Kunden in `ap-southeast-1` und `ap-southeast-5` können sich die Felder für unterstützte Anfrage und Antwort unterscheiden. Einzelheiten finden Sie in der [CalculateRoutes API-Referenz](https://docs.aws.amazon.com/location/latest/APIReference/API_CalculateRoutes.html). 

Die Anfrage erfordert `Destination` Parameter `Origin` und optionale Parameter wie `Allow``Avoid`, und `Traffic` passt die Route an spezifische Bedürfnisse und Einschränkungen an.

**Urspung**  
Die Startposition der Route in Längen- und Breitengrad.

**Ziel**  
Die Endposition der Route.

**Wegpunkte**  
Zwischenpositionen, die entlang einer Route zwischen Start- und Endposition aufgenommen werden sollen.

**OptimizeRoutingFor**  
Optimierungskriterien für die Route, z. B. die schnellste oder die kürzeste Route.

**LegGeometryFormat**  
Format der Geometrie, die für jeden Routenabschnitt zurückgegeben wurde.

**Vermeiden**  
Merkmale, die bei der Routenberechnung vermieden werden sollen, werden ignoriert, wenn keine alternative Route gefunden wird.

**Verkehr**  
Verkehrsbezogene Optionen, die sich auf die Routenberechnung auswirken.

**Mautgebühren**  
Mautbezogene Optionen, die sich auf Routenberechnungen und Mautkosten auswirken.

**LegAdditionalFeatures**  
Funktionen, die in der Antwort für jede Etappe der Reise aktiviert werden können.

**SpanAdditionalFeatures**  
Umfassende Funktionen, die in der Antwort für jede Etappe der Reise aktiviert werden können.

## Verstehen Sie die Antwort
<a name="understanding-response"></a>

Die Antwort enthält Routendetails wie die Etappen der Reise, Hinweise zu Routenberechnungen und zusammenfassende Informationen, einschließlich Entfernung und Dauer.

**Routen**  
Eine Reihe von Routen, die Abschnitte und zugehörige Eigenschaften enthalten.

**Hinweise**  
Warnungen oder Informationsmeldungen zur Route.

**LegGeometryFormat**  
Gibt das Format der Routengeometrie an.

### Angaben zu den Beinen
<a name="leg-details"></a>

Jede Etappe einer Reise kann je nach Transportart vom Typ Fähre, Fußgänger oder Fahrzeug sein. Jede Etappe enthält Eigenschaften, die unabhängig vom jeweiligen Transportmittel sind, spezifische Eigenschaften finden Sie jedoch unter:

**FerryLegDetails**  
Fährenspezifische Eigenschaften für das Bein.

**VehicleLegDetails**  
Fahrzeugspezifische Eigenschaften für das Bein.

**PedestrianLegDetails**  
Fußgängerspezifische Eigenschaften für das Bein.

### Schritte
<a name="steps"></a>

Jede Etappe einer Reise ist in Schritte unterteilt, die Aktionen für Teile der Route beschreiben. Bei einem Schritt kann es sich entweder um einen Standardschritt handeln, der für grundlegende Anwendungen geeignet ist TurnByTurn, oder um einen für die turn-by-turn Navigation geeigneten Schritt. Jeder Schritt enthält Eigenschaften, die unabhängig vom Schritttyp sind, wie Dauer und Entfernung, und andere spezifische Eigenschaften ExitStepDetails, die nur für Ausgangsschritte gelten.

**BeforeTravelSteps**  
Schritte, die vor Reiseantritt ausgeführt werden müssen.

**TravelSteps**  
Schritte, die während der Reise durchgeführt werden müssen.

**AfterTravelSteps**  
Schritte, die nach Abschluss der Reise durchzuführen sind.

### Spans
<a name="spans"></a>

Jede Etappe einer Reise kann in Abschnitte aufgeteilt werden. Eine Spanne ist ein Teil der Etappe mit den gleichen Werten für die angeforderte `SpanAdditionalFeatures` Menge. Spannweiten werden nach Straßeneigenschaften wie `SpeedLimit` Straßennamen oder Regionen unterteilt. Die zurückgegebenen Spannweiten können zur Visualisierung von Straßenattributen und zufahrtsbezogenen Informationen verwendet werden.

# Mautkosten berechnen
<a name="calculate-toll-cost"></a>

Dieses Thema bietet einen Überblick über die Felder und Definitionen im Zusammenhang mit der Berechnung der Mautkosten. Mithilfe dieser Felder können Sie Parameter wie Zahlungsmethoden, Währung und Fahrzeugmerkmale angeben, um die Berechnung der Mautkosten individuell anzupassen.


| Feldname | Routen | 
| --- | --- | 
| Transponder | Ja, mit Optionen | 
| Vignetten | Ja, mit Optionen | 
| Währung | Ja, mit Optionen | 
| EmissionType | Ja, mit Optionen | 
| VehicleCategory | Ja, mit Optionen | 

## Definitionen
<a name="definitions"></a>

Dieser Abschnitt enthält kurze Definitionen für jedes Feld, das bei der Berechnung der Mautkosten verwendet wird.

****Transponder****  
Transponder sind eine Zahlungsmethode für Mautgebühren, was möglicherweise zu einem anderen Preis als bei anderen Zahlungsmethoden führt.

****Vignetten****  
Eine Vignette ist eine Form der Straßenbenutzungsgebühr. Wenn ein Benutzer über die erforderliche Vignette verfügt, sind keine zusätzlichen Mautgebühren erforderlich.

****Währung****  
Die Währung, in der die Mautkosten gemeldet werden. Zusätzlich zur Landeswährung ist eine umgerechnete Währung enthalten, was sich auch auf die Währung auswirkt, die in der Mautübersicht in der Antwort verwendet wird.

****EmissionType****  
Der Emissionstyp des Fahrzeugs, der für die Berechnung der Mautkosten auf der Grundlage der Fahrzeugemissionen verwendet wird.

****VehicleCategory****  
Die für die Berechnung der Mautkosten verwendete Fahrzeugunterkategorie.

# Routenschritte verstehen
<a name="understanding-route-steps"></a>

In diesem Abschnitt werden verschiedene Aktionen und Schritte beschrieben, die ergriffen werden müssen, um eine Etappe einer Reise abzuschließen. Die Routenschritte variieren je nach Reisemodus und bieten Anleitungen sowohl für Übersichtsanwendungen als auch für die detaillierte turn-by-turn Navigation.

## Übersicht der Routenschritte
<a name="route-steps-overview"></a>

Die folgenden Arten von Routenschritten definieren die Aktionen, die erforderlich sind, um einen Streckenabschnitt abzuschließen, und variieren je nach Reisemodus und Etappe der Reise.


| **Step type (Schritttyp)** | **Beschreibung** | 
| --- | --- | 
| Default steps | Grundlegende Schritte mit menschenlesbaren Anweisungen, die häufig in webbasierten Anwendungen verwendet werden, um einen Überblick über die Route zu bieten. | 
| Turn by turn steps | Detaillierte Schritte zur Erstellung einer turn-by-turn Navigationsanwendung, die detailliertere Anweisungen bietet. | 
| Before travel steps | Schritte, die vor Beginn des Reiseabschnitts abgeschlossen werden müssen, z. B. das Einsteigen in eine Fähre. | 
| After travel steps | Schritte, die nach Abschluss des Reiseabschnitts ausgeführt werden müssen, z. B. das Aussteigen aus einer Fähre. | 

## Aufschlüsselung der Schritte nach Reisemodus
<a name="route-step-types"></a>


| **Abschnitt** | **Schritt** | **Vor der Reise** | **Reisen** | **Nach der Reise** | 
| --- | --- | --- | --- | --- | 
| Fahrzeug | Ankommen | Nein | Ja | Nein | 
| Fahrzeug | Continue | Nein | Ja | Nein | 
| Fahrzeug | ContinueHighway | Nein | Ja | Nein | 
| Fahrzeug | Abfahrt | Nein | Ja | Nein | 
| Fahrzeug | Exit | Nein | Ja | Nein | 
| Fußgänger | Ankommen | Nein | Ja | Nein | 
| Fußgänger | Gebühr | Nein | Ja | Nein | 
| Fähre | Wait | Nein | Nein | Ja | 
| Fähre | Vorstand | Ja | Nein | Nein | 
| Fähre | Aussteigen | Nein | Nein | Ja | 

# Routenmatrix berechnen
<a name="calculate-route-matrix"></a>

Der Matrix-Routing-Service berechnet Routing-Matrizen und gibt Reisezeiten oder Entfernungen zwischen mehreren Start- und Zielorten an. Dieser Service bietet flexible Anpassungsoptionen, mit denen Sie Reisemodi, Verkehrsbedingungen und andere Routing-Parameter angeben können. Die Matrixberechnungen können in Größe und Form variieren. Sie unterstützen sowohl quadratische als auch nicht-quadratische Matrizen und berücksichtigen dynamische Verkehrsdaten oder Verkehrsdaten mit freiem Datenfluss.

Weitere Informationen finden Sie [CalculateRouteMatrix](https://docs.aws.amazon.com/location/latest/APIReference/API_CalculateRouteMatrix.html)in der *Amazon Location Service API-Referenz*.

Beispiele für Anfragen, Antworten, cURL- und CLI-Befehle für diese API finden Sie unter [So verwenden Sie die Routenmatrix berechnen](https://docs.aws.amazon.com/location/latest/developerguide/calculate-route-matrix-how-to.html).

## Anwendungsfälle
<a name="route-matrix-use-cases"></a>
+ **Optimieren Sie Lieferrouten für Logistik und E-Commerce:** Berechnen Sie effizient die Reisezeit und die Entfernung zwischen mehreren Abhol- und Lieferorten, um die Routen zu optimieren. Logistikunternehmen können diese Funktion nutzen, um Kosten und Lieferzeiten zu minimieren, indem sie effiziente Wege zwischen Städten planen. Es ist ideal, um optimierte Lieferfenster für Lieferungen am selben oder am nächsten Tag festzulegen und Lieferrouten mit mehreren Stopps zu planen.
+ **Fahrer und Passagiere in Mitfahrgelegenheiten abgleichen:** Verwenden Sie Routenberechnungen, um Fahrer den nächstgelegenen Passagieren zuzuordnen, indem Sie die schnellste Route zwischen Standorten ermitteln. Mitfahr-Apps können das Nutzererlebnis verbessern, indem sie Schätzungen der Ankunft von Fahrern in Echtzeit bereitstellen und so eine schnelle Abholung und Rückgabe gewährleisten. Unterstützt verschiedene Transportarten wie Autos, Fahrräder und Motorroller.
+ **Planen und optimieren Sie Routen für das Flottenmanagement:** Verwalten Sie große Flotten, indem Sie Routen optimieren, um den Kraftstoffverbrauch und die Reisezeit zu reduzieren. Flottenmanager können Fahrzeugen für mehrere Stopps die effizientesten Routen zuweisen und so die allgemeine Betriebseffizienz erhöhen. Zu den Anwendungsfällen gehören Serviceflotten, Transportunternehmen und Versorgungsunternehmen, bei denen eine optimale Routenplanung für Besuche vor Ort unerlässlich ist.

## Verstehen Sie die Anfrage
<a name="route-matrix-request"></a>

**Anmerkung**  
 Für Kunden in `ap-southeast-1` und `ap-southeast-5` können sich die Felder für unterstützte Anfrage und Antwort unterscheiden. Einzelheiten finden Sie in der [CalculateRouteMatrix API-Referenz](https://docs.aws.amazon.com/location/latest/APIReference/API_CalculateRouteMatrix.html). 

Die Anfrage umfasst **Startpunkte** und **Ziele** für Routenberechnungen sowie optionale Parameter, um die Matrix auf der Grundlage von Präferenzen und Einschränkungen anzupassen. Weitere Informationen finden Sie in der API-Referenz für die Calculate Route Matrix API.
+ `Origins`: Liste der Ursprungskoordinaten in Längen- und Breitengrad.
+ `Destinations`: Liste der Zielkoordinaten.
+ `OptimizeRoutingFor`: Optimierungskriterien wie „Schnellste“ oder „Kürzeste“ Route.
+ `RoutingBoundary`: Definiert Grenzen für die Berechnung, entweder als „unbegrenzt“ oder auf eine bestimmte Geometrie beschränkt.
+ `Avoid`: Merkmale, die bei der Routenberechnung vermieden werden sollten. Wird ignoriert, wenn keine brauchbare Route gefunden werden kann.
+ `Traffic`: Verkehrsbezogene Optionen, die sich auf Routenberechnungen auswirken.

## Verstehen Sie die Reaktion
<a name="route-matrix-response"></a>

Die Antwort umfasst eine Matrix berechneter Routen zwischen Start- und Zielorten mit Details wie Entfernung und Dauer. Falls zutreffend, werden auch Fehler und Grenzen für die Routen angegeben. Weitere Informationen zur Calculate Route Matrix API finden Sie in der API-Referenz.
+ `RouteMatrix`: Matrix mit Reisedistanzen (in Metern) und Reisedauern (in Sekunden) zwischen Start- und Zielorten.
+ `ErrorCount`: Anzahl der Fehler, die bei der Routenberechnung aufgetreten sind.
+ `RoutingBoundary`: Grenze, innerhalb derer die Matrix berechnet wird.

# Isolinien berechnen
<a name="calculate-isolines"></a>

Mit der Calculate Isolines API können Sie Bereiche bestimmen, die innerhalb bestimmter Zeit- oder Entfernungsgrenzen erreichbar sind. Unter Berücksichtigung von Faktoren wie Straßenbeschränkungen, Verkehrsbedingungen und Reisemodus werden Isolinien generiert, die zugängliche Bereiche umreißen und so Anwendungen in den Bereichen Stadtplanung, Logistik und Barrierefreiheit unterstützen. Diese API kann für Stadtplanung, Immobilienanalysen und Studien zur Barrierefreiheit verwendet werden, indem die Reichweite von Diensten, Transportmöglichkeiten oder Ressourcen innerhalb eines festgelegten Zeitrahmens oder einer bestimmten Entfernungsgrenze visualisiert werden. Durch die Anzeige dieser Isolinien auf einer Karte können Benutzer die Reisereichweite innerhalb bestimmter Einschränkungen einschätzen und so die Entscheidungsfindung bei der Standortwahl, der Serviceabdeckung und der Ressourcenzuweisung verbessern.

Weitere Informationen finden Sie [CalculateIsolines](https://docs.aws.amazon.com/location/latest/APIReference/API_CalculateIsolines.html)in der *Amazon Location Service API-Referenz*.

Beispiele für Anfragen, Antworten, cURL- und CLI-Befehle für diese API finden Sie unter [So verwenden Sie Isolinien berechnen](https://docs.aws.amazon.com/location/latest/developerguide/calculate-isolines-how-to.html).

## Anwendungsfälle
<a name="use-cases"></a>
+ **Beurteilen Sie die Erreichbarkeit des Gesundheitswesens anhand von Isolinien zur Reisezeit:** Generieren Sie Isolinien, um den Zugang zu Gesundheitseinrichtungen aus verschiedenen Stadtteilen anhand der Reisezeiten zu bewerten. Gesundheitsorganisationen können diese Funktion nutzen, um unterversorgte Bereiche zu identifizieren und fundierte Entscheidungen über Klinikstandorte oder mobile Gesundheitsdienste zu treffen und so den Zugang zur Gesundheitsversorgung vor Ort zu verbessern.
+ **Analysieren Sie die Marktreichweite für die Expansion des Einzelhandels mithilfe von Isolinien zur Reisezeit:** Erstellen Sie Isolinien, um den Kundenzugang zu Einzelhandelsstandorten auf der Grundlage der Reisezeiten darzustellen. Einzelhandelsunternehmen können neue Ladenstandorte einschätzen und die Kundendemografie verstehen. Mithilfe dieser Visualisierungen können sie ihr Umsatzpotenzial strategisch erweitern und optimieren.
+ **Optimieren Sie Logistik und Lieferzonen mit Isolinien: Generieren Sie Isolinien**, um Lieferzonen auf der Grundlage zeitkritischer Logistikanforderungen zu definieren. Logistikunternehmen können Bereiche visualisieren, die innerhalb bestimmter Zeiträume von Distributionszentren aus erreichbar sind, was die Routenplanung, die betriebliche Effizienz und die termingerechte Lieferung verbessert.
+ **Planen Sie den Zugang zu Tourismus und Freizeitaktivitäten mit Isolinien:** Visualisieren Sie die Reisezeiten von Touristenattraktionen zu nahe gelegenen Unterkünften. Tourismusverbände können Reisenden dabei helfen, günstige Übernachtungsmöglichkeiten zu finden, lokale Unternehmen fördern und das Reiseerlebnis verbessern, indem sie diese Isolinien auf einer Karte anzeigen.
+ **Verbessern Sie die Notfallplanung durch Isolinien:** Generieren Sie Isolinien, um die Reaktionszeiten von Notdienststellen bis zu verschiedenen Bereichen in einer Gemeinde einzuschätzen. Notfallmanagementteams können Regionen mit kritischen Reaktionszeiten identifizieren und so die Ressourcenzuweisung optimieren, um die Reaktion bei Vorfällen zu verbessern.
+ **Analysieren Sie Pendelmuster für die Personalplanung mit Isolinien:** Generieren Sie Isolinien, um Pendelzeiten zu visualisieren und Bereiche mit hohen Reisezeiten zu identifizieren. Unternehmen können diese Erkenntnisse für Richtlinien zur Telearbeit oder für Büroumzüge nutzen und so die Mitarbeiterzufriedenheit und Produktivität steigern.

## Verstehen Sie die Anfrage
<a name="understanding-request"></a>

Die Anfrage akzeptiert Parameter wie `Origin``Destination`, und `Thresholds` für die Definition von Isolinien. Optionale Parameter wie `Allow` `Avoid``TravelModeOptions`, und ermöglichen die Anpassung von Isolinienbeschränkungen. Weitere Informationen hierzu finden Sie unter .

**Urspung**  
Der Ausgangspunkt für die Berechnung der Isolinien in Längen- und Breitengrad.

**Schwellenwerte**  
Zeit- oder Entfernungsgrenzen, die zur Definition der Isoliniengrenze verwendet wurden.

**TravelMode**  
Das Transportmittel, z. B. Auto, Fußgänger oder Lkw.

**OptimizeIsolineFor**  
Optimierungskriterien, wie z. B. Genaue, Ausgewogene oder Schnelle Berechnung.

**DepartureTime**  
Abfahrtszeit, falls angegeben, für die Berechnung zeitabhängiger Isolinien.

**ArrivalTime**  
Ankunftszeit, falls angegeben, für die Berechnung zeitabhängiger Isolinien.

**IsolineGranularity**  
Die maximale Anzahl von Punkten und die Auflösung der Isoliniengrenze.

## Verstehe die Antwort
<a name="understanding-response"></a>

Die Antwort enthält Isolinien mit Eigenschaften wie`IsolineGeometryFormat`, die den erreichbaren Bereich anhand von Anforderungsparametern umreißen.

**Isolinien**  
Berechnete Isolinien mit zugehörigen Eigenschaften, einschließlich Geometrien und Verbindungen.

**Geometrien**  
Liste der Geometrien, die die berechneten Isoliniengrenzen umreißen.

**Verbindungen**  
Verbindungen zwischen Isoliniengeometrien, einschließlich der Geometrie für jede Verbindung.

# Wegpunkte optimieren
<a name="actions-optimize-waypoints"></a>

Die Optimize Waypoints API berechnet die effizienteste Reihenfolge für den Besuch mehrerer Wegpunkte entlang einer Route. Mithilfe fortschrittlicher Algorithmen minimiert diese API Reisezeit und Entfernung und berücksichtigt dabei Faktoren wie Verkehrsbedingungen, Vermeidungen und Fahrzeugspezifikationen. Die Integration der Optimize Waypoints API hilft Unternehmen dabei, Abläufe zu rationalisieren, den Kraftstoffverbrauch zu senken, die Liefereffizienz zu verbessern und die Kundenzufriedenheit zu verbessern. Die API bietet optimierte Routen und ermöglicht so eine bessere Entscheidungsfindung und Ressourcenzuweisung in Reiseszenarien mit mehreren Stopps.

Weitere Informationen finden Sie [OptimizeWaypoints](https://docs.aws.amazon.com/location/latest/APIReference/API_OptimizeWaypoints.html)in der *Amazon Location Service API-Referenz*.

Beispiele für Anfragen, Antworten, cURL- und CLI-Befehle für diese API finden Sie unter [So verwenden Sie Optimize Waypoints](https://docs.aws.amazon.com/location/latest/developerguide/optimize-waypoints-how-to.html).

## Anwendungsfälle
<a name="use-cases"></a>
+ **Verbessern Sie die Effizienz der Lieferung mit mehreren Stopps:** Optimieren Sie effizient die Reihenfolge mehrerer Lieferstopps, um Reisezeit und -kosten zu reduzieren. Lieferservices können Abläufe rationalisieren, indem sie die effizienteste Route für Fahrer berechnen, die Treibstoffkosten minimieren und pünktliche Lieferungen sicherstellen, was die Kundenzufriedenheit und die betriebliche Effizienz verbessert.
+ **Optimieren Sie den Außendienstbetrieb:** Optimieren Sie die Reihenfolge der Besuche mehrerer Baustellen an einem einzigen Tag und reduzieren Sie so die Reisezeit für Außendiensttechniker. Dies ermöglicht es Unternehmen, täglich mehr Aufträge zu erledigen und so die Produktivität und Servicebereitstellung zu verbessern.
+ **Planen Sie effiziente Reiserouten für Reisebüros:** Optimieren Sie Reiserouten, die mehrere Attraktionen beinhalten, um die Sehenswürdigkeiten zu maximieren und gleichzeitig die Reisezeit zu minimieren. Reisebüros können diese Funktion nutzen, um optimale Pläne für geführte Touren zu erstellen und so das gesamte touristische Erlebnis zu verbessern, indem die verfügbare Zeit besser genutzt wird.
+ **Verbessern Sie die Effizienz von Mitfahrern:** Optimieren Sie die Abhol- und Bringsequenzen für mehrere Passagiere, reduzieren Sie die Wartezeiten und verbessern Sie das Fahrerlebnis. Mitfahrdienste können die Einnahmen der Fahrer maximieren und durch die Optimierung der Wegpunkte einen pünktlichen Service für Fahrgäste sicherstellen.
+ **Optimieren Sie die Routen für die Müllabfuhr:** Planen Sie Müllabfuhrrouten, um die Entfernung und die Zeit zu minimieren. Dies hilft Abfallentsorgungsunternehmen dabei, ihre Abläufe zu rationalisieren und eine rechtzeitige Abholung sicherzustellen, wodurch Kosteneinsparungen erzielt und die Umweltbelastung reduziert wird.
+ **Koordinieren Sie die Logistik für Veranstaltungen und Konferenzen:** Managen Sie die Transportlogistik für die Lieferung von Ausrüstung und Material an mehrere Veranstaltungsorte und optimieren Sie die Lade- und Entladerouten. Auf diese Weise können Veranstaltungsplaner den Transport optimieren, Verzögerungen reduzieren und die rechtzeitige Ankunft von Material für Veranstaltungen sicherstellen.
+ **Verbessern Sie die Notfallwege:** Planen Sie die schnellsten Wege für mehrere Notfälle und optimieren Sie so die Reaktionszeiten in kritischen Situationen. Notfalldienste können die Reaktionseffizienz verbessern und möglicherweise Leben retten, indem sie optimierte Wegpunkte verwenden.
+ **Erleichtern Sie Außendienstmitarbeitern die Planung von Vertriebswegen:** Optimieren Sie die Routen für Vertriebsmitarbeiter, die an einem Tag mehrere Kunden besuchen, und minimieren Sie so die Reisezeit und maximieren Sie die Anzahl der Kundenbesuche. Dies hilft Unternehmen, ihre Produktivität zu steigern und mehr Verkaufschancen zu nutzen.

## Verstehe die Anfrage
<a name="understanding-request"></a>

Die Anfrage benötigt Parameter wie `Origin` und`Waypoints`, um eine optimierte Sequenz zu berechnen. Optionale Parameter wie `Avoid``Traffic`, und `Driver` ermöglichen zusätzliche Anpassungen.

**Wegpunkte**  
Eine Liste von Wegpunkten, die nacheinander optimiert werden sollen.

**Urspung**  
Die Startposition der Route für die Optimierung.

**Zieladresse**  
Eine optionale Endposition der Route für die Optimierung.

**OptimizeSequencingFor**  
Kriterien für die Sequenzoptimierung, z. B. die schnellste oder kürzeste Route.

**Verkehr**  
Verkehrsbezogene Optionen, die sich auf die Routenberechnung auswirken.

**Treiber**  
Arbeits- und Ruhezyklen der Fahrer, um die Einhaltung der regionalen Fahrvorschriften sicherzustellen.

**Clusterbildung**  
Mithilfe von Clustering können Sie angeben, wie Wegpunkte in der Nähe gruppiert werden können, um die optimierte Reihenfolge zu verbessern.

Für jeden Wegpunkt können auch Einschränkungen festgelegt werden, die erfüllt sein müssen, wie z. B., `AppointmentTime``AccessHours`, und Reihenfolgebeschränkungen wie bei einem anderen Wegpunkt. `Before`

## Verstehe die Antwort
<a name="understanding-response"></a>

Die Antwort enthält Einzelheiten zur optimierten Wegpunktsequenz, einschließlich der gesamten Wegpunktsequenz `OptimizedWaypoints` `Distance` und `Duration` der gesamten Route. 

**OptimizedWaypoints**  
Eine Liste der Wegpunkte in ihrer optimierten Reihenfolge.

**ImpedingWaypoints**  
Wegpunkte, die eine optimierte Sequenz verhindern, einschließlich fehlgeschlagener Einschränkungen, die nicht erfüllt wurden.

**Verbindungen**  
Details zu Reisen zwischen Wegpunkten, einschließlich Entfernung und Dauer.

**TimeBreakdown**  
Aufschlüsselung der Gesamtdauer `Travel` `Rest``Service`, und der `Wait` Dauer der Route.

**ClusterIndex**  
Index des Clusters, dem der Wegpunkt zugeordnet ist. Der Index ist nur dann in der Antwort enthalten, wenn während der Bearbeitung der Anfrage ein Clustering durchgeführt wurde.

# Snap to Roads
<a name="snap-to-roads"></a>

Die Snap to Road API verbessert die Genauigkeit der geografischen Positionierung, indem sie die GPS-Koordinaten an den nächstgelegenen Straßensegmenten auf einer digitalen Karte ausrichtet. Diese API verwendet Rohdaten zu Längen- und Breitengrad, die häufig von Mobilgeräten oder Fahrzeugen gesammelt wurden, und ordnet diese Punkte dem entsprechenden Straßennetz zu, um Ungenauigkeiten zu korrigieren, die durch GPS-Drift oder Signalverlust verursacht werden. Durch die Integration der Snap to Road API können Sie sicherstellen, dass Ihre Anwendungen zuverlässige und genaue Daten liefern, was zu einer besseren Entscheidungsfindung und einer besseren Betriebseffizienz in verschiedenen Szenarien beiträgt.

Weitere Informationen finden Sie [SnapToRoads](https://docs.aws.amazon.com/location/latest/APIReference/API_SnapToRoads.html)in der *Amazon Location Service API-Referenz*.

Beispiele für Anfragen, Antworten, cURL- und CLI-Befehle für diese API finden Sie unter [So verwenden Sie Snap to Roads](https://docs.aws.amazon.com/location/latest/developerguide/snap-to-roads-how-to.html).

## Anwendungsfälle
<a name="use-cases"></a>
+ **Verbessern Sie die Navigationsgenauigkeit, indem Sie sich am Straßennetz orientieren: Richten Sie die** GPS-Koordinaten effizient an den nächstgelegenen Straßensegmenten aus, um die Navigationsgenauigkeit zu verbessern. Diese Funktion ist nützlich für Karten- und Navigationsdienste, da sie Benutzern präzise Wegbeschreibungen und Standortaktualisierungen in Echtzeit bietet und so das Navigationserlebnis verbessert.
+ **Verbessern Sie die Datengenauigkeit für Flottenmanagement-Anwendungen:** Korrigieren Sie die gemeldeten Positionen von Fahrzeugen, indem Sie deren GPS-Koordinaten den nächstgelegenen Straßen zuordnen. In Flottenmanagementsystemen sorgt diese Funktion für eine genaue Fahrzeugortung und ermöglicht so eine optimierte Logistik und eine bessere Betriebseffizienz.

## Verstehe die Anfrage
<a name="understanding-request"></a>

Die Anfrage `TracePoints` muss mit Straßen übereinstimmen und optionale Parameter wie `SnappedGeometryFormat` und `SnapRadius` zur Steuerung des Geometrieformats und des Fangradius enthalten.

**TracePoints**  
Eine Liste von Koordinaten, die in das Straßennetz aufgenommen werden sollen.

**SnappedGeometryFormat**  
Das Format der zurückgegebenen Geometrie, z. B. "FlexiblePolyline" oder „Einfach“.

**SnapRadius**  
Der Radius um die Spurpunkte herum, innerhalb dessen Straßenübergänge berücksichtigt werden.

## Verstehen Sie die Reaktion
<a name="understanding-response"></a>

Die Antwortvariable enthält eine korrigierte Geometrie und gerastete Spurpunkte mit Eigenschaften wie `SnappedGeometry` und, `SnappedTracePoints` die auf Genauigkeit und Zuverlässigkeit beim Einrasten hinweisen.

**SnappedGeometry**  
Die korrigierte Geometrie der eingefahrenen Route.

**SnappedTracePoints**  
Die angepassten Koordinaten der Spurpunkte wurden an Straßen angepasst.

**Hinweise**  
Warnungen oder Informationsmeldungen zum Fangvorgang.

# Vorgehensweise
<a name="routes-how-to"></a>

Dieser Abschnitt enthält Anleitungen zur Nutzung der Routen APIs zur Lösung von Routing- und Navigationsproblemen. Diese Tutorials behandeln die wichtigsten Aufgaben zur Integration von Routing-Funktionen in Ihre Anwendungen. Jedes Thema konzentriert sich auf einen bestimmten Anwendungsfall, sodass Sie erweiterte Routing-Funktionen, die auf Ihre Geschäftsanforderungen zugeschnitten sind, effizient implementieren können.

**Topics**
+ [Lernen Sie, wie man es benutzt CalculateRoutes](calculate-routes-how-to.md)
+ [Lernen Sie, wie man es benutzt CalculateIsolines](calculate-isolines-how-to.md)
+ [Lernen Sie, wie man es benutzt CalculateRouteMatrix](calculate-route-matrix-how-to.md)
+ [Lernen Sie, wie man es benutzt OptimizeWaypoints](optimize-waypoints-how-to.md)
+ [Lernen Sie, wie man es benutzt SnapToRoads](snap-to-roads-how-to.md)

# Lernen Sie, wie man es benutzt CalculateRoutes
<a name="calculate-routes-how-to"></a>

Dieser Abschnitt enthält step-by-step Anweisungen zur Verwendung`CalculateRoutes`. In diesem Thema finden Sie Anleitungen zur Suche nach Routen mit bestimmten Konfigurationen, wie z. B. der Integration von turn-by-turn Navigation, der Einstellung von Reisemodi und dem Hinzufügen von Wegpunkten.

**Topics**
+ [So finden Sie eine Route für einen Start- und Zielort](calculate-routes-origin-destination-waypoints.md)
+ [So finden Sie Routen mit turn-by-turn Wegbeschreibungen](how-to-find-turn-by-turn-route.md)
+ [So finden Sie eine Geschwindigkeitsbegrenzung für eine Straßenspanne](calculate-routes-speed-limit-road.md)
+ [Wie finde ich alternative Routen](calculate-routes-alternate.md)
+ [Wie berechnet man die Mautgebühren für eine Route](calculate-routes-tolls.md)
+ [Wie erstellt man Routen mit benutzerdefinierter Vermeidung](calculate-routes-custom-avoidance-poly.md)
+ [So erstellen Sie Routen mit benutzerdefinierter Vermeidung mehrerer potenzieller Elemente](calculate-routes-custom-avoidance-multiple.md)
+ [So finden Sie die schnellste Route](calculate-routes-custom-avoidance-fast.md)
+ [So finden Sie die kürzesten Routen](calculate-routes-custom-avoidance-shortest.md)

# So finden Sie eine Route für einen Start- und Zielort
<a name="calculate-routes-origin-destination-waypoints"></a>

Die CalculateRoutes API hilft Ihnen dabei, die besten Strecken zwischen Abflug- und Zielort sowie die besten Ruhezeiten für Fahrer zu finden. Es unterstützt Reisemodi wie Lkw, Fußgänger, Auto und Roller. Es unterstützt auch bis zu 25 Wegpunkte (Zwischenstopps), einschließlich Start- und Zielort, mit nur wenigen Einschränkungen.

## Mögliche Anwendungsfälle
<a name="potential-use-cases"></a>
+ ** point-to-pointRouten finden:** Ermitteln Sie anhand verschiedener Reisemodi und zusätzlicher Optionen die beste Route zwischen zwei Orten.

## Beispiele
<a name="calculate-routes-examples"></a>

### Berechne Routen vom Ausgangspunkt bis zum Ziel mit Car TravelMode
<a name="calculate-routes-car-mode"></a>

------
#### [ Sample request ]

```
{
    "Origin": [
        -123.118105,
        49.282423
    ],
    "Destination": [
        -123.020098,
        49.232872
    ]
}
```

------
#### [ Sample response ]

```
{
    "LegGeometryFormat": "FlexiblePolyline",
    "Notices": [],
    "Routes": [
        {
            "Legs": [
                {
                    "Geometry": {
                        "Polyline": "Redacted"
                    },
                    "TravelMode": "Car",
                    "Type": "Vehicle",
                    "VehicleLegDetails": {
                        "AfterTravelSteps": [],
                        "Arrival": {
                            "Place": {
                                "ChargingStation": false,
                                "OriginalPosition": [
                                    -123.020098,
                                    49.232872
                                ],
                                "Position": [
                                    -123.0203051,
                                    49.2328499
                                ]
                            }
                        },
                        "Departure": {
                            "Place": {
                                "ChargingStation": false,
                                "OriginalPosition": [
                                    -123.1181051,
                                    49.282423
                                ],
                                "Position": [
                                    -123.1180883,
                                    49.2824349
                                ]
                            }
                        },
                        "TravelSteps": [
                            {
                                "Distance": 1288,
                                "Duration": 102,
                                "Type": "Depart"
                            },
                            {
                                "Distance": 262,
                                "Duration": 24,
                                "Type": "Ramp"
                            },
                            {
                                "Distance": 1356,
                                "Duration": 134,
                                "Type": "Turn"
                            },
                            {
                                "Distance": 7092,
                                "Duration": 568,
                                "Type": "Keep"
                            },
                            {
                                "Distance": 65,
                                "Duration": 26,
                                "Type": "Turn"
                            },
                            {
                                "Distance": 50,
                                "Duration": 18,
                                "Type": "Turn"
                            },
                            {
                                "Distance": 0,
                                "Duration": 0,
                                "Type": "Arrive"
                            }
                        ]
                    }
                }
            ]
        }
    ]
}
```

------
#### [ cURL ]

```
curl --request POST \
  --url 'https://routes.geo.eu-central-1.amazonaws.com/v2/routes?key=Your_key' \
  --header 'Content-Type: application/json' \
  --data '{
  "Origin": [
    -123.118105,
    49.282423
  ],
  "Destination": [
    -123.020098,
    49.232872
  ]
}'
```

------
#### [ AWS CLI ]

```
aws geo-routes calculate-routes --key ${YourKey} \
--origin -123.118105 49.282423 \
--destination -123.020098 49.232872
```

------

# So finden Sie Routen mit turn-by-turn Wegbeschreibungen
<a name="how-to-find-turn-by-turn-route"></a>

Die CalculateRoutes API hilft Ihnen dabei, die besten Strecken zwischen Abflug- und Zielort sowie die besten Ruhezeiten für Fahrer zu finden. Es unterstützt Reisemodi wie Auto, LKW, Fußgänger und Roller. Es unterstützt auch bis zu 25 Wegpunkte (Zwischenstopps), einschließlich Start- und Zielort, mit nur wenigen Einschränkungen.

## Mögliche Anwendungsfälle
<a name="potential-use-cases-turn-by-turn"></a>
+ **Erstellen Sie eine mobile Navigations-App:** Verwenden Sie die API, um turn-by-turn Navigationsanweisungen zu erhalten.
+ **Wegbeschreibungen auf einer Webplattform anzeigen:** Zeigt detaillierte Routenführungen für Webanwendungen an, um Sie bei der Navigation zu unterstützen.

## Beispiele
<a name="calculate-routes-examples-turn-by-turn"></a>

### Routen mit dem Auto berechnen TravelMode
<a name="calculate-routes-car-mode-turn-by-turn"></a>

------
#### [ Sample request ]

```
{
    "Origin": [
        -123.118105,
        49.282423
    ],
    "Destination": [
        -123.020098,
        49.232872
    ],
    "TravelStepType": "TurnByTurn",
    "TravelMode": "Car"
}
```

------
#### [ Sample response ]

```
{
    "LegGeometryFormat": "FlexiblePolyline",
    "Notices": [],
    "Routes": [
        {
            "Legs": [
                {
                    "Geometry": {
                        "Polyline": "Redacted"
                    },
                    "TravelMode": "Car",
                    "Type": "Vehicle",
                    "VehicleLegDetails": {
                        "Arrival": {
                            "Place": {
                                "Position": [-123.0203051, 49.2328499]
                            }
                        },
                        "Departure": {
                            "Place": {
                                "Position": [-123.1180883, 49.2824349]
                            }
                        },
                        "TravelSteps": [
                            {
                                "Distance": 1288,
                                "Duration": 102,
                                "Type": "Depart",
                                "NextRoad": {
                                    "RoadName": "W Georgia St",
                                    "RouteNumber": "HWY-1A"
                                }
                            },
                            {
                                "Distance": 262,
                                "Duration": 24,
                                "Type": "Keep",
                                "NextRoad": {
                                    "RoadName": "Main St",
                                    "RouteNumber": "HWY-1A"
                                }
                            },
                            {
                                "Distance": 1356,
                                "Duration": 134,
                                "Type": "Turn",
                                "NextRoad": {
                                    "RoadName": "Main St",
                                    "RouteNumber": "HWY-1A"
                                }
                            },
                            {
                                "Distance": 7092,
                                "Duration": 568,
                                "Type": "Keep",
                                "NextRoad": {
                                    "RoadName": "Kingsway",
                                    "RouteNumber": "HWY-1A"
                                }
                            },
                            {
                                "Distance": 65,
                                "Duration": 26,
                                "Type": "Turn"
                            },
                            {
                                "Distance": 0,
                                "Duration": 0,
                                "Type": "Arrive"
                            }
                        ]
                    }
                }
            ]
        }
    ]
}
```

------
#### [ cURL ]

```
curl --request POST \
  --url 'https://routes.geo.eu-central-1.amazonaws.com/v2/routes?key=Your_key' \
  --header 'Content-Type: application/json' \
  --data '{
  "Origin": [
    -123.118105,
    49.282423
  ],
  "Destination": [
    -123.020098,
    49.232872
  ],
  "TravelStepType": "TurnByTurn",
  "TravelMode": "Car"
}'
```

------
#### [ AWS CLI ]

```
aws geo-routes calculate-routes --key ${YourKey} \
--origin -123.118105 49.282423 \
--destination -123.020098 49.232872 \
--travel-step-type "TurnByTurn" \
--travel-mode "Car"
```

------

# So finden Sie eine Geschwindigkeitsbegrenzung für eine Straßenspanne
<a name="calculate-routes-speed-limit-road"></a>

Die CalculateRoutes API hilft Ihnen dabei, die besten Strecken zwischen Start- und Zielort sowie die besten Ruhezeiten für Fahrer zu finden. Es unterstützt Reisemodi wie Auto, LKW, Fußgänger und Roller. Es unterstützt auch bis zu 25 Wegpunkte (Zwischenstopps), einschließlich Start- und Zielort, mit nur wenigen Einschränkungen.

## Mögliche Anwendungsfälle
<a name="potential-use-cases"></a>
+ **Überprüfung der Einhaltung von Geschwindigkeitsbegrenzungen:** Bleibt über Geschwindigkeitsbegrenzungen und deren Einhaltung auf dem Laufenden.
+ **Informieren Sie den Fahrer über die Geschwindigkeitsbegrenzung:** Informiert den Fahrer über die Geschwindigkeitsbegrenzung, wenn diese sonst möglicherweise nicht klar ist.

## Beispiele
<a name="calculate-routes-speed-examples"></a>

### Finde Geschwindigkeitsbegrenzungen im Auto TravelMode
<a name="calculate-routes-speed"></a>

------
#### [ Sample request ]

```
{
    "Origin": [
        13.055211,
        52.704802
    ],
    "Destination": [
        13.551910,
        52.282705
    ],
    "TravelMode": "Car",
    "SpanAdditionalFeatures": ["SpeedLimit"]
}
```

------
#### [ Sample response ]

```
{
    "LegGeometryFormat": "FlexiblePolyline",
    "Notices": [],
    "Routes": [
        {
            "Legs": [
                {
                    "Geometry": {
                        "Polyline": "Redacted"
                    },
                    "TravelMode": "Car",
                    "Type": "Vehicle",
                    "VehicleLegDetails": {
                        "AfterTravelSteps": [],
                        "Arrival": {
                            "Place": {
                                "ChargingStation": false,
                                "OriginalPosition": [
                                    13.55191,
                                    52.282705
                                ],
                                "Position": [
                                    13.5507836,
                                    52.2859121
                                ]
                            }
                        },
                        "Departure": {
                            "Place": {
                                "ChargingStation": false,
                                "OriginalPosition": [
                                    13.055211,
                                    52.704802
                                ],
                                "Position": [
                                    13.0555036,
                                    52.7056073
                                ]
                            }
                        },
                        "Incidents": [],
                        "Notices": [],
                        "PassThroughWaypoints": [],
                        "Spans": [
                            {
                                "GeometryOffset": 0,
                                "SpeedLimit": {
                                    "Unlimited": true
                                }
                            },
                            {
                                "GeometryOffset": 151,
                                "SpeedLimit": {
                                    "MaxSpeed": 120.00000762939453
                                }
                            },
                            {
                                "GeometryOffset": 167,
                                "SpeedLimit": {
                                    "MaxSpeed": 80
                                }
                            },
                            {
                                "GeometryOffset": 195,
                                "SpeedLimit": {
                                    "MaxSpeed": 120.00000762939453
                                }
                            },
                            {
                                "GeometryOffset": 220,
                                "SpeedLimit": {
                                    "Unlimited": true
                                }
                            },
                            {
                                "GeometryOffset": 356,
                                "SpeedLimit": {
                                    "MaxSpeed": 120.00000762939453
                                }
                            },
                            {
                                "GeometryOffset": 358,
                                "SpeedLimit": {
                                    "MaxSpeed": 100
                                }
                            },
                            {
                                "GeometryOffset": 368,
                                "SpeedLimit": {
                                    "MaxSpeed": 80
                                }
                            },
                            {
                                "GeometryOffset": 384,
                                "SpeedLimit": {
                                    "MaxSpeed": 60.000003814697266
                                }
                            },
                            {
                                "GeometryOffset": 639,
                                "SpeedLimit": {
                                    "MaxSpeed": 80
                                }
                            },
                            {
                                "GeometryOffset": 701,
                                "SpeedLimit": {
                                    "MaxSpeed": 60.000003814697266
                                }
                            },
                            {
                                "GeometryOffset": 726,
                                "SpeedLimit": {
                                    "MaxSpeed": 80
                                }
                            },
                            {
                                "GeometryOffset": 805,
                                "SpeedLimit": {
                                    "MaxSpeed": 60.000003814697266
                                }
                            },
                            {
                                "GeometryOffset": 839,
                                "SpeedLimit": {
                                    "MaxSpeed": 80
                                }
                            },
                            {
                                "GeometryOffset": 1384,
                                "SpeedLimit": {
                                    "MaxSpeed": 60.000003814697266
                                }
                            },
                            {
                                "GeometryOffset": 1393,
                                "SpeedLimit": {
                                    "MaxSpeed": 50
                                }
                            },
                            {
                                "GeometryOffset": 1443,
                                "SpeedLimit": {
                                    "MaxSpeed": 30.000001907348633
                                }
                            },
                            {
                                "GeometryOffset": 1454,
                                "SpeedLimit": {
                                    "MaxSpeed": 50
                                }
                            },
                            {
                                "GeometryOffset": 1504,
                                "SpeedLimit": {
                                    "MaxSpeed": 60.000003814697266
                                }
                            },
                            {
                                "GeometryOffset": 1513,
                                "SpeedLimit": {
                                    "MaxSpeed": 80
                                }
                            },
                            {
                                "GeometryOffset": 1516,
                                "SpeedLimit": {
                                    "MaxSpeed": 60.000003814697266
                                }
                            },
                            {
                                "GeometryOffset": 1555,
                                "SpeedLimit": {
                                    "MaxSpeed": 80
                                }
                            },
                            {
                                "GeometryOffset": 1748,
                                "SpeedLimit": {
                                    "MaxSpeed": 120.00000762939453
                                }
                            },
                            {
                                "GeometryOffset": 1904,
                                "SpeedLimit": {
                                    "MaxSpeed": 100
                                }
                            },
                            {
                                "GeometryOffset": 1945,
                                "SpeedLimit": {
                                    "Unlimited": true
                                }
                            },
                            {
                                "GeometryOffset": 2006,
                                "SpeedLimit": {
                                    "MaxSpeed": 70
                                }
                            },
                            {
                                "GeometryOffset": 2017,
                                "SpeedLimit": {
                                    "MaxSpeed": 50
                                }
                            },
                            {
                                "GeometryOffset": 2033,
                                "SpeedLimit": {
                                    "MaxSpeed": 30.000001907348633
                                }
                            }
                        ],
                        "Tolls": [],
                        "TollSystems": [],
                        "TravelSteps": [
                            {
                                "Distance": 9099,
                                "Duration": 262,
                                "ExitNumber": [],
                                "GeometryOffset": 0,
                                "Type": "Depart"
                            },
                            {
                                "Distance": 18849,
                                "Duration": 800,
                                "ExitNumber": [],
                                "GeometryOffset": 162,
                                "KeepStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right"
                                },
                                "Type": "Keep"
                            },
                            {
                                "Distance": 4290,
                                "Duration": 212,
                                "ExitNumber": [],
                                "ExitStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right"
                                },
                                "GeometryOffset": 701,
                                "Type": "Exit"
                            },
                            {
                                "Distance": 14418,
                                "Duration": 651,
                                "ExitNumber": [],
                                "GeometryOffset": 828,
                                "Type": "Continue"
                            },
                            {
                                "Distance": 1255,
                                "Duration": 62,
                                "ExitNumber": [],
                                "ExitStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right"
                                },
                                "GeometryOffset": 1359,
                                "Type": "Exit"
                            },
                            {
                                "Distance": 1607,
                                "Duration": 139,
                                "ExitNumber": [],
                                "GeometryOffset": 1393,
                                "TurnStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Left",
                                    "TurnIntensity": "Typical"
                                },
                                "Type": "Turn"
                            },
                            {
                                "Distance": 934,
                                "Duration": 92,
                                "ExitNumber": [],
                                "GeometryOffset": 1442,
                                "Type": "Continue"
                            },
                            {
                                "Distance": 320,
                                "Duration": 27,
                                "ExitNumber": [],
                                "GeometryOffset": 1473,
                                "Type": "Continue"
                            },
                            {
                                "Distance": 320,
                                "Duration": 33,
                                "ExitNumber": [],
                                "GeometryOffset": 1491,
                                "Type": "Continue"
                            },
                            {
                                "Distance": 17863,
                                "Duration": 680,
                                "ExitNumber": [],
                                "GeometryOffset": 1504,
                                "RampStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right"
                                },
                                "Type": "Ramp"
                            },
                            {
                                "Distance": 2888,
                                "Duration": 95,
                                "ExitNumber": [],
                                "GeometryOffset": 1917,
                                "Type": "Continue"
                            },
                            {
                                "Distance": 321,
                                "Duration": 28,
                                "ExitNumber": [],
                                "ExitStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right"
                                },
                                "GeometryOffset": 1977,
                                "Type": "Exit"
                            },
                            {
                                "Distance": 549,
                                "Duration": 41,
                                "ExitNumber": [],
                                "GeometryOffset": 2006,
                                "TurnStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right",
                                    "TurnIntensity": "Typical"
                                },
                                "Type": "Turn"
                            },
                            {
                                "Distance": 386,
                                "Duration": 51,
                                "ExitNumber": [],
                                "GeometryOffset": 2023,
                                "TurnStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Left",
                                    "TurnIntensity": "Typical"
                                },
                                "Type": "Turn"
                            },
                            {
                                "Distance": 98,
                                "Duration": 15,
                                "ExitNumber": [],
                                "GeometryOffset": 2033,
                                "TurnStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right",
                                    "TurnIntensity": "Typical"
                                },
                                "Type": "Turn"
                            },
                            {
                                "Distance": 0,
                                "Duration": 0,
                                "ExitNumber": [],
                                "GeometryOffset": 2036,
                                "Type": "Arrive"
                            }
                        ],
                        "TruckRoadTypes": [],
                        "Zones": []
                    }
                }
            ],
            "MajorRoadLabels": [
                {
                    "RouteNumber": {
                        "Language": "de",
                        "Value": "A111"
                    }
                },
                {
                    "RouteNumber": {
                        "Language": "de",
                        "Value": "A113"
                    }
                }
            ]
        }
    ]
}
```

------
#### [ cURL ]

```
curl --request POST \
  --url 'https://routes.geo.eu-central-1.amazonaws.com/v2/routes?key=Your_key' \
  --header 'Content-Type: application/json' \
  --data '{
  "Origin": [
    13.055211,
    52.704802
  ],
  "Destination": [
    13.551910,
    52.282705
  ],
  "TravelMode": "Car",
  "SpanAdditionalFeatures": ["SpeedLimit"]
}'
```

------
#### [ AWS CLI ]

```
aws geo-routes calculate-routes --key ${YourKey} \
--origin 13.055211 52.704802 \
--destination 13.551910 52.282705 \
--travel-mode "Car" \
--span-additional-features "SpeedLimit"
```

------

# Wie finde ich alternative Routen
<a name="calculate-routes-alternate"></a>

Die CalculateRoutes API hilft Ihnen dabei, die besten Strecken zwischen Start- und Zielort sowie die besten Ruhezeiten für Fahrer zu finden. Es unterstützt Reisemodi wie Auto, LKW, Fußgänger und Roller. Es unterstützt auch bis zu 25 Wegpunkte (Zwischenstopps), einschließlich Start- und Zielort, mit nur wenigen Einschränkungen.

## Mögliche Anwendungsfälle
<a name="potential-use-cases"></a>
+ **Identifizieren Sie alternative Routen:** Sie können die Route auswählen, die Ihren Geschäftsanforderungen am besten entspricht.

## Beispiele
<a name="calculate-routes-alternate-examples"></a>

### Finden Sie alternative Routen in Car TravelMode
<a name="calculate-routes-alternate"></a>

------
#### [ Sample request ]

```
{
    "Origin": [
        13.055211,
        52.704802
    ],
    "Destination": [
        13.551910,
        52.282705
    ],
    "TravelMode": "Car",
    "MaxAlternatives": 2
}
```

------
#### [ Sample response ]

```
{
    "LegGeometryFormat": "FlexiblePolyline",
    "Notices": [],
    "Routes": [
        {
            "Legs": [
                {
                    "Geometry": {
                        "Polyline": "Redacted"
                    },
                    "TravelMode": "Car",
                    "Type": "Vehicle",
                    "VehicleLegDetails": {
                        "AfterTravelSteps": [],
                        "Arrival": {
                            "Place": {
                                "ChargingStation": false,
                                "OriginalPosition": [
                                    13.55191,
                                    52.282705
                                ],
                                "Position": [
                                    13.5507836,
                                    52.2859121
                                ]
                            }
                        },
                        "Departure": {
                            "Place": {
                                "ChargingStation": false,
                                "OriginalPosition": [
                                    13.055211,
                                    52.704802
                                ],
                                "Position": [
                                    13.0555036,
                                    52.7056073
                                ]
                            }
                        },
                        "Incidents": [],
                        "Notices": [],
                        "PassThroughWaypoints": [],
                        "Spans": [],
                        "Tolls": [],
                        "TollSystems": [],
                        "TravelSteps": [
                            {
                                "Distance": 9099,
                                "Duration": 262,
                                "ExitNumber": [],
                                "GeometryOffset": 0,
                                "Type": "Depart"
                            },
                            {
                                "Distance": 18849,
                                "Duration": 800,
                                "ExitNumber": [],
                                "GeometryOffset": 162,
                                "KeepStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right"
                                },
                                "Type": "Keep"
                            },
                            {
                                "Distance": 4290,
                                "Duration": 212,
                                "ExitNumber": [],
                                "ExitStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right"
                                },
                                "GeometryOffset": 701,
                                "Type": "Exit"
                            },
                            {
                                "Distance": 14418,
                                "Duration": 651,
                                "ExitNumber": [],
                                "GeometryOffset": 828,
                                "Type": "Continue"
                            },
                            {
                                "Distance": 1255,
                                "Duration": 62,
                                "ExitNumber": [],
                                "ExitStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right"
                                },
                                "GeometryOffset": 1359,
                                "Type": "Exit"
                            },
                            {
                                "Distance": 1607,
                                "Duration": 139,
                                "ExitNumber": [],
                                "GeometryOffset": 1393,
                                "TurnStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Left",
                                    "TurnIntensity": "Typical"
                                },
                                "Type": "Turn"
                            },
                            {
                                "Distance": 934,
                                "Duration": 92,
                                "ExitNumber": [],
                                "GeometryOffset": 1442,
                                "Type": "Continue"
                            },
                            {
                                "Distance": 320,
                                "Duration": 27,
                                "ExitNumber": [],
                                "GeometryOffset": 1473,
                                "Type": "Continue"
                            },
                            {
                                "Distance": 320,
                                "Duration": 33,
                                "ExitNumber": [],
                                "GeometryOffset": 1491,
                                "Type": "Continue"
                            },
                            {
                                "Distance": 17863,
                                "Duration": 680,
                                "ExitNumber": [],
                                "GeometryOffset": 1504,
                                "RampStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right"
                                },
                                "Type": "Ramp"
                            },
                            {
                                "Distance": 2888,
                                "Duration": 95,
                                "ExitNumber": [],
                                "GeometryOffset": 1917,
                                "Type": "Continue"
                            },
                            {
                                "Distance": 321,
                                "Duration": 28,
                                "ExitNumber": [],
                                "ExitStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right"
                                },
                                "GeometryOffset": 1977,
                                "Type": "Exit"
                            },
                            {
                                "Distance": 549,
                                "Duration": 41,
                                "ExitNumber": [],
                                "GeometryOffset": 2006,
                                "TurnStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right",
                                    "TurnIntensity": "Typical"
                                },
                                "Type": "Turn"
                            },
                            {
                                "Distance": 386,
                                "Duration": 51,
                                "ExitNumber": [],
                                "GeometryOffset": 2023,
                                "TurnStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Left",
                                    "TurnIntensity": "Typical"
                                },
                                "Type": "Turn"
                            },
                            {
                                "Distance": 98,
                                "Duration": 15,
                                "ExitNumber": [],
                                "GeometryOffset": 2033,
                                "TurnStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right",
                                    "TurnIntensity": "Typical"
                                },
                                "Type": "Turn"
                            },
                            {
                                "Distance": 0,
                                "Duration": 0,
                                "ExitNumber": [],
                                "GeometryOffset": 2036,
                                "Type": "Arrive"
                            }
                        ],
                        "TruckRoadTypes": [],
                        "Zones": []
                    }
                }
            ],
            "MajorRoadLabels": [
                {
                    "RouteNumber": {
                        "Language": "de",
                        "Value": "A111"
                    }
                },
                {
                    "RouteNumber": {
                        "Language": "de",
                        "Value": "A113"
                    }
                }
            ]
        },
        {
            "Legs": [
                {
                    "Geometry": {
                        "Polyline": "Redacted"
                    },
                    "TravelMode": "Car",
                    "Type": "Vehicle",
                    "VehicleLegDetails": {
                        "AfterTravelSteps": [],
                        "Arrival": {
                            "Place": {
                                "ChargingStation": false,
                                "OriginalPosition": [
                                    13.55191,
                                    52.282705
                                ],
                                "Position": [
                                    13.5507836,
                                    52.2859121
                                ]
                            }
                        },
                        "Departure": {
                            "Place": {
                                "ChargingStation": false,
                                "OriginalPosition": [
                                    13.055211,
                                    52.704802
                                ],
                                "Position": [
                                    13.0555036,
                                    52.7056073
                                ]
                            }
                        },
                        "Incidents": [],
                        "Notices": [],
                        "PassThroughWaypoints": [],
                        "Spans": [],
                        "Tolls": [],
                        "TollSystems": [],
                        "TravelSteps": [
                            {
                                "Distance": 91047,
                                "Duration": 2880,
                                "ExitNumber": [],
                                "GeometryOffset": 0,
                                "Type": "Depart"
                            },
                            {
                                "Distance": 3496,
                                "Duration": 119,
                                "ExitNumber": [],
                                "ExitStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right"
                                },
                                "GeometryOffset": 1473,
                                "Type": "Exit"
                            },
                            {
                                "Distance": 321,
                                "Duration": 28,
                                "ExitNumber": [],
                                "ExitStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right"
                                },
                                "GeometryOffset": 1565,
                                "Type": "Exit"
                            },
                            {
                                "Distance": 549,
                                "Duration": 41,
                                "ExitNumber": [],
                                "GeometryOffset": 1594,
                                "TurnStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right",
                                    "TurnIntensity": "Typical"
                                },
                                "Type": "Turn"
                            },
                            {
                                "Distance": 386,
                                "Duration": 51,
                                "ExitNumber": [],
                                "GeometryOffset": 1611,
                                "TurnStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Left",
                                    "TurnIntensity": "Typical"
                                },
                                "Type": "Turn"
                            },
                            {
                                "Distance": 98,
                                "Duration": 15,
                                "ExitNumber": [],
                                "GeometryOffset": 1621,
                                "TurnStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right",
                                    "TurnIntensity": "Typical"
                                },
                                "Type": "Turn"
                            },
                            {
                                "Distance": 0,
                                "Duration": 0,
                                "ExitNumber": [],
                                "GeometryOffset": 1624,
                                "Type": "Arrive"
                            }
                        ],
                        "TruckRoadTypes": [],
                        "Zones": []
                    }
                }
            ],
            "MajorRoadLabels": [
                {
                    "RouteNumber": {
                        "Language": "de",
                        "Value": "A10"
                    }
                }
            ]
        },
        {
            "Legs": [
                {
                    "Geometry": {
                        "Polyline": "Redacted"
                    },
                    "TravelMode": "Car",
                    "Type": "Vehicle",
                    "VehicleLegDetails": {
                        "AfterTravelSteps": [],
                        "Arrival": {
                            "Place": {
                                "ChargingStation": false,
                                "OriginalPosition": [
                                    13.55191,
                                    52.282705
                                ],
                                "Position": [
                                    13.5507836,
                                    52.2859121
                                ]
                            }
                        },
                        "Departure": {
                            "Place": {
                                "ChargingStation": false,
                                "OriginalPosition": [
                                    13.055211,
                                    52.704802
                                ],
                                "Position": [
                                    13.0555036,
                                    52.7056073
                                ]
                            }
                        },
                        "Incidents": [],
                        "Notices": [],
                        "PassThroughWaypoints": [],
                        "Spans": [],
                        "Tolls": [],
                        "TollSystems": [],
                        "TravelSteps": [
                            {
                                "Distance": 9099,
                                "Duration": 262,
                                "ExitNumber": [],
                                "GeometryOffset": 0,
                                "Type": "Depart"
                            },
                            {
                                "Distance": 18849,
                                "Duration": 800,
                                "ExitNumber": [],
                                "GeometryOffset": 162,
                                "KeepStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right"
                                },
                                "Type": "Keep"
                            },
                            {
                                "Distance": 4290,
                                "Duration": 212,
                                "ExitNumber": [],
                                "ExitStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right"
                                },
                                "GeometryOffset": 701,
                                "Type": "Exit"
                            },
                            {
                                "Distance": 12258,
                                "Duration": 554,
                                "ExitNumber": [],
                                "GeometryOffset": 828,
                                "Type": "Continue"
                            },
                            {
                                "Distance": 18567,
                                "Duration": 1218,
                                "ExitNumber": [],
                                "ExitStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right"
                                },
                                "GeometryOffset": 1282,
                                "Type": "Exit"
                            },
                            {
                                "Distance": 250,
                                "Duration": 28,
                                "ExitNumber": [],
                                "GeometryOffset": 1760,
                                "RampStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right"
                                },
                                "Type": "Ramp"
                            },
                            {
                                "Distance": 4856,
                                "Duration": 245,
                                "ExitNumber": [],
                                "GeometryOffset": 1793,
                                "TurnStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right",
                                    "TurnIntensity": "Typical"
                                },
                                "Type": "Turn"
                            },
                            {
                                "Distance": 3202,
                                "Duration": 165,
                                "ExitNumber": [],
                                "GeometryOffset": 1970,
                                "RoundaboutExitStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right"
                                },
                                "Type": "RoundaboutExit"
                            },
                            {
                                "Distance": 386,
                                "Duration": 51,
                                "ExitNumber": [],
                                "GeometryOffset": 2072,
                                "TurnStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right",
                                    "TurnIntensity": "Typical"
                                },
                                "Type": "Turn"
                            },
                            {
                                "Distance": 98,
                                "Duration": 15,
                                "ExitNumber": [],
                                "GeometryOffset": 2082,
                                "TurnStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right",
                                    "TurnIntensity": "Typical"
                                },
                                "Type": "Turn"
                            },
                            {
                                "Distance": 0,
                                "Duration": 0,
                                "ExitNumber": [],
                                "GeometryOffset": 2085,
                                "Type": "Arrive"
                            }
                        ],
                        "TruckRoadTypes": [],
                        "Zones": []
                    }
                }
            ],
            "MajorRoadLabels": [
                {
                    "RouteNumber": {
                        "Language": "de",
                        "Value": "A111"
                    }
                },
                {
                    "RouteNumber": {
                        "Language": "de",
                        "Value": "B96"
                    }
                }
            ]
        }
    ]
}
```

------
#### [ cURL ]

```
curl --request POST \
  --url 'https://routes.geo.eu-central-1.amazonaws.com/v2/routes?key=Your_key' \
  --header 'Content-Type: application/json' \
  --data '{
  "Origin": [
    13.055211,
    52.704802
  ],
  "Destination": [
    13.551910,
    52.282705
  ],
  "TravelMode": "Car",
  "MaxAlternatives": 2
}'
```

------
#### [ AWS CLI ]

```
aws geo-routes calculate-routes --key ${YourKey} \
--origin 13.055211 52.704802 \
--destination 13.551910 52.282705 \
--travel-mode "Car" \
--max-alternatives 2
```

------

# Wie berechnet man die Mautgebühren für eine Route
<a name="calculate-routes-tolls"></a>

Die CalculateRoutes API hilft Ihnen dabei, die besten Strecken zwischen Abfahrts- und Zielort sowie die besten Ruhezeiten für Fahrer zu finden. Es unterstützt Reisemodi wie Auto, LKW, Fußgänger und Roller. Es unterstützt auch bis zu 25 Wegpunkte (Zwischenstopps), einschließlich Start- und Zielort, mit nur wenigen Einschränkungen.

## Mögliche Anwendungsfälle
<a name="potential-use-cases"></a>
+ **Mautgebühren berechnen:** Sie können die Mautkosten bei der Routenplanung berechnen.
+ **Mautgebühren überprüfen:** Sie können die Mautkosten nach der Reise überprüfen.

## Beispiele
<a name="calculate-routes-tolls-examples"></a>

### Berechnen Sie die Mautgebühren für Ihre Strecken in Car TravelMode
<a name="calculate-routes-tolls"></a>

------
#### [ Sample request ]

```
{
    "Origin": [
        2.234491,
        48.815704
    ],
    "Destination": [
        5.11412,
        47.260723
    ],
    "TravelMode": "Car",
    "Tolls": {
        "AllTransponders": true,
        "AllVignettes": true
    }
}
```

------
#### [ Sample response ]

```
{
    "LegGeometryFormat": "FlexiblePolyline",
    "Notices": [],
    "Routes": [
        {
            "Legs": [
                {
                    "Geometry": {
                        "Polyline": "Redacted"
                    },
                    "TravelMode": "Car",
                    "Type": "Vehicle",
                    "VehicleLegDetails": {
                        "AfterTravelSteps": [],
                        "Arrival": {
                            "Place": {
                                "ChargingStation": false,
                                "OriginalPosition": [
                                    5.11412,
                                    47.2607229
                                ],
                                "Position": [
                                    5.1128203,
                                    47.2596356
                                ]
                            }
                        },
                        "Departure": {
                            "Place": {
                                "ChargingStation": false,
                                "OriginalPosition": [
                                    2.234491,
                                    48.8157039
                                ],
                                "Position": [
                                    2.2346482,
                                    48.815674
                                ]
                            }
                        },
                        "Incidents": [],
                        "Notices": [],
                        "PassThroughWaypoints": [],
                        "Spans": [],
                        "Tolls": [
                            {
                                "Country": "FRA",
                                "PaymentSites": [
                                    {
                                        "Name": "FLEURY-EN-BIERE",
                                        "Position": [
                                            2.53988,
                                            48.42578
                                        ]
                                    },
                                    {
                                        "Name": "POUILLY-EN-AUXOIS",
                                        "Position": [
                                            4.56112,
                                            47.25244
                                        ]
                                    }
                                ],
                                "Rates": [
                                    {
                                        "Id": "2d680295-fb0f-45aa-a8ed-79d9f0f9ff9f",
                                        "LocalPrice": {
                                            "Currency": "EUR",
                                            "Estimate": false,
                                            "Range": false,
                                            "Value": 21.700000762939453
                                        },
                                        "Name": "APRR",
                                        "PaymentMethods": [
                                            "Cash",
                                            "BankCard",
                                            "CreditCard",
                                            "Transponder",
                                            "TravelCard"
                                        ],
                                        "Transponders": [
                                            {
                                                "SystemName": "BipandGo"
                                            },
                                            {
                                                "SystemName": "BipandGo"
                                            },
                                            {
                                                "SystemName": "BipandGo IDVROOM carpoorling"
                                            },
                                            {
                                                "SystemName": "Cito30"
                                            },
                                            {
                                                "SystemName": "Easytrip pass"
                                            },
                                            {
                                                "SystemName": "Liane 30"
                                            },
                                            {
                                                "SystemName": "Liber-t"
                                            },
                                            {
                                                "SystemName": "Liber-t mobilitis"
                                            },
                                            {
                                                "SystemName": "Pass Pont-Pont"
                                            },
                                            {
                                                "SystemName": "Progressivi'T Maurienne"
                                            },
                                            {
                                                "SystemName": "TopEurop"
                                            },
                                            {
                                                "SystemName": "Tunnel Pass+"
                                            },
                                            {
                                                "SystemName": "Ulys"
                                            },
                                            {
                                                "SystemName": "Ulys Europe"
                                            },
                                            {
                                                "SystemName": "Viaduc-t 30"
                                            }
                                        ]
                                    }
                                ],
                                "Systems": [
                                    0
                                ]
                            }
                        ],
                        "TollSystems": [
                            {
                                "Name": "APRR"
                            }
                        ],
                        "TravelSteps": [
                            {
                                "Distance": 122,
                                "Duration": 21,
                                "ExitNumber": [],
                                "GeometryOffset": 0,
                                "Type": "Depart"
                            },
                            {
                                "Distance": 32,
                                "Duration": 7,
                                "ExitNumber": [],
                                "GeometryOffset": 7,
                                "TurnStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right",
                                    "TurnIntensity": "Typical"
                                },
                                "Type": "Turn"
                            },
                            {
                                "Distance": 74,
                                "Duration": 14,
                                "ExitNumber": [],
                                "GeometryOffset": 8,
                                "TurnStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right",
                                    "TurnIntensity": "Typical"
                                },
                                "Type": "Turn"
                            },
                            {
                                "Distance": 199,
                                "Duration": 33,
                                "ExitNumber": [],
                                "GeometryOffset": 9,
                                "TurnStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right",
                                    "TurnIntensity": "Typical"
                                },
                                "Type": "Turn"
                            },
                            {
                                "Distance": 21,
                                "Duration": 10,
                                "ExitNumber": [],
                                "GeometryOffset": 17,
                                "TurnStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right",
                                    "TurnIntensity": "Typical"
                                },
                                "Type": "Turn"
                            },
                            {
                                "Distance": 461,
                                "Duration": 63,
                                "ExitNumber": [],
                                "GeometryOffset": 20,
                                "TurnStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right",
                                    "TurnIntensity": "Typical"
                                },
                                "Type": "Turn"
                            },
                            {
                                "Distance": 1557,
                                "Duration": 145,
                                "ExitNumber": [],
                                "GeometryOffset": 41,
                                "TurnStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Left",
                                    "TurnIntensity": "Typical"
                                },
                                "Type": "Turn"
                            },
                            {
                                "Distance": 3471,
                                "Duration": 151,
                                "ExitNumber": [],
                                "GeometryOffset": 135,
                                "RoundaboutExitStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right"
                                },
                                "Type": "RoundaboutExit"
                            },
                            {
                                "Distance": 9796,
                                "Duration": 430,
                                "ExitNumber": [],
                                "GeometryOffset": 242,
                                "RampStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right"
                                },
                                "Type": "Ramp"
                            },
                            {
                                "Distance": 2473,
                                "Duration": 112,
                                "ExitNumber": [],
                                "ExitStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right"
                                },
                                "GeometryOffset": 582,
                                "Type": "Exit"
                            },
                            {
                                "Distance": 674,
                                "Duration": 25,
                                "ExitNumber": [],
                                "GeometryOffset": 669,
                                "Type": "Continue"
                            },
                            {
                                "Distance": 253953,
                                "Duration": 7468,
                                "ExitNumber": [],
                                "GeometryOffset": 679,
                                "Type": "Continue"
                            },
                            {
                                "Distance": 37379,
                                "Duration": 1192,
                                "ExitNumber": [],
                                "ExitStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right"
                                },
                                "GeometryOffset": 5701,
                                "Type": "Exit"
                            },
                            {
                                "Distance": 2021,
                                "Duration": 110,
                                "ExitNumber": [],
                                "GeometryOffset": 6695,
                                "RoundaboutExitStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right"
                                },
                                "Type": "RoundaboutExit"
                            },
                            {
                                "Distance": 7380,
                                "Duration": 316,
                                "ExitNumber": [],
                                "GeometryOffset": 6776,
                                "RoundaboutPassStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right"
                                },
                                "Type": "RoundaboutPass"
                            },
                            {
                                "Distance": 4253,
                                "Duration": 156,
                                "ExitNumber": [],
                                "GeometryOffset": 6987,
                                "KeepStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Left"
                                },
                                "Type": "Keep"
                            },
                            {
                                "Distance": 813,
                                "Duration": 54,
                                "ExitNumber": [],
                                "GeometryOffset": 7081,
                                "RampStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right"
                                },
                                "Type": "Ramp"
                            },
                            {
                                "Distance": 1909,
                                "Duration": 109,
                                "ExitNumber": [],
                                "GeometryOffset": 7133,
                                "TurnStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Left",
                                    "TurnIntensity": "Sharp"
                                },
                                "Type": "Turn"
                            },
                            {
                                "Distance": 827,
                                "Duration": 47,
                                "ExitNumber": [],
                                "GeometryOffset": 7182,
                                "Type": "Continue"
                            },
                            {
                                "Distance": 680,
                                "Duration": 41,
                                "ExitNumber": [],
                                "GeometryOffset": 7216,
                                "RoundaboutExitStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right"
                                },
                                "Type": "RoundaboutExit"
                            },
                            {
                                "Distance": 224,
                                "Duration": 12,
                                "ExitNumber": [],
                                "GeometryOffset": 7258,
                                "Type": "Continue"
                            },
                            {
                                "Distance": 25,
                                "Duration": 2,
                                "ExitNumber": [],
                                "GeometryOffset": 7265,
                                "Type": "Continue"
                            },
                            {
                                "Distance": 748,
                                "Duration": 51,
                                "ExitNumber": [],
                                "GeometryOffset": 7267,
                                "Type": "Continue"
                            },
                            {
                                "Distance": 656,
                                "Duration": 46,
                                "ExitNumber": [],
                                "GeometryOffset": 7299,
                                "RoundaboutExitStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right"
                                },
                                "Type": "RoundaboutExit"
                            },
                            {
                                "Distance": 1119,
                                "Duration": 78,
                                "ExitNumber": [],
                                "GeometryOffset": 7329,
                                "Type": "Continue"
                            },
                            {
                                "Distance": 432,
                                "Duration": 26,
                                "ExitNumber": [],
                                "GeometryOffset": 7383,
                                "TurnStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right",
                                    "TurnIntensity": "Typical"
                                },
                                "Type": "Turn"
                            },
                            {
                                "Distance": 1864,
                                "Duration": 100,
                                "ExitNumber": [],
                                "GeometryOffset": 7402,
                                "RoundaboutExitStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right"
                                },
                                "Type": "RoundaboutExit"
                            },
                            {
                                "Distance": 1110,
                                "Duration": 93,
                                "ExitNumber": [],
                                "GeometryOffset": 7470,
                                "RoundaboutExitStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right"
                                },
                                "Type": "RoundaboutExit"
                            },
                            {
                                "Distance": 232,
                                "Duration": 10,
                                "ExitNumber": [],
                                "GeometryOffset": 7563,
                                "Type": "Continue"
                            },
                            {
                                "Distance": 642,
                                "Duration": 29,
                                "ExitNumber": [],
                                "GeometryOffset": 7572,
                                "Type": "Continue"
                            },
                            {
                                "Distance": 357,
                                "Duration": 25,
                                "ExitNumber": [],
                                "GeometryOffset": 7580,
                                "Type": "Continue"
                            },
                            {
                                "Distance": 63,
                                "Duration": 10,
                                "ExitNumber": [],
                                "GeometryOffset": 7600,
                                "TurnStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right",
                                    "TurnIntensity": "Typical"
                                },
                                "Type": "Turn"
                            },
                            {
                                "Distance": 2626,
                                "Duration": 411,
                                "ExitNumber": [],
                                "GeometryOffset": 7602,
                                "TurnStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right",
                                    "TurnIntensity": "Typical"
                                },
                                "Type": "Turn"
                            },
                            {
                                "Distance": 234,
                                "Duration": 37,
                                "ExitNumber": [],
                                "GeometryOffset": 7627,
                                "Type": "Continue"
                            },
                            {
                                "Distance": 0,
                                "Duration": 0,
                                "ExitNumber": [],
                                "GeometryOffset": 7632,
                                "Type": "Arrive"
                            }
                        ],
                        "TruckRoadTypes": [],
                        "Zones": []
                    }
                }
            ],
            "MajorRoadLabels": [
                {
                    "RouteNumber": {
                        "Language": "fr",
                        "Value": "A6"
                    }
                }
            ]
        }
    ]
}
```

------
#### [ cURL ]

```
curl --request POST \
  --url 'https://routes.geo.eu-central-1.amazonaws.com/v2/routes?key=Your_key' \
  --header 'Content-Type: application/json' \
  --data '{
  "Origin": [
    2.234491,
    48.815704
  ],
  "Destination": [
    5.11412,
    47.260723
  ],
  "TravelMode": "Car",
  "Tolls": {
    "AllTransponders": true,
    "AllVignettes": true
  }
}'
```

------
#### [ AWS CLI ]

```
aws geo-routes calculate-routes --key ${YourKey} \
--origin 13.055211 52.704802 \
--destination 13.551910 52.282705 \
--travel-mode "Car" \
--tolls '{"AllTransponders": true, "AllVignettes": true}'
```

------

# Wie erstellt man Routen mit benutzerdefinierter Vermeidung
<a name="calculate-routes-custom-avoidance-poly"></a>

Die CalculateRoutes API hilft Ihnen dabei, die besten Routen zwischen Abfahrts- und Zielort sowie die besten Ruhezeiten für Fahrer zu finden. Es unterstützt Reisemodi wie Auto, LKW, Fußgänger und Roller. Es unterstützt auch bis zu 25 Wegpunkte (Zwischenstopps), einschließlich Start- und Zielort, mit nur wenigen Einschränkungen.

## Mögliche Anwendungsfälle
<a name="potential-use-cases"></a>
+ **Routen mit benutzerdefinierter Vermeidung berechnen:** Passen Sie Routen mit Vermeidungsmöglichkeiten an, um bessere Routen und Pendelwege zu planen.

## Beispiele
<a name="calculate-routes-custom-avoidance-examples"></a>

### Verwenden Sie die CalculateRoutes Option mit einem Avoid BoundingBox , um benutzerdefinierte Routen zu erstellen.
<a name="calculate-routes-custom-avoidance-poly"></a>

------
#### [ Sample request ]

```
{
    "Origin": [
        -123.116655,
        49.281538
    ],
    "Destination": [
        -123.01791785749363,
        49.22782762759908
    ],
    "TravelMode": "Car",
    "Avoid": {
        "Areas": [
            {
                "Geometry": {
                    "BoundingBox": [
                        -123.078693,
                        49.238987,
                        -123.054638,
                        49.251694
                    ]
                }
            }
        ]
    }
}
```

------
#### [ Sample response ]

```
{
    "LegGeometryFormat": "FlexiblePolyline",
    "Notices": [],
    "Routes": [
        {
            "Legs": [
                {
                    "Geometry": {
                        "Polyline": "Redacted"
                    },
                    "TravelMode": "Car",
                    "Type": "Vehicle",
                    "VehicleLegDetails": {
                        "AfterTravelSteps": [],
                        "Arrival": {
                            "Place": {
                                "ChargingStation": false,
                                "OriginalPosition": [
                                    -123.0179179,
                                    49.2278276
                                ],
                                "Position": [
                                    -123.0229001,
                                    49.22883
                                ]
                            }
                        },
                        "Departure": {
                            "Place": {
                                "ChargingStation": false,
                                "OriginalPosition": [
                                    -123.116655,
                                    49.281538
                                ],
                                "Position": [
                                    -123.1166332,
                                    49.2815528
                                ]
                            }
                        },
                        "Incidents": [],
                        "Notices": [],
                        "PassThroughWaypoints": [],
                        "Spans": [],
                        "Tolls": [],
                        "TollSystems": [],
                        "TravelSteps": [
                            {
                                "Distance": 1144,
                                "Duration": 85,
                                "ExitNumber": [],
                                "GeometryOffset": 0,
                                "Type": "Depart"
                            },
                            {
                                "Distance": 262,
                                "Duration": 24,
                                "ExitNumber": [],
                                "GeometryOffset": 35,
                                "RampStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right"
                                },
                                "Type": "Ramp"
                            },
                            {
                                "Distance": 433,
                                "Duration": 47,
                                "ExitNumber": [],
                                "GeometryOffset": 40,
                                "TurnStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right",
                                    "TurnIntensity": "Typical"
                                },
                                "Type": "Turn"
                            },
                            {
                                "Distance": 1131,
                                "Duration": 81,
                                "ExitNumber": [],
                                "GeometryOffset": 54,
                                "TurnStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Left",
                                    "TurnIntensity": "Typical"
                                },
                                "Type": "Turn"
                            },
                            {
                                "Distance": 54,
                                "Duration": 4,
                                "ExitNumber": [],
                                "GeometryOffset": 79,
                                "Type": "Continue"
                            },
                            {
                                "Distance": 520,
                                "Duration": 39,
                                "ExitNumber": [],
                                "GeometryOffset": 83,
                                "Type": "Continue"
                            },
                            {
                                "Distance": 1123,
                                "Duration": 111,
                                "ExitNumber": [],
                                "GeometryOffset": 101,
                                "TurnStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right",
                                    "TurnIntensity": "Typical"
                                },
                                "Type": "Turn"
                            },
                            {
                                "Distance": 1131,
                                "Duration": 81,
                                "ExitNumber": [],
                                "GeometryOffset": 141,
                                "TurnStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Left",
                                    "TurnIntensity": "Typical"
                                },
                                "Type": "Turn"
                            },
                            {
                                "Distance": 2843,
                                "Duration": 209,
                                "ExitNumber": [],
                                "GeometryOffset": 167,
                                "Type": "Continue"
                            },
                            {
                                "Distance": 3219,
                                "Duration": 246,
                                "ExitNumber": [],
                                "GeometryOffset": 255,
                                "TurnStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right",
                                    "TurnIntensity": "Typical"
                                },
                                "Type": "Turn"
                            },
                            {
                                "Distance": 64,
                                "Duration": 23,
                                "ExitNumber": [],
                                "GeometryOffset": 332,
                                "TurnStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Left",
                                    "TurnIntensity": "Typical"
                                },
                                "Type": "Turn"
                            },
                            {
                                "Distance": 0,
                                "Duration": 0,
                                "ExitNumber": [],
                                "GeometryOffset": 334,
                                "Type": "Arrive"
                            }
                        ],
                        "TruckRoadTypes": [],
                        "Zones": []
                    }
                }
            ],
            "MajorRoadLabels": [
                {
                    "RoadName": {
                        "Language": "en",
                        "Value": "Boundary Rd"
                    }
                },
                {
                    "RoadName": {
                        "Language": "en",
                        "Value": "Grandview Hwy"
                    }
                }
            ]
        }
    ]
}
```

------
#### [ cURL ]

```
curl --request POST \
  --url 'https://routes.geo.eu-central-1.amazonaws.com/v2/routes?key=Your_key' \
  --header 'Content-Type: application/json' \
  --data '{
  "Origin": [
    -123.116655,
    49.281538
  ],
  "Destination": [
    -123.01791785749363,
    49.22782762759908
  ],
  "TravelMode": "Car",
  "Avoid": {
    "Areas": [
      {
        "Geometry": {
          "BoundingBox": [
            -123.078693,
            49.238987,
            -123.054638,
            49.251694
          ]
        }
      }
    ]
  }
}'
```

------
#### [ AWS CLI ]

```
aws geo-routes calculate-routes --key ${YourKey} \
--origin -123.13277 49.281538 \
--destination -123.01791785749363 49.22782762759908 \
--travel-mode "Car" \
--avoid '{"Areas":[{"Geometry":{"BoundingBox":[-123.054638,49.238987,-123.054638,49.251694]}}]}'
```

------

### Verwenden Sie es CalculateRoutes zusammen mit einem Avoid-Polygon, um benutzerdefinierte Routen zu erstellen.
<a name="calculate-routes-custom-avoidance-poly-polygon"></a>

------
#### [ Sample request ]

```
{
    "Origin": [
        -123.116655,
        49.281538
    ],
    "Destination": [
        -123.01791785749363,
        49.22782762759908
    ],
    "TravelMode": "Car",
    "Avoid": {
        "Areas": [
            {
                "Geometry": {
                    "polygon": [
                        [
                            [
                                -123.06953,
                                49.256419
                            ],
                            [
                                -123.080486,
                                49.242115
                            ],
                            [
                                -123.058573,
                                49.242115
                            ],
                            [
                                -123.06953,
                                49.256419
                            ]
                        ]
                    ]
                }
            }
        ]
    }
}
```

------
#### [ Sample response ]

```
{
    "LegGeometryFormat": "FlexiblePolyline",
    "Notices": [],
    "Routes": [
        {
            "Legs": [
                {
                    "Geometry": {
                        "Polyline": "Redacted"
                    },
                    "TravelMode": "Car",
                    "Type": "Vehicle",
                    "VehicleLegDetails": {
                        "AfterTravelSteps": [],
                        "Arrival": {
                            "Place": {
                                "ChargingStation": false,
                                "OriginalPosition": [
                                    -123.0179179,
                                    49.2278276
                                ],
                                "Position": [
                                    -123.0229001,
                                    49.22883
                                ]
                            }
                        },
                        "Departure": {
                            "Place": {
                                "ChargingStation": false,
                                "OriginalPosition": [
                                    -123.116655,
                                    49.281538
                                ],
                                "Position": [
                                    -123.1166332,
                                    49.2815528
                                ]
                            }
                        },
                        "Incidents": [],
                        "Notices": [],
                        "PassThroughWaypoints": [],
                        "Spans": [],
                        "Tolls": [],
                        "TollSystems": [],
                        "TravelSteps": [
                            {
                                "Distance": 1144,
                                "Duration": 85,
                                "ExitNumber": [],
                                "GeometryOffset": 0,
                                "Type": "Depart"
                            },
                            {
                                "Distance": 262,
                                "Duration": 24,
                                "ExitNumber": [],
                                "GeometryOffset": 35,
                                "RampStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right"
                                },
                                "Type": "Ramp"
                            },
                            {
                                "Distance": 433,
                                "Duration": 47,
                                "ExitNumber": [],
                                "GeometryOffset": 40,
                                "TurnStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right",
                                    "TurnIntensity": "Typical"
                                },
                                "Type": "Turn"
                            },
                            {
                                "Distance": 1131,
                                "Duration": 81,
                                "ExitNumber": [],
                                "GeometryOffset": 54,
                                "TurnStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Left",
                                    "TurnIntensity": "Typical"
                                },
                                "Type": "Turn"
                            },
                            {
                                "Distance": 54,
                                "Duration": 4,
                                "ExitNumber": [],
                                "GeometryOffset": 79,
                                "Type": "Continue"
                            },
                            {
                                "Distance": 520,
                                "Duration": 39,
                                "ExitNumber": [],
                                "GeometryOffset": 83,
                                "Type": "Continue"
                            },
                            {
                                "Distance": 1123,
                                "Duration": 111,
                                "ExitNumber": [],
                                "GeometryOffset": 101,
                                "TurnStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right",
                                    "TurnIntensity": "Typical"
                                },
                                "Type": "Turn"
                            },
                            {
                                "Distance": 1131,
                                "Duration": 81,
                                "ExitNumber": [],
                                "GeometryOffset": 141,
                                "TurnStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Left",
                                    "TurnIntensity": "Typical"
                                },
                                "Type": "Turn"
                            },
                            {
                                "Distance": 448,
                                "Duration": 34,
                                "ExitNumber": [],
                                "GeometryOffset": 167,
                                "Type": "Continue"
                            },
                            {
                                "Distance": 1797,
                                "Duration": 151,
                                "ExitNumber": [],
                                "GeometryOffset": 182,
                                "TurnStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right",
                                    "TurnIntensity": "Typical"
                                },
                                "Type": "Turn"
                            },
                            {
                                "Distance": 2836,
                                "Duration": 224,
                                "ExitNumber": [],
                                "GeometryOffset": 222,
                                "TurnStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Left",
                                    "TurnIntensity": "Typical"
                                },
                                "Type": "Turn"
                            },
                            {
                                "Distance": 339,
                                "Duration": 30,
                                "ExitNumber": [],
                                "GeometryOffset": 326,
                                "TurnStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right",
                                    "TurnIntensity": "Typical"
                                },
                                "Type": "Turn"
                            },
                            {
                                "Distance": 64,
                                "Duration": 23,
                                "ExitNumber": [],
                                "GeometryOffset": 335,
                                "TurnStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Left",
                                    "TurnIntensity": "Typical"
                                },
                                "Type": "Turn"
                            },
                            {
                                "Distance": 0,
                                "Duration": 0,
                                "ExitNumber": [],
                                "GeometryOffset": 337,
                                "Type": "Arrive"
                            }
                        ],
                        "TruckRoadTypes": [],
                        "Zones": []
                    }
                }
            ],
            "MajorRoadLabels": [
                {
                    "RouteNumber": {
                        "Language": "en",
                        "Value": "HWY-1A"
                    }
                },
                {
                    "RoadName": {
                        "Language": "en",
                        "Value": "Nanaimo St"
                    }
                }
            ]
        }
    ]
}
```

------
#### [ cURL ]

```
curl --request POST \
  --url 'https://routes.geo.eu-central-1.amazonaws.com/v2/routes?key=Your_key' \
  --header 'Content-Type: application/json' \
  --data '{
  "Origin": [
    -123.116655,
    49.281538
  ],
  "Destination": [
    -123.01791785749363,
    49.22782762759908
  ],
  "TravelMode": "Car",
  "Avoid": {
    "Areas": [
      {
        "Geometry": {
          "polygon": [
            [
              [
                -123.06953,
                49.256419
              ],
              [
                -123.080486,
                49.242115
              ],
              [
                -123.058573,
                49.242115
              ],
              [
                -123.06953,
                49.256419
              ]
            ]
          ]
        }
      }
    ]
  }
}'
```

------
#### [ AWS CLI ]

```
aws geo-routes calculate-routes --key ${YourKey} \
--origin -123.13277 49.281538 \
--destination -123.01791785749363 49.22782762759908 \
--travel-mode "Car" \
--avoid '{"Areas":[{"Geometry":{"Polygon":[[[-123.06953,49.256419],[-123.05167,49.242115],[-123.02381,49.242115],[-123.06953,49.256419]]]}}]}'
```

------

### Verwenden Sie CalculateRoutes with PolylinePolygon , um benutzerdefinierte Routen zu erstellen.
<a name="calculate-routes-custom-avoidance-poly-polyline"></a>

------
#### [ Sample request ]

```
{
    "Origin": [
        -123.116655,
        49.281538
    ],
    "Destination": [
        -123.01791785749363,
        49.22782762759908
    ],
    "TravelMode": "Car",
    "Avoid": {
        "Areas": [
            {
                "Geometry": {
                    "PolylinePolygon": [
                        "BF0s0sJxglvXr5CvkCAgpEs5CvkC"
                    ]
                }
            }
        ]
    }
}
```

------
#### [ Sample response ]

```
{
    "LegGeometryFormat": "FlexiblePolyline",
    "Notices": [],
    "Routes": [
        {
            "Legs": [
                {
                    "Geometry": {
                        "Polyline": "Redacted"
                    },
                    "TravelMode": "Car",
                    "Type": "Vehicle",
                    "VehicleLegDetails": {
                        "AfterTravelSteps": [],
                        "Arrival": {
                            "Place": {
                                "ChargingStation": false,
                                "OriginalPosition": [
                                    -123.0179179,
                                    49.2278276
                                ],
                                "Position": [
                                    -123.0229001,
                                    49.22883
                                ]
                            }
                        },
                        "Departure": {
                            "Place": {
                                "ChargingStation": false,
                                "OriginalPosition": [
                                    -123.116655,
                                    49.281538
                                ],
                                "Position": [
                                    -123.1166332,
                                    49.2815528
                                ]
                            }
                        },
                        "Incidents": [],
                        "Notices": [],
                        "PassThroughWaypoints": [],
                        "Spans": [],
                        "Tolls": [],
                        "TollSystems": [],
                        "TravelSteps": [
                            {
                                "Distance": 1144,
                                "Duration": 85,
                                "ExitNumber": [],
                                "GeometryOffset": 0,
                                "Type": "Depart"
                            },
                            {
                                "Distance": 262,
                                "Duration": 24,
                                "ExitNumber": [],
                                "GeometryOffset": 35,
                                "RampStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right"
                                },
                                "Type": "Ramp"
                            },
                            {
                                "Distance": 433,
                                "Duration": 47,
                                "ExitNumber": [],
                                "GeometryOffset": 40,
                                "TurnStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right",
                                    "TurnIntensity": "Typical"
                                },
                                "Type": "Turn"
                            },
                            {
                                "Distance": 1131,
                                "Duration": 81,
                                "ExitNumber": [],
                                "GeometryOffset": 54,
                                "TurnStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Left",
                                    "TurnIntensity": "Typical"
                                },
                                "Type": "Turn"
                            },
                            {
                                "Distance": 54,
                                "Duration": 4,
                                "ExitNumber": [],
                                "GeometryOffset": 79,
                                "Type": "Continue"
                            },
                            {
                                "Distance": 520,
                                "Duration": 39,
                                "ExitNumber": [],
                                "GeometryOffset": 83,
                                "Type": "Continue"
                            },
                            {
                                "Distance": 1123,
                                "Duration": 111,
                                "ExitNumber": [],
                                "GeometryOffset": 101,
                                "TurnStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right",
                                    "TurnIntensity": "Typical"
                                },
                                "Type": "Turn"
                            },
                            {
                                "Distance": 1131,
                                "Duration": 81,
                                "ExitNumber": [],
                                "GeometryOffset": 141,
                                "TurnStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Left",
                                    "TurnIntensity": "Typical"
                                },
                                "Type": "Turn"
                            },
                            {
                                "Distance": 448,
                                "Duration": 34,
                                "ExitNumber": [],
                                "GeometryOffset": 167,
                                "Type": "Continue"
                            },
                            {
                                "Distance": 1797,
                                "Duration": 151,
                                "ExitNumber": [],
                                "GeometryOffset": 182,
                                "TurnStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right",
                                    "TurnIntensity": "Typical"
                                },
                                "Type": "Turn"
                            },
                            {
                                "Distance": 2836,
                                "Duration": 224,
                                "ExitNumber": [],
                                "GeometryOffset": 222,
                                "TurnStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Left",
                                    "TurnIntensity": "Typical"
                                },
                                "Type": "Turn"
                            },
                            {
                                "Distance": 339,
                                "Duration": 30,
                                "ExitNumber": [],
                                "GeometryOffset": 326,
                                "TurnStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right",
                                    "TurnIntensity": "Typical"
                                },
                                "Type": "Turn"
                            },
                            {
                                "Distance": 64,
                                "Duration": 23,
                                "ExitNumber": [],
                                "GeometryOffset": 335,
                                "TurnStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Left",
                                    "TurnIntensity": "Typical"
                                },
                                "Type": "Turn"
                            },
                            {
                                "Distance": 0,
                                "Duration": 0,
                                "ExitNumber": [],
                                "GeometryOffset": 337,
                                "Type": "Arrive"
                            }
                        ],
                        "TruckRoadTypes": [],
                        "Zones": []
                    }
                }
            ],
            "MajorRoadLabels": [
                {
                    "RouteNumber": {
                        "Language": "en",
                        "Value": "HWY-1A"
                    }
                },
                {
                    "RoadName": {
                        "Language": "en",
                        "Value": "Nanaimo St"
                    }
                }
            ]
        }
    ]
}
```

------
#### [ cURL ]

```
curl --request POST \
  --url 'https://routes.geo.eu-central-1.amazonaws.com/v2/routes?key=Your_key' \
  --header 'Content-Type: application/json' \
  --data '{
  "Origin": [
    -123.116655,
    49.281538
  ],
  "Destination": [
    -123.01791785749363,
    49.22782762759908
  ],
  "TravelMode": "Car",
  "Avoid": {
    "Areas": [
      {
        "Geometry": {
          "PolylinePolygon": [
            "BF0s0sJxglvXr5CvkCAgpEs5CvkC"
          ]
        }
      }
    ]
  }
}'
```

------
#### [ AWS CLI ]

```
aws geo-routes calculate-routes --key ${YourKey} \
--origin -123.13277 49.281538 \
--destination -123.01791785749363 49.22782762759908 \
--travel-mode "Car" \
--avoid '{"Areas":[{"Geometry":{"PolylinePolygon":["BF0s0sJxglvXr5CvkCAgpEs5CvkC"]}}]}'
```

------

### Verwenden Sie CalculateRoutes mit avoid Corridor, um benutzerdefinierte Routen zu erstellen.
<a name="calculate-routes-custom-avoidance-corridor"></a>

------
#### [ Sample request ]

```
{
    "Origin": [
        -123.116655,
        49.281538
    ],
    "Destination": [
        -123.01791785749363,
        49.22782762759908
    ],
    "TravelMode": "Car",
    "Avoid": {
        "Areas": [
            {
                "Geometry": {
                    "PolylineCorridor": {
                        "Polyline": "Redacted",
                        "Radius": 10
                    }
                }
            }
        ]
    }
}
```

------
#### [ Sample response ]

```
{
    "LegGeometryFormat": "FlexiblePolyline",
    "Notices": [],
    "Routes": [
        {
            "Legs": [
                {
                    "Geometry": {
                        "Polyline": "Redacted"
                    },
                    "TravelMode": "Car",
                    "Type": "Vehicle",
                    "VehicleLegDetails": {
                        "AfterTravelSteps": [],
                        "Arrival": {
                            "Place": {
                                "ChargingStation": false,
                                "OriginalPosition": [
                                    -123.0179179,
                                    49.2278276
                                ],
                                "Position": [
                                    -123.0229001,
                                    49.22883
                                ]
                            }
                        },
                        "Departure": {
                            "Place": {
                                "ChargingStation": false,
                                "OriginalPosition": [
                                    -123.116655,
                                    49.281538
                                ],
                                "Position": [
                                    -123.1166332,
                                    49.2815528
                                ]
                            }
                        },
                        "Incidents": [],
                        "Notices": [],
                        "PassThroughWaypoints": [],
                        "Spans": [],
                        "Tolls": [],
                        "TollSystems": [],
                        "TravelSteps": [
                            {
                                "Distance": 1144,
                                "Duration": 85,
                                "ExitNumber": [],
                                "GeometryOffset": 0,
                                "Type": "Depart"
                            },
                            {
                                "Distance": 262,
                                "Duration": 24,
                                "ExitNumber": [],
                                "GeometryOffset": 35,
                                "RampStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right"
                                },
                                "Type": "Ramp"
                            },
                            {
                                "Distance": 1356,
                                "Duration": 134,
                                "ExitNumber": [],
                                "GeometryOffset": 40,
                                "TurnStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right",
                                    "TurnIntensity": "Typical"
                                },
                                "Type": "Turn"
                            },
                            {
                                "Distance": 2468,
                                "Duration": 204,
                                "ExitNumber": [],
                                "GeometryOffset": 90,
                                "KeepStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Left"
                                },
                                "Type": "Keep"
                            },
                            {
                                "Distance": 1100,
                                "Duration": 88,
                                "ExitNumber": [],
                                "GeometryOffset": 170,
                                "TurnStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right",
                                    "TurnIntensity": "Typical"
                                },
                                "Type": "Turn"
                            },
                            {
                                "Distance": 1588,
                                "Duration": 133,
                                "ExitNumber": [],
                                "GeometryOffset": 214,
                                "TurnStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Left",
                                    "TurnIntensity": "Typical"
                                },
                                "Type": "Turn"
                            },
                            {
                                "Distance": 47,
                                "Duration": 14,
                                "ExitNumber": [],
                                "GeometryOffset": 260,
                                "Type": "Continue"
                            },
                            {
                                "Distance": 2478,
                                "Duration": 196,
                                "ExitNumber": [],
                                "GeometryOffset": 265,
                                "TurnStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right",
                                    "TurnIntensity": "Typical"
                                },
                                "Type": "Turn"
                            },
                            {
                                "Distance": 339,
                                "Duration": 30,
                                "ExitNumber": [],
                                "GeometryOffset": 357,
                                "TurnStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right",
                                    "TurnIntensity": "Typical"
                                },
                                "Type": "Turn"
                            },
                            {
                                "Distance": 64,
                                "Duration": 23,
                                "ExitNumber": [],
                                "GeometryOffset": 366,
                                "TurnStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Left",
                                    "TurnIntensity": "Typical"
                                },
                                "Type": "Turn"
                            },
                            {
                                "Distance": 0,
                                "Duration": 0,
                                "ExitNumber": [],
                                "GeometryOffset": 368,
                                "Type": "Arrive"
                            }
                        ],
                        "TruckRoadTypes": [],
                        "Zones": []
                    }
                }
            ],
            "MajorRoadLabels": [
                {
                    "RouteNumber": {
                        "Language": "en",
                        "Value": "HWY-1A"
                    }
                }
            ]
        }
    ]
}
```

------
#### [ cURL ]

```
curl --request POST \
  --url 'https://routes.geo.eu-central-1.amazonaws.com/v2/routes?key=Your_key' \
  --header 'Content-Type: application/json' \
  --data '{
  "Origin": [
    -123.116655,
    49.281538
  ],
  "Destination": [
    -123.01791785749363,
    49.22782762759908
  ],
  "TravelMode": "Car",
  "Avoid": {
    "Areas": [
      {
        "Geometry": {
          "PolylineCorridor": {
            "Polyline": "Redacted",
            "Radius": 10
          }
        }
      }
    ]
  }
}'
```

------
#### [ AWS CLI ]

```
aws geo-routes calculate-routes --key ${YourKey} \
--origin -123.116655 49.281538 \
--destination -123.01791785749363 49.22782762759908 \
--travel-mode "Car" \
--avoid '{"Areas": [{"Geometry": {"PolylineCorridor": {"Polyline": "BF2mysJnmkvX5ekiC", "Radius": 10}}}]}'
```

------

### Verwenden Sie CalculateRoutes mit einem Avoid PolylineCorridor , um benutzerdefinierte Routen zu erstellen.
<a name="calculate-routes-custom-avoidance-polyline-corridor"></a>

------
#### [ Sample request ]

```
{
    "Origin": [
        -123.116655,
        49.281538
    ],
    "Destination": [
        -123.01791785749363,
        49.22782762759908
    ],
    "TravelMode": "Car",
    "Avoid": {
        "Areas": [
            {
                "Geometry": {
                    "Corridor": {
                        "LineString": [
                            [
                                -123.06532243038754,
                                49.245226301868776
                            ],
                            [
                                -123.0547357660333,
                                49.24030469850804
                            ]
                        ],
                        "Radius": 10
                    }
                }
            }
        ]
    }
}
```

------
#### [ Sample response ]

```
{
    "LegGeometryFormat": "FlexiblePolyline",
    "Notices": [],
    "Routes": [
        {
            "Legs": [
                {
                    "Geometry": {
                        "Polyline": "Redacted"
                    },
                    "TravelMode": "Car",
                    "Type": "Vehicle",
                    "VehicleLegDetails": {
                        "AfterTravelSteps": [],
                        "Arrival": {
                            "Place": {
                                "ChargingStation": false,
                                "OriginalPosition": [
                                    -123.0179179,
                                    49.2278276
                                ],
                                "Position": [
                                    -123.0229001,
                                    49.22883
                                ]
                            }
                        },
                        "Departure": {
                            "Place": {
                                "ChargingStation": false,
                                "OriginalPosition": [
                                    -123.116655,
                                    49.281538
                                ],
                                "Position": [
                                    -123.1166332,
                                    49.2815528
                                ]
                            }
                        },
                        "Incidents": [],
                        "Notices": [],
                        "PassThroughWaypoints": [],
                        "Spans": [],
                        "Tolls": [],
                        "TollSystems": [],
                        "TravelSteps": [
                            {
                                "Distance": 1144,
                                "Duration": 85,
                                "ExitNumber": [],
                                "GeometryOffset": 0,
                                "Type": "Depart"
                            },
                            {
                                "Distance": 262,
                                "Duration": 24,
                                "ExitNumber": [],
                                "GeometryOffset": 35,
                                "RampStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right"
                                },
                                "Type": "Ramp"
                            },
                            {
                                "Distance": 1356,
                                "Duration": 134,
                                "ExitNumber": [],
                                "GeometryOffset": 40,
                                "TurnStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right",
                                    "TurnIntensity": "Typical"
                                },
                                "Type": "Turn"
                            },
                            {
                                "Distance": 2468,
                                "Duration": 204,
                                "ExitNumber": [],
                                "GeometryOffset": 90,
                                "KeepStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Left"
                                },
                                "Type": "Keep"
                            },
                            {
                                "Distance": 1100,
                                "Duration": 88,
                                "ExitNumber": [],
                                "GeometryOffset": 170,
                                "TurnStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right",
                                    "TurnIntensity": "Typical"
                                },
                                "Type": "Turn"
                            },
                            {
                                "Distance": 1588,
                                "Duration": 133,
                                "ExitNumber": [],
                                "GeometryOffset": 214,
                                "TurnStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Left",
                                    "TurnIntensity": "Typical"
                                },
                                "Type": "Turn"
                            },
                            {
                                "Distance": 47,
                                "Duration": 14,
                                "ExitNumber": [],
                                "GeometryOffset": 260,
                                "Type": "Continue"
                            },
                            {
                                "Distance": 2478,
                                "Duration": 196,
                                "ExitNumber": [],
                                "GeometryOffset": 265,
                                "TurnStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right",
                                    "TurnIntensity": "Typical"
                                },
                                "Type": "Turn"
                            },
                            {
                                "Distance": 339,
                                "Duration": 30,
                                "ExitNumber": [],
                                "GeometryOffset": 357,
                                "TurnStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right",
                                    "TurnIntensity": "Typical"
                                },
                                "Type": "Turn"
                            },
                            {
                                "Distance": 64,
                                "Duration": 23,
                                "ExitNumber": [],
                                "GeometryOffset": 366,
                                "TurnStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Left",
                                    "TurnIntensity": "Typical"
                                },
                                "Type": "Turn"
                            },
                            {
                                "Distance": 0,
                                "Duration": 0,
                                "ExitNumber": [],
                                "GeometryOffset": 368,
                                "Type": "Arrive"
                            }
                        ],
                        "TruckRoadTypes": [],
                        "Zones": []
                    }
                }
            ],
            "MajorRoadLabels": [
                {
                    "RouteNumber": {
                        "Language": "en",
                        "Value": "HWY-1A"
                    }
                }
            ]
        }
    ]
}
```

------
#### [ cURL ]

```
curl --request POST \
  --url 'https://routes.geo.eu-central-1.amazonaws.com/v2/routes?key=Your_key' \
  --header 'Content-Type: application/json' \
  --data '{
  "Origin": [
    -123.116655,
    49.281538
  ],
  "Destination": [
    -123.01791785749363,
    49.22782762759908
  ],
  "TravelMode": "Car",
  "Avoid": {
    "Areas": [
      {
        "Geometry": {
          "Corridor": {
            "LineString": [
              [
                -123.06532243038754,
                49.245226301868776
              ],
              [
                -123.0547357660333,
                49.24030469850804
              ]
            ],
            "Radius": 10
          }
        }
      }
    ]
  }
}'
```

------
#### [ AWS CLI ]

```
aws geo-routes calculate-routes --key ${YourKey} \
--origin -123.13277 49.281538 \
--destination -123.01791785749363 49.22782762759908 \
--travel-mode "Car" \
--avoid '{"Areas":[{"Geometry":{"Corridor":{"LineString":[[-123.06532243038754,49.245226301868776],[-123.0547357660333,49.24030469850804]],"Radius":10}}}]}'
```

------

# So erstellen Sie Routen mit benutzerdefinierter Vermeidung mehrerer potenzieller Elemente
<a name="calculate-routes-custom-avoidance-multiple"></a>

Die CalculateRoutes API hilft Ihnen dabei, die besten Routen zwischen Abfahrts- und Zielort sowie die besten Ruhezeiten für Fahrer zu finden. Es unterstützt Reisemodi wie Auto, LKW, Fußgänger und Roller. Es unterstützt auch bis zu 25 Wegpunkte (Zwischenstopps), einschließlich Start- und Zielort, mit nur wenigen Einschränkungen.

## Mögliche Anwendungsfälle
<a name="potential-use-cases"></a>
+ **Routen mit benutzerdefinierter Vermeidung berechnen:** Passen Sie Routen mit Vermeidungsmöglichkeiten an, um bessere Routen und Pendelwege zu planen.

## Beispiele
<a name="calculate-routes-examples"></a>

### Verwenden Sie es CalculateRoutes unter Vermeidung von Mautgebühren, Kehrtwenden, Fähren, Autobahnen, Tunneln und mehr.
<a name="calculate-routes-custom-avoidance-tolls-ferries"></a>

------
#### [ Sample request ]

```
{
    "Origin": [
        -123.118105,
        49.282423
    ],
    "Destination": [
        -123.020098,
        49.232872
    ],
    "TravelMode": "Car",
    "Avoid": {
        "TollRoads": true,
        "UTurns": true,
        "Ferries": true,
        "ControlledAccessHighways": true,
        "Tunnels": true
    }
}
```

------
#### [ Sample response ]

```
{
    "LegGeometryFormat": "FlexiblePolyline",
    "Notices": [],
    "Routes": [
        {
            "Legs": [
                {
                    "Geometry": {
                        "Polyline": "Redacted"
                    },
                    "TravelMode": "Car",
                    "Type": "Vehicle",
                    "VehicleLegDetails": {
                        "AfterTravelSteps": [],
                        "Arrival": {
                            "Place": {
                                "ChargingStation": false,
                                "OriginalPosition": [
                                    -123.020098,
                                    49.232872
                                ],
                                "Position": [
                                    -123.0203051,
                                    49.2328499
                                ]
                            }
                        },
                        "Departure": {
                            "Place": {
                                "ChargingStation": false,
                                "OriginalPosition": [
                                    -123.1181051,
                                    49.282423
                                ],
                                "Position": [
                                    -123.1180883,
                                    49.2824349
                                ]
                            }
                        },
                        "Incidents": [],
                        "Notices": [],
                        "PassThroughWaypoints": [],
                        "Spans": [],
                        "Tolls": [],
                        "TollSystems": [],
                        "TravelSteps": [
                            {
                                "Distance": 1288,
                                "Duration": 102,
                                "ExitNumber": [],
                                "GeometryOffset": 0,
                                "Type": "Depart"
                            },
                            {
                                "Distance": 262,
                                "Duration": 24,
                                "ExitNumber": [],
                                "GeometryOffset": 37,
                                "RampStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right"
                                },
                                "Type": "Ramp"
                            },
                            {
                                "Distance": 1356,
                                "Duration": 134,
                                "ExitNumber": [],
                                "GeometryOffset": 42,
                                "TurnStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right",
                                    "TurnIntensity": "Typical"
                                },
                                "Type": "Turn"
                            },
                            {
                                "Distance": 7092,
                                "Duration": 568,
                                "ExitNumber": [],
                                "GeometryOffset": 92,
                                "KeepStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Left"
                                },
                                "Type": "Keep"
                            },
                            {
                                "Distance": 65,
                                "Duration": 26,
                                "ExitNumber": [],
                                "GeometryOffset": 337,
                                "TurnStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Left",
                                    "TurnIntensity": "Typical"
                                },
                                "Type": "Turn"
                            },
                            {
                                "Distance": 50,
                                "Duration": 18,
                                "ExitNumber": [],
                                "GeometryOffset": 339,
                                "TurnStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right",
                                    "TurnIntensity": "Typical"
                                },
                                "Type": "Turn"
                            },
                            {
                                "Distance": 0,
                                "Duration": 0,
                                "ExitNumber": [],
                                "GeometryOffset": 343,
                                "Type": "Arrive"
                            }
                        ],
                        "TruckRoadTypes": [],
                        "Zones": []
                    }
                }
            ],
            "MajorRoadLabels": [
                {
                    "RouteNumber": {
                        "Language": "en",
                        "Value": "HWY-1A"
                    }
                }
            ]
        }
    ]
}
```

------
#### [ cURL ]

```
curl --request POST \
  --url 'https://routes.geo.eu-central-1.amazonaws.com/v2/routes?key=Your_key' \
  --header 'Content-Type: application/json' \
  --data '{
  "Origin": [
    -123.118105,
    49.282423
  ],
  "Destination": [
    -123.020098,
    49.232872
  ],
  "TravelMode": "Car",
  "Avoid": {
    "TollRoads": true,
    "UTurns": true,
    "Ferries": true,
    "ControlledAccessHighways": true,
    "Tunnels": true
  }
}'
```

------
#### [ AWS CLI ]

```
aws geo-routes calculate-routes --key ${YourKey} \
--origin -123.118105 49.282423 \
--destination -123.020098 49.232872 \
--travel-mode "Car" \
--avoid '{"TollRoads": true, "UTurns": true, "Ferries": true, "ControlledAccessHighways": true, "Tunnels": true}'
```

------

# So finden Sie die schnellste Route
<a name="calculate-routes-custom-avoidance-fast"></a>

Die CalculateRoutes API hilft Ihnen dabei, die schnellsten Routen zwischen Start- und Zielort zu finden.

## Mögliche Anwendungsfälle
<a name="calculate-routes-fast-potential-use"></a>
+ **Optimieren Sie Routen im Hinblick auf Zeiteffizienz:** Verbessern Sie die Lieferabläufe, indem Sie die schnellste Route berechnen. Dies ist nützlich, um die Reisezeit in Logistik- und Lieferdiensten zu verkürzen.

## Beispiele
<a name="calculate-routes-fast-examples"></a>

### Berechne die schnellste Route
<a name="calculate-routes-fast-car"></a>

------
#### [ Sample request ]

```
{
    "Origin": [
        -123.118105,
        49.282423
    ],
    "Destination": [
        -123.020098,
        49.232872
    ],
    "TravelMode": "Car",
    "OptimizeRoutingFor": "FastestRoute"
}
```

------
#### [ Sample response ]

```
{
    "LegGeometryFormat": "FlexiblePolyline",
    "Notices": [],
    "Routes": [
        {
            "Legs": [
                {
                    "Geometry": {
                        "Polyline": "Redacted"
                    },
                    "TravelMode": "Car",
                    "Type": "Vehicle",
                    "VehicleLegDetails": {
                        "AfterTravelSteps": [],
                        "Arrival": {
                            "Place": {
                                "ChargingStation": false,
                                "OriginalPosition": [
                                    -123.020098,
                                    49.232872
                                ],
                                "Position": [
                                    -123.0203051,
                                    49.2328499
                                ]
                            }
                        },
                        "Departure": {
                            "Place": {
                                "ChargingStation": false,
                                "OriginalPosition": [
                                    -123.1181051,
                                    49.282423
                                ],
                                "Position": [
                                    -123.1180883,
                                    49.2824349
                                ]
                            }
                        },
                        "Incidents": [],
                        "Notices": [],
                        "PassThroughWaypoints": [],
                        "Spans": [],
                        "Tolls": [],
                        "TollSystems": [],
                        "TravelSteps": [
                            {
                                "Distance": 1288,
                                "Duration": 102,
                                "ExitNumber": [],
                                "GeometryOffset": 0,
                                "Type": "Depart"
                            },
                            {
                                "Distance": 262,
                                "Duration": 24,
                                "ExitNumber": [],
                                "GeometryOffset": 37,
                                "RampStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right"
                                },
                                "Type": "Ramp"
                            },
                            {
                                "Distance": 1356,
                                "Duration": 134,
                                "ExitNumber": [],
                                "GeometryOffset": 42,
                                "TurnStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right",
                                    "TurnIntensity": "Typical"
                                },
                                "Type": "Turn"
                            },
                            {
                                "Distance": 7092,
                                "Duration": 568,
                                "ExitNumber": [],
                                "GeometryOffset": 92,
                                "KeepStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Left"
                                },
                                "Type": "Keep"
                            },
                            {
                                "Distance": 65,
                                "Duration": 26,
                                "ExitNumber": [],
                                "GeometryOffset": 337,
                                "TurnStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Left",
                                    "TurnIntensity": "Typical"
                                },
                                "Type": "Turn"
                            },
                            {
                                "Distance": 50,
                                "Duration": 18,
                                "ExitNumber": [],
                                "GeometryOffset": 339,
                                "TurnStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right",
                                    "TurnIntensity": "Typical"
                                },
                                "Type": "Turn"
                            },
                            {
                                "Distance": 0,
                                "Duration": 0,
                                "ExitNumber": [],
                                "GeometryOffset": 343,
                                "Type": "Arrive"
                            }
                        ],
                        "TruckRoadTypes": [],
                        "Zones": []
                    }
                }
            ],
            "MajorRoadLabels": [
                {
                    "RouteNumber": {
                        "Language": "en",
                        "Value": "HWY-1A"
                    }
                }
            ]
        }
    ]
}
```

------
#### [ cURL ]

```
curl --request POST \
  --url 'https://routes.geo.eu-central-1.amazonaws.com/v2/routes?key=Your_key' \
  --header 'Content-Type: application/json' \
  --data '{
  "Origin": [
    -123.118105,
    49.282423
  ],
  "Destination": [
    -123.020098,
    49.232872
  ],
  "TravelMode": "Car",
  "OptimizeRoutingFor": "FastestRoute"
}'
```

------
#### [ AWS CLI ]

```
aws geo-routes calculate-routes --key ${YourKey} \
--origin -123.118105 49.282423 \
--destination -123.020098 49.232872 \
--travel-mode "Car" \
--optimize-routing-for "FastestRoute"
```

------

# So finden Sie die kürzesten Routen
<a name="calculate-routes-custom-avoidance-shortest"></a>

Die CalculateRoutes API hilft Ihnen dabei, die kürzesten Strecken zwischen Start- und Zielort zu finden.

## Mögliche Anwendungsfälle
<a name="calculate-routes-short-potential-use"></a>
+ **Optimieren Sie Routen im Hinblick auf Zeiteffizienz:** Verbessern Sie die Lieferabläufe, indem Sie die kürzeste Route berechnen. Dies ist nützlich, um die Reisedistanz bei Logistik- und Lieferdiensten zu reduzieren.

## Beispiele
<a name="calculate-routes-short-examples"></a>

### Wird verwendet CalculateRoutes , um die kürzeste Route zu finden und Reisedistanz zu sparen.
<a name="calculate-routes-shortest"></a>

------
#### [ Sample request ]

```
{
    "Origin": [
        -123.118105,
        49.282423
    ],
    "Destination": [
        -123.020098,
        49.232872
    ],
    "TravelMode": "Car",
    "OptimizeRoutingFor": "ShortestRoute"
}
```

------
#### [ Sample response ]

```
{
    "LegGeometryFormat": "FlexiblePolyline",
    "Notices": [],
    "Routes": [
        {
            "Legs": [
                {
                    "Geometry": {
                        "Polyline": "Redacted"
                    },
                    "TravelMode": "Car",
                    "Type": "Vehicle",
                    "VehicleLegDetails": {
                        "AfterTravelSteps": [],
                        "Arrival": {
                            "Place": {
                                "ChargingStation": false,
                                "OriginalPosition": [
                                    -123.020098,
                                    49.232872
                                ],
                                "Position": [
                                    -123.0203051,
                                    49.2328499
                                ]
                            }
                        },
                        "Departure": {
                            "Place": {
                                "ChargingStation": false,
                                "OriginalPosition": [
                                    -123.1181051,
                                    49.282423
                                ],
                                "Position": [
                                    -123.1180883,
                                    49.2824349
                                ]
                            }
                        },
                        "Incidents": [],
                        "Notices": [],
                        "PassThroughWaypoints": [],
                        "Spans": [],
                        "Tolls": [],
                        "TollSystems": [],
                        "TravelSteps": [
                            {
                                "Distance": 1288,
                                "Duration": 102,
                                "ExitNumber": [],
                                "GeometryOffset": 0,
                                "Type": "Depart"
                            },
                            {
                                "Distance": 262,
                                "Duration": 24,
                                "ExitNumber": [],
                                "GeometryOffset": 37,
                                "RampStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right"
                                },
                                "Type": "Ramp"
                            },
                            {
                                "Distance": 1356,
                                "Duration": 134,
                                "ExitNumber": [],
                                "GeometryOffset": 42,
                                "TurnStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right",
                                    "TurnIntensity": "Typical"
                                },
                                "Type": "Turn"
                            },
                            {
                                "Distance": 7092,
                                "Duration": 568,
                                "ExitNumber": [],
                                "GeometryOffset": 92,
                                "KeepStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Left"
                                },
                                "Type": "Keep"
                            },
                            {
                                "Distance": 65,
                                "Duration": 26,
                                "ExitNumber": [],
                                "GeometryOffset": 337,
                                "TurnStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Left",
                                    "TurnIntensity": "Typical"
                                },
                                "Type": "Turn"
                            },
                            {
                                "Distance": 50,
                                "Duration": 18,
                                "ExitNumber": [],
                                "GeometryOffset": 339,
                                "TurnStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right",
                                    "TurnIntensity": "Typical"
                                },
                                "Type": "Turn"
                            },
                            {
                                "Distance": 0,
                                "Duration": 0,
                                "ExitNumber": [],
                                "GeometryOffset": 343,
                                "Type": "Arrive"
                            }
                        ],
                        "TruckRoadTypes": [],
                        "Zones": []
                    }
                }
            ],
            "MajorRoadLabels": [
                {
                    "RouteNumber": {
                        "Language": "en",
                        "Value": "HWY-1A"
                    }
                }
            ]
        }
    ]
}
```

------
#### [ cURL ]

```
curl --request POST \
  --url 'https://routes.geo.eu-central-1.amazonaws.com/v2/routes?key=Your_key' \
  --header 'Content-Type: application/json' \
  --data '{
    "Origin": [
        -123.118105,
        49.282423
    ],
    "Destination": [
        -123.020098,
        49.232872
    ],
    "TravelMode": "Car",
    "OptimizeRoutingFor": "ShortestRoute"
}'
```

------
#### [ AWS CLI ]

```
aws geo-routes calculate-routes --key ${YourKey} \
--origin -123.118105 49.282423 \
--destination -123.020098 49.232872 \
--travel-mode "Scooter" \
--optimize-routing-for "ShortestRoute"
```

------

# Lernen Sie, wie man es benutzt CalculateIsolines
<a name="calculate-isolines-how-to"></a>

In diesem Abschnitt erfahren Sie, wie Sie `CalculateIsolines` mit Zeit- oder Entfernungsbereichen arbeiten und wie Sie Bereiche festlegen, die vermieden werden sollen.

**Topics**
+ [So berechnen Sie ein Einzugsgebiet anhand von Zeiträumen](calculate-service-area-based-on-time.md)
+ [So berechnen Sie ein Einzugsgebiet anhand von Entfernungsbereichen](calculate-service-area-based-on-distance.md)
+ [So berechnen Sie ein Einzugsgebiet auf der Grundlage von Vermeidung](calculate-service-area-based-on-avoidance.md)

# So berechnen Sie ein Einzugsgebiet anhand von Zeiträumen
<a name="calculate-service-area-based-on-time"></a>

Die CalculateIsolines API ermöglicht es Ihnen, erreichbare Einzugsgebiete innerhalb bestimmter Zeit- oder Entfernungsbereiche zu ermitteln, wobei Straßennetze und Verkehrsbedingungen berücksichtigt werden. Diese Funktion unterstützt Anwendungen bei der Definition von Servicebereichen für Restaurants, Lebensmittelgeschäfte oder andere Dienstleister, was bei der Planung der Kraftstoffeffizienz und der Definition zugänglicher Bereiche für die Serviceabdeckung hilfreich sein kann.

## Mögliche Anwendungsfälle
<a name="calculate-service-area-time-potential-use"></a>
+ **Servicebereiche planen:** Verwenden Sie diese API, um zugängliche Bereiche für Dienstleistungen wie Restaurants oder Lebensmittellieferungen auf der Grundlage von Reisezeit oder Entfernung zu planen.

## Beispiele
<a name="calculate-service-area-time-examples"></a>

### Berechne mit Car ein Einzugsgebiet auf der Grundlage eines Zeitbereichs TravelMode
<a name="calculate-service-area-time"></a>

------
#### [ Sample request ]

```
{
    "Origin": [
        -123.11679620827039,
        49.28147612192166
    ],
    "DepartureTime": "2024-10-28T21:27:56Z",
    "Thresholds": {
        "Time": [
            500,
            1000,
            1500
        ]
    },
    "TravelMode": "Car"
}
```

------
#### [ Sample response ]

```
{
    "DepartureTime": "2024-10-28T14:27:56-07:00",
    "IsolineGeometryFormat": "FlexiblePolyline",
    "Isolines": [
        {
            "Connections": [],
            "Geometries": [
                {
                    "PolylinePolygon": [
                        "Redacted"
                    ]
                }
            ],
            "TimeThreshold": 500
        },
        {
            "Connections": [],
            "Geometries": [
                {
                    "PolylinePolygon": [
                        "Redacted"
                    ]
                }
            ],
            "TimeThreshold": 1000
        },
        {
            "Connections": [],
            "Geometries": [
                {
                    "PolylinePolygon": [
                        "Redacted"
                    ]
                }
            ],
            "TimeThreshold": 1500
        }
    ],
    "SnappedOrigin": [
        -123.11687,
        49.2813999
    ]
}
```

------
#### [ cURL ]

```
curl --request POST \
  --url 'https://routes.geo.eu-central-1.amazonaws.com/v2/isolines?key=Your_key' \
  --header 'Content-Type: application/json' \
  --data '{
    "Origin": [
        -123.11679620827039,
        49.28147612192166
    ],
    "DepartureTime": "2024-10-28T21:27:56Z",
    "Thresholds": {
        "Time": [
            500,
            1000,
            1500
        ]
    },
    "TravelMode": "Car"
}'
```

------
#### [ AWS CLI ]

```
aws geo-routes calculate-isolines --key ${YourKey} \
--origin -123.11679620827039 49.28147612192166 \
--departure-time "2024-10-28T21:27:56Z" \
--thresholds '{"Time": [500, 1000, 1500]}' \
--travel-mode "Car"
```

------

# So berechnen Sie ein Einzugsgebiet anhand von Entfernungsbereichen
<a name="calculate-service-area-based-on-distance"></a>

Die CalculateIsolines API ermöglicht es Ihnen, erreichbare Einzugsgebiete innerhalb bestimmter Zeit- oder Entfernungsbereiche zu ermitteln, wobei Straßennetze und Verkehrsbedingungen berücksichtigt werden. Diese Funktion unterstützt Anwendungen bei der Definition von Servicebereichen für Restaurants, Lebensmittelgeschäfte oder andere Dienstleister, was bei der Planung der Kraftstoffeffizienz und der Definition zugänglicher Bereiche für die Serviceabdeckung hilfreich sein kann.

## Mögliche Anwendungsfälle
<a name="calculate-service-area-distance-potential-use"></a>
+ **Servicebereiche planen:** Verwenden Sie diese API, um zugängliche Bereiche für Dienstleistungen wie Restaurants oder Lebensmittellieferungen auf der Grundlage von Reisezeit oder Entfernung zu planen.

## Beispiele
<a name="calculate-service-area-distance-examples"></a>

### Berechne mit Car ein Einzugsgebiet auf der Grundlage von Entfernungsbereichen TravelMode
<a name="calculate-service-area-distance"></a>

------
#### [ Sample request ]

```
{
    "Origin": [
        -123.11679620827039,
        49.28147612192166
    ],
    "DepartureTime": "2024-10-28T21:27:56Z",
    "Thresholds": {
        "Distance": [
            1000,
            2000,
            3000
        ]
    },
    "TravelMode": "Car"
}
```

------
#### [ Sample response ]

```
{
    "DepartureTime": "2024-10-28T14:27:56-07:00",
    "IsolineGeometryFormat": "FlexiblePolyline",
    "Isolines": [
        {
            "Connections": [],
            "DistanceThreshold": 1000,
            "Geometries": [
                {
                    "PolylinePolygon": [
                        "Redacted"
                    ]
                }
            ]
        },
        {
            "Connections": [],
            "DistanceThreshold": 2000,
            "Geometries": [
                {
                    "PolylinePolygon": [
                        "Redacted"
                    ]
                }
            ]
        },
        {
            "Connections": [],
            "DistanceThreshold": 3000,
            "Geometries": [
                {
                    "PolylinePolygon": [
                        "Redacted"
                    ]
                }
            ]
        }
    ],
    "SnappedOrigin": [
        -123.11687,
        49.2813999
    ]
}
```

------
#### [ cURL ]

```
curl --request POST \
  --url 'https://routes.geo.eu-central-1.amazonaws.com/v2/isolines?key=Your_key' \
  --header 'Content-Type: application/json' \
  --data '{
    "Origin": [
        -123.11679620827039,
        49.28147612192166
    ],
    "DepartureTime": "2024-10-28T21:27:56Z",
    "Thresholds": {
        "Distance": [
            1000,
            2000,
            3000
        ]
    },
    "TravelMode": "Car"
}'
```

------
#### [ AWS CLI ]

```
aws geo-routes calculate-isolines --key ${YourKey} \
--origin -123.11679620827039 49.28147612192166 \
--departure-time "2024-10-28T21:27:56Z" \
--thresholds '{"Distance": [1000, 2000, 3000]}' \
--travel-mode "Car"
```

------

# So berechnen Sie ein Einzugsgebiet auf der Grundlage von Vermeidung
<a name="calculate-service-area-based-on-avoidance"></a>

Die CalculateIsolines API ermöglicht es Ihnen, erreichbare Einzugsgebiete innerhalb bestimmter Zeit- oder Entfernungsbereiche zu ermitteln. Dabei werden Straßennetze und zu vermeidende Verkehrsbedingungen berücksichtigt. Diese Funktion unterstützt Anwendungen bei der Definition von Servicebereichen für Restaurants, Lebensmittelgeschäfte oder andere Dienstleister, was bei der Planung der Kraftstoffeffizienz und der Definition zugänglicher Bereiche für die Serviceabdeckung hilfreich sein kann.

## Mögliche Anwendungsfälle
<a name="calculate-service-area-avoidance-potential-use"></a>
+ **Servicebereiche planen:** Verwenden Sie diese API, um barrierefreie Bereiche für Dienstleistungen wie Restaurants oder Lebensmittellieferungen zu planen, indem Sie sie vermeiden.

## Beispiele
<a name="calculate-service-area-avoidance-examples"></a>

### Berechne mit Car ein Einzugsgebiet auf der Grundlage von Vermeidungsmöglichkeiten TravelMode
<a name="calculate-service-area-avoidance-car"></a>

------
#### [ Sample request ]

```
{
    "Origin": [
        -123.11679620827039,
        49.28147612192166
    ],
    "DepartureTime": "2024-10-28T21:27:56Z",
    "Thresholds": {
        "Distance": [
            4000
        ]
    },
    "Avoid": {
        "TollRoads": true,
        "UTurns": true,
        "ControlledAccessHighways": true,
        "Ferries": true,
        "DirtRoads": true,
        "SeasonalClosure": true,
        "CarShuttleTrains": true,
        "TollTransponders": true,
        "ZoneCategories": [
            {
                "Category": "Environmental"
            }
        ]
    },
    "TravelMode": "Car"
}
```

------
#### [ Sample response ]

```
{
    "DepartureTime": "2024-10-28T14:27:56-07:00",
    "IsolineGeometryFormat": "FlexiblePolyline",
    "Isolines": [
        {
            "Connections": [],
            "DistanceThreshold": 4000,
            "Geometries": [
                {
                    "PolylinePolygon": [
                        "Redacted"
                    ]
                }
            ]
        }
    ],
    "SnappedOrigin": [
        -123.11687,
        49.2813999
    ]
}
```

------
#### [ cURL ]

```
curl --request POST \
  --url 'https://routes.geo.eu-central-1.amazonaws.com/v2/isolines?key=Your_key' \
  --header 'Content-Type: application/json' \
  --data '{
    "Origin": [
        -123.11679620827039,
        49.28147612192166
    ],
    "DepartureTime": "2024-10-28T21:27:56Z",
    "Thresholds": {
        "Distance": [
            4000
        ]
    },
    "Avoid": {
        "TollRoads": true,
        "UTurns": true,
        "ControlledAccessHighways": true,
        "Ferries": true,
        "DirtRoads": true,
        "SeasonalClosure": true,
        "CarShuttleTrains": true,
        "TollTransponders": true,
        "ZoneCategories": [
            {
                "Category": "Environmental"
            }
        ]
    },
    "TravelMode": "Car"
}'
```

------
#### [ AWS CLI ]

```
aws geo-routes calculate-isolines --key ${YourKey} \
--origin -123.11679620827039 49.28147612192166 \
--departure-time "2024-10-28T21:27:56Z" \
--thresholds '{"Distance": [4000]}' \
--avoid '{"TollRoads": true, "UTurns": true, "ControlledAccessHighways": true, "Ferries": true, "DirtRoads": true, "SeasonalClosure": true, "CarShuttleTrains": true, "TollTransponders": true, "ZoneCategories": [{"Category": "Environmental"}]}' \
--travel-mode "Car"
```

------

### Berechnen Sie mit Truck ein Einzugsgebiet auf der Grundlage von Vermeidungsmöglichkeiten TravelMode
<a name="calculate-service-area-avoidance-truck"></a>

------
#### [ Sample request ]

```
{
    "Origin": [
        -123.11679620827039,
        49.28147612192166
    ],
    "DepartureTime": "2024-10-28T21:27:56Z",
    "Thresholds": {
        "Distance": [
            4000
        ]
    },
    "Avoid": {
        "TollRoads": true,
        "UTurns": true,
        "ControlledAccessHighways": true,
        "Ferries": true,
        "DirtRoads": true,
        "SeasonalClosure": true,
        "CarShuttleTrains": true,
        "TollTransponders": true,
        "ZoneCategories": [
            {
                "Category": "Environmental"
            }
        ]
    },
    "TravelMode": "Truck"
}
```

------
#### [ Sample response ]

```
{
    "DepartureTime": "2024-10-28T14:27:56-07:00",
    "IsolineGeometryFormat": "FlexiblePolyline",
    "Isolines": [
        {
            "Connections": [],
            "DistanceThreshold": 4000,
            "Geometries": [
                {
                    "PolylinePolygon": [
                        "Redacted"
                    ]
                }
            ]
        }
    ],
    "SnappedOrigin": [
        -123.11687,
        49.2813999
    ]
}
```

------
#### [ cURL ]

```
curl --request POST \
  --url 'https://routes.geo.eu-central-1.amazonaws.com/v2/isolines?key=Your_key' \
  --header 'Content-Type: application/json' \
  --data '{
    "Origin": [
        -123.11679620827039,
        49.28147612192166
    ],
    "DepartureTime": "2024-10-28T21:27:56Z",
    "Thresholds": {
        "Distance": [
            4000
        ]
    },
    "Avoid": {
        "TollRoads": true,
        "UTurns": true,
        "ControlledAccessHighways": true,
        "Ferries": true,
        "DirtRoads": true,
        "SeasonalClosure": true,
        "CarShuttleTrains": true,
        "TollTransponders": true,
        "ZoneCategories": [
            {
                "Category": "Environmental"
            }
        ]
    },
    "TravelMode": "Truck"
}'
```

------
#### [ AWS CLI ]

```
aws geo-routes calculate-isolines --key ${YourKey} \
--origin -123.11679620827039 49.28147612192166 \
--departure-time "2024-10-28T21:27:56Z" \
--thresholds '{"Distance": [4000]}' \
--avoid '{"TollRoads": true, "UTurns": true, "ControlledAccessHighways": true, "Ferries": true, "DirtRoads": true, "SeasonalClosure": true, "CarShuttleTrains": true, "TollTransponders": true, "ZoneCategories": [{"Category": "Environmental"}]}' \
--travel-mode "Truck"
```

------

### Berechne ein Einzugsgebiet auf der Grundlage der Ausweichmanöver für Fußgänger
<a name="calculate-service-area-avoidance-truck"></a>

------
#### [ Sample request ]

```
{
    "Origin": [
        -123.11679620827039,
        49.28147612192166
    ],
    "DepartureTime": "2024-10-28T21:27:56Z",
    "Thresholds": {
        "Distance": [
            4000
        ]
    },
    "Avoid": {
        "TollRoads": true,
        "ControlledAccessHighways": true,
        "Ferries": true,
        "DirtRoads": true,
        "SeasonalClosure": true,
        "CarShuttleTrains": true,
        "TollTransponders": true,
        "ZoneCategories": [
            {
                "Category": "Environmental"
            }
        ]
    },
    "TravelMode": "Pedestrian"
}
```

------
#### [ Sample response ]

```
{
    "DepartureTime": "2024-10-28T14:27:56-07:00",
    "IsolineGeometryFormat": "FlexiblePolyline",
    "Isolines": [
        {
            "Connections": [],
            "DistanceThreshold": 4000,
            "Geometries": [
                {
                    "PolylinePolygon": [
                        "Redacted"
                    ]
                }
            ]
        }
    ],
    "SnappedOrigin": [
        -123.11687,
        49.2813999
    ]
}
```

------
#### [ cURL ]

```
curl --request POST \
  --url 'https://routes.geo.eu-central-1.amazonaws.com/v2/isolines?key=Your_key' \
  --header 'Content-Type: application/json' \
  --data '{
    "Origin": [
        -123.11679620827039,
        49.28147612192166
    ],
    "DepartureTime": "2024-10-28T21:27:56Z",
    "Thresholds": {
        "Distance": [
            4000
        ]
    },
    "Avoid": {
        "TollRoads": true,
        "ControlledAccessHighways": true,
        "Ferries": true,
        "DirtRoads": true,
        "SeasonalClosure": true,
        "CarShuttleTrains": true,
        "TollTransponders": true,
        "ZoneCategories": [
            {
                "Category": "Environmental"
            }
        ]
    },
    "TravelMode": "Pedestrian"
}'
```

------
#### [ AWS CLI ]

```
aws geo-routes calculate-isolines --key ${YourKey} \
--origin -123.11679620827039 49.28147612192166 \
--departure-time "2024-10-28T21:27:56Z" \
--thresholds '{"Distance": [4000]}' \
--avoid '{"TollRoads": true, "ControlledAccessHighways": true, "Ferries": true, "DirtRoads": true, "SeasonalClosure": true, "CarShuttleTrains": true, "TollTransponders": true, "ZoneCategories": [{"Category": "Environmental"}]}' \
--travel-mode "Pedestrian"
```

------

### Berechne mit Scooter ein Einzugsgebiet, das auf der Vermeidung basiert TravelMode
<a name="calculate-service-area-avoidance-scooter"></a>

------
#### [ Sample request ]

```
{
    "Origin": [
        -123.11679620827039,
        49.28147612192166
    ],
    "DepartureTime": "2024-10-28T21:27:56Z",
    "Thresholds": {
        "Distance": [
            4000
        ]
    },
    "Avoid": {
        "TollRoads": true,
        "ControlledAccessHighways": true,
        "DifficultTurns": false,
        "Ferries": true,
        "DirtRoads": true,
        "SeasonalClosure": true,
        "CarShuttleTrains": true,
        "TollTransponders": true,
        "ZoneCategories": [
            {
                "Category": "Environmental"
            }
        ]
    },
    "TravelMode": "Scooter"
}
```

------
#### [ Sample response ]

```
{
    "DepartureTime": "2024-10-28T14:27:56-07:00",
    "IsolineGeometryFormat": "FlexiblePolyline",
    "Isolines": [
        {
            "Connections": [],
            "DistanceThreshold": 4000,
            "Geometries": [
                {
                    "PolylinePolygon": [
                        "Redacted"
                    ]
                }
            ]
        }
    ],
    "SnappedOrigin": [
        -123.11687,
        49.2813999
    ]
}
```

------
#### [ cURL ]

```
curl --request POST \
  --url 'https://routes.geo.eu-central-1.amazonaws.com/v2/isolines?key=Your_key' \
  --header 'Content-Type: application/json' \
  --data '{
    "Origin": [
        -123.11679620827039,
        49.28147612192166
    ],
    "DepartureTime": "2024-10-28T21:27:56Z",
    "Thresholds": {
        "Distance": [
            4000
        ]
    },
    "Avoid": {
        "TollRoads": true,
        "ControlledAccessHighways": true,
        "Ferries": true,
        "DirtRoads": true,
        "SeasonalClosure": true,
        "CarShuttleTrains": true,
        "TollTransponders": true,
        "ZoneCategories": [
            {
                "Category": "Environmental"
            }
        ]
    },
    "TravelMode": "Scooter"
}'
```

------
#### [ AWS CLI ]

```
aws geo-routes calculate-isolines --key ${YourKey} \
--origin -123.11679620827039 49.28147612192166 \
--departure-time "2024-10-28T21:27:56Z" \
--thresholds '{"Distance": [4000]}' \
--avoid '{"TollRoads": true, "ControlledAccessHighways": true, "Ferries": true, "DirtRoads": true, "SeasonalClosure": true, "CarShuttleTrains": true, "TollTransponders": true, "ZoneCategories": [{"Category": "Environmental"}]}' \
--travel-mode "Scooter"
```

------

# Lernen Sie, wie man es benutzt CalculateRouteMatrix
<a name="calculate-route-matrix-how-to"></a>

In diesem Abschnitt erfahren Sie, wie Sie `CalculateRouteMatrix` effiziente Routen für mehrere Start- und Zielorte finden können.

**Topics**
+ [So berechnen Sie eine Routenmatrix aus Entfernung und Zeit für mehrere Startpunkte und Ziele](calculate-route-matrix-distance.md)
+ [So berechnen Sie die Routenmatrix mit Vermeidung](calculate-route-matrix-with-avoidance.md)

# So berechnen Sie eine Routenmatrix aus Entfernung und Zeit für mehrere Startpunkte und Ziele
<a name="calculate-route-matrix-distance"></a>

Die CalculateRouteMatrix API berechnet Routen und bietet Reisezeit und Reisedistanz für jede Kombination von Start- und Zielorten. Diese Funktion ist nützlich für Anwendungen, die eine Routenplanung und -optimierung für mehrere Standorte erfordern.

Die Antwort erfolgt in Metern und `Distance` `Duration` in Sekunden für jedes Abfahrts- und Zielpaar.

## Mögliche Anwendungsfälle
<a name="calculate-route-matrix-potential-use"></a>
+ **Optimieren Sie die Routenplanung:** Verwenden Sie die Routenmatrix als Eingabe für die Routenoptimierungssoftware, um die Serviceeffizienz zu verbessern und die Reisezeit zu reduzieren.

## Beispiele
<a name="calculate-route-matrix-examples"></a>

### CalculateRouteMatrix mit einer unbegrenzten Routinggrenze
<a name="calculate-route-matrix-unbounded"></a>

------
#### [ Sample request ]

```
{
    "Origins": [
        {
            "Position": [-123.11679620827039, 49.28147612192166]
        },
        {
            "Position": [-123.11179620827039, 49.3014761219]
        }
    ],
    "Destinations": [
        {
            "Position": [-123.112317039, 49.28897192166]
        }
    ],
    "DepartureTime": "2024-05-28T21:27:56Z",
    "RoutingBoundary": {
        "Unbounded": true
    }
}
```

------
#### [ Sample response ]

```
{
    "ErrorCount": 0,
    "RouteMatrix": [
        [
            {
                "Distance": 1907,
                "Duration": 343
            }
        ],
        [
            {
                "Distance": 5629,
                "Duration": 954
            }
        ]
    ],
    "RoutingBoundary": {
        "Unbounded": true
    }
}
```

------
#### [ cURL ]

```
curl --request POST \
  --url 'https://routes.geo.eu-central-1.amazonaws.com/v2/route-matrix?key=Your_key' \
  --header 'Content-Type: application/json' \
  --data '{
    "Origins": [
        {
            "Position": [-123.11679620827039, 49.28147612192166]
        },
        {
            "Position": [-123.11179620827039, 49.3014761219]
        }
    ],
    "Destinations": [
        {
            "Position": [-123.112317039, 49.28897192166]
        }
    ],
    "DepartureTime": "2024-05-28T21:27:56Z",
    "RoutingBoundary": {
        "Unbounded": true
    }
}'
```

------
#### [ AWS CLI ]

```
aws geo-routes calculate-route-matrix --key ${YourKey} \
--origins '[{"Position": [-123.11679620827039, 49.28147612192166]}, {"Position": [-123.11179620827039, 49.3014761219]}]' \
--destinations '[{"Position": [-123.11179620827039, 49.28897192166]}]' \
--departure-time "2024-05-28T21:27:56Z" \
--routing-boundary '{"Unbounded": true}'
```

------

### CalculateRouteMatrix mit einer geometriebasierten Routing-Grenze
<a name="calculate-route-matrix-geometry"></a>

------
#### [ Sample request ]

```
{
    "Origins": [
        {
            "Position": [-123.11679620827039, 49.28147612192166]
        },
        {
            "Position": [-123.11179620827039, 49.3014761219]
        }
    ],
    "Destinations": [
        {
            "Position": [-123.112317039, 49.28897192166]
        }
    ],
    "DepartureTime": "2024-05-28T21:27:56Z",
    "RoutingBoundary": {
        "Geometry": {
            "AutoCircle": {
                "Margin": 10000,
                "MaxRadius": 30000
            }
        }
    }
}
```

------
#### [ Sample response ]

```
{
    "ErrorCount": 0,
    "RouteMatrix": [
        [
            {
                "Distance": 1907,
                "Duration": 344
            }
        ],
        [
            {
                "Distance": 5629,
                "Duration": 950
            }
        ]
    ],
    "RoutingBoundary": {
        "Geometry": {
            "Circle": {
                "Center": [
                    -123.1142962082704,
                    49.29147612191083
                ],
                "Radius": 11127
            }
        },
        "Unbounded": false
    }
}
```

------
#### [ cURL ]

```
curl --request POST \
  --url 'https://routes.geo.eu-central-1.amazonaws.com/v2/route-matrix?key=Your_key' \
  --header 'Content-Type: application/json' \
  --data '{
    "Origins": [
        {
            "Position": [-123.11679620827039, 49.28147612192166]
        },
        {
            "Position": [-123.11179620827039, 49.3014761219]
        }
    ],
    "Destinations": [
        {
            "Position": [-123.112317039, 49.28897192166]
        }
    ],
    "DepartureTime": "2024-05-28T21:27:56Z",
    "RoutingBoundary": {
        "Geometry": {
            "AutoCircle": {
                "Margin": 10000,
                "MaxRadius": 30000
            }
        }
    }
}'
```

------
#### [ AWS CLI ]

```
aws geo-routes calculate-route-matrix --key ${YourKey} \
--origins '[{"Position": [-123.11679620827039, 49.28147612192166]}, {"Position": [-123.11179620827039, 49.3014761219]}]' \
--destinations '[{"Position": [-123.11179620827039, 49.28897192166]}]' \
--departure-time "2024-05-28T21:27:56Z" \
--routing-boundary '{"Geometry": {"AutoCircle": {"Margin": 10000, "MaxRadius": 30000}}}'
```

------

# So berechnen Sie die Routenmatrix mit Vermeidung
<a name="calculate-route-matrix-with-avoidance"></a>

Die CalculateRouteMatrix API berechnet Routen und gibt Reisezeit und Entfernung von jedem Ausgangspunkt zu jedem Ziel in den angegebenen Listen zurück. Die Antwort erfolgt `Distance` in Metern und `Duration` in Sekunden. Die API kann verwendet werden, um Vermeidungsoptionen für bestimmte Gebiete oder Straßenmerkmale festzulegen und so sicherzustellen, dass Routen bestimmte Zonen oder Bedingungen vermeiden. Wenn eine alternative Route nicht durchführbar ist, kann die Präferenz zur Vermeidung umgangen werden.

## Mögliche Anwendungsfälle
<a name="calculate-route-matrix-potential-use"></a>
+ **Routenplanung und -optimierung:** Verwenden Sie die Routenmatrix als Eingabe für Software, die optimierte Reiserouten benötigt und dabei bestimmte Bereiche oder Straßenmerkmale meidet.

## Beispiele
<a name="calculate-route-matrix-examples"></a>

### CalculateRouteMatrix mit einem Vermeidungsbereich
<a name="calculate-route-matrix-avoidance-area"></a>

------
#### [ Sample request ]

```
{
    "Origins": [
        {
            "Position": [-123.11679620827039, 49.28147612192166]
        }
    ],
    "Destinations": [
        {
            "Position": [-123.112317039, 49.28897192166]
        }
    ],
    "Avoid": {
        "Areas": [
            {
                "Geometry": {
                    "BoundingBox": [
                         -123.116561,
                         49.281517,
                         -123.110165,
                         49.285689
                    ]
                }
            }
        ]
    },
    "RoutingBoundary": {
        "Unbounded": true
    }
}
```

------
#### [ Sample response ]

```
{
    "ErrorCount": 0,
    "RouteMatrix": [
        [
            {
                "Distance": 1855,
                "Duration": 295
            }
        ]
    ],
    "RoutingBoundary": {
        "Unbounded": true
    }
}
```

------
#### [ cURL ]

```
curl --request POST \
  --url 'https://routes.geo.eu-central-1.amazonaws.com/v2/route-matrix?key=Your_key' \
  --header 'Content-Type: application/json' \
  --data '{
    "Origins": [
        {
            "Position": [-123.11679620827039, 49.28147612192166]
        }
    ],
    "Destinations": [
        {
            "Position": [-123.112317039, 49.28897192166]
        }
    ],
    "Avoid": {
        "Areas": [
            {
                "Geometry": {
                    "BoundingBox": [
                         -123.116561,
                         49.281517,
                         -123.110165,
                         49.285689
                    ]
                }
            }
        ]
    },
    "RoutingBoundary": {
        "Unbounded": true
    }
}'
```

------
#### [ AWS CLI ]

```
aws geo-routes calculate-route-matrix --key ${YourKey} \
--origins '[{"Position": [-123.11679620827039, 49.28147612192166]}]' \
--destinations '[{"Position": [-123.112317039, 49.28897192166]}]' \
--avoid '{"Areas": [{"Geometry": {"BoundingBox": [-123.116561, 49.281517, -123.110165, 49.285689]}}]}' \
--routing-boundary '{"Unbounded": true}'
```

------

### CalculateRouteMatrix Vermeidung von Mautstraßen, Autobahnen und Fähren
<a name="calculate-route-matrix-avoidance-features"></a>

------
#### [ Sample request ]

```
{
    "Origins": [
        {
            "Position": [-123.11679620827039, 49.28147612192166]
        }
    ],
    "Destinations": [
        {
            "Position": [-123.112317039, 49.28897192166]
        }
    ],
    "Avoid": {
        "TollRoads": true,
        "ControlledAccessHighways": true,
        "Ferries": true    
    },
    "RoutingBoundary": {
        "Unbounded": true
    }
}
```

------
#### [ Sample response ]

```
{
    "ErrorCount": 0,
    "RouteMatrix": [
        [
            {
                "Distance": 1855,
                "Duration": 295
            }
        ]
    ],
    "RoutingBoundary": {
        "Unbounded": true
    }
}
```

------
#### [ cURL ]

```
curl --request POST \
  --url 'https://routes.geo.eu-central-1.amazonaws.com/v2/route-matrix?key=Your_key' \
  --header 'Content-Type: application/json' \
  --data '{
    "Origins": [
        {
            "Position": [-123.11679620827039, 49.28147612192166]
        }
    ],
    "Destinations": [
        {
            "Position": [-123.112317039, 49.28897192166]
        }
    ],
    "Avoid": {
        "TollRoads": true,
        "ControlledAccessHighways": true,
        "Ferries": true    
    },
    "RoutingBoundary": {
        "Unbounded": true
    }
}'
```

------
#### [ AWS CLI ]

```
aws geo-routes calculate-route-matrix --key ${YourKey} \
--origins '[{"Position": [-123.11679620827039, 49.28147612192166]}]' \
--destinations '[{"Position": [-123.112317039, 49.28897192166]}]' \
--avoid '{"TollRoads": true, "ControlledAccessHighways": true, "Ferries": true}' \
--routing-boundary '{"Unbounded": true}'
```

------

# Lernen Sie, wie man es benutzt OptimizeWaypoints
<a name="optimize-waypoints-how-to"></a>

Erfahren Sie, wie Sie `OptimizeWaypoints` damit die besten Routen finden, um Reisezeit oder Entfernung zu minimieren.

**Topics**
+ [So optimieren Sie Wegpunkte für eine Route](optimize-waypoints.md)
+ [So optimieren Sie Wegpunkte für eine Route mit Verkehrsbewusstsein](optimize-waypoints-traffic-awareness.md)
+ [So optimieren Sie Wegpunkte für eine Route mit Angabe der Zugriffszeiten](optimize-waypoints-access-hours.md)

# So optimieren Sie Wegpunkte für eine Route
<a name="optimize-waypoints"></a>

Die OptimizeWaypoints API berechnet die effizienteste Route zwischen einer Reihe von Wegpunkten und minimiert so entweder die Reisezeit oder die Gesamtentfernung. Diese API löst das Problem des reisenden Verkäufers, indem sie Straßennetze und Verkehrsbedingungen berücksichtigt, um den optimalen Weg zu bestimmen.

## Mögliche Anwendungsfälle
<a name="optimize-waypoints-potential-use"></a>
+ **Analysieren Sie Muster in Versorgungsgebieten:** Nutzen Sie die Wegpunktoptimierung, um fundierte Entscheidungen über Servicebereiche für Unternehmen zu treffen und die Effizienz der Logistik zu verbessern.

## Beispiele
<a name="optimize-waypoints-examples"></a>

### Optimieren Sie Wegpunkte mit Car TravelMode
<a name="optimize-waypoints-car"></a>

------
#### [ Sample Request ]

```
{
    "Origin": [
        -123.095740,
        49.274426
    ],
    "Waypoints": [
        {
            "Position": [
                -123.115193,
                49.280596
            ]
        },
        {
            "Position": [
                -123.089557,
                49.271774
            ]
        }
    ],
    "DepartureTime": "2024-10-25T18:13:42Z",
    "Destination": [
        -123.095185,
        49.263728
    ],
    "TravelMode": "Car"
}
```

------
#### [ Sample Response ]

```
{
    "Connections": [
        {
            "Distance": 1989,
            "From": "Origin",
            "RestDuration": 0,
            "To": "Waypoint0",
            "TravelDuration": 258,
            "WaitDuration": 0
        },
        {
            "Distance": 3010,
            "From": "Waypoint0",
            "RestDuration": 0,
            "To": "Waypoint1",
            "TravelDuration": 298,
            "WaitDuration": 0
        },
        {
            "Distance": 2371,
            "From": "Waypoint1",
            "RestDuration": 0,
            "To": "Destination",
            "TravelDuration": 311,
            "WaitDuration": 0
        }
    ],
    "Distance": 7370,
    "Duration": 867,
    "ImpedingWaypoints": [],
    "OptimizedWaypoints": [
        {
            "DepartureTime": "2024-10-25T18:13:42Z",
            "Id": "Origin",
            "Position": [
                -123.09574,
                49.274426
            ]
        },
        {
            "DepartureTime": "2024-10-25T18:18:00Z",
            "Id": "Waypoint0",
            "Position": [
                -123.115193,
                49.280596
            ]
        },
        {
            "DepartureTime": "2024-10-25T18:22:58Z",
            "Id": "Waypoint1",
            "Position": [
                -123.089557,
                49.271774
            ]
        },
        {
            "ArrivalTime": "2024-10-25T18:28:09Z",
            "Id": "Destination",
            "Position": [
                -123.095185,
                49.263728
            ]
        }
    ],
    "TimeBreakdown": {
        "RestDuration": 0,
        "ServiceDuration": 0,
        "TravelDuration": 867,
        "WaitDuration": 0
    }
}
```

------
#### [ cURL ]

```
curl --request POST \
  --url 'https://routes.geo.eu-central-1.amazonaws.com/v2/optimize-waypoints?key=Your_key' \
  --header 'Content-Type: application/json' \
  --data '{
    "Origin": [
        -123.095740,
        49.274426
    ],
    "Waypoints": [
        {
            "Position": [
                -123.115193,
                49.280596
            ]
        },
        {
            "Position": [
                -123.089557,
                49.271774
            ]
        }
    ],
    "DepartureTime": "2024-10-25T18:13:42Z",
    "Destination": [
        -123.095185,
        49.263728
    ],
    "TravelMode": "Car"
}'
```

------
#### [ AWS CLI ]

```
aws geo-routes optimize-waypoints --key ${YourKey} \
--origin -123.095740 49.274426 \
--waypoints '[{"Position": [-123.115193 , 49.280596]}, {"Position": [-123.089557 , 49.271774]}]' \
--destination -123.095185 49.263728 \
--departure-time "2024-10-25T18:13:42Z" \
--travel-mode "Car"
```

------

# So optimieren Sie Wegpunkte für eine Route mit Verkehrsbewusstsein
<a name="optimize-waypoints-traffic-awareness"></a>

Die OptimizeWaypoints API berechnet die optimale Route zwischen mehreren Wegpunkten, um die Reisezeit oder die Gesamtentfernung zu minimieren. Sie verwendet fortschrittliche Algorithmen, um das Problem des reisenden Verkäufers zu lösen. Dabei wird der effizienteste Weg ermittelt und dabei Faktoren wie Straßennetze und Verkehrsbedingungen in Echtzeit berücksichtigt.

## Mögliche Anwendungsfälle
<a name="optimize-waypoints-potential-use"></a>
+ **Optimieren Sie Routen mit mehreren Stopps, um die Zustellung effizienter zu gestalten:** Verbessern Sie die Lieferabläufe, indem Sie die kürzeste oder schnellste Route unter mehreren Stopps berechnen. Dies ist nützlich, um die Betriebskosten, den Kraftstoffverbrauch und die Reisezeit in Logistik- und Lieferdiensten zu senken.

## Beispiele
<a name="optimize-waypoints-examples"></a>

### Optimieren Sie Wegpunkte mit dem Auto, indem Sie das Verkehrsbewusstsein erhöhen TravelMode
<a name="optimize-waypoints-traffic-car"></a>

------
#### [ Sample request ]

```
{
    "Origin": [
        -123.095740,
        49.274426
    ],
    "Waypoints": [
        {
            "Position": [
                -123.115193,
                49.280596
            ]
        },
        {
            "Position": [
                -123.089557,
                49.271774
            ]
        }
    ],
    "DepartureTime": "2024-10-25T18:13:42Z",
    "Destination": [
        -123.095185,
        49.263728
    ],
    "TravelMode": "Car",
    "Traffic": {
        "Usage": "UseTrafficData"
    }
}
```

------
#### [ Sample response ]

```
{
    "Connections": [
        {
            "Distance": 1989,
            "From": "Origin",
            "RestDuration": 0,
            "To": "Waypoint0",
            "TravelDuration": 324,
            "WaitDuration": 0
        },
        {
            "Distance": 2692,
            "From": "Waypoint0",
            "RestDuration": 0,
            "To": "Waypoint1",
            "TravelDuration": 338,
            "WaitDuration": 0
        },
        {
            "Distance": 2371,
            "From": "Waypoint1",
            "RestDuration": 0,
            "To": "Destination",
            "TravelDuration": 395,
            "WaitDuration": 0
        }
    ],
    "Distance": 7052,
    "Duration": 1057,
    "ImpedingWaypoints": [],
    "OptimizedWaypoints": [
        {
            "DepartureTime": "2024-10-25T18:13:42Z",
            "Id": "Origin",
            "Position": [
                -123.09574,
                49.274426
            ]
        },
        {
            "ArrivalTime": "2024-10-25T18:19:06Z",
            "DepartureTime": "2024-10-25T18:19:06Z",
            "Id": "Waypoint0",
            "Position": [
                -123.115193,
                49.280596
            ]
        },
        {
            "ArrivalTime": "2024-10-25T18:24:44Z",
            "DepartureTime": "2024-10-25T18:24:44Z",
            "Id": "Waypoint1",
            "Position": [
                -123.089557,
                49.271774
            ]
        },
        {
            "ArrivalTime": "2024-10-25T18:31:19Z",
            "Id": "Destination",
            "Position": [
                -123.095185,
                49.263728
            ]
        }
    ],
    "TimeBreakdown": {
        "RestDuration": 0,
        "ServiceDuration": 0,
        "TravelDuration": 1057,
        "WaitDuration": 0
    }
}
```

------
#### [ cURL ]

```
curl --request POST \
  --url 'https://routes.geo.eu-central-1.amazonaws.com/v2/optimize-waypoints?key=Your_key' \
  --header 'Content-Type: application/json' \
  --data '{
    "Origin": [
        -123.095740,
        49.274426
    ],
    "Waypoints": [
        {
            "Position": [
                -123.115193,
                49.280596
            ]
        },
        {
            "Position": [
                -123.089557,
                49.271774
            ]
        }
    ],
    "DepartureTime": "2024-10-25T18:13:42Z",
    "Destination": [
        -123.095185,
        49.263728
    ],
    "TravelMode": "Car",
    "Traffic": {
        "Usage": "UseTrafficData"
    }
}'
```

------
#### [ AWS CLI ]

```
aws geo-routes optimize-waypoints --key ${YourKey} \
--origin -123.095740 49.274426 \
--waypoints '[{"Position": [-123.115193 , 49.280596]}, {"Position": [-123.089557 , 49.271774]}]' \
--destination -123.095185 49.263728 \
--departure-time "2024-10-25T18:13:42Z" \
--travel-mode "Car" \
--traffic '{"Usage": "UseTrafficData"}'
```

------

# So optimieren Sie Wegpunkte für eine Route mit Angabe der Zugriffszeiten
<a name="optimize-waypoints-access-hours"></a>

Die OptimizeWaypoints API berechnet auch die optimale Route zwischen einer Reihe von Wegpunkten mit dem Ziel, entweder die Reisezeit oder die zurückgelegte Gesamtstrecke zu minimieren. Sie löst das Problem des reisenden Verkäufers, den effizientesten Weg zu ermitteln und dabei Faktoren wie das Straßennetz und die Verkehrsbedingungen zu berücksichtigen.

## Mögliche Anwendungsfälle
<a name="optimize-waypoints-access-hours-potential-use"></a>
+ **Analysieren Sie die Öffnungszeiten der Kunden:** Richten Sie sich bei der Planung der Effizienz nach den Öffnungszeiten Ihrer Kunden.

## Beispiele
<a name="optimize-waypoints-examples"></a>

### Optimieren Sie Wegpunkte mithilfe von Car, indem Sie die Zugangszeiten im Auge behalten TravelMode
<a name="optimize-waypoints-car"></a>

------
#### [ Sample Request ]

```
{
    "Origin": [
        -123.095740,
        49.274426
    ],
    "Waypoints": [
        {
            "Position": [
                -123.115193,
                49.280596
            ],
            "SideOfStreet": {
                "Position": [
                    -123.089557,
                    49.271774
                ],
                "UseWith": "AnyStreet"
            },
            "AccessHours": {
                "From": {
                    "DayOfWeek": "Saturday",
                    "TimeOfDay": "00:02:42Z"
                },
                "To": {
                    "DayOfWeek": "Friday",
                    "TimeOfDay": "1:33:36+02:50"
                }
            },
            "Heading": "250",
            "ServiceDuration": "200"
        },
        {
            "Position": [
                -123.089557,
                49.271774
            ],
            "AccessHours": {
                "From": {
                    "DayOfWeek": "Monday",
                    "TimeOfDay": "00:02:42Z"
                },
                "To": {
                    "DayOfWeek": "Tuesday",
                    "TimeOfDay": "1:33:36+02:50"
                }
            },
            "ServiceDuration": "200"
        }
    ],
    "DepartureTime": "2024-10-25T18:13:42Z",
    "Destination": [
        -123.095185,
        49.263728
    ],
    "TravelMode": "Car"
}
```

------
#### [ Sample Response ]

```
{
    "Connections": [
        {
            "Distance": 1989,
            "From": "Origin",
            "RestDuration": 0,
            "To": "Waypoint0",
            "TravelDuration": 258,
            "WaitDuration": 20682
        },
        {
            "Distance": 3360,
            "From": "Waypoint0",
            "RestDuration": 0,
            "To": "Waypoint1",
            "TravelDuration": 378,
            "WaitDuration": 172222
        },
        {
            "Distance": 2371,
            "From": "Waypoint1",
            "RestDuration": 0,
            "To": "Destination",
            "TravelDuration": 311,
            "WaitDuration": 0
        }
    ],
    "Distance": 7720,
    "Duration": 194251,
    "ImpedingWaypoints": [],
    "OptimizedWaypoints": [
        {
            "DepartureTime": "2024-10-25T18:13:42Z",
            "Id": "Origin",
            "Position": [
                -123.09574,
                49.274426
            ]
        },
        {
            "ArrivalTime": "2024-10-25T18:18:00Z",
            "DepartureTime": "2024-10-26T00:06:02Z",
            "Id": "Waypoint0",
            "Position": [
                -123.115193,
                49.280596
            ]
        },
        {
            "ArrivalTime": "2024-10-26T00:12:20Z",
            "DepartureTime": "2024-10-28T00:06:02Z",
            "Id": "Waypoint1",
            "Position": [
                -123.089557,
                49.271774
            ]
        },
        {
            "ArrivalTime": "2024-10-28T00:11:13Z",
            "Id": "Destination",
            "Position": [
                -123.095185,
                49.263728
            ]
        }
    ],
    "TimeBreakdown": {
        "RestDuration": 0,
        "ServiceDuration": 400,
        "TravelDuration": 947,
        "WaitDuration": 192904
    }
}
```

------
#### [ cURL ]

```
curl --request POST \
  --url 'https://routes.geo.eu-central-1.amazonaws.com/v2/optimize-waypoints?key=Your_key' \
  --header 'Content-Type: application/json' \
  --data '{
    "Origin": [
        -123.095740,
        49.274426
    ],
    "Waypoints": [
        {
            "Position": [
                -123.115193,
                49.280596
            ],
            "SideOfStreet": {
                "Position": [
                    -123.089557,
                    49.271774
                ],
                "UseWith": "AnyStreet"
            },
            "AccessHours": {
                "From": {
                    "DayOfWeek": "Saturday",
                    "TimeOfDay": "00:02:42Z"
                },
                "To": {
                    "DayOfWeek": "Friday",
                    "TimeOfDay": "1:33:36+02:50"
                }
            },
            "Heading": "250",
            "ServiceDuration": "200"
        },
        {
            "Position": [
                -123.089557,
                49.271774
            ],
            "AccessHours": {
                "From": {
                    "DayOfWeek": "Monday",
                    "TimeOfDay": "00:02:42Z"
                },
                "To": {
                    "DayOfWeek": "Tuesday",
                    "TimeOfDay": "1:33:36+02:50"
                }
            },
            "ServiceDuration": "200"
        }
    ],
    "DepartureTime": "2024-10-25T18:13:42Z",
    "Destination": [
        -123.095185,
        49.263728
    ],
    "TravelMode": "Car"
}'
```

------
#### [ AWS CLI ]

```
aws geo-routes optimize-waypoints --key ${YourKey} \
--origin -123.095740 49.274426 \
--waypoints '[{"Position": [-123.115193 , 49.280596], "SideOfStreet": {"Position": [-123.089557, 49.271774], "UseWith": "AnyStreet"}, "AccessHours": {"From": {"DayOfWeek": "Saturday", "TimeOfDay": "00:02:42Z"}, "To": {"DayOfWeek": "Friday", "TimeOfDay": "1:33:36+02:50"}}, "Heading": 250, "ServiceDuration": 200}, {"Position": [-123.089557, 49.271774], "AccessHours": {"From": {"DayOfWeek": "Monday", "TimeOfDay": "00:02:42Z"}, "To": {"DayOfWeek": "Tuesday", "TimeOfDay": "1:33:36+02:50"}}, "ServiceDuration": 200}]' \
--destination -123.095185 49.263728 \
--departure-time "2024-10-25T18:13:42Z" \
--travel-mode "Car"
```

------

# Lernen Sie, wie man es benutzt SnapToRoads
<a name="snap-to-roads-how-to"></a>

 In diesem Thema wird erklärt, wie `SnapToRoads` GPS-Tracks mit Straßennetzen abgeglichen werden können, wodurch die Positionsgenauigkeit für Navigations- und Flottenmanagementanwendungen verbessert wird. Diese API korrigiert GPS-Drift und Signalverlust, indem sie die Koordinaten der nächstgelegenen Straßensegmente erfasst und gleichzeitig die Einschränkungen des Reisemodus einhält. Beispiele veranschaulichen praktische Einsatzmöglichkeiten wie das Überlagern von GPS-Spuren, das Füllen von Datenlücken und das Reduzieren von Rauschen für eine klarere Routenvisualisierung.

**Topics**
+ [So ordnen Sie GPS-Tracks einem Straßennetz zu](how-to-match-gps-traces.md)

# So ordnen Sie GPS-Tracks einem Straßennetz zu
<a name="how-to-match-gps-traces"></a>

Die SnapToRoads API ermöglicht es Ihnen, GPS-Spuren mit dem Straßennetz abzugleichen. Ein GPS-Trace umfasst Positionen und Metadaten wie Zeitstempel, Geschwindigkeit und Richtung, die mit einem GPS-Gerät aufgezeichnet wurden. Diese Spuren weisen oft eine gewisse Fehlerquote auf, was es schwierig macht, sie direkt für Analysen und Visualisierungen zu verwenden.

SnapToRoads berücksichtigt beim Abgleich der Spuren die rechtlichen und zeitlichen Beschränkungen für den angegebenen Reisemodus. Wenn der Trace eindeutig auf einen Verstoß gegen die Beschränkung hindeutet, wird die tatsächlich eingeschlagene Route beibehalten.

## Mögliche Anwendungsfälle
<a name="potential-use"></a>
+ **Überlagern Sie GPS-Tracks auf den Straßen, die am wahrscheinlichsten befahren wurden:** Diese Funktion hilft dabei, GPS-Daten an der genauesten Route im Straßennetz auszurichten und unterstützt so eine klarere Datenvisualisierung.
+ **Lücken in GPS-Spuren interpolieren: SnapToRoads Kann** Lücken schließen, indem Koordinaten an Straßensegmenten angepasst werden, wodurch ein kontinuierlicherer und nützlicherer Datensatz für Anwendungen entsteht.
+ **Rauschen und Ausreißer filtern:** Durch die Suche nach der nächstgelegenen Straße kann diese API helfen, Ausreißer zu entfernen und GPS-Rauschen zu reduzieren, wodurch die Datenzuverlässigkeit für Analysen verbessert wird.

## Beispiele
<a name="examples"></a>

### GPS-Trace im Automodus abgleichen
<a name="match-gps-car-mode"></a>

------
#### [ Sample request ]

```
{
  "TracePoints": [
    {
      "Position": [8.53404,50.16364],
      "Timestamp": "2024-05-22T18:13:42Z"
    },
    {
      "Position": [8.53379056,50.16352417],
      "Speed": 20,
      "Timestamp": "2024-05-22T18:13:59Z"
    }
  ],
  "TravelMode": "Car"
}
```

------
#### [ Sample response ]

```
{
    "Notices": [],
    "SnappedGeometry": {
        "Polyline": "Redacted"
    },
    "SnappedGeometryFormat": "FlexiblePolyline",
    "SnappedTracePoints": [
        {
            "Confidence": 1,
            "OriginalPosition": [8.53404, 50.16364],
            "SnappedPosition": [8.53402, 50.16367]
        },
        {
            "Confidence": 0.86,
            "OriginalPosition": [8.53379056, 50.16352417],
            "SnappedPosition": [8.53375, 50.16356]
        }
    ]
}
```

------
#### [ cURL ]

```
curl --request POST \
  --url 'https://routes.geo.eu-central-1.amazonaws.com/v2/snap-to-roads?key=Your_key' \
  --header 'Content-Type: application/json' \
  --data '{
  "TracePoints": [
    {
      "Position": [8.53404,50.16364],
      "Timestamp": "2024-05-22T18:13:42Z"
    },
    {
      "Position": [8.53379056,50.16352417],
      "Speed": 20,
      "Timestamp": "2024-05-22T18:13:59Z"
    }
  ],
  "TravelMode": "Car"
}'
```

------
#### [ AWS CLI ]

```
aws geo-routes snap-to-roads --key ${YourKey} \
--trace-points '[{"Position": [8.53404, 50.16364], "Timestamp": "2024-05-22T18:13:42Z"}, {"Position": [8.53379056, 50.16352417], "Speed": 20, "Timestamp": "2024-05-22T18:13:59Z"}]' \
--travel-mode "Car"
```

------

### Ordnen Sie die GPS-Spur im Lkw-Modus den Optionen zu
<a name="match-gps-truck-mode-options"></a>

------
#### [ Sample request ]

```
{
  "TracePoints": [
    {
      "Position": [8.53404,50.16364],
      "Timestamp": "2024-05-22T18:13:42Z"
    },
    {
      "Position": [8.53379056,50.16352417],
      "Speed": 20,
      "Timestamp": "2024-05-22T18:13:59Z"
    }
  ],
  "TravelMode": "Truck",
  "TravelModeOptions": {
    "Truck": {
      "GrossWeight": 10000
    }
  }
}
```

------
#### [ Sample response ]

```
{
    "Notices": [],
    "SnappedGeometry": {
        "Polyline": "Redacted"
    },
    "SnappedGeometryFormat": "FlexiblePolyline",
    "SnappedTracePoints": [
        {
            "Confidence": 1,
            "OriginalPosition": [8.53404, 50.16364],
            "SnappedPosition": [8.53402, 50.16367]
        },
        {
            "Confidence": 0.86,
            "OriginalPosition": [8.53379056, 50.16352417],
            "SnappedPosition": [8.53375, 50.16356]
        }
    ]
}
```

------
#### [ cURL ]

```
curl --request POST \
  --url 'https://routes.geo.eu-central-1.amazonaws.com/v2/snap-to-roads?key=Your_key' \
  --header 'Content-Type: application/json' \
  --data '{
  "TracePoints": [
    {
      "Position": [8.53404,50.16364],
      "Timestamp": "2024-05-22T18:13:42Z"
    },
    {
      "Position": [8.53379056,50.16352417],
      "Speed": 20,
      "Timestamp": "2024-05-22T18:13:59Z"
    }
  ],
  "TravelMode": "Truck",
  "TravelModeOptions": {
    "Truck": {
      "GrossWeight": 10000
    }
  }
}'
```

------
#### [ AWS CLI ]

```
aws geo-routes snap-to-roads --key ${YourKey} \
--trace-points '[{"Position": [8.53404, 50.16364], "Timestamp": "2024-05-22T18:13:42Z"}, {"Position": [8.53379056, 50.16352417], "Speed": 20, "Timestamp": "2024-05-22T18:13:59Z"}]' \
--travel-mode "Truck" \
--travel-mode-options '{"Truck": {"GrossWeight": 10000}}'
```

------

# Kosten und Nutzung verwalten
<a name="routes-whats-next"></a>

Wenn Sie mehr über Amazon Location-Routen erfahren, ist es wichtig zu verstehen, wie Sie die Servicekapazität verwalten, sicherstellen, dass Sie Nutzungsbeschränkungen einhalten und durch Kontingent- und API-Optimierungen die besten Ergebnisse erzielen. Indem Sie bewährte Verfahren für Leistung und Genauigkeit anwenden, können Sie Ihre Anwendung so anpassen, dass ortsbezogene Anfragen effizient bearbeitet und Ihre API-Anfragen optimal genutzt werden.

**Topics**
+ [Bewährte Methoden](routes-best-practices.md)
+ [Preise für Strecken](routes-pricing.md)
+ [Routen-Kontingent und Nutzung](routes-quota-usage.md)

# Bewährte Methoden
<a name="routes-best-practices"></a>

In diesem Abschnitt werden bewährte Methoden für die Verwendung der Komprimierung und die Auswahl zwischen Simple (GeoJSON) und FlexiblePolyline Formaten bei der Interaktion mit der API behandelt. Er enthält Anleitungen zur Optimierung von Leistung, Bandbreite und Datenverarbeitung.

## Komprimierung
<a name="compression"></a>

Um die Leistung und Effizienz Ihrer Anwendungen bei der Interaktion mit unserer API zu verbessern, wird empfohlen, die Komprimierung für Antworten zu aktivieren, insbesondere bei großen textbasierten Nutzlasten. Sie können die Komprimierung aktivieren, indem Sie den `Accept-Encoding` Header in Ihre API-Anfragen aufnehmen und dabei Ihre bevorzugte Komprimierungsmethode angeben. Wir unterstützen `gzip` und `deflate` unterstützen ihre Komprimierungsfunktionen, die `gzip` in der Regel bessere Komprimierungsraten bieten.

### Wann sollte die Komprimierung aktiviert werden
<a name="when-to-enable-compression"></a>

**Große Antworten**  
Aktivieren Sie die Komprimierung für große textbasierte Antworten, um die Bandbreitennutzung zu reduzieren und die Ladezeiten zu verbessern.

**Netzwerkeinschränkungen**  
Wenn Ihre Anwendung in Netzwerken mit begrenzter Bandbreite oder mit hoher Latenz betrieben wird, kann die Komprimierung die Effizienz der Datenübertragung verbessern.

### Wie kann die Komprimierung effektiv eingesetzt werden
<a name="how-to-use-compression-effectively"></a>

**Stellen Sie den Accept-Encoding-Header ein**  
Nehmen Sie `Accept-Encoding: gzip, deflate` in Ihre HTTP-Anfragen auf, um unsere API darüber zu informieren, dass Sie diese Komprimierungsmethoden unterstützen. Die Methode zur Aktivierung und Handhabung der Komprimierung ist je nach [AWS-SDK](https://docs.aws.amazon.com/sdkref/latest/guide/overview.html) und Programmiersprache unterschiedlich. Beispielsweise verwendet das [AWS SDK for Java v1](https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/ClientConfiguration.html#withGzip-boolean-) die `withGzip` Methode in der `ClientConfiguration` Klasse, um Gzip zu aktivieren, während das AWS-SDK SDK for Go das Hinzufügen bestimmter Middleware für die Komprimierungsverarbeitung erfordert. Weitere SDKs Informationen finden Sie im [AWS SDK-Referenzhandbuch](https://docs.aws.amazon.com/sdkref/latest/guide/overview.html) mit detaillierten Anweisungen.

**Gehen Sie richtig mit der Dekomprimierung**  
Stellen Sie sicher, dass Ihre Client-Anwendung die Antworten auf der Grundlage des von unserer API zurückgegebenen `Content-Encoding` Headers korrekt dekomprimieren kann.

**Testen und Überwachen**  
Bewerten Sie regelmäßig die Auswirkungen der Komprimierung auf die Leistung Ihrer Anwendung und wägen Sie dabei die Vorteile reduzierter Nutzlastgrößen gegen den zusätzlichen CPU-Overhead durch Dekomprimierungsprozesse ab.

## Polyline
<a name="polyline"></a>

Bewährte Methoden für die Wahl zwischen Simple (GeoJSON) und FlexiblePolyline Formaten bei der Interaktion mit unserer API, um sowohl die Leistung als auch die Benutzerfreundlichkeit Ihrer Geodaten zu optimieren.

### Verwenden Sie das einfache Format (GeoJSON)
<a name="use-simple-format"></a>

**Lesbarkeit und Standardisierung**  
Verwenden Sie dieses Format, wenn Sie ein allgemein anerkanntes und für Menschen lesbares Format benötigen, um das Debuggen zu vereinfachen und die Interoperabilität mit verschiedenen Geodatenwerkzeugen zu gewährleisten.

**Genauigkeit**  
Wählen Sie das einfache Format, wenn Ihre Anwendung eine hohe Genauigkeit für Koordinaten benötigt, da GeoJSON die volle Dezimalgenauigkeit ohne Verlust beibehält.

**Kleinere Datensätze**  
Das einfache Format ist ideal, wenn Sie mit kleineren Koordinatendatensätzen arbeiten, bei denen die Vorteile der Komprimierung bei der Größenreduzierung minimal sind.

### Verwenden Sie FlexiblePolyline Format
<a name="use-flexiblepolyline-format"></a>

**Reduzierung der Datengröße**  
FlexiblePolyline ist ideal, wenn Sie die übertragene Datenmenge minimieren müssen, insbesondere bei großen Koordinatenlisten, indem Sie verlustbehaftete Komprimierungstechniken nutzen.

**URL-Sicherheit**  
FlexiblePolyline stellt eine kompakte, URL-sichere Zeichenfolge bereit, die ohne zusätzliche Kodierung direkt in Abfrageparametern verwendet werden kann.

**Optimierung der Leistung**  
FlexiblePolyline trägt dazu bei, die Größe der Nutzlast zu reduzieren, was zu einer schnelleren Datenübertragung und einer geringeren Bandbreitennutzung führt. Dies macht sie für Hochleistungsanwendungen oder solche, die in eingeschränkten Netzwerken betrieben werden, von entscheidender Bedeutung.

# Preise für Strecken
<a name="routes-pricing"></a>

Nachfolgend finden Sie die Preisklassen für die einzelnen APIs:

## Routen berechnen
<a name="calculate-routes-price"></a>

Dieser Preis basiert auf der Anzahl der API-Anfragen. `CalculateRoutes`hat drei Preisklassen: Core, Advanced und Premium.

**Core**  
Diese Preisklasse unterstützt die Reisemodi Pkw, Lkw und Fußgänger ohne Berechnung der Mautkosten.

**Advanced**  
Diese Preisklasse unterstützt alternative Reisemodi wie Scooter ohne Berechnung der Mautkosten.

**Premium**  
Dieser Preisbereich unterstützt die Berechnung der Mautkosten. Ihnen wird der Premium-Preis berechnet, wenn Sie die Berechnung der Mautkosten durch die Einstellung der Anforderungsparameter beantragen`SpanAdditionalFeatures["TollSystems"]`, `LegAdditionalFeatures["Tolls"]` oder unabhängig vom Reisemodus.

## Routenmatrix berechnen
<a name="calculate-route-matri-price"></a>

Dieser Preis basiert auf der Anzahl der berechneten Routen. Die Anzahl der in jeder Anfrage berechneten Routen entspricht der Anzahl der Startpunkte multipliziert mit der Anzahl der Ziele,`Number of Routes = Number of origins x Number of Destinations`. Wenn Sie beispielsweise eine Matrixgröße von 300 Startpunkten mal 100 Zielen verwenden, beträgt die Gesamtzahl der berechneten Routen 30.000 (300 x 100 = 30.000).

**Anmerkung**  
Routenberechnungen werden für jedes Ausgangs- und Zielpaar in Rechnung gestellt. Wenn Sie eine große Matrix von Start- und Zielorten verwenden, steigen Ihre Kosten entsprechend.

`CalculateRouteMatrix`hat 2 Preisklassen: Core und Advanced.

**Core**  
Diese Preisklasse unterstützt die Reisemodi Auto, Lkw und Fußgänger.

**Advanced**  
Diese Preisklasse unterstützt alternative Reisemodi wie Roller.

## Waypoint optimieren
<a name="optimize-waypoint-price"></a>

Dieser Preis basiert auf der Anzahl der API-Anfragen. `OptimizeWaypoint`hat 2 Preisklassen: Advanced und Premium.

**Advanced**  
 Dieser Preisbereich unterstützt bis zu 30 Wegpunkte in einer einzigen Anfrage; Reisemodi für Auto, LKW und Fußgänger, bei denen das Begrenzungsfeld der Eingabepunkte innerhalb von 200 km liegt und ohne optionale Parameter wie,,,,`Avoid`,,,,,`Clustering`,, `Driver` `Exclude.Countries` `TravelModeOptions.Truck.HazardousCargos``TravelModeOptions.Truck.TunnelRestrictionCode`, und ohne zusätzliche Wegpunkte oder Zielbeschränkungen wie,`AccessHours`,,,,,,`AppointmentTime`. `Before` `Heading` `ServiceDuration` `SideOfStreet`  
Automatisches Clustering kann erfolgen, wenn sich Wegpunkte in unmittelbarer Nähe befinden, aber es wird immer noch als erweiterte Preisklasse betrachtet.

**Premium**  
 Dieses Preissegment unterstützt bis zu 50 Wegpunkte in einer einzigen Anfrage, ohne Einschränkungen bei den Reisemodi, mit einem Begrenzungsrahmen der Eingabepunkte innerhalb von 500 km und mit optionalen Parametern wie`Avoid`,,,, `Clustering``Driver`,`Exclude.Countries`. `TravelModeOptions.Truck.HazardousCargos` `TravelModeOptions.Truck.TunnelRestrictionCode` Darüber hinaus unterstützt dieser Preisbereich optionale Einschränkungen für Wegpunkte und Ziele wie,,,`AccessHours`,`AppointmentTime`,`Before`. `Heading` `ServiceDuration` `SideOfStreet`   
Eine einzelne Anfrage kann nur bis zu 20 Wegpunkte unterstützen, wenn eine der optionalen Wegpunkt- und Zielbeschränkungen angewendet wird.

## S nap-to-road
<a name="snap-to-road-price"></a>

Dieser Preis basiert auf der Anzahl der API-Anfragen. `SnaptoRoad`hat 2 Preisklassen: Advanced und Premium.

**Advanced**  
Diese Preisklasse unterstützt die Reisemodi Auto, Lkw und Fußgänger mit einer `TracePoints` Anzahl von bis zu 200 und einer maximalen Flugstrecke zwischen 100 `TracePoints` Kilometern.

**Premium**  
In dieser Preisklasse gibt es keine Einschränkungen hinsichtlich der Reisemodi, bis zu 5.000 `TracePoints` Punkte.

## Isolinie berechnen
<a name="calculate-isoline-price"></a>

Dieser Preis basiert auf der Anzahl der Isolinien, die in der Antwort berechnet wurde. `CalculateIsolines`hat 2 Preisklassen: Advanced und Premium.

**Advanced**  
Diese Preisklasse unterstützt die Reisemodi Auto, Lkw und Fußgänger mit `Thresholds.Time` Werten bis zu 60 Minuten oder `Thresholds.Distance` Werten bis zu 100 Kilometern.

**Premium**  
In dieser Preisklasse gibt es keine Einschränkungen hinsichtlich der Reisemodi mit `Thresholds.Time` Werten bis zu 180 Minuten oder `Thresholds.Distance` Werten bis zu 300 KM.

# Routen-Kontingent und Nutzung
<a name="routes-quota-usage"></a>

## Servicekontingent
<a name="service-quota"></a>

Amazon Location Service APIs hat Standardkontingente. Sie können die Kontingente mithilfe der [Service-Kontingentkonsole](https://console.aws.amazon.com/servicequotas/home#!/services/geo/quotas) erhöhen. Für Limits, die das Zweifache des Standardwerts überschreiten, wenden Sie sich an die Self-Service-Konsole oder wenden Sie sich an den Support.


**Beschränkungen der Servicekontingenten**  

| API-Name | Standard | Maximal einstellbares Limit | Mehr als einstellbares maximales Limit | 
| --- | --- | --- | --- | 
| [Routen berechnen](calculate-routes.md) | 20 | 40 | Fragen Sie über die [Service-Kontingentkonsole](https://console.aws.amazon.com/servicequotas/home#!/services/geo/quotas) an oder wenden Sie sich an das Support-Team | 
| [Isolinien berechnen](calculate-isolines.md) | 20 | 40 | Fragen Sie über die [Service Quota Console](https://console.aws.amazon.com/servicequotas/home#!/services/geo/quotas) an oder wenden Sie sich an das Support-Team | 
| [Snap to Roads](snap-to-roads.md) | 20 | 40 | Fragen Sie über die [Service Quota Console](https://console.aws.amazon.com/servicequotas/home#!/services/geo/quotas) an oder wenden Sie sich an das Support-Team | 
| [Routenmatrix berechnen](calculate-route-matrix.md) | 5 | 10 | Fragen Sie über die [Service Quota Console](https://console.aws.amazon.com/servicequotas/home#!/services/geo/quotas) an oder wenden Sie sich an das Support-Team | 
| [Wegpunkte optimieren](actions-optimize-waypoints.md) | 5 | 10 | Fragen Sie über die [Service Quota Console](https://console.aws.amazon.com/servicequotas/home#!/services/geo/quotas) an oder wenden Sie sich an das Support-Team | 

## Andere Nutzungsbeschränkungen
<a name="other-usage-limits"></a>

Zusätzlich zu den Servicekontingenten gelten die folgenden API-Nutzungsbeschränkungen:


**Andere Nutzungsbeschränkungen**  

| API-Name | Limit | Wert | 
| --- | --- | --- | 
| [Snap to Roads](snap-to-roads.md) | Summe der geodätischen Entfernung zwischen allen TracePoints | 500 KM | 
| [Wegpunkte optimieren](actions-optimize-waypoints.md) | Summe der geodätischen Entfernung zwischen dem Startpunkt, den Wegpunkten in der angegebenen Reihenfolge und dem Ziel | 100 KM | 
| [Wegpunkte optimieren](actions-optimize-waypoints.md) | Umfang des Begrenzungsrahmens, der den Ursprung, die Wegpunkte und das Ziel umgibt | 500 KM | 
| [Routenmatrix berechnen](calculate-route-matrix.md) | Maximale Entfernung zwischen Start- und Zielorten für unbegrenztes Routing (wenn Avoid oder TravelModeOptions .Truck verwendet wird) | 60 KM | 
| [Routenmatrix berechnen](calculate-route-matrix.md) | Maximale Entfernung zwischen Start- und Zielorten für unbegrenztes Routing | 10000 KM | 
| [Routen berechnen](calculate-routes.md) | Größe der Antwort-Nutzlast nach der Komprimierung | 6 MB | 
| [Routenmatrix berechnen](calculate-route-matrix.md) | Größe der Antwort-Nutzlast nach der Komprimierung | 6 MB | 
| [Isolinien berechnen](calculate-isolines.md) | Größe der Antwort-Nutzlast nach der Komprimierung | 6 MB | 
| [Wegpunkte optimieren](actions-optimize-waypoints.md) | Größe der Antwort-Nutzlast nach der Komprimierung | 6 MB | 
| [Snap to Roads](snap-to-roads.md) | Größe der Antwort-Nutzlast nach der Komprimierung | 6 MB | 

## Nächste Schritte
<a name="next-steps"></a>

Bitte überprüfen Sie die folgenden Informationen für weitere Informationen:
+ [Zuordnung](https://docs.aws.amazon.com/location/latest/developerguide/data-attribution.html): Informationen zu den Anforderungen an die Datenzuweisung für Amazon Location Service.
+ [SLA](https://aws.amazon.com/location/sla/): Das Service Level Agreement für Amazon Location Service, einschließlich Verfügbarkeitszusagen und Reaktionszeiten.
+ [Servicebedingungen](https://aws.amazon.com/service-terms/): Bedingungen, die die Nutzung von Amazon Location Service regeln, einschließlich Einschränkungen und Beschränkungen.