Routenplanung mit einer Routenmatrix - Amazon Location Service

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

Sie können Amazon Location Service verwenden, um Eingaben für Ihre Routenplanungs- und Optimierungssoftware zu erstellen. Sie können Routenergebnisse, einschließlich der Zeit und Entfernung, für Routen zwischen einer Reihe von Abstiegspositionen und einer Reihe von Zielpositionen erstellen.

Angenommen, es handelt sich um die Abgangspositionen A und B sowie die Zielpositionen X und Y. Amazon Location Service gibt die Zeit und Entfernung für Routen von A zu X, A zu Y, B zu X und B zu Y zurück.

Sie können die Routen mit unterschiedlichen Transportarten, Abstammungen und Verkehrsbedingungen berechnen. Sie können beispielsweise angeben, dass das Fahrzeug ein Lkw mit einer Länge von 35 Fuß ist, und die berechnete Route verwendet diese Einschränkungen, um die Fahrtzeit und die Entfernung zu bestimmen.

Die Anzahl der zurückgegebenen Ergebnisse (und berechneten Routen) ist die Anzahl der Abstiegspositionen multipliziert mit der Anzahl der Zielpositionen. Ihnen wird jede berechnete Route in Rechnung gestellt, nicht jede Anforderung an den Service. Daher wird eine Routenmatrix mit 10 Abgängen und 10 Zielen als 100 Routen abgerechnet.

Berechnen einer Routenmatrix

Sie können eine Matrix von Routen zwischen einer Reihe von Abstiegspositionen und einer Reihe von Zielpositionen berechnen. Die Routenergebnisse beinhalten die Reisezeit und die Entfernung.

Voraussetzung

  • Sie müssen zunächst eine Routenrechner-Ressource erstellen und die Authentifizierung für Ihre Anfragen an Amazon Location einrichten. Weitere Informationen finden Sie unter Voraussetzungen.

Senden Sie eine -Anforderung mithilfe der -CalculateRouteMatrixOperation. Eine minimale Anforderung enthält die folgenden Pflichtfelder:

  • DeparturePositions – Der Satz von Startpositionen, für die die Routen berechnet werden sollen. Definiert als Array von [longitude, latitude]

  • DestinationPositions – Der Satz von Endpositionen, für die die Routen berechnet werden sollen. Definiert als Array von [longitude, latitude].

Anmerkung

Wenn Sie eine Verlassen- oder Zielposition angeben, die sich nicht auf einer Straßen befindet, verschiebt Amazon Location die Position auf die nächste Straßen .

Sie können optional eine Ankunftszeit und einen Reisemodus in Ihrer Anfrage angeben.

Sie können die AWS CLI oder die Amazon Location APIs verwenden.

API

Das folgende Beispiel ist eine -CalculateRouteMatrixAnforderung mit der Routenrechner-Ressource ExampleCalculator. Die Anforderung gibt die Berechnung der Matrix der Routen von den Abgangspositionen [-122.7565, 49.0021] und [-122.2014, 47.6101] zu den Zielpositionen [-122.3394, 47.6159] und [-122.4813, 48.7511] an.

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] ] }
AWS CLI

Das folgende Beispiel ist ein calculate-route-matrix Befehl, der die Routenrechner-Ressource verwendetExampleCalculator. Die Anforderung gibt die Berechnung der Matrix der Routen von den Abgangspositionen [-122.7565, 49.0021] und [-122.2014, 47.6101] zu den Zielpositionen [-122.3394, 47.6159] und [-122.4813, 48.7511] an.

aws location \ calculate-route-matrix \ --calculator-name ExampleCalculator \ --departure-positions "[[-122.7565,49.0021],[-122.2014,47.6101]]" \ --destination-positions "[[-122.3394,47.6159],[-122.4813,48.7511]]"

Standardmäßig gibt die Antwort Distance in Kilometern zurück. Mit dem folgenden optionalen Parameter können Sie die Maßeinheit in Fuß ändern:

  • DistanceUnit – Gibt das Einheitensystem an, das für die Abstandsergebnisse 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 der Ankunft und bei Zielpositionen

Bei der Berechnung einer Routenmatrix gibt es Einschränkungen in Bezug auf die Ausgangs- und Zielpositionen. Diese Einschränkungen variieren je nach Anbieter, der von der RouteCalculator Ressource verwendet wird.

Einschränkung Esri Grab Hier
Anzahl der Positionen Bis zu 10 Ausgangspositionen und 10 Zielpositionen. Bis zu 350 Ausgangspositionen und 350 Zielpositionen.

Bis zu 350 Ausgangspositionen und 350 Zielpositionen.

