Pianificazione del percorso con una matrice di percorso - 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à.

Pianificazione del percorso con una matrice di percorso

Puoi utilizzare Amazon Location Service per creare input per il tuo software di pianificazione e ottimizzazione dei percorsi. Puoi creare risultati di percorso, inclusi tempo di viaggio e distanza da percorrere, per percorsi tra una serie di posizioni di partenza e una serie di posizioni di destinazione.

Ad esempio, date le posizioni di partenza A e B e le posizioni di destinazione X e Y, Amazon Location Service restituirà il tempo di viaggio e la distanza percorsa per i percorsi da A a X, da A a Y, da B a X e da B a Y.

Puoi calcolare i percorsi con diverse modalità di trasporto, evitamenti e condizioni del traffico. Ad esempio, è possibile specificare che il veicolo è un camion lungo 35 piedi e il percorso calcolato utilizzerà tali restrizioni per determinare il tempo di viaggio e la distanza da percorrere.

Il numero di risultati restituiti (e percorsi calcolati) è il numero di posizioni di partenza moltiplicato per il numero di posizioni di destinazione. Ti viene addebitato ogni itinerario calcolato, non ogni richiesta al servizio, quindi una matrice di itinerari con 10 partenze e 10 destinazioni verrà fatturata come 100 rotte.

Calcolo di una matrice di itinerari

È possibile calcolare una matrice di percorsi tra un insieme di posizioni di partenza e un insieme di posizioni di destinazione. I risultati del percorso includeranno il tempo di viaggio e la distanza da percorrere.

Prerequisito

  • 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.

Invia una richiesta utilizzando l'CalculateRouteMatrixoperazione. Una richiesta minima contiene i seguenti campi obbligatori:

  • DeparturePositions— L'insieme delle posizioni di partenza per le quali calcolare i percorsi. Definito come una matrice di [longitude, latitude]

  • DestinationPositions— L'insieme delle posizioni finali per le quali calcolare i percorsi. Definito come una matrice di[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 un orario di partenza e una modalità di viaggio nella tua richiesta.

Puoi utilizzare le AWS CLI o le API di localizzazione di Amazon.

API

L'esempio seguente è una CalculateRouteMatrix richiesta che utilizza la risorsa route calculator. ExampleCalculator La richiesta specifica il calcolo della matrice dei percorsi dalle posizioni di partenza [-122.7565, 49.0021] e [-122.2014, 47.6101] alle posizioni di destinazione [-122.3394, 47.6159] e [-122.4813, 48.7511].

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

L'esempio seguente è un comando ExampleCalculatorche utilizza la risorsa del calcolatore di rotta. calculate-route-matrix La richiesta specifica il calcolo della matrice dei percorsi dalle posizioni di partenza [-122.7565, 49.0021] e [-122.2014, 47.6101] alle posizioni di destinazione [-122.3394, 47.6159] e [-122.4813, 48.7511].

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

Per impostazione predefinita, la risposta viene restituita in chilometri. Distance È 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-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" }

Restrizioni sulle posizioni di partenza e di destinazione

Quando si calcola una matrice di percorso, esistono restrizioni sulle posizioni di partenza e di destinazione. Queste restrizioni variano a seconda del provider utilizzato dalla RouteCalculator risorsa.

Limitazione Esri Afferra QUI
Numero di posizioni Fino a 10 posizioni di partenza e 10 posizioni di destinazione. Fino a 350 posizioni di partenza e 350 posizioni di destinazione.

Fino a 350 posizioni di partenza e 350 posizioni di destinazione.

Per i percorsi più lunghi, si applicano restrizioni aggiuntive. Consulta la sezione.

Distanza tra le posizioni Qualsiasi coppia di posizioni di partenza e di destinazione deve trovarsi entro 400 km l'una dall'altra (40 km per i percorsi pedonali).

Tutte le posizioni di partenza e di destinazione devono rientrare in un cerchio di 180 km di diametro.

Per i percorsi più lunghi, si applicano restrizioni aggiuntive. Consulta la sezione.

Lunghezza del percorso I percorsi non verranno completati se il tempo di percorrenza totale per il percorso è superiore a 400 minuti.

I percorsi che si discostano per più di 10 km dall'esterno di un cerchio attorno ai punti di partenza e di destinazione non verranno calcolati.

Per i percorsi più lunghi, si applicano restrizioni aggiuntive. Consulta la sezione.

Regioni Il calcolo di una matrice di percorso non è supportato in Corea. Disponibile nel sud-est asiatico. Per un elenco dei paesi/aree geografiche supportati e ulteriori informazioni, consulta. Paesi/regioni e aree coperte Nessuna restrizione aggiuntiva.

Pianificazione di percorsi più lunghi

Il calcolo di una matrice dei risultati del percorso è utile per una pianificazione efficiente del percorso, ma il calcolo può richiedere del tempo. Tutti i fornitori di dati di Amazon Location Service impongono limitazioni al numero di percorsi o alla distanza dei percorsi che possono essere calcolati. Ad esempio, HERE consente di creare percorsi tra 350 posizioni di partenza e di destinazione, ma tali posizioni devono rientrare in un cerchio di 180 km. Cosa succede se desideri pianificare percorsi più lunghi?

Puoi calcolare una matrice di percorsi con lunghezze illimitate per un numero inferiore di percorsi utilizzando, a RouteCalculator con HERE come fornitore di dati. Ciò non cambia il modo in cui chiami l'CalculateRouteMatrixAPI, Amazon Location consente semplicemente percorsi più lunghi quando soddisfi i requisiti.

I requisiti per il calcolo di percorsi di maggiore lunghezza sono:

  • È RouteCalculator necessario utilizzare il fornitore di dati HERE.

  • Il numero di posizioni di partenza non deve essere superiore a 15.

  • Il numero totale di rotte da calcolare non deve essere superiore a 100.

  • L'itinerario a lunga distanza non è consentito per gli itinerari su camion che evitano i pedaggi quando i percorsi superano i 1.000 km. Questa combinazione è più lenta da calcolare e può causare il timeout della chiamata. È possibile calcolare questi percorsi singolarmente con l'CalculateRouteoperazione.

Se la chiamata non soddisfa questi requisiti (ad esempio, si richiedono 150 calcoli di percorso in una singola chiamata), CalculateRouteMatrix tornerà a consentire solo le regole di routing più brevi. È quindi possibile calcolare i percorsi, purché le posizioni si trovino all'interno di un cerchio di 180 km.

Nel calcolare percorsi più lunghi, tieni a mente questi punti:

  • I percorsi più lunghi possono richiedere più tempo per essere calcolati, anche più del tempo massimo per le API di localizzazione di Amazon. Se ricevi timeout frequenti con percorsi specifici, puoi provare un numero inferiore di percorsi per ogni chiamata verso. CalculateRouteMatrix

  • Se aggiungi più destinazioni o posizioni di partenza alla tua CalculateRouteMatrix richiesta, l'operazione può passare alla modalità più limitata e potresti ricevere un errore relativo a un percorso che può essere calcolato senza problemi quando ci sono meno percorsi da creare. In questo caso, riduci il numero di posizioni di destinazione o di partenza ed effettua più richieste per ottenere il set completo di calcoli del percorso di cui hai bisogno.

Example response

Di seguito è riportato un esempio di richiesta con la risposta corrispondente quando si chiama l'CalculateRouteMatrixoperazione dall'API Amazon Location Routes.

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