Calcola un percorso con Amazon Location - Servizio di posizione Amazon

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Calcola un percorso con Amazon Location

Puoi utilizzare Amazon Location Service per calcolare i percorsi tra un'origine e una destinazione, con un massimo di 23 waypoint lungo il percorso, per diverse modalità di trasporto, evitamenti e condizioni del traffico.

Nota

Devi prima creare una risorsa per il calcolo del percorso e configurare l'autenticazione per le tue richieste ad Amazon Location. Per ulteriori informazioni, consulta Prerequisiti per il calcolo dei percorsi utilizzando Amazon Location.

Inizia a calcolare i percorsi

Invia una richiesta semplice utilizzando l'CalculateRouteoperazione. Una richiesta semplice contiene i seguenti campi obbligatori:

  • DeparturePosition— La posizione di partenza da cui calcolare il percorso. Definita come [longitude, latitude]

  • DestinationPosition— La posizione finale verso la quale calcolare il percorso. Definito come[longitude, latitude].

Nota

Se specifichi una posizione di partenza o di destinazione che non si trova su una strada, Amazon Location sposta la posizione sulla strada più vicina.

Facoltativamente, puoi specificare waypoint, un orario di partenza e una modalità di viaggio nella tua richiesta.

Puoi utilizzare la AWS CLI o la sede AmazonAPIs.

API

L'esempio seguente è una CalculateRoute richiesta che utilizza la risorsa Route Calculator ExampleCalculator. La richiesta specifica il calcolo di un percorso a partire da una posizione di partenza [-122.7565, 49.0021] a una posizione di destinazione [-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

L'esempio seguente è un calculate-route comando che utilizza la risorsa del calcolatore di percorso ExampleCalculator. La richiesta specifica il calcolo di un percorso a partire da una posizione di partenza [-122.7565, 49.0021] a una posizione di destinazione [-122.3394, 47.6159].

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

Per impostazione predefinita, la risposta viene restituita Distance in chilometri. È possibile modificare l'unità di misura in miglia utilizzando il seguente parametro opzionale:

  • DistanceUnit— specifica il sistema di unità da utilizzare per i risultati della distanza.

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

Impostazione dei waypoint

Quando si calcola un percorso, è possibile specificare fino a 23 punti di scalo intermedi tra la posizione di partenza e la posizione di destinazione utilizzando le posizioni dei waypoint.

  • WaypointPositions— Speciifica un elenco ordinato di posizioni intermedie da includere lungo un percorso tra la posizione di partenza e la posizione di destinazione.

    Nota

    Se specifichi una posizione del waypoint che non si trova su una strada, Amazon Location sposta la posizione sulla strada più vicina.

La seguente CalculateRoute richiesta calcola un percorso con 2 waypoint:

  • La posizione di partenza è [-122.7565, 49.0021] e la posizione di destinazione è [-122.3394, 47.6159].

  • WaypointPositionsPer il parametro di richiesta:

    • La prima posizione di stop over è [-122.1884, 48.0936].

    • La seconda posizione di stop over è [-122.3493, 47.6205].

  • Per includere la geometria del leg linestring tra questi due waypoint, imposta il seguente parametro opzionale su true:

    • IncludeLegGeometry— Include la geometria di ogni percorso tra un paio di posizioni nella risposta.

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 }

Example response

Di seguito è riportato un esempio di richiesta con la risposta corrispondente quando si chiama l'CalculateRouteoperazione da Amazon Location Routes API con l'IncludeLegGeometryimpostazione su true, che include la geometria delle stringhe lineari di ogni percorso tra una coppia di posizioni nella risposta.

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