Für längere Routen gelten zusätzliche Einschränkungen. Weitere Informationen finden Sie im Abschnitt .

Abstand zwischen Positionen Jedes Paar von Verlassen- und Zielpositionen muss sich innerhalb von 400 km voneinander befinden (40 km für Walking-Routen).

Alle Eingangs- und Zielpositionen müssen innerhalb eines 180 km langen Trichterkreises liegen.

Für längere Routen gelten zusätzliche Einschränkungen. Weitere Informationen finden Sie im Abschnitt .

Routenlänge Routen werden nicht abgeschlossen, wenn die Gesamtreisezeit für die Route mehr als 400 Minuten beträgt.

Routen, die mehr als 10 km außerhalb eines Kreises um die Ausgangspunkte und Zielpunkte herum abweichen, werden nicht berechnet.

Für längere Routen gelten zusätzliche Einschränkungen. Weitere Informationen finden Sie im Abschnitt .

Regionen Die Berechnung einer Routenmatrix wird in Korea nicht unterstützt. Verfügbar in Südostasien. 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, aber die Berechnung kann einige Zeit in Anspruch nehmen. Alle Amazon Location Service-Datenanbieter setzen Einschränkungen für die Anzahl der Routen oder die Entfernung der Routen fest, die berechnet werden können. HERE ermöglicht beispielsweise das Erstellen von Routen zwischen 350 Eingangs- und Zielpositionen, diese Positionen müssen jedoch innerhalb eines 180-km-Bereichs liegen. Was ist, wenn Sie mit längeren Routen planen möchten?

Sie können eine Matrix von Routen mit uneingeschränkten Längen für eine geringere Anzahl von Routen berechnen, indem Sie einen RouteCalculator mit HERE als Datenanbieter verwenden. Dies ändert nichts daran, wie Sie die CalculateRouteMatrix API aufrufen. Amazon Location lässt einfach längere Routen zu, wenn Sie die Anforderungen erfüllen.

Die Anforderungen für Routenberechnungen mit längerer Länge sind:

  • Der RouteCalculator muss den HERE-Datenanbieter verwenden.

  • Die Anzahl der Abstiegspositionen darf nicht größer als 15 sein.

  • Die Gesamtzahl der zu berechnenden Routen darf nicht größer als 100 sein.

  • Langdistanz-Routing ist für Lkw-Routing mit Gebührenvermeidungen nicht zulässig, wenn die Routen größer als 1.000 km sind. Diese Kombination ist langsamer zu berechnen und kann dazu führen, dass der Aufruf eine Zeitüberschreitung hat. Sie können diese Routen mit der -CalculateRouteOperation einzeln berechnen.

Wenn Ihr Aufruf diese Anforderungen nicht erfüllt (z. B. wenn Sie 150 Routenberechnungen in einem einzigen Aufruf anfordern), CalculateRouteMatrix kehrt dazu zurück, nur die kürzeren Routenregeln zuzulassen. Anschließend können Sie die Routen berechnen, solange sich die Positionen in einem 180-km-Kreis befinden.

Beachten Sie bei der Berechnung längerer Routen die folgenden Punkte:

  • Längere Routen können länger dauern als die maximale Zeit für Amazon Location APIs . Wenn Sie häufige Timeouts mit bestimmten Routen erhalten, können Sie bei jedem Aufruf von eine geringere Anzahl von Routen ausprobierenCalculateRouteMatrix.

  • Wenn Sie Ihrer CalculateRouteMatrix Anfrage weitere Ziel- oder Ausgangspositionen hinzufügen, kann der Vorgang in den eingeschränkteren Modus wechseln und Sie können eine Fehlermeldung für eine Route erhalten, die problemlos berechnet werden kann, wenn weniger Routen erstellt werden müssen. Reduzieren Sie in diesem Fall die Anzahl der Ziel- oder Ausgangspositionen und stellen Sie mehrere Anfragen, um den gesamten Satz von Routenberechnungen zu erhalten, die Sie benötigen.

Beispielantwort

Im Folgenden finden Sie eine Beispielanforderung mit der entsprechenden Antwort beim Aufrufen der -CalculateRouteMatrixOperation von der Amazon Location Routes API aus.

Example request
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] ] }
Example response
{ "RouteMatrix": [ [ { "Distance": 178.764, "DurationSeconds": 7565 }, { "Distance": 39.795, "DurationSeconds": 1955 } ], [ { "Distance": 15.31, "DurationSeconds": 1217 }, { "Distance": 142.506, "DurationSeconds": 6279 } ] ], "Summary": { "DataSource": "Here", "RouteCount": 4, "ErrorCount": 0, "DistanceUnit": "Kilometers" } }