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'CalculateRouteMatrix
operazione. 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.
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'CalculateRouteMatrix
API, 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'CalculateRouteMatrix
operazione dall'API Amazon Location Routes.