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.
Routenplanung mit einer Routenmatrix in Amazon Location
Sie können Amazon Location Service verwenden, um Eingaben für Ihre Routenplanungs- und Optimierungssoftware zu erstellen. Sie können Routenergebnisse, einschließlich Reisezeit und Reisedistanz, für Routen zwischen einer Reihe von Abflugspositionen und einer Reihe von Zielpositionen erstellen.
Wenn beispielsweise die Abflugspositionen A und B und die Zielpositionen X und Y angegeben sind, gibt Amazon Location Service die Reisezeit und die Reisedistanz für Routen von A nach X, A nach Y, B nach X und B nach Y zurück.
Sie können die Routen mit unterschiedlichen Transportmitteln, Vermeidungsmöglichkeiten und Verkehrsbedingungen berechnen. Sie können beispielsweise angeben, dass es sich bei dem Fahrzeug um einen Lkw mit einer Länge von 35 Fuß handelt, und die berechnete Route verwendet diese Einschränkungen, um die Reisezeit und die Reisedistanz zu bestimmen.
Die Anzahl der zurückgegebenen Ergebnisse (und der berechneten Routen) entspricht der Anzahl der Abfahrtspositionen multipliziert mit der Anzahl der Zielpositionen. Ihnen wird jede berechnete Route in Rechnung gestellt, nicht jede Anfrage an den Service. Eine Routenmatrix mit 10 Abfahrten und 10 Zielen wird also als 100 Routen abgerechnet.
Berechnung einer Routenmatrix
Sie können eine Routenmatrix zwischen einer Reihe von Abflugspositionen und einer Reihe von Zielpositionen berechnen. Die Routenergebnisse werden die Reisezeit und die Reisedistanz beinhalten.
Voraussetzung
-
Sie müssen zunächst eine Routenberechnungsressource erstellen und die Authentifizierung für Ihre Anfragen an Amazon Location einrichten. Weitere Informationen finden Sie unter Voraussetzungen für die Berechnung von Routen mit Amazon Location.
Reichen Sie mithilfe des CalculateRouteMatrix
Vorgangs eine Anfrage ein. Eine Minimalanforderung enthält die folgenden Pflichtfelder:
-
DeparturePositions
— Die Gruppe von Startpositionen, für die die Routen berechnet werden sollen. Definiert als ein Array von[longitude, latitude]
-
DestinationPositions
— Die Gruppe von Endpositionen, für die die Routen berechnet werden sollen. Definiert als ein Array von[longitude, latitude]
.
Anmerkung
Wenn Sie eine Abfahrts- oder Zielposition angeben, die sich nicht an einer Straße befindet, verschiebt Amazon Location die Position auf die nächstgelegene Straße.
Sie können in Ihrer Anfrage optional eine Abfahrtszeit und einen Reisemodus angeben.
Sie können den AWS CLI oder den Amazon-Standort verwendenAPIs.
Standardmäßig wird die Antwort Distance
in Kilometern zurückgegeben. Mit dem folgenden optionalen Parameter können Sie die Maßeinheit in Meilen ändern:
-
DistanceUnit
— Gibt das Einheitensystem an, das für die Entfernungsergebnisse verwendet werden soll.
POST /routes/v0/calculators/
ExampleCalculator
/calculate/route-matrix Content-type: application/json { "DeparturePositions": [ [-122.7565
,49.0021
], [-122.2014
,47.6101
] ], "DestinationPositions": [ [-122.3394
,47.6159
], [-122.4813
,48.7511
] ], "DistanceUnit": "Miles
" }
Einschränkungen bei Abflug- und Zielpositionen
Bei der Berechnung einer Routenmatrix gibt es Einschränkungen hinsichtlich der Abfahrts- und Zielpositionen. Diese Einschränkungen variieren je nach dem von der RouteCalculator
Ressource verwendeten Anbieter.
Einschränkung | Esri | Schnappen | HERE |
---|---|---|---|
Anzahl der Positionen | Bis zu 10 Abflugspositionen und 10 Zielpositionen. | Bis zu 350 Abflugspositionen und 350 Zielpositionen. |
Bis zu 350 Abflugspositionen und 350 Zielpositionen. Für längere Strecken gelten zusätzliche Einschränkungen. Siehe den Abschnitt. |
Entfernung zwischen den Positionen | Jedes Paar von Start- und Zielpositionen muss nicht weiter als 400 km voneinander entfernt sein (40 km für Wanderrouten). |
Alle Start- und Zielpositionen müssen innerhalb eines Kreises mit einem Durchmesser von 180 km liegen. Für längere Strecken gelten zusätzliche Einschränkungen. Siehe den Abschnitt. |
|
Länge der Route | Routen werden nicht fertiggestellt, wenn die Gesamtfahrzeit für die Route mehr als 400 Minuten beträgt. |
Strecken, die außerhalb eines Kreises um den Start- und Zielpunkt mehr als 10 km abweichen, werden nicht berechnet. Für längere Strecken gelten zusätzliche Einschränkungen. Siehe den Abschnitt. |
|
Regionen | Die Berechnung einer Routenmatrix wird in Korea nicht unterstützt. | In Südostasien erhältlich. Eine Liste der unterstützten Länder/Regionen und weitere Informationen finden Sie unter. Länder/Regionen und abgedecktes Gebiet | Keine zusätzlichen Einschränkungen. |
Längere Routenplanung
Die Berechnung einer Matrix von Routenergebnissen ist für eine effiziente Routenplanung nützlich, die Berechnung kann jedoch einige Zeit in Anspruch nehmen. Alle Datenanbieter von Amazon Location Service beschränken die Anzahl der Routen oder die Entfernung der Routen, die berechnet werden können. HEREErmöglicht beispielsweise die Erstellung von Routen zwischen 350 Start- und Zielpositionen, wobei diese Positionen jedoch innerhalb eines 180 km langen Kreises liegen müssen. Was ist, wenn Sie längere Strecken planen möchten?
Sie können eine Matrix von Routen mit unbegrenzter Länge für eine kleinere Anzahl von Routen berechnen, indem Sie a RouteCalculator
mit HERE als Datenanbieter verwenden. Dies ändert nichts an der Art und Weise, wie Sie den CalculateRouteMatrix
API Standort anrufen. Amazon Location ermöglicht lediglich längere Routen, wenn Sie die Anforderungen erfüllen.
Die Anforderungen für die Berechnung von Routen mit längerer Länge sind:
-
Sie
RouteCalculator
müssen den HERE Datenanbieter verwenden. -
Die Anzahl der Abflugspositionen darf nicht größer als 15 sein.
-
Die Gesamtzahl der zu berechnenden Strecken darf 100 nicht überschreiten.
-
Das Routing über große Entfernungen ist für Lkw-Routing mit Mautvermeidung nicht zulässig, wenn die Strecken länger als 1.000 km sind. Diese Kombination ist langsamer zu berechnen und kann zu einem Timeout beim Anruf führen. Sie können diese Routen mit der CalculateRouteOperation individuell berechnen.
Wenn Ihr Anruf diese Anforderungen nicht erfüllt (Sie fordern beispielsweise 150 Routenberechnungen in einem einzigen Anruf an), CalculateRouteMatrix
werden nur die kürzeren Routenregeln zugelassen. Sie können dann die Routen berechnen, sofern sich die Positionen innerhalb eines Kreises von 180 km befinden.
Beachten Sie bei der Berechnung längerer Routen die folgenden Punkte:
-
Die Berechnung längerer Routen kann länger dauern, sogar länger als die maximale Zeit für Amazon LocationAPIs. Wenn es bei bestimmten Routen häufig zu Timeouts kommt, können Sie bei jedem Anruf eine kleinere Anzahl von Routen ausprobieren.
CalculateRouteMatrix
-
Wenn Sie Ihrer
CalculateRouteMatrix
Anfrage weitere Ziel- oder Abflugspositionen hinzufügen, kann der Vorgang in den eingeschränkteren Modus wechseln, und Sie erhalten möglicherweise eine Fehlermeldung für eine Route, die problemlos berechnet werden kann, wenn weniger Routen erstellt werden müssen. Reduzieren Sie in diesem Fall die Anzahl der Ziel- oder Abflugspositionen und stellen Sie mehrere Anfragen, um alle benötigten Routenberechnungen zu erhalten.
Beispielantwort
Im Folgenden finden Sie eine Beispielanforderung mit der entsprechenden Antwort, wenn der CalculateRouteMatrix
Vorgang von Amazon Location Routes aus aufgerufen wirdAPI.