Route mit Amazon Location berechnen - 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.

Route mit Amazon Location berechnen

Sie können Amazon Location Service verwenden, um Routen zwischen einem Start- und einem Zielort mit bis zu 23 Wegpunkten entlang der Route für verschiedene Transportarten, Vermeidungen und Verkehrsbedingungen zu berechnen.

Anmerkung

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.

Beginnen Sie mit der Berechnung von Routen

Senden Sie mithilfe der CalculateRoute Operation eine einfache Anfrage. Eine einfache Anfrage enthält die folgenden Pflichtfelder:

  • DeparturePosition— Die Startposition, von der aus die Route berechnet werden soll. Definiert als [longitude, latitude]

  • DestinationPosition— Die Endposition, bis zu der die Route berechnet werden soll. Definiert als[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 Wegpunkte, eine Abfahrtszeit und einen Reisemodus angeben.

Sie können den AWS CLI oder den Amazon-Standort verwendenAPIs.

API

Das folgende Beispiel ist eine CalculateRoute Anfrage, die die Ressource Route Calculator verwendet ExampleCalculator. Die Anfrage spezifiziert die Berechnung einer Route von einer Abflugsposition aus [-122.7565, 49.0021] zu einer Zielposition [-122.3394, 47.6159].

POST /routes/v0/calculators/ExampleCalculator/calculate/route Content-type: application/json { "DeparturePosition": [-122.7565,49.0021], "DestinationPosition": [-122.3394, 47.6159] }
AWS CLI

Das folgende Beispiel ist ein calculate-route Befehl, der die Ressource Route Calculator verwendet ExampleCalculator. Die Anfrage spezifiziert die Berechnung einer Route von einer Abflugsposition aus [-122.7565, 49.0021] zu einer Zielposition [-122.3394, 47.6159].

aws location \ calculate-route \ --calculator-name ExampleCalculator \ --departure-position -122.7565 49.0021 \ --destination-position -122.3394 47.6159

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 Content-type: application/json { "DeparturePosition": [-122.7565,49.0021], "DestinationPosition": [-122.3394, 47.6159], "DistanceUnit": "Miles" }

Wegpunkte setzen

Bei der Berechnung einer Route können Sie mithilfe von Wegpunktpositionen bis zu 23 Zwischenlandungspunkte zwischen der Abfahrts- und der Zielposition angeben.

  • WaypointPositions— Gibt eine geordnete Liste von Zwischenpositionen an, die entlang einer Route zwischen der Abfahrts- und der Zielposition berücksichtigt werden sollen.

    Anmerkung

    Wenn Sie eine Wegpunktposition angeben, die sich nicht auf einer Straße befindet, verschiebt Amazon Location die Position auf die nächstgelegene Straße.

Die folgende CalculateRoute Anfrage berechnet eine Route mit 2 Wegpunkten:

  • Die Abfahrtsposition ist [-122.7565, 49.0021] und die Zielposition ist [-122.3394, 47.6159].

  • WaypointPositionsFür den Anforderungsparameter:

    • Die erste Zwischenstation ist [-122.1884, 48.0936].

    • Die zweite Stop-Over-Position ist [-122.3493, 47.6205].

  • Um die Geometrie der Beinlinie zwischen diesen beiden Wegpunkten einzubeziehen, setzen Sie den folgenden optionalen Parameter auf true:

    • IncludeLegGeometry— Schließt die Geometrie der einzelnen Pfade zwischen zwei Positionen in die Antwort ein.

POST /routes/v0/calculators/ExampleCalculator/calculate/route Content-type: application/json { "DeparturePosition": [-122.7565,49.0021], "DestinationPosition": [-122.3394, 47.6159], "WaypointPositions":[ [-122.1884,48.0936], [-122.3493,47.6205] ], "IncludeLegGeometry": true }

Beispielantwort

Im Folgenden finden Sie eine Beispielanforderung mit der entsprechenden Antwort beim Aufrufen des CalculateRoute Vorgangs über Amazon Location Routes API mit der IncludeLegGeometry Einstellung auf true, das die Liniengeometrie jedes Pfads zwischen zwei Positionen in der Antwort beinhaltet.

Example request
POST /routes/v0/calculators/ExampleCalculator/calculate/route Content-type: application/json { "DeparturePosition": [-122.7565,49.0021], "DestinationPosition": [-122.3394, 47.6159], "IncludeLegGeometry": true }
Example response
{ "Legs": [ { "Distance": 178.5, "DurationSeconds": 6480, "EndPosition": [-122.3394,47.6159], "Geometry": { "LineString": [ [-122.7565,49.0021], [-122.3394,47.6159] ] }, "StartPosition": [-122.7565,49.0021], "Steps": [ { "Distance": 178.5, "DurationSeconds": 6480, "EndPosition": [-122.3394,47.6159], "GeometryOffset": 0, "StartPosition": [-122.7565,49.0021] } ] } ], "Summary": { "DataSource": "Esri", "Distance": 178.5, "DistanceUnit": "Kilometers", "DurationSeconds": 6480, "RouteBBox": [ -122.7565,49.0021, -122.3394,47.6159 ] } }