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 percorsi
L'API Routes calcola i percorsi tra due o più località con o senza evitamenti per diverse modalità di viaggio come auto, camion, scooter e pedone. Con questa API, puoi personalizzare le opzioni di routing e richiedere informazioni aggiuntive relative al percorso per soddisfare esigenze specifiche. Questa API supporta turn-by-turn la navigazione e personalizza i calcoli dei percorsi applicando parametri come evitare strade a pedaggio, autostrade o traghetti. L'API restituisce anche i limiti di velocità e i costi dei pedaggi.
Per ulteriori informazioni, consulta il *riferimento [CalculateRoutes](https://docs.aws.amazon.com/location/latest/APIReference/API_CalculateRoutes.html)all'API di Amazon Location Service*.
Per esempio richieste, risposte, cURL e comandi CLI per questa API, vedi [Come usare](https://docs.aws.amazon.com/location/latest/developerguide/calculate-routes-how-to.html) Calculate route.
![\[Una panoramica dei percorsi di Amazon Location Service.\]](http://docs.aws.amazon.com/it_it/location/latest/developerguide/images/routesV2/P2P-Turn-by-turn-navigation.gif)
## Casi d’uso
+ **Visualizza i dettagli geografici su una mappa del percorso:** utilizza funzionalità di mappatura avanzate per visualizzare percorsi dettagliati con informazioni geografiche complete, tra cui punti di riferimento, terreno e infrastrutture urbane. Migliora il processo decisionale consentendo agli utenti di visualizzare percorsi chiari dal punto di partenza alla destinazione. Questa funzionalità può supportare la navigazione, la pianificazione e vari scenari logistici e visualizzare percorsi per modalità di viaggio come auto, camion, scooter e pedoni. Personalizza i percorsi aggiungendo elementi come gli evitamenti o il calcolo dei pedaggi.
+ **Mostra turn-by-turn la navigazione: offri** un supporto di navigazione senza interruzioni su dispositivi web e mobili. Gli utenti possono accedere alle turn-by-turn indicazioni stradali, garantendo viaggi efficienti. Entrambe le piattaforme possono sfruttare le istruzioni di navigazione per offrire percorsi per viaggi personali o aziendali, compresi i limiti di velocità.
+ **Calcola i costi dei pedaggi lungo i percorsi:** incorpora i calcoli dei costi dei pedaggi nella pianificazione del percorso per fornire stime accurate dei prezzi per i percorsi che includono strade a pedaggio, ponti o tunnel. Visualizza in anticipo i costi dei pedaggi per aiutare conducenti e pianificatori a prendere decisioni convenienti ed evitare i pedaggi quando necessario.
+ **Garantisci il rispetto dei limiti di velocità:** integra i dati sui limiti di velocità per aiutare i conducenti a rispettare i limiti legali, ridurre il rischio di multe e promuovere una guida più sicura ed efficiente in termini di consumo di carburante. Anche la logistica e la gestione della flotta possono trarre vantaggio dal monitoraggio del rispetto della velocità in tempo reale.
+ **Fornisci assistenza con le soluzioni di routing di merci e veicoli:** semplifica le operazioni di routing di merci e veicoli integrando percorsi, navigazione e funzionalità di tracciamento nei portali logistici. Pianifica in modo efficiente i percorsi per più consegne, monitora le spedizioni in tempo reale e gestisci i costi del carburante attraverso un routing migliore.
## Comprendi la richiesta
**Nota**
Per i clienti`ap-southeast-5`, i campi di richiesta e risposta supportati possono essere diversi. `ap-southeast-1` Per i dettagli, consulta l'[CalculateRoutes API Reference](https://docs.aws.amazon.com/location/latest/APIReference/API_CalculateRoutes.html).
La richiesta richiede `Origin` `Destination` parametri, mentre i parametri opzionali come `Allow``Avoid`, `Traffic` personalizzano il percorso per soddisfare esigenze e vincoli specifici.
**Origine**
La posizione di partenza del percorso in longitudine e latitudine.
**Destinazione**
La posizione finale del percorso.
**Waypoint**
Posizioni intermedie da includere lungo un percorso tra la posizione iniziale e quella finale.
**OptimizeRoutingFor**
Criteri di ottimizzazione per il percorso, ad esempio il più veloce o il più breve.
**LegGeometryFormat**
Formato della geometria restituita per ogni tratta del percorso.
**Evitare**
Caratteristiche da evitare durante il calcolo del percorso, ignorate se non viene trovato un percorso alternativo.
**Traffico**
Opzioni relative al traffico che influiscono sul calcolo del percorso.
**pedaggi**
Opzioni relative ai pedaggi che influiscono sul calcolo del percorso e sui costi dei pedaggi.
**LegAdditionalFeatures**
Funzionalità che possono essere abilitate all'interno della risposta per ogni tappa del viaggio.
**SpanAdditionalFeatures**
Ampia gamma di funzionalità che possono essere abilitate all'interno della risposta per ogni tappa del viaggio.
## Comprendi la risposta
La risposta fornisce dettagli sul percorso come le tappe del viaggio, avvisi sui calcoli del percorso e informazioni di riepilogo tra cui distanza e durata.
**Percorsi**
Matrice di percorsi contenenti gambe e proprietà associate.
**Note**
Avvertenze o messaggi informativi sul percorso.
**LegGeometryFormat**
Specifica il formato della geometria del percorso.
### Dettagli della gamba
Ogni tappa di un viaggio può essere di tipo traghetto, pedone o veicolo a seconda della modalità di trasporto. Sebbene ogni tappa contenga proprietà indipendenti dalla modalità di trasporto, le proprietà specifiche sono disponibili in:
**FerryLegDetails**
Proprietà specifiche del traghetto per la gamba.
**VehicleLegDetails**
Proprietà specifiche del veicolo per la gamba.
**PedestrianLegDetails**
Proprietà specifiche della gamba per i pedoni.
### Fasi
Ogni tappa di un viaggio è suddivisa in fasi che descrivono le azioni relative a porzioni del percorso. Un passaggio può essere predefinito, adatto per le applicazioni di base TurnByTurn, oppure adatto alla turn-by-turn navigazione. Ogni passaggio contiene proprietà indipendenti dal tipo di passo, come la durata e la distanza, e altre proprietà specifiche come ExitStepDetails, che si applicano solo ai passaggi di uscita.
**BeforeTravelSteps**
Passaggi da eseguire prima di iniziare il viaggio.
**TravelSteps**
Passaggi da eseguire durante il viaggio.
**AfterTravelSteps**
Passaggi da eseguire dopo aver completato il viaggio.
### Intervalli
Ogni tappa di un viaggio può essere suddivisa in intervalli. Una campata è una porzione della tappa con gli stessi valori per l'insieme di quelle richieste. `SpanAdditionalFeatures` Le campate sono divise in base alle proprietà delle strade`SpeedLimit`, ad esempio i nomi delle strade o le regioni. Le campate restituite possono essere utilizzate per visualizzare gli attributi stradali e le informazioni relative all'accesso.