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

# Route del servizio di posizione Amazon
<a name="routes"></a>

![\[Una panoramica dei percorsi di Amazon Location Service.\]](http://docs.aws.amazon.com/it_it/location/latest/developerguide/images/routesV2/route-banner.png)


Con Amazon Location Service Routes, puoi calcolare il tempo e la distanza di viaggio tra più punti di partenza e di arrivo, visualizzare le tracce GPS dei veicoli allineate alle strade e comprendere meglio le aree servibili. Questo aiuta a ridurre i costi operativi e a migliorare l'esperienza del cliente.

## Funzionalità
<a name="routes-features"></a>

**Pianifica un percorso**  
Calcola i percorsi tra due o più località, considerando vari fattori come distanza, tempo e condizioni stradali. Puoi anche visualizzare percorsi alternativi per lo stesso insieme di località.

**Ottimizzazione del percorso**  
Ottimizza i percorsi per tempo o distanza, scegliendo il percorso più veloce o più breve. Puoi anche mettere in sequenza i waypoint per ottimizzare il problema del venditore ambulante.

**Analisi del percorso**  
Analizza le metriche delle prestazioni come il tempo di viaggio, la distanza o il numero di fermate per assicurarti che il percorso soddisfi gli obiettivi desiderati.

**Area di servizio**  
Definisce l'area geografica che può essere servita da una particolare località in base ai limiti di distanza o di tempo.

**Costi di pedaggio**  
Calcola i costi associati all'infrastruttura di pedaggio sul tuo percorso.

**Elvenimenti**  
Limita il calcolo del percorso evitando autostrade, tunnel, traghetti e strade a pedaggio.

**Limiti di velocità**  
Trova i limiti di velocità per ogni segmento di un percorso, assicurandoti che i conducenti rispettino le normative locali.

![\[Un'applicazione che utilizza le funzionalità di routing di Amazon Location Service.\]](http://docs.aws.amazon.com/it_it/location/latest/developerguide/images/routesV2/route-demo.png)


## Casi d'uso
<a name="routes-usecases"></a>

**Fornisci percorsi e turn-by-turn indicazioni efficienti**  
Pianifica i percorsi da qualsiasi posizione di partenza (indirizzo, POI o coordinate GPS) e calcola il percorso migliore verso più destinazioni, tenendo conto delle dimensioni e delle restrizioni del veicolo.  
Per ulteriori informazioni, consulta [Calcola percorsi](calculate-routes.md).

**Ottimizza i percorsi di consegna**  
Usa il sequenziamento dei waypoint per risolvere il problema del venditore ambulante e calcola il percorso ottimale verso più destinazioni, riducendo al minimo tempo e distanza.  
Per ulteriori informazioni, consulta [Ottimizza i waypoint](actions-optimize-waypoints.md).

**Assicurati che le consegne vengano effettuate dal magazzino più vicino**  
Utilizzate Matrix Routing e Waypoint Sequencing per identificare il percorso più veloce dai vostri magazzini a ciascun cliente, massimizzando l'efficienza e riducendo al minimo i costi.  
Per ulteriori informazioni, consultare [Calcola percorsi](calculate-routes.md) e [Calcola la matrice del percorso](calculate-route-matrix.md).

**Migliora l'invio di taxi e ride-sharing**  
Usa Matrix Routing per identificare il veicolo disponibile più vicino e calcolare percorsi ottimali in base al traffico in tempo reale. Ciò garantisce che il veicolo più vicino raggiunga il cliente in modo efficiente, favorendo sia la soddisfazione del cliente che la produttività aziendale. Fai più viaggi, risparmia sui costi del carburante e offri un'esperienza di servizio superiore.  
Per ulteriori informazioni, consulta [Calcola percorsi](calculate-routes.md), [Calcola la matrice del percorso](calculate-route-matrix.md) e [Calcola isolinee](calculate-isolines.md).

**Trova le aree di servizio**  
Utilizza i percorsi Isoline per determinare la copertura geografica della tua attività, in base a vincoli di tempo o distanza. Ciò consente all'azienda di identificare potenziali clienti e di elaborare piani di spedizione. Gli operatori sanitari a domicilio possono assicurarsi di disporre di personale e risorse sufficienti per raggiungere tutti i pazienti entro 15 minuti. Isoline aiuta a ottimizzare le aree di servizio, a garantire consegne puntuali e a localizzare nuove strutture.  
Per ulteriori informazioni, consulta [Calcola isolinee](calculate-isolines.md).

**Registra la traccia GPS sulle strade**  
Allinea le tracce GPS alle strade e visualizza i movimenti dei veicoli, garantendo l'aderenza del percorso e la conformità alle normative. I gestori delle flotte possono verificare se i veicoli rimangono sui percorsi pianificati e identificare le deviazioni. Verifica che i conducenti seguano le linee guida, individuino le inefficienze e garantiscano la conformità alle normative. Corregge le imprecisioni e le variazioni del GPS e presenta una visione realistica dell'attività del veicolo. Consenti un migliore processo decisionale in merito all'ottimizzazione del percorso, al comportamento dei conducenti e alla gestione della flotta.  
Per ulteriori informazioni, consulta [Snap to Roads](snap-to-roads.md).

## APIs
<a name="routes-apis"></a>

Questa tabella fornisce una panoramica dei principali servizi di Amazon Location Service APIs per la pianificazione del percorso e l'elaborazione dei dati basata sulla posizione. Ogni API offre funzionalità uniche, come il calcolo dei percorsi, l'ottimizzazione dei waypoint e l'inserimento delle tracce GPS sulle strade per un tracciamento accurato.


**APIs**  

| Nome API | Descrizione | Leggi di più | 
| --- | --- | --- | 
| Calcola percorsi | Calcola la distanza da percorrere, il tempo di percorrenza e turn-by-turn le indicazioni stradali tra un punto di partenza e più destinazioni tenendo conto delle restrizioni relative ai veicoli e del traffico in tempo reale. | [Calcola percorsi](calculate-routes.md) | 
| Calcola la matrice del percorso | Calcola la distanza e il tempo del percorso tra un insieme di punti di partenza e un insieme di destinazioni, tenendo conto del traffico in tempo reale. | [Calcola la matrice del percorso](calculate-route-matrix.md) | 
| Calcola le isoline | Identifica l'area geografica che può essere raggiunta entro un tempo o una distanza specificati in base alle tue modalità di viaggio. | [Calcola isolinee](calculate-isolines.md) | 
| Ottimizza i waypoint | Trova l'ordine efficiente per viaggiare verso più destinazioni, riducendo i tempi e la distanza di viaggio e tenendo conto di fattori come il traffico e i vincoli dei veicoli. | [Come ottimizzare i waypoint per un percorso](optimize-waypoints.md) | 
| Snap to Roads | Abbina le tracce GPS al segmento stradale più vicino, per migliorare la precisione del tracciamento dei veicoli e la visualizzazione del percorso. | [Snap to Roads](snap-to-roads.md) | 

# Concetti di percorsi
<a name="routes-concepts"></a>

I concetti di Routes in Amazon Location Service forniscono un solido framework per la pianificazione e l'ottimizzazione dei viaggi, sia per una navigazione semplice che per una logistica complessa. I percorsi comprendono vari componenti, come waypoint, tappe, gradini e campate, ognuno dei quali contribuisce alla granularità e alla flessibilità dei calcoli dei percorsi. Sfruttando l'API Routes, puoi calcolare le distanze di viaggio, stimare i tempi di viaggio e ottimizzare i viaggi con più fermate. Inoltre, funzionalità come la geometria del percorso, la consapevolezza del traffico, i limiti di velocità, i costi dei pedaggi e la codifica flessibile delle polilinee migliorano le capacità di visualizzazione, analisi ed efficienza operativa. Questa sezione tratta la terminologia, le best practice e i modelli di utilizzo dettagliati, guidandovi nell'implementazione di soluzioni di percorso efficaci per la navigazione, la consegna, i servizi sul campo e altro ancora.

**Topics**
+ [Terminologia dei percorsi](routes-terminology.md)
+ [Dove (origine, destinazione, waypoint e tracce)](concepts-where.md)
+ [Quando (partenza e arrivo)](concepts-when.md)
+ [Come (modalità di viaggio, evitamento ed esclusione)](concepts-how.md)
+ [Conoscenza del traffico](concepts-traffic-awareness.md)
+ [Ottimizza la sequenza di percorsi e waypoint](optimize-route-waypoint.md)
+ [Orari e avvisi del conducente](driver-schedule-notices.md)

# Terminologia dei percorsi
<a name="routes-terminology"></a>

**Route**  
Un itinerario fornisce dettagli per viaggiare da una posizione di partenza attraverso le posizioni dei waypoint verso una destinazione. Include la distanza da percorrere, il tempo di percorrenza, la geometria del percorso, i limiti di velocità, gli intervalli e altri attributi.

**Matrice del percorso**  
Una matrice che rappresenta la distanza e il tempo di viaggio da un insieme di origini a un insieme di destinazioni. È utile come input per le applicazioni di pianificazione o ottimizzazione del percorso.

**Waypoint**  
I waypoint sono fermate intermedie lungo un percorso dal punto di partenza alla destinazione. Il percorso segue l'ordine di scalo specificato nella richiesta.

**Gamba**  
Una tappa rappresenta il viaggio tra due posizioni consecutive su un percorso. Se le posizioni sono fuoristrada, vengono spostate sulla strada più vicina. Un percorso senza waypoint è costituito da un'unica tappa. I percorsi con uno o più waypoint hanno più tappe, ognuna delle quali rappresenta il viaggio da un waypoint all'altro. Alcune tappe, come quelle che coinvolgono i traghetti, contengono informazioni specifiche relative a quel tipo di tratta.

**Fase**  
Una tappa è un segmento all'interno di una tappa, che fornisce dettagli riassuntivi per quella parte del viaggio. I tipi di passaggi includono:  
+ **Passaggi predefiniti**: passaggi di base con istruzioni leggibili dall'uomo, adatti per applicazioni Web che visualizzano una panoramica del percorso.
+ **Turn-by-Turn Fasi: passaggi** dettagliati adatti alle turn-by-turn applicazioni, che forniscono istruzioni granulari.
+ Fasi **prima del viaggio: passaggi** da completare prima di iniziare il viaggio. Esempio: imbarcarsi su un traghetto.
+ **After Travel Steps**: passaggi da completare dopo aver raggiunto la fine di un viaggio. Esempio: scendere dall'imbarco su un traghetto.

**Intervallo**  
Una campata rappresenta un tratto continuo di una strada che condivide un insieme coerente di attributi. Le nuove campate vengono create lungo un percorso ogni volta che uno degli attributi richiesti cambia.

**Segment**  
Un segmento è una parte navigabile di una strada, tipicamente rappresentata come un tratto lineare.

**Geometria del percorso**  
La geometria del percorso rappresenta il percorso di un percorso per la visualizzazione, l'analisi o altri usi. La geometria di ogni tappa del percorso può essere rappresentata come una polilinea compressa e codificata o come una semplice stringa di linee.

**Polilinea flessibile**  
Un formato polilinea compatto e codificato per rappresentare la geometria. Consigliato per limitare le dimensioni della risposta e ottimizzato per la decodifica lato client.

**Stringa di linea semplice**  
Un formato LineString GeoJSON che rappresenta la geometria. Questo formato produce un carico utile di risposta più ampio ed è una matrice ordinata di coordinate che può essere utilizzata per tracciare percorsi su una mappa.

# Dove (origine, destinazione, waypoint e tracce)
<a name="concepts-where"></a>

Speciifica la posizione per il calcolo del percorso, incluso il punto di inizio e di fine del percorso e le fermate intermedie (o le località da attraversare).


**Specificare dove calcolare il percorso**  

| Parametro | Descrizione | Route | Matrice dei percorsi | Isolina | Ottimizza Waypoint | Snap to Road | 
| --- | --- | --- | --- | --- | --- | --- | 
| Origine/i | Posizione di partenza del percorso. | Sì, con opzioni | Sì, con opzioni | Sì, con opzioni | Sì, con opzioni | No | 
| Waypoint | Posizioni intermedie da includere lungo il percorso. | Sì, con opzioni | Sì, con opzioni | Sì, con opzioni | Sì, con opzioni | No | 
| Destinazione (e) | Posizione finale del percorso. | Sì, con opzioni | Sì, con opzioni | Sì, con opzioni | Sì, con opzioni | No | 
| Punti di traccia | Traccia GPS che include le informazioni storiche sulla posizione emesse da una modalità di viaggio. Queste posizioni includono imprecisioni tipiche del GPS e lacune quando il dispositivo non è in grado di emettere o registrare queste informazioni. | No | No | No | No | Sì, con opzioni | 

## Opzioni configurabili
<a name="configurable-options"></a>

Fornisce opzioni per personalizzare il comportamento di routing per waypoint, origini e destinazioni.

**Opzioni relative ai waypoint**


| Parametro | Descrizione | Route | Matrice dei percorsi | Isolina | Ottimizza Waypoint | Snap To Road | 
| --- | --- | --- | --- | --- | --- | --- | 
| AvoidActionsForDistance | Evita azioni per la distanza fornita. In genere viene utilizzato per garantire che i conducenti abbiano abbastanza tempo per prendere decisioni in prossimità dei waypoint. | Sì | No | No | No | No | 
| Evita UTurns | Specifica se le inversioni a U sono consentite nel waypoint. | Sì | No | No | No | No | 
| Heading | Il GPS si dirige verso la posizione del waypoint. | Sì | No | No | Sì | No | 
| Corrispondenza | Opzioni di configurazione per abbinare la posizione fornita alla rete stradale. | Sì, con opzioni | No | No | No | No | 
| SideOfStreet | Specificate il lato della strada in modo che corrisponda alla posizione del waypoint. | Sì, con opzioni | No | No | Sì, con opzioni | No | 
| StopDuration | Durata della sosta nella posizione del waypoint. | Sì | No | No | No | No | 
| Posizione | Longitudine e latitudine del waypoint. | Sì | No | No | Sì | No | 
| PassThrough | Determina se il waypoint deve essere considerato una fermata o attraversato. | Sì | No | No | No | No | 
| Id | Stringa identificativa per il waypoint. | No | No | No | Sì | No | 
| AccessHours | Speciifica gli orari di accesso per visitare la destinazione. | No | No | No | Sì | No | 
| AppointmentTime | Ora programmata per l'appuntamento al waypoint. | No | No | No | Sì | No | 
| ServiceDuration | Orario di servizio al waypoint, ad esempio la durata di un appuntamento. | No | No | No | Sì | No | 
| Prima | Definisce quali waypoint devono essere visitati dopo questo. | No | No | No | Sì | No | 

**Opzioni di origine**


| Parametro | Descrizione | Route | Matrice dei percorsi | Isolina | Ottimizza Waypoint | Snap To Road | 
| --- | --- | --- | --- | --- | --- | --- | 
| AvoidActionsForDistance | Evita azioni per la distanza fornita. | Sì  | Sì | Sì | No | No | 
| Evita UTurns | Speciifica se all'origine sono consentite inversioni a U. | Sì | No | No | No | No | 
| Heading | Direzione GPS verso la posizione di origine. | Sì  | Sì | Sì | No | No | 
| Corrispondenza | Opzioni per abbinare la posizione di origine alla rete stradale. | Sì, con opzioni | Sì, con opzioni | Sì, con opzioni | No | No | 
| SideOfStreet | Specificate il lato della strada in modo che corrisponda alla posizione di origine. | Sì, con opzioni | Sì, con opzioni | Sì, con opzioni | No | No | 
| Id | Stringa identificativa per l'origine. | No | No | Sì | No | No | 

**Opzioni di destinazione**


| Parametro | Descrizione | Route | Matrice dei percorsi | Isolina | Ottimizza Waypoint | Snap To Road | 
| --- | --- | --- | --- | --- | --- | --- | 
| AvoidActionsForDistance | Evita azioni per la distanza fornita dalla destinazione. | Sì  | Sì | Sì | No | No | 
| Evita UTurns | Speciifica se le inversioni a U sono consentite nella destinazione. | Sì | No | No | No | No | 
| Heading | Il GPS si dirige verso la posizione di destinazione. | Sì  | Sì | Sì | Sì | No | 
| Corrispondenza | Opzioni per abbinare la posizione di destinazione alla rete stradale. | Sì, con opzioni | Sì, con opzioni | Sì, con opzioni | No | No | 
| SideOfStreet | Specificate il lato della strada in modo che corrisponda alla posizione di destinazione. | Sì, con opzioni | Sì, con opzioni | Sì, con opzioni | Sì, con opzioni | No | 
| StopDuration | Durata della sosta presso la destinazione. | Sì | No | No | No | No | 
| Id | Stringa identificativa per la destinazione. | No | No | Sì | No | No | 
| AccessHours | Speciifica gli orari di accesso per visitare la destinazione. | No | No | Sì | No | No | 
| AppointmentTime | Orario programmato per l'appuntamento presso la destinazione. | No | No | Sì | No | No | 
| ServiceDuration | Orario di servizio presso la destinazione, ad esempio la durata di un appuntamento. | No | No | Sì | No | No | 

# Quando (partenza e arrivo)
<a name="concepts-when"></a>

Specifica l'ora per il calcolo del percorso. L'ora non solo determina gli orari di partenza e arrivo, ma influenza anche i dati sul traffico da utilizzare.


| Parametro | Descrizione | Route | Matrice dei percorsi | Isolina | Ottimizza Waypoint | Snap To Road | 
| --- | --- | --- | --- | --- | --- | --- | 
| Orario di partenza | Ora di partenza dall'origine. Se non viene fornito né l'orario di arrivo né quello di partenza, non vengono utilizzate le informazioni dinamiche sul traffico e vengono applicate solo le velocità di flusso libero basate sulla cronologia del traffico. | Sì  | Sì | Sì | Sì | No | 
| Parti adesso | Usa l'ora corrente come ora di partenza dall'Origine. | Sì  | Sì | Sì | No | No | 
| Ora di arrivo | Ora di arrivo a destinazione. Se non viene fornito né l'orario di arrivo né quello di partenza, non vengono utilizzate informazioni dinamiche sul traffico e vengono applicate solo le velocità di flusso libero basate sulla cronologia del traffico. | Sì | No | Sì | No | No | 

# Come (modalità di viaggio, evitamento ed esclusione)
<a name="concepts-how"></a>

Utilizza le seguenti opzioni per specificare la modalità di viaggio e le relative funzionalità da utilizzare per il calcolo del percorso.

**Opzioni della modalità di viaggio**

Specificate la modalità di trasporto durante il calcolo di un percorso. Questa impostazione influenza la velocità di viaggio stimata, la compatibilità stradale e il potenziale utilizzo dei traghetti laddove necessario.


| Parametro | Descrizione | Route | Matrice dei percorsi | Isolina | Ottimizza Waypoint | Snap to Road | 
| --- | --- | --- | --- | --- | --- | --- | 
| Car | Modalità viaggio in auto. | Sì, con opzioni | Sì, con opzioni | Sì, con opzioni | Sì  | Sì | 
| Monopattino | Modalità di viaggio in scooter. | Sì, con opzioni | Sì | Sì, con opzioni | Sì  | Sì | 
| Pedone | Modalità viaggio a piedi. | Sì, con opzioni | Sì  | Sì | Sì, con opzioni | Sì | 
| Camion | Modalità di viaggio in camion. | Sì, con opzioni | Sì, con opzioni | Sì, con opzioni | Sì, con opzioni | Sì, con opzioni | 

**Opzioni di evitamento, esclusione e autorizzazione**

Determina se un insieme specifico di caratteristiche deve essere incluso, escluso o evitato durante il calcolo del percorso.


| Parametro | Descrizione | Route | Matrice dei percorsi | Isolina | Ottimizza Waypoint | Snap to Road | 
| --- | --- | --- | --- | --- | --- | --- | 
| Evitare | Funzionalità che vengono evitate nella migliore delle ipotesi. Se il router non riesce a trovare un percorso valido, l'elusione verrà ignorata e un avviso indicherà che l'elusione non può essere rispettata. | Sì, con opzioni | Sì, con opzioni | Sì, con opzioni | Sì, con opzioni | No | 
| Esclusione | Funzionalità rigorosamente escluse. Se il router non riesce a trovare un percorso valido con le opzioni di esclusione, non viene restituito alcun percorso. | Sì, con opzioni | Sì, con opzioni | No | No | No | 
| Consenso | Funzionalità che devono essere abilitate in modo esplicito. | Sì, con opzioni | Sì, con opzioni | Sì, con opzioni | Sì, con opzioni | No | 

**Elenco degli evitamenti**

Elenca le funzionalità che vengono evitate nella migliore delle ipotesi. Se il router non riesce a trovare un percorso valido, l'elusione verrà ignorata e un avviso indicherà che l'elusione non può essere rispettata.


| Parametro | Descrizione | Route | Matrice dei percorsi | Isolina | Ottimizza Waypoint | Snap to Road | 
| --- | --- | --- | --- | --- | --- | --- | 
| Aree | Zone da evitare con eccezioni. | Sì, con opzioni | Sì, con opzioni | Sì, con opzioni | Sì, con opzioni | No | 
| Autostrade ad accesso controllato | Strade ad alta velocità con punti di accesso limitati. | Sì  | Sì | Sì | Sì | No | 
| Treni Car Shuttle | Treni che trasportano veicoli attraverso i tunnel. | Sì  | Sì | Sì | No | No | 
| Strade sterrate | Strade non asfaltate con superfici naturali. | Sì  | Sì | Sì | Sì | No | 
| Traghetti | Imbarcazioni che trasportano veicoli attraverso corpi idrici | Sì  | Sì | Sì | No | No | 
| Traghetti per barche | Traghetti che trasportano veicoli su binari ferroviari. | No | No | Sì | Sì | No | 
| Traghetti ferroviari | Traghetti che trasportano veicoli su binari ferroviari. | No | No | Sì | Sì | No | 
| Chiusura stagionale | Strade chiuse in determinate stagioni. | Sì | No | Sì | No | No | 
| Tunnel | Passaggi sotterranei per il traffico veicolare. | Sì  | Sì | Sì | Sì | No | 
| Strada a pedaggio | Strade che richiedono il pagamento per l'accesso. | Sì  | Sì | Sì | Sì | No | 
| Transponder per pedaggi | Evita le strade in cui i transponder dei pedaggi sono l'unico mezzo di pagamento. | Sì | No | Sì | No | No | 
| inversioni a U | Punti che consentono ai veicoli di svoltare in senso inverso. | Sì  | Sì | Sì | Sì | No | 
| Categorie di zone | Categorie di zone da evitare. | Sì  | Sì | Sì | No | No | 

**Elenco delle esclusioni**

Elenca le funzionalità che sono rigorosamente escluse. Se il router non riesce a trovare un percorso valido con le opzioni di esclusione, non viene restituito alcun percorso.


| Parametro | Descrizione | Route | Matrice dei percorsi | Isolina | Ottimizza Waypoint | Snap to Road | 
| --- | --- | --- | --- | --- | --- | --- | 
| Countries (Paesi) | Country Code 2 o Country Code 3 per i paesi che devono essere rigorosamente esclusi dal calcolo del percorso. | Sì  | Sì | No | Sì | No | 

**Elenco delle autorizzazioni**

Elenca le funzionalità che devono essere abilitate esplicitamente per il calcolo del percorso.


| Parametro | Descrizione | Route | Matrice dei percorsi | Isolina | Ottimizza Waypoint | Snap to Road | 
| --- | --- | --- | --- | --- | --- | --- | 
| HOV | Abilita l'uso di corsie veicolari ad alta occupazione per il calcolo del percorso. | Sì  | Sì | Sì | No | No | 
| CALDO | Abilita l'uso di corsie a pedaggio ad alta occupazione per il calcolo del percorso. | Sì  | Sì | Sì | No | No | 

# Conoscenza del traffico
<a name="concepts-traffic-awareness"></a>

Determina il tipo di informazioni relative al traffico utilizzate durante il calcolo del percorso. Il traffico di flusso rappresenta la congestione, esclusa la congestione a lungo termine legata a incidenti. La precisione dei dati sul traffico di flusso diminuisce nel tempo, rendendo i dati storici sul traffico più affidabili per gli eventi passati.


| Parametro | Descrizione | Route | Matrice dei percorsi | Isolina | Ottimizza Waypoint | Snap To Road | 
| --- | --- | --- | --- | --- | --- | --- | 
| Utilizzo | Abilita o disabilita i dati sul traffico durante il calcolo del percorso. Se abilitate`DepartureTime`, se fornite o meno`ArrivalTime`, `DepartNow` verranno prese in considerazione solo le chiusure a lungo termine. Altrimenti, se viene fornito un orario, vengono presi in considerazione tutti i dati sul traffico. | Sì  | Sì | Sì | Sì | No | 
| FlowEventThresholdOverride | Durata in secondi per la quale un evento di traffico di flusso è considerato valido. Sebbene validi, i dati sul traffico di flusso verranno utilizzati rispetto ai dati storici sul traffico. | Sì  | Sì | Sì | No | No | 

# Ottimizza la sequenza di percorsi e waypoint
<a name="optimize-route-waypoint"></a>

## Ottimizza il routing
<a name="optimize-routing"></a>

Criteri di ottimizzazione per il calcolo di un percorso. Questo può essere il percorso più veloce misurato in base al tempo o il percorso più breve misurato in base alla distanza.


| Opzione | Descrizione | Misura | 
| --- | --- | --- | 
| Percorso più veloce | Calcola il percorso più veloce, concentrandoti sulla riduzione al minimo dei tempi di viaggio. Ciò tiene conto delle condizioni del traffico, dei limiti di velocità stradale e di altri fattori. | Orario | 
| Percorso più breve | Calcola il percorso più breve, riducendo al minimo la distanza percorsa. Viene spesso utilizzato quando la distanza è il fattore chiave, ad esempio per ridurre i costi del carburante o le emissioni. | Distance | 

## Ottimizza il waypoint
<a name="optimize-waypoint"></a>

Criteri di ottimizzazione per il sequenziamento dei waypoint lungo un percorso. 

# Orari e avvisi del conducente
<a name="driver-schedule-notices"></a>

## Pianificazione del conducente
<a name="driver-schedule"></a>

Impostazioni del conducente per definire gli orari di lavoro e di riposo. Questo è obbligatorio per molte giurisdizioni.


| Parametro | Description | Percorsi | Matrice dei percorsi | Isolina | Ottimizza Waypoint | Snap To road | 
| --- | --- | --- | --- | --- | --- | --- | 
| Cicli di riposo personalizzati | Cicli di riposo definiti in base alla durata dell'unità a cui seguire una durata di riposo. È possibile fornire un numero qualsiasi di tali cicli. | Sì, con opzioni | No | No | No | No | 
| Ciclo di riposo lungo e ciclo di riposo breve | Cicli di riposo definiti da ciclo breve e ciclo lungo. Una breve durata del viaggio è seguita da una breve durata del viaggio a riposo. I viaggi brevi possono essere ripetuti fino al raggiungimento di una lunga durata di guida, a quel punto viene applicata la lunga durata di riposo. | No | No | No | Sì, con opzioni | No | 

## Avvisi, avvertenze e vincoli
<a name="notices-warnings-constraints"></a>

Informazioni supplementari che forniscono informazioni dettagliate sulle decisioni prese durante il calcolo del percorso.


| Parametro | Description | Percorsi | Matrice dei percorsi | Isolina | Ottimizza Waypoint | Snap To road | 
| --- | --- | --- | --- | --- | --- | --- | 
| Note | Avvisi relativi al calcolo del percorso. Inoltre, possono includere un avviso che indichi se i risultati del calcolo del percorso possono essere utilizzati così come sono o se dovranno essere ispezionati manualmente prima dell'uso. | Sì, con dettagli | No | No | No | Sì | 
| FailedConstraints | Vincoli forniti nella richiesta che non hanno potuto essere soddisfatti, con conseguente fallimento del problema di ottimizzazione. | No | No | No | Sì, con dettagli | No | 

# Itinerario APIs
<a name="choose-routes-apis"></a>

I percorsi offrono funzionalità per il calcolo di percorsi ottimizzati tra le località. Queste funzionalità supportano applicazioni che richiedono pianificazione logistica, calcolo delle distanze e ottimizzazione dei percorsi. Gli utenti possono anche agganciare i punti di posizione alle strade per una maggiore precisione. Per ulteriori informazioni, vedere[Route del servizio di posizione Amazon](routes.md).
+ **CalculateIsolines**: Genera isolinee in base al tempo o alla distanza di viaggio, utili per definire aree di servizio o zone di raggiungibilità. Per ulteriori informazioni, vedere. [Calcola isolinee](calculate-isolines.md)
+ **CalculateRouteMatrix**: fornisce una matrice di distanze e tempi di viaggio tra più origini e destinazioni, a supporto della logistica e della pianificazione dei viaggi. Per ulteriori informazioni, vedere[Calcola la matrice del percorso](calculate-route-matrix.md).
+ **CalculateRoutes**: calcola percorsi ottimizzati per la point-to-point navigazione con più fermate, incluse le preferenze di percorso personalizzabili. Per ulteriori informazioni, vedere. [Calcola percorsi](calculate-routes.md)
+ **OptimizeWaypoints**: ottimizza l'ordine dei waypoint per l'itinerario di viaggio più efficiente, riducendo al minimo la distanza o il tempo. Per ulteriori informazioni, vedere. [Ottimizza i waypoint](actions-optimize-waypoints.md)
+ **SnapToRoads**: allinea le coordinate ai percorsi stradali più vicini, migliorando la precisione del GPS associando i punti alle strade conosciute. Per ulteriori informazioni, vedere. [Snap to Roads](snap-to-roads.md)

La tabella seguente presenta una serie di casi d'uso aziendali che possono essere risolti al meglio con Routes APIs.


| **Esigenze aziendali** | **API utile** | **Esempi** | 
| --- | --- | --- | 
| **Calcola la distanza e il tempo di viaggio per un'origine e una destinazione**Supporta quanto segue: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/location/latest/developerguide/choose-routes-apis.html) | `CalculateRoutes` |  | 
| **Trova la polilinea del percorso per un'origine e una destinazione**Supporta quanto segue: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/location/latest/developerguide/choose-routes-apis.html) | `CalculateRoutes` |  | 
| **Trova i percorsi, svolta dopo curva, la direzione dell'origine e della destinazione**Supporta quanto segue: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/location/latest/developerguide/choose-routes-apis.html) | `CalculateRoutes` |  | 
| **Trova un percorso partendo ora**Supporta quanto segue: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/location/latest/developerguide/choose-routes-apis.html) | `CalculateRoutes` |  | 
| **Trova un percorso se parti a un orario specifico**Supporta quanto segue: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/location/latest/developerguide/choose-routes-apis.html) | `CalculateRoutes` |  | 
| **Trova un percorso se devi arrivare a un orario specifico**Supporta quanto segue: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/location/latest/developerguide/choose-routes-apis.html) | `CalculateRoutes` |  | 
| **Trova i percorsi più brevi**Supporta quanto segue: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/location/latest/developerguide/choose-routes-apis.html) | `CalculateRoutes` |  | 
| **Trova i percorsi più veloci**Supporta quanto segue: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/location/latest/developerguide/choose-routes-apis.html) | `CalculateRoutes` |  | 
| **Trova percorsi alternativi**Supporta quanto segue: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/location/latest/developerguide/choose-routes-apis.html) | `CalculateRoutes` |  | 
| **Trova percorsi che tengono conto del traffico**Supporta quanto segue: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/location/latest/developerguide/choose-routes-apis.html) | `CalculateRoutes` |  | 
| **Trova percorsi evitabili, come ad esempio pedaggi, inversioni a U, traghetti, autostrade, tunnel e altro**Supporta quanto segue: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/location/latest/developerguide/choose-routes-apis.html) | `CalculateRoutes` |  | 
| **Trova percorsi con elusione personalizzata facendo passare una polilinea o un poligono**Supporta quanto segue: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/location/latest/developerguide/choose-routes-apis.html) | `CalculateRoutes` |  | 
| **Calcola il costo del pedaggio**Supporta quanto segue: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/location/latest/developerguide/choose-routes-apis.html) | `CalculateRoutes` | [Calcola il costo del pedaggio](calculate-toll-cost.md) | 
| **Trova il limite di velocità di un tratto stradale su un percorso**Supporta quanto segue: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/location/latest/developerguide/choose-routes-apis.html) | `CalculateRoutes` |  | 
| **Disegna un percorso su una mappa**Supporta la marcatura dei waypoint. | `GetTile`e `GetStyleDescriptor` con motore di rendering (MapLibre) con Calculate route  |  | 
| **Calcola la matrice del percorso di distanza e tempo per più origini e destinazioni**Supporta quanto segue:[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/location/latest/developerguide/choose-routes-apis.html) | `CalculateRouteMatrix` | [Come calcolare una matrice di percorso di distanza e tempo per più origini e destinazioni](calculate-route-matrix-distance.md) | 
| **Calcola la matrice dei percorsi evitando**Supporta quanto segue:[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/location/latest/developerguide/choose-routes-apis.html) | `CalculateRouteMatrix` | [Come calcolare la matrice dei percorsi evitando](calculate-route-matrix-with-avoidance.md) | 
| **Calcola un'area di servizio in base al tempo (isocrone)**Supporta modalità di viaggio, come camion, pedone, auto e scooter.  | `CalculateIsolines` | [Come calcolare un'area di servizio in base a intervalli di tempo](calculate-service-area-based-on-time.md) | 
| **Calcola un'area di servizio in base alla distanza (isodistanza)**Supporta modalità di viaggio, come camion, pedone, auto e scooter.  | `CalculateIsolines` |  | 
| **Calcola un'area di servizio evitando**Supporta le modalità di viaggio, come camion, pedone, auto e scooter.  | `CalculateIsolines` |  | 
|  **Calcola un'area di servizio dalla direzione inversa** Supporta modalità di viaggio, come camion, pedone, auto e scooter.  | `CalculateIsolines` |  | 
|  **Calcola l'area di servizio per più intervalli di tempo o distanza** Supporta modalità di viaggio, come camion, pedone, auto e scooter.  | `CalculateIsolines` |  | 
| **Ottimizza i waypoint per i percorsi (problema del venditore ambulante)** Supporta modalità di viaggio, come camion, pedone, auto e scooter.  | `OptimizeWaypoint` | [Come ottimizzare i waypoint per un percorso](optimize-waypoints.md) | 
| **Ottimizza i waypoint per un percorso grazie alla consapevolezza del traffico** Supporta modalità di viaggio, come camion, pedone, auto e scooter.  | `OptimizeWaypoint` |  | 
| **Ottimizza i waypoint per un percorso grazie alla consapevolezza dell'ora di accesso** Supporta modalità di viaggio, come camion, pedone, auto e scooter. | `OptimizeWaypoint` |  | 
| **Abbina le tracce GPS alla rete stradale**Supporta modalità di viaggio, come camion, pedone, auto e scooter. | Snap to road  | [Come abbinare le tracce GPS a una rete stradale](how-to-match-gps-traces.md) | 
| **Visualizza le tracce GPS corrispondenti su una mappa**Supporta modalità di viaggio, come camion, pedone, auto e scooter. | `GetStyleDescriptor`con motore di rendering (MapLibre) con Snap to road  |  | 

# Calcola percorsi
<a name="calculate-routes"></a>

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
<a name="use-cases"></a>
+ **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
<a name="understanding-request"></a>

**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
<a name="understanding-response"></a>

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
<a name="leg-details"></a>

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
<a name="steps"></a>

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
<a name="spans"></a>

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.

# Calcola il costo del pedaggio
<a name="calculate-toll-cost"></a>

Questo argomento fornisce una panoramica dei campi e delle definizioni associati al calcolo dei costi dei pedaggi. Utilizzando questi campi, è possibile specificare parametri quali metodi di pagamento, valuta e caratteristiche del veicolo per personalizzare i calcoli dei costi di pedaggio.


| Nome del campo | Route | 
| --- | --- | 
| Transponder | Sì, con opzioni | 
| Vignette | Sì, con opzioni | 
| Valuta | Sì, con opzioni | 
| EmissionType | Sì, con opzioni | 
| VehicleCategory | Sì, con opzioni | 

## Definizioni
<a name="definitions"></a>

Questa sezione fornisce brevi definizioni per ogni campo utilizzato nel calcolo dei costi di pedaggio.

****Transponder****  
I transponder sono un metodo di pagamento dei pedaggi, che potenzialmente comportano un prezzo diverso rispetto ad altri metodi di pagamento.

****Vignette****  
La vignetta è una forma di tariffazione stradale. Quando un utente ha la vignetta richiesta, non sono necessari ulteriori pagamenti del pedaggio.

****Valuta****  
La valuta in cui vengono riportati i costi dei pedaggi. Oltre alla valuta locale, è inclusa una valuta convertita, che influisce anche sulla valuta utilizzata nel riepilogo dei pedaggi contenuto nella risposta.

****EmissionType****  
Il tipo di emissione del veicolo, utilizzato per calcolare i costi dei pedaggi in base alle emissioni del veicolo.

****VehicleCategory****  
La sottocategoria di veicoli utilizzata per il calcolo del costo del pedaggio.

# Comprendere le fasi del percorso
<a name="understanding-route-steps"></a>

Questa sezione definisce varie azioni e passaggi da intraprendere per completare una tappa di un viaggio. Le fasi del percorso variano in base alla modalità di viaggio e forniscono indicazioni sia per la panoramica delle applicazioni che per turn-by-turn la navigazione dettagliata.

## Panoramica delle tappe del percorso
<a name="route-steps-overview"></a>

I seguenti tipi di tappe del percorso definiscono le azioni necessarie per completare una tappa del percorso, a seconda della modalità di viaggio e della fase del viaggio.


| **Step type (Tipo di fase)** | **Descrizione** | 
| --- | --- | 
| Default steps | Passaggi di base che forniscono istruzioni leggibili dall'uomo, spesso utilizzati nelle applicazioni basate sul Web per offrire una panoramica del percorso. | 
| Turn by turn steps | Passaggi dettagliati per la creazione di un'applicazione di turn-by-turn navigazione, che offra indicazioni più granulari. | 
| Before travel steps | Passaggi che devono essere completati prima di iniziare la sezione di viaggio, come l'imbarco su un traghetto. | 
| After travel steps | Passaggi da eseguire dopo aver completato la sezione di viaggio, come lo sbarco su un traghetto. | 

## Suddivisione delle fasi per modalità di viaggio
<a name="route-step-types"></a>


| **Sezione** | **Fase** | **Prima del viaggio** | **Viaggiare** | **Dopo il viaggio** | 
| --- | --- | --- | --- | --- | 
| Veicolo | Arrivare | No | Sì | No | 
| Veicolo | Continua | No | Sì | No | 
| Veicolo | ContinueHighway | No | Sì | No | 
| Veicolo | Partenza | No | Sì | No | 
| Veicolo | Esci | No | Sì | No | 
| Pedone | Arrivare | No | Sì | No | 
| Pedone | Costo | No | Sì | No | 
| Traghetto | Attendi | No | No | Sì | 
| Traghetto | Tavola | Sì | No | No | 
| Traghetto | Scendi a bordo | No | No | Sì | 

# Calcola la matrice del percorso
<a name="calculate-route-matrix"></a>

Il servizio Matrix Routing calcola le matrici di routing, fornendo tempi di viaggio o distanze tra più origini e destinazioni. Questo servizio offre opzioni di personalizzazione flessibili, che consentono di specificare le modalità di viaggio, le condizioni del traffico e altri parametri di routing. I calcoli della matrice possono variare in dimensioni e forma, supportano matrici quadrate e non quadrate e possono contenere dati sul traffico dinamici o a flusso libero.

Per ulteriori informazioni, consulta il *riferimento [CalculateRouteMatrix](https://docs.aws.amazon.com/location/latest/APIReference/API_CalculateRouteMatrix.html)all'API di Amazon Location Service*.

Ad esempio richieste, risposte, comandi CURL e CLI per questa API, vedi [Come usare](https://docs.aws.amazon.com/location/latest/developerguide/calculate-route-matrix-how-to.html) Calculate route matrix.

## Casi d’uso
<a name="route-matrix-use-cases"></a>
+ **Ottimizza i percorsi di consegna per la logistica e l'e-commerce:** calcola in modo efficiente i tempi di viaggio e la distanza tra più punti di ritiro e consegna per ottimizzare i percorsi. Le società di logistica possono utilizzare questa funzione per ridurre al minimo i costi e i tempi di consegna pianificando percorsi efficienti tra le città. È ideale per impostare finestre di consegna ottimizzate per i servizi in giornata o il giorno successivo e pianificare percorsi di consegna con più fermate.
+ **Abbina conducenti e passeggeri nelle applicazioni di condivisione del viaggio:** utilizza i calcoli degli itinerari per abbinare i conducenti ai passeggeri più vicini trovando il percorso più veloce tra le località. Le app di ride-sharing possono migliorare l'esperienza dell'utente fornendo stime degli arrivi degli autisti in tempo reale e garantendo consegne e riconsegne rapide. Supporta varie modalità di trasporto come auto, biciclette e scooter.
+ **Pianifica e ottimizza i percorsi per la gestione della flotta:** gestisci flotte di grandi dimensioni ottimizzando i percorsi per ridurre il consumo di carburante e i tempi di viaggio. I gestori di flotte possono assegnare i percorsi più efficienti ai veicoli per più fermate, aumentando così l'efficienza operativa complessiva. I casi d'uso includono flotte di servizi, società di trasporto e servizi di pubblica utilità in cui una pianificazione ottimale del percorso è essenziale per le visite in loco.

## Comprendi la richiesta
<a name="route-matrix-request"></a>

**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'[CalculateRouteMatrix API Reference](https://docs.aws.amazon.com/location/latest/APIReference/API_CalculateRouteMatrix.html). 

La richiesta include **Origins** e **Destinations** per il calcolo del percorso, con parametri opzionali per personalizzare la matrice in base a preferenze e vincoli. Per maggiori dettagli, consulta l'API Reference for Calculate Route Matrix API.
+ `Origins`: Elenco delle coordinate di origine in longitudine e latitudine.
+ `Destinations`: Elenco delle coordinate di destinazione.
+ `OptimizeRoutingFor`: criteri di ottimizzazione come il percorso «Più veloce» o «Il più breve».
+ `RoutingBoundary`: definisce i limiti per il calcolo, come «illimitati» o limitati a una geometria specifica.
+ `Avoid`: Funzionalità da evitare durante il calcolo del percorso. Ignorato se non è possibile trovare un percorso percorribile.
+ `Traffic`: opzioni relative al traffico che influiscono sul calcolo del percorso.

## Comprendi la risposta
<a name="route-matrix-response"></a>

La risposta include una matrice di percorsi calcolati tra origini e destinazioni, con dettagli come distanza e durata. Se applicabile, vengono inoltre forniti errori e limiti per i percorsi. Consulta l'API Reference per ulteriori dettagli sull'API Calculate Route Matrix.
+ `RouteMatrix`: Matrice contenente le distanze di viaggio (in metri) e le durate (in secondi) tra origini e destinazioni.
+ `ErrorCount`: Numero di errori riscontrati durante il calcolo del percorso.
+ `RoutingBoundary`: limite entro il quale viene calcolata la matrice.

# Calcola isolinee
<a name="calculate-isolines"></a>

L'API Calculate Isolines consente di determinare le aree raggiungibili entro limiti di tempo o distanza specificati. Considerando fattori come le restrizioni stradali, le condizioni del traffico e le modalità di viaggio, genera isoline che delineano le aree accessibili, supportando le applicazioni di pianificazione urbana, logistica e accessibilità dei servizi. Questa API può essere utilizzata per la pianificazione urbana, l'analisi immobiliare e gli studi di accessibilità visualizzando la portata dei servizi, le opzioni di trasporto o le risorse entro un periodo di tempo o un limite di distanza prestabiliti. Visualizzando queste isolinee su una mappa, gli utenti possono valutare la portata degli spostamenti entro limiti specifici, migliorando il processo decisionale per la selezione del sito, la copertura dei servizi e l'allocazione delle risorse.

Per ulteriori informazioni, consulta il *riferimento [CalculateIsolines](https://docs.aws.amazon.com/location/latest/APIReference/API_CalculateIsolines.html)all'API di Amazon Location Service*.

Ad esempio richieste, risposte, comandi CURL e CLI per questa API, vedi [Come](https://docs.aws.amazon.com/location/latest/developerguide/calculate-isolines-how-to.html) usare Calculate isolines.

## Casi d'uso
<a name="use-cases"></a>
+ **Valuta l'accessibilità dell'assistenza sanitaria attraverso isoline del tempo di viaggio: genera isoline** per valutare l'accesso alle strutture sanitarie di vari quartieri in base ai tempi di viaggio. Le organizzazioni sanitarie possono utilizzare questa funzione per identificare le aree svantaggiate e prendere decisioni informate sulle sedi delle cliniche o sui servizi sanitari mobili, migliorando così l'accesso all'assistenza sanitaria comunitaria.
+ **Analizza la portata del mercato ai fini dell'espansione della vendita al dettaglio utilizzando le isoline relative ai tempi di viaggio:** crea isoline per rappresentare l'accesso dei clienti ai punti vendita in base ai tempi di viaggio. Le aziende di vendita al dettaglio possono valutare le nuove ubicazioni dei negozi e comprendere i dati demografici dei clienti, utilizzando queste visualizzazioni per espandere e ottimizzare strategicamente il potenziale di vendita.
+ **Ottimizza la logistica e le zone di consegna con isoline: genera isoline** per definire zone di consegna in base a requisiti logistici sensibili al fattore tempo. Le società di logistica possono visualizzare le aree raggiungibili entro intervalli di tempo specifici dai centri di distribuzione, migliorando la pianificazione del percorso, l'efficienza operativa e le consegne puntuali.
+ **Pianifica l'accesso turistico e ricreativo con isolines:** visualizza i tempi di percorrenza dalle attrazioni turistiche alle strutture ricettive vicine. Gli enti del turismo possono aiutare i viaggiatori a trovare comode opzioni di alloggio, promuovere le attività commerciali locali e migliorare l'esperienza di viaggio visualizzando queste isoline su una mappa.
+ **Migliora la pianificazione della risposta alle emergenze tramite isoline:** genera isoline per valutare i tempi di risposta dalle sedi dei servizi di emergenza alle varie aree di una comunità. I team di gestione delle emergenze possono identificare le regioni entro i tempi di risposta critici, ottimizzando l'allocazione delle risorse per migliorare la risposta durante gli incidenti.
+ **Analizza i modelli di spostamento per la pianificazione della forza lavoro con isolinee: genera isolinee** per visualizzare i tempi di percorrenza e identificare le aree con tempi di viaggio elevati. Le aziende possono utilizzare queste informazioni per politiche di lavoro a distanza o per il trasferimento degli uffici, migliorando la soddisfazione e la produttività dei dipendenti.

## Comprendi la richiesta
<a name="understanding-request"></a>

La richiesta accetta parametri come `Origin``Destination`, e `Thresholds` per definire le isoline. I parametri opzionali, come`Allow`, e `Avoid``TravelModeOptions`, consentono la personalizzazione dei vincoli di isolinea. Per ulteriori informazioni, consulta .

**Origine**  
Il punto di partenza per il calcolo delle isoline in longitudine e latitudine.

**Soglie**  
Limiti di tempo o distanza utilizzati per definire il limite dell'isolinea.

**TravelMode**  
La modalità di trasporto, ad esempio auto, pedone o camion.

**OptimizeIsolineFor**  
Criteri di ottimizzazione, ad esempio Calcolo accurato, bilanciato o rapido.

**DepartureTime**  
Orario di partenza, se specificato, per il calcolo delle isoline dipendenti dal tempo.

**ArrivalTime**  
Ora di arrivo, se specificata, per il calcolo delle isoline dipendenti dal tempo.

**IsolineGranularity**  
Il numero massimo di punti e la risoluzione del limite dell'isolinea.

## Comprendi la risposta
<a name="understanding-response"></a>

La risposta include isoline con proprietà come`IsolineGeometryFormat`, ad esempio, che delineano l'area raggiungibile in base ai parametri della richiesta.

**Isoline**  
Isolinee calcolate con proprietà associate, incluse geometrie e connessioni.

**Geometrie**  
Elenco di geometrie che delineano i limiti delle isoline calcolate.

**Connessioni**  
Connessioni tra geometrie isolinee, inclusa la geometria per ogni connessione.

# Ottimizza i waypoint
<a name="actions-optimize-waypoints"></a>

L'API Optimize Waypoints calcola la sequenza più efficiente per visitare più waypoint lungo un percorso. Utilizzando algoritmi avanzati, questa API riduce al minimo i tempi e la distanza di viaggio tenendo conto di fattori quali le condizioni del traffico, gli evitamenti e le specifiche del veicolo. L'integrazione dell'API Optimize Waypoints aiuta le aziende a semplificare le operazioni, ridurre il consumo di carburante, migliorare l'efficienza delle consegne e migliorare la soddisfazione dei clienti. L'API fornisce percorsi ottimizzati, consentendo un migliore processo decisionale e un'allocazione delle risorse in scenari di viaggio con più fermate.

Per ulteriori informazioni, consulta il *riferimento [OptimizeWaypoints](https://docs.aws.amazon.com/location/latest/APIReference/API_OptimizeWaypoints.html)all'API di Amazon Location Service*.

Ad esempio richieste, risposte, cURL e comandi CLI per questa API, vedi [Come](https://docs.aws.amazon.com/location/latest/developerguide/optimize-waypoints-how-to.html) usare Optimize waypoint.

## Casi d'uso
<a name="use-cases"></a>
+ **Migliora l'efficienza delle consegne con più fermate:** ottimizza in modo efficiente la sequenza di più fermate di consegna per ridurre tempi e costi di viaggio. I servizi di consegna possono semplificare le operazioni calcolando il percorso più efficiente per gli autisti, riducendo al minimo le spese di carburante e garantendo consegne puntuali, il che migliora la soddisfazione del cliente e l'efficienza operativa.
+ **Semplifica le operazioni di assistenza sul campo:** ottimizza la sequenza delle visite a più cantieri in un solo giorno, riducendo i tempi di viaggio per i tecnici dell'assistenza sul campo. Ciò consente alle aziende di completare più lavori ogni giorno, migliorando la produttività e l'erogazione dei servizi.
+ **Pianifica percorsi turistici efficienti per le agenzie di viaggio:** ottimizza gli itinerari che includono più attrazioni per massimizzare le visite turistiche e ridurre al minimo i tempi di viaggio. Le agenzie di viaggio possono utilizzare questa funzione per creare piani ottimali per le visite guidate, migliorando l'esperienza turistica complessiva sfruttando meglio il tempo disponibile.
+ **Migliora l'efficienza dei conducenti che condividono il viaggio:** ottimizza le sequenze di ritiro e riconsegna per più passeggeri, riducendo i tempi di attesa e migliorando l'esperienza del passeggero. I servizi di ride-sharing possono massimizzare i guadagni degli autisti e garantire un servizio tempestivo ai passeggeri ottimizzando i waypoint.
+ **Ottimizza i percorsi per i servizi di raccolta dei rifiuti:** pianifica i percorsi di raccolta dei rifiuti per ridurre al minimo la distanza e il tempo di viaggio, il che aiuta le società di gestione dei rifiuti a semplificare le operazioni e garantire una raccolta tempestiva, ottenendo risparmi sui costi e riducendo l'impatto ambientale.
+ **Coordina la logistica per eventi e conferenze:** gestisci la logistica dei trasporti per la consegna di attrezzature e forniture a più sedi, ottimizzando i percorsi di carico e scarico. Ciò consente agli organizzatori di eventi di semplificare i trasporti, ridurre i ritardi e garantire l'arrivo tempestivo del materiale per gli eventi.
+ **Migliora i percorsi di risposta alle emergenze:** pianifica i percorsi più veloci per più emergenze, ottimizzando i tempi di risposta in situazioni critiche. I servizi di emergenza possono migliorare l'efficienza della risposta, salvando potenzialmente vite umane utilizzando waypoint ottimizzati.
+ **Facilita la pianificazione dei percorsi di vendita per i rappresentanti sul campo:** ottimizza i percorsi per i rappresentanti di vendita che visitano più clienti in un giorno, riducendo al minimo i tempi di viaggio e massimizzando le visite ai clienti. Questo aiuta le aziende ad aumentare la produttività e a sfruttare maggiori opportunità di vendita.

## Comprendi la richiesta
<a name="understanding-request"></a>

La richiesta richiede parametri come `Origin` e `Waypoints` per calcolare una sequenza ottimizzata. Parametri opzionali come `Avoid``Traffic`, e `Driver` consentono personalizzazioni aggiuntive.

**Waypoint**  
Un elenco di waypoint da ottimizzare in sequenza.

**Origine**  
La posizione di partenza del percorso per l'ottimizzazione.

**Destinazione**  
Una posizione finale opzionale del percorso per l'ottimizzazione.

**OptimizeSequencingFor**  
Criteri per l'ottimizzazione del sequenziamento, ad esempio il percorso più veloce o più breve.

**Traffico**  
Opzioni relative al traffico che influiscono sul calcolo del percorso.

**Driver**  
Cicli di lavoro e di riposo del conducente per garantire la conformità alle normative regionali sulla guida.

**Raggruppamento**  
Il clustering consente di specificare in che modo i waypoint vicini possono essere raggruppati per migliorare la sequenza ottimizzata.

Ogni waypoint può anche specificare vincoli che devono essere soddisfatti, ad esempio, e vincoli di ordinamento come `AppointmentTime` un altro waypoint. `AccessHours` `Before`

## Comprendi la risposta
<a name="understanding-response"></a>

La risposta fornisce dettagli sulla sequenza ottimizzata dei waypoint, compresi quelli `OptimizedWaypoints` complessivi `Distance` e relativi `Duration` al viaggio. 

**OptimizedWaypoints**  
Un elenco di waypoint nel loro ordine ottimizzato.

**ImpedingWaypoints**  
Waypoint che impediscono una sequenza ottimizzata, compresi i vincoli falliti che non sono stati rispettati.

**Connessioni**  
Dettagli sui viaggi tra i waypoint, incluse distanza e durata.

**TimeBreakdown**  
Suddivisione del totale`Travel`, `Rest``Service`, e della `Wait` durata del percorso.

**ClusterIndex**  
Indice del cluster a cui è associato il waypoint. L'indice è incluso nella risposta solo se il clustering è stato eseguito durante l'elaborazione della richiesta.

# Snap to Roads
<a name="snap-to-roads"></a>

L'API Snap to Road migliora la precisione del posizionamento geografico allineando le coordinate GPS ai segmenti stradali più vicini su una mappa digitale. Questa API prende i dati grezzi di longitudine e latitudine, spesso raccolti da dispositivi mobili o veicoli, e «aggancia» questi punti alla rete stradale corrispondente, correggendo le imprecisioni causate dalla deriva del GPS o dalla perdita di segnale. Integrando l'API Snap to Road, puoi garantire che le tue applicazioni forniscano dati affidabili e accurati, supportando una migliore efficienza decisionale e operativa in vari scenari.

Per ulteriori informazioni, consulta il *riferimento [SnapToRoads](https://docs.aws.amazon.com/location/latest/APIReference/API_SnapToRoads.html)all'API di Amazon Location Service*.

Per esempio richieste, risposte, comandi CURL e CLI per questa API, vedi [Come usare Snap to Roads](https://docs.aws.amazon.com/location/latest/developerguide/snap-to-roads-how-to.html).

## Casi d'uso
<a name="use-cases"></a>
+ **Migliora la precisione della navigazione collegandoti alla rete stradale:** allinea in modo efficiente le coordinate GPS ai segmenti stradali più vicini per migliorare la precisione della navigazione. Questa funzionalità è utile per i servizi di mappatura e navigazione, poiché fornisce agli utenti indicazioni stradali precise e aggiornamenti sulla posizione in tempo reale, migliorando così l'esperienza di navigazione.
+ **Migliora la precisione dei dati per le applicazioni di gestione del parco veicoli:** correggi le posizioni riportate dei veicoli associando le loro coordinate GPS alle strade più vicine. Nei sistemi di gestione della flotta, questa funzionalità garantisce un tracciamento accurato dei veicoli, consentendo una logistica ottimizzata e una migliore efficienza operativa.

## Comprendi la richiesta
<a name="understanding-request"></a>

La richiesta richiede `TracePoints` la corrispondenza con le strade, con parametri opzionali come `SnappedGeometryFormat` e `SnapRadius` per il controllo del formato della geometria e del raggio di scatto.

**TracePoints**  
Un elenco di coordinate da agganciare alla rete stradale.

**SnappedGeometryFormat**  
Il formato della geometria restituita, ad esempio "FlexiblePolyline" o «Semplice».

**SnapRadius**  
Il raggio attorno ai punti di traccia entro il quale viene considerata la frammentazione della strada.

## Comprendi la risposta
<a name="understanding-response"></a>

La risposta contiene geometria corretta e punti di traccia interrotti, con proprietà quali `SnappedGeometry` e volte `SnappedTracePoints` a indicare la precisione e la sicurezza di aggancio.

**SnappedGeometry**  
La geometria corretta del percorso interrotto.

**SnappedTracePoints**  
Le coordinate modificate dei punti di traccia sono state adattate alle strade.

**Note**  
Avvertenze o messaggi informativi sul processo di aggancio.

# Procedura
<a name="routes-how-to"></a>

Questa sezione fornisce guide per utilizzare i Routes per APIs risolvere i problemi di routing e navigazione. Questi tutorial coprono le attività essenziali per l'integrazione della funzionalità di routing nelle applicazioni. Ogni argomento si concentra su un caso d'uso specifico e consente di implementare in modo efficiente funzionalità di routing avanzate personalizzate in base alle esigenze aziendali.

**Topics**
+ [Scopri come usare CalculateRoutes](calculate-routes-how-to.md)
+ [Scopri come usare CalculateIsolines](calculate-isolines-how-to.md)
+ [Scopri come usare CalculateRouteMatrix](calculate-route-matrix-how-to.md)
+ [Scopri come usare OptimizeWaypoints](optimize-waypoints-how-to.md)
+ [Scopri come usare SnapToRoads](snap-to-roads-how-to.md)

# Scopri come usare CalculateRoutes
<a name="calculate-routes-how-to"></a>

Questa sezione fornisce step-by-step istruzioni per l'uso`CalculateRoutes`. Questo argomento descrive in dettaglio le linee guida su come trovare percorsi con configurazioni specifiche, come incorporare la turn-by-turn navigazione, impostare le modalità di viaggio e aggiungere waypoint.

**Topics**
+ [Come trovare un percorso per un'origine e una destinazione](calculate-routes-origin-destination-waypoints.md)
+ [Come trovare percorsi con turn-by-turn indicazioni stradali](how-to-find-turn-by-turn-route.md)
+ [Come trovare un limite di velocità per una campata stradale](calculate-routes-speed-limit-road.md)
+ [Come trovare percorsi alternativi](calculate-routes-alternate.md)
+ [Come calcolare i pedaggi per un percorso](calculate-routes-tolls.md)
+ [Come creare percorsi con elusione personalizzata](calculate-routes-custom-avoidance-poly.md)
+ [Come creare percorsi evitando in modo personalizzato diversi oggetti potenziali](calculate-routes-custom-avoidance-multiple.md)
+ [Come trovare il percorso più veloce](calculate-routes-custom-avoidance-fast.md)
+ [Come trovare i percorsi più brevi](calculate-routes-custom-avoidance-shortest.md)

# Come trovare un percorso per un'origine e una destinazione
<a name="calculate-routes-origin-destination-waypoints"></a>

L' CalculateRoutes API ti aiuta a trovare i percorsi migliori tra origine e destinazione, nonché le migliori opportunità per riposare il conducente. Supporta modalità di viaggio come camion, pedone, auto e scooter. Supporta anche fino a 25 waypoint (scali) tra cui l'origine e la destinazione con solo pochi vincoli.

## Casi d'uso potenziali
<a name="potential-use-cases"></a>
+ **Trova point-to-point percorsi:** determina il percorso migliore tra due località in base a varie modalità di viaggio e opzioni aggiuntive.

## Esempi
<a name="calculate-routes-examples"></a>

### Calcola i percorsi dall'origine alla destinazione utilizzando Car TravelMode
<a name="calculate-routes-car-mode"></a>

------
#### [ Sample request ]

```
{
    "Origin": [
        -123.118105,
        49.282423
    ],
    "Destination": [
        -123.020098,
        49.232872
    ]
}
```

------
#### [ Sample response ]

```
{
    "LegGeometryFormat": "FlexiblePolyline",
    "Notices": [],
    "Routes": [
        {
            "Legs": [
                {
                    "Geometry": {
                        "Polyline": "Redacted"
                    },
                    "TravelMode": "Car",
                    "Type": "Vehicle",
                    "VehicleLegDetails": {
                        "AfterTravelSteps": [],
                        "Arrival": {
                            "Place": {
                                "ChargingStation": false,
                                "OriginalPosition": [
                                    -123.020098,
                                    49.232872
                                ],
                                "Position": [
                                    -123.0203051,
                                    49.2328499
                                ]
                            }
                        },
                        "Departure": {
                            "Place": {
                                "ChargingStation": false,
                                "OriginalPosition": [
                                    -123.1181051,
                                    49.282423
                                ],
                                "Position": [
                                    -123.1180883,
                                    49.2824349
                                ]
                            }
                        },
                        "TravelSteps": [
                            {
                                "Distance": 1288,
                                "Duration": 102,
                                "Type": "Depart"
                            },
                            {
                                "Distance": 262,
                                "Duration": 24,
                                "Type": "Ramp"
                            },
                            {
                                "Distance": 1356,
                                "Duration": 134,
                                "Type": "Turn"
                            },
                            {
                                "Distance": 7092,
                                "Duration": 568,
                                "Type": "Keep"
                            },
                            {
                                "Distance": 65,
                                "Duration": 26,
                                "Type": "Turn"
                            },
                            {
                                "Distance": 50,
                                "Duration": 18,
                                "Type": "Turn"
                            },
                            {
                                "Distance": 0,
                                "Duration": 0,
                                "Type": "Arrive"
                            }
                        ]
                    }
                }
            ]
        }
    ]
}
```

------
#### [ cURL ]

```
curl --request POST \
  --url 'https://routes.geo.eu-central-1.amazonaws.com/v2/routes?key=Your_key' \
  --header 'Content-Type: application/json' \
  --data '{
  "Origin": [
    -123.118105,
    49.282423
  ],
  "Destination": [
    -123.020098,
    49.232872
  ]
}'
```

------
#### [ AWS CLI ]

```
aws geo-routes calculate-routes --key ${YourKey} \
--origin -123.118105 49.282423 \
--destination -123.020098 49.232872
```

------

# Come trovare percorsi con turn-by-turn indicazioni stradali
<a name="how-to-find-turn-by-turn-route"></a>

L' CalculateRoutes API ti aiuta a trovare i percorsi migliori tra origine e destinazione, nonché le migliori opportunità per riposare l'autista. Supporta modalità di viaggio come auto, camion, pedone e scooter. Supporta anche fino a 25 waypoint (scali) tra cui l'origine e la destinazione, con solo pochi vincoli.

## Casi d'uso potenziali
<a name="potential-use-cases-turn-by-turn"></a>
+ **Crea un'app di navigazione per dispositivi mobili:** utilizza l'API per ottenere istruzioni turn-by-turn di navigazione.
+ **Visualizza le indicazioni stradali su una piattaforma web:** mostra indicazioni dettagliate sul percorso per le applicazioni web per aiutarti nella navigazione.

## Esempi
<a name="calculate-routes-examples-turn-by-turn"></a>

### Calcola i percorsi utilizzando Car TravelMode
<a name="calculate-routes-car-mode-turn-by-turn"></a>

------
#### [ Sample request ]

```
{
    "Origin": [
        -123.118105,
        49.282423
    ],
    "Destination": [
        -123.020098,
        49.232872
    ],
    "TravelStepType": "TurnByTurn",
    "TravelMode": "Car"
}
```

------
#### [ Sample response ]

```
{
    "LegGeometryFormat": "FlexiblePolyline",
    "Notices": [],
    "Routes": [
        {
            "Legs": [
                {
                    "Geometry": {
                        "Polyline": "Redacted"
                    },
                    "TravelMode": "Car",
                    "Type": "Vehicle",
                    "VehicleLegDetails": {
                        "Arrival": {
                            "Place": {
                                "Position": [-123.0203051, 49.2328499]
                            }
                        },
                        "Departure": {
                            "Place": {
                                "Position": [-123.1180883, 49.2824349]
                            }
                        },
                        "TravelSteps": [
                            {
                                "Distance": 1288,
                                "Duration": 102,
                                "Type": "Depart",
                                "NextRoad": {
                                    "RoadName": "W Georgia St",
                                    "RouteNumber": "HWY-1A"
                                }
                            },
                            {
                                "Distance": 262,
                                "Duration": 24,
                                "Type": "Keep",
                                "NextRoad": {
                                    "RoadName": "Main St",
                                    "RouteNumber": "HWY-1A"
                                }
                            },
                            {
                                "Distance": 1356,
                                "Duration": 134,
                                "Type": "Turn",
                                "NextRoad": {
                                    "RoadName": "Main St",
                                    "RouteNumber": "HWY-1A"
                                }
                            },
                            {
                                "Distance": 7092,
                                "Duration": 568,
                                "Type": "Keep",
                                "NextRoad": {
                                    "RoadName": "Kingsway",
                                    "RouteNumber": "HWY-1A"
                                }
                            },
                            {
                                "Distance": 65,
                                "Duration": 26,
                                "Type": "Turn"
                            },
                            {
                                "Distance": 0,
                                "Duration": 0,
                                "Type": "Arrive"
                            }
                        ]
                    }
                }
            ]
        }
    ]
}
```

------
#### [ cURL ]

```
curl --request POST \
  --url 'https://routes.geo.eu-central-1.amazonaws.com/v2/routes?key=Your_key' \
  --header 'Content-Type: application/json' \
  --data '{
  "Origin": [
    -123.118105,
    49.282423
  ],
  "Destination": [
    -123.020098,
    49.232872
  ],
  "TravelStepType": "TurnByTurn",
  "TravelMode": "Car"
}'
```

------
#### [ AWS CLI ]

```
aws geo-routes calculate-routes --key ${YourKey} \
--origin -123.118105 49.282423 \
--destination -123.020098 49.232872 \
--travel-step-type "TurnByTurn" \
--travel-mode "Car"
```

------

# Come trovare un limite di velocità per una campata stradale
<a name="calculate-routes-speed-limit-road"></a>

L' CalculateRoutes API ti aiuta a trovare i percorsi migliori tra origine e destinazione, nonché le migliori opportunità per far riposare il conducente. Supporta modalità di viaggio come auto, camion, pedone e scooter. Supporta anche fino a 25 waypoint (scali) tra cui l'origine e la destinazione, con solo pochi vincoli.

## Casi d'uso potenziali
<a name="potential-use-cases"></a>
+ **Verifica la conformità ai limiti di velocità:** resta consapevole dei limiti di velocità e della loro conformità.
+ **Informa il conducente del limite di velocità:** notifica al conducente il limite di velocità quando altrimenti potrebbe non essere chiaro.

## Esempi
<a name="calculate-routes-speed-examples"></a>

### Trova i limiti di velocità in Auto TravelMode
<a name="calculate-routes-speed"></a>

------
#### [ Sample request ]

```
{
    "Origin": [
        13.055211,
        52.704802
    ],
    "Destination": [
        13.551910,
        52.282705
    ],
    "TravelMode": "Car",
    "SpanAdditionalFeatures": ["SpeedLimit"]
}
```

------
#### [ Sample response ]

```
{
    "LegGeometryFormat": "FlexiblePolyline",
    "Notices": [],
    "Routes": [
        {
            "Legs": [
                {
                    "Geometry": {
                        "Polyline": "Redacted"
                    },
                    "TravelMode": "Car",
                    "Type": "Vehicle",
                    "VehicleLegDetails": {
                        "AfterTravelSteps": [],
                        "Arrival": {
                            "Place": {
                                "ChargingStation": false,
                                "OriginalPosition": [
                                    13.55191,
                                    52.282705
                                ],
                                "Position": [
                                    13.5507836,
                                    52.2859121
                                ]
                            }
                        },
                        "Departure": {
                            "Place": {
                                "ChargingStation": false,
                                "OriginalPosition": [
                                    13.055211,
                                    52.704802
                                ],
                                "Position": [
                                    13.0555036,
                                    52.7056073
                                ]
                            }
                        },
                        "Incidents": [],
                        "Notices": [],
                        "PassThroughWaypoints": [],
                        "Spans": [
                            {
                                "GeometryOffset": 0,
                                "SpeedLimit": {
                                    "Unlimited": true
                                }
                            },
                            {
                                "GeometryOffset": 151,
                                "SpeedLimit": {
                                    "MaxSpeed": 120.00000762939453
                                }
                            },
                            {
                                "GeometryOffset": 167,
                                "SpeedLimit": {
                                    "MaxSpeed": 80
                                }
                            },
                            {
                                "GeometryOffset": 195,
                                "SpeedLimit": {
                                    "MaxSpeed": 120.00000762939453
                                }
                            },
                            {
                                "GeometryOffset": 220,
                                "SpeedLimit": {
                                    "Unlimited": true
                                }
                            },
                            {
                                "GeometryOffset": 356,
                                "SpeedLimit": {
                                    "MaxSpeed": 120.00000762939453
                                }
                            },
                            {
                                "GeometryOffset": 358,
                                "SpeedLimit": {
                                    "MaxSpeed": 100
                                }
                            },
                            {
                                "GeometryOffset": 368,
                                "SpeedLimit": {
                                    "MaxSpeed": 80
                                }
                            },
                            {
                                "GeometryOffset": 384,
                                "SpeedLimit": {
                                    "MaxSpeed": 60.000003814697266
                                }
                            },
                            {
                                "GeometryOffset": 639,
                                "SpeedLimit": {
                                    "MaxSpeed": 80
                                }
                            },
                            {
                                "GeometryOffset": 701,
                                "SpeedLimit": {
                                    "MaxSpeed": 60.000003814697266
                                }
                            },
                            {
                                "GeometryOffset": 726,
                                "SpeedLimit": {
                                    "MaxSpeed": 80
                                }
                            },
                            {
                                "GeometryOffset": 805,
                                "SpeedLimit": {
                                    "MaxSpeed": 60.000003814697266
                                }
                            },
                            {
                                "GeometryOffset": 839,
                                "SpeedLimit": {
                                    "MaxSpeed": 80
                                }
                            },
                            {
                                "GeometryOffset": 1384,
                                "SpeedLimit": {
                                    "MaxSpeed": 60.000003814697266
                                }
                            },
                            {
                                "GeometryOffset": 1393,
                                "SpeedLimit": {
                                    "MaxSpeed": 50
                                }
                            },
                            {
                                "GeometryOffset": 1443,
                                "SpeedLimit": {
                                    "MaxSpeed": 30.000001907348633
                                }
                            },
                            {
                                "GeometryOffset": 1454,
                                "SpeedLimit": {
                                    "MaxSpeed": 50
                                }
                            },
                            {
                                "GeometryOffset": 1504,
                                "SpeedLimit": {
                                    "MaxSpeed": 60.000003814697266
                                }
                            },
                            {
                                "GeometryOffset": 1513,
                                "SpeedLimit": {
                                    "MaxSpeed": 80
                                }
                            },
                            {
                                "GeometryOffset": 1516,
                                "SpeedLimit": {
                                    "MaxSpeed": 60.000003814697266
                                }
                            },
                            {
                                "GeometryOffset": 1555,
                                "SpeedLimit": {
                                    "MaxSpeed": 80
                                }
                            },
                            {
                                "GeometryOffset": 1748,
                                "SpeedLimit": {
                                    "MaxSpeed": 120.00000762939453
                                }
                            },
                            {
                                "GeometryOffset": 1904,
                                "SpeedLimit": {
                                    "MaxSpeed": 100
                                }
                            },
                            {
                                "GeometryOffset": 1945,
                                "SpeedLimit": {
                                    "Unlimited": true
                                }
                            },
                            {
                                "GeometryOffset": 2006,
                                "SpeedLimit": {
                                    "MaxSpeed": 70
                                }
                            },
                            {
                                "GeometryOffset": 2017,
                                "SpeedLimit": {
                                    "MaxSpeed": 50
                                }
                            },
                            {
                                "GeometryOffset": 2033,
                                "SpeedLimit": {
                                    "MaxSpeed": 30.000001907348633
                                }
                            }
                        ],
                        "Tolls": [],
                        "TollSystems": [],
                        "TravelSteps": [
                            {
                                "Distance": 9099,
                                "Duration": 262,
                                "ExitNumber": [],
                                "GeometryOffset": 0,
                                "Type": "Depart"
                            },
                            {
                                "Distance": 18849,
                                "Duration": 800,
                                "ExitNumber": [],
                                "GeometryOffset": 162,
                                "KeepStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right"
                                },
                                "Type": "Keep"
                            },
                            {
                                "Distance": 4290,
                                "Duration": 212,
                                "ExitNumber": [],
                                "ExitStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right"
                                },
                                "GeometryOffset": 701,
                                "Type": "Exit"
                            },
                            {
                                "Distance": 14418,
                                "Duration": 651,
                                "ExitNumber": [],
                                "GeometryOffset": 828,
                                "Type": "Continue"
                            },
                            {
                                "Distance": 1255,
                                "Duration": 62,
                                "ExitNumber": [],
                                "ExitStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right"
                                },
                                "GeometryOffset": 1359,
                                "Type": "Exit"
                            },
                            {
                                "Distance": 1607,
                                "Duration": 139,
                                "ExitNumber": [],
                                "GeometryOffset": 1393,
                                "TurnStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Left",
                                    "TurnIntensity": "Typical"
                                },
                                "Type": "Turn"
                            },
                            {
                                "Distance": 934,
                                "Duration": 92,
                                "ExitNumber": [],
                                "GeometryOffset": 1442,
                                "Type": "Continue"
                            },
                            {
                                "Distance": 320,
                                "Duration": 27,
                                "ExitNumber": [],
                                "GeometryOffset": 1473,
                                "Type": "Continue"
                            },
                            {
                                "Distance": 320,
                                "Duration": 33,
                                "ExitNumber": [],
                                "GeometryOffset": 1491,
                                "Type": "Continue"
                            },
                            {
                                "Distance": 17863,
                                "Duration": 680,
                                "ExitNumber": [],
                                "GeometryOffset": 1504,
                                "RampStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right"
                                },
                                "Type": "Ramp"
                            },
                            {
                                "Distance": 2888,
                                "Duration": 95,
                                "ExitNumber": [],
                                "GeometryOffset": 1917,
                                "Type": "Continue"
                            },
                            {
                                "Distance": 321,
                                "Duration": 28,
                                "ExitNumber": [],
                                "ExitStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right"
                                },
                                "GeometryOffset": 1977,
                                "Type": "Exit"
                            },
                            {
                                "Distance": 549,
                                "Duration": 41,
                                "ExitNumber": [],
                                "GeometryOffset": 2006,
                                "TurnStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right",
                                    "TurnIntensity": "Typical"
                                },
                                "Type": "Turn"
                            },
                            {
                                "Distance": 386,
                                "Duration": 51,
                                "ExitNumber": [],
                                "GeometryOffset": 2023,
                                "TurnStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Left",
                                    "TurnIntensity": "Typical"
                                },
                                "Type": "Turn"
                            },
                            {
                                "Distance": 98,
                                "Duration": 15,
                                "ExitNumber": [],
                                "GeometryOffset": 2033,
                                "TurnStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right",
                                    "TurnIntensity": "Typical"
                                },
                                "Type": "Turn"
                            },
                            {
                                "Distance": 0,
                                "Duration": 0,
                                "ExitNumber": [],
                                "GeometryOffset": 2036,
                                "Type": "Arrive"
                            }
                        ],
                        "TruckRoadTypes": [],
                        "Zones": []
                    }
                }
            ],
            "MajorRoadLabels": [
                {
                    "RouteNumber": {
                        "Language": "de",
                        "Value": "A111"
                    }
                },
                {
                    "RouteNumber": {
                        "Language": "de",
                        "Value": "A113"
                    }
                }
            ]
        }
    ]
}
```

------
#### [ cURL ]

```
curl --request POST \
  --url 'https://routes.geo.eu-central-1.amazonaws.com/v2/routes?key=Your_key' \
  --header 'Content-Type: application/json' \
  --data '{
  "Origin": [
    13.055211,
    52.704802
  ],
  "Destination": [
    13.551910,
    52.282705
  ],
  "TravelMode": "Car",
  "SpanAdditionalFeatures": ["SpeedLimit"]
}'
```

------
#### [ AWS CLI ]

```
aws geo-routes calculate-routes --key ${YourKey} \
--origin 13.055211 52.704802 \
--destination 13.551910 52.282705 \
--travel-mode "Car" \
--span-additional-features "SpeedLimit"
```

------

# Come trovare percorsi alternativi
<a name="calculate-routes-alternate"></a>

L' CalculateRoutes API ti aiuta a trovare i percorsi migliori tra origine e destinazione, nonché le migliori opportunità per riposare l'autista. Supporta modalità di viaggio come auto, camion, pedone e scooter. Supporta anche fino a 25 waypoint (scali) tra cui l'origine e la destinazione, con solo pochi vincoli.

## Casi d'uso potenziali
<a name="potential-use-cases"></a>
+ **Identifica percorsi alternativi:** sii in grado di scegliere il percorso migliore per soddisfare le tue esigenze aziendali.

## Esempi
<a name="calculate-routes-alternate-examples"></a>

### Trova percorsi alternativi in Car TravelMode
<a name="calculate-routes-alternate"></a>

------
#### [ Sample request ]

```
{
    "Origin": [
        13.055211,
        52.704802
    ],
    "Destination": [
        13.551910,
        52.282705
    ],
    "TravelMode": "Car",
    "MaxAlternatives": 2
}
```

------
#### [ Sample response ]

```
{
    "LegGeometryFormat": "FlexiblePolyline",
    "Notices": [],
    "Routes": [
        {
            "Legs": [
                {
                    "Geometry": {
                        "Polyline": "Redacted"
                    },
                    "TravelMode": "Car",
                    "Type": "Vehicle",
                    "VehicleLegDetails": {
                        "AfterTravelSteps": [],
                        "Arrival": {
                            "Place": {
                                "ChargingStation": false,
                                "OriginalPosition": [
                                    13.55191,
                                    52.282705
                                ],
                                "Position": [
                                    13.5507836,
                                    52.2859121
                                ]
                            }
                        },
                        "Departure": {
                            "Place": {
                                "ChargingStation": false,
                                "OriginalPosition": [
                                    13.055211,
                                    52.704802
                                ],
                                "Position": [
                                    13.0555036,
                                    52.7056073
                                ]
                            }
                        },
                        "Incidents": [],
                        "Notices": [],
                        "PassThroughWaypoints": [],
                        "Spans": [],
                        "Tolls": [],
                        "TollSystems": [],
                        "TravelSteps": [
                            {
                                "Distance": 9099,
                                "Duration": 262,
                                "ExitNumber": [],
                                "GeometryOffset": 0,
                                "Type": "Depart"
                            },
                            {
                                "Distance": 18849,
                                "Duration": 800,
                                "ExitNumber": [],
                                "GeometryOffset": 162,
                                "KeepStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right"
                                },
                                "Type": "Keep"
                            },
                            {
                                "Distance": 4290,
                                "Duration": 212,
                                "ExitNumber": [],
                                "ExitStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right"
                                },
                                "GeometryOffset": 701,
                                "Type": "Exit"
                            },
                            {
                                "Distance": 14418,
                                "Duration": 651,
                                "ExitNumber": [],
                                "GeometryOffset": 828,
                                "Type": "Continue"
                            },
                            {
                                "Distance": 1255,
                                "Duration": 62,
                                "ExitNumber": [],
                                "ExitStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right"
                                },
                                "GeometryOffset": 1359,
                                "Type": "Exit"
                            },
                            {
                                "Distance": 1607,
                                "Duration": 139,
                                "ExitNumber": [],
                                "GeometryOffset": 1393,
                                "TurnStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Left",
                                    "TurnIntensity": "Typical"
                                },
                                "Type": "Turn"
                            },
                            {
                                "Distance": 934,
                                "Duration": 92,
                                "ExitNumber": [],
                                "GeometryOffset": 1442,
                                "Type": "Continue"
                            },
                            {
                                "Distance": 320,
                                "Duration": 27,
                                "ExitNumber": [],
                                "GeometryOffset": 1473,
                                "Type": "Continue"
                            },
                            {
                                "Distance": 320,
                                "Duration": 33,
                                "ExitNumber": [],
                                "GeometryOffset": 1491,
                                "Type": "Continue"
                            },
                            {
                                "Distance": 17863,
                                "Duration": 680,
                                "ExitNumber": [],
                                "GeometryOffset": 1504,
                                "RampStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right"
                                },
                                "Type": "Ramp"
                            },
                            {
                                "Distance": 2888,
                                "Duration": 95,
                                "ExitNumber": [],
                                "GeometryOffset": 1917,
                                "Type": "Continue"
                            },
                            {
                                "Distance": 321,
                                "Duration": 28,
                                "ExitNumber": [],
                                "ExitStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right"
                                },
                                "GeometryOffset": 1977,
                                "Type": "Exit"
                            },
                            {
                                "Distance": 549,
                                "Duration": 41,
                                "ExitNumber": [],
                                "GeometryOffset": 2006,
                                "TurnStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right",
                                    "TurnIntensity": "Typical"
                                },
                                "Type": "Turn"
                            },
                            {
                                "Distance": 386,
                                "Duration": 51,
                                "ExitNumber": [],
                                "GeometryOffset": 2023,
                                "TurnStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Left",
                                    "TurnIntensity": "Typical"
                                },
                                "Type": "Turn"
                            },
                            {
                                "Distance": 98,
                                "Duration": 15,
                                "ExitNumber": [],
                                "GeometryOffset": 2033,
                                "TurnStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right",
                                    "TurnIntensity": "Typical"
                                },
                                "Type": "Turn"
                            },
                            {
                                "Distance": 0,
                                "Duration": 0,
                                "ExitNumber": [],
                                "GeometryOffset": 2036,
                                "Type": "Arrive"
                            }
                        ],
                        "TruckRoadTypes": [],
                        "Zones": []
                    }
                }
            ],
            "MajorRoadLabels": [
                {
                    "RouteNumber": {
                        "Language": "de",
                        "Value": "A111"
                    }
                },
                {
                    "RouteNumber": {
                        "Language": "de",
                        "Value": "A113"
                    }
                }
            ]
        },
        {
            "Legs": [
                {
                    "Geometry": {
                        "Polyline": "Redacted"
                    },
                    "TravelMode": "Car",
                    "Type": "Vehicle",
                    "VehicleLegDetails": {
                        "AfterTravelSteps": [],
                        "Arrival": {
                            "Place": {
                                "ChargingStation": false,
                                "OriginalPosition": [
                                    13.55191,
                                    52.282705
                                ],
                                "Position": [
                                    13.5507836,
                                    52.2859121
                                ]
                            }
                        },
                        "Departure": {
                            "Place": {
                                "ChargingStation": false,
                                "OriginalPosition": [
                                    13.055211,
                                    52.704802
                                ],
                                "Position": [
                                    13.0555036,
                                    52.7056073
                                ]
                            }
                        },
                        "Incidents": [],
                        "Notices": [],
                        "PassThroughWaypoints": [],
                        "Spans": [],
                        "Tolls": [],
                        "TollSystems": [],
                        "TravelSteps": [
                            {
                                "Distance": 91047,
                                "Duration": 2880,
                                "ExitNumber": [],
                                "GeometryOffset": 0,
                                "Type": "Depart"
                            },
                            {
                                "Distance": 3496,
                                "Duration": 119,
                                "ExitNumber": [],
                                "ExitStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right"
                                },
                                "GeometryOffset": 1473,
                                "Type": "Exit"
                            },
                            {
                                "Distance": 321,
                                "Duration": 28,
                                "ExitNumber": [],
                                "ExitStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right"
                                },
                                "GeometryOffset": 1565,
                                "Type": "Exit"
                            },
                            {
                                "Distance": 549,
                                "Duration": 41,
                                "ExitNumber": [],
                                "GeometryOffset": 1594,
                                "TurnStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right",
                                    "TurnIntensity": "Typical"
                                },
                                "Type": "Turn"
                            },
                            {
                                "Distance": 386,
                                "Duration": 51,
                                "ExitNumber": [],
                                "GeometryOffset": 1611,
                                "TurnStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Left",
                                    "TurnIntensity": "Typical"
                                },
                                "Type": "Turn"
                            },
                            {
                                "Distance": 98,
                                "Duration": 15,
                                "ExitNumber": [],
                                "GeometryOffset": 1621,
                                "TurnStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right",
                                    "TurnIntensity": "Typical"
                                },
                                "Type": "Turn"
                            },
                            {
                                "Distance": 0,
                                "Duration": 0,
                                "ExitNumber": [],
                                "GeometryOffset": 1624,
                                "Type": "Arrive"
                            }
                        ],
                        "TruckRoadTypes": [],
                        "Zones": []
                    }
                }
            ],
            "MajorRoadLabels": [
                {
                    "RouteNumber": {
                        "Language": "de",
                        "Value": "A10"
                    }
                }
            ]
        },
        {
            "Legs": [
                {
                    "Geometry": {
                        "Polyline": "Redacted"
                    },
                    "TravelMode": "Car",
                    "Type": "Vehicle",
                    "VehicleLegDetails": {
                        "AfterTravelSteps": [],
                        "Arrival": {
                            "Place": {
                                "ChargingStation": false,
                                "OriginalPosition": [
                                    13.55191,
                                    52.282705
                                ],
                                "Position": [
                                    13.5507836,
                                    52.2859121
                                ]
                            }
                        },
                        "Departure": {
                            "Place": {
                                "ChargingStation": false,
                                "OriginalPosition": [
                                    13.055211,
                                    52.704802
                                ],
                                "Position": [
                                    13.0555036,
                                    52.7056073
                                ]
                            }
                        },
                        "Incidents": [],
                        "Notices": [],
                        "PassThroughWaypoints": [],
                        "Spans": [],
                        "Tolls": [],
                        "TollSystems": [],
                        "TravelSteps": [
                            {
                                "Distance": 9099,
                                "Duration": 262,
                                "ExitNumber": [],
                                "GeometryOffset": 0,
                                "Type": "Depart"
                            },
                            {
                                "Distance": 18849,
                                "Duration": 800,
                                "ExitNumber": [],
                                "GeometryOffset": 162,
                                "KeepStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right"
                                },
                                "Type": "Keep"
                            },
                            {
                                "Distance": 4290,
                                "Duration": 212,
                                "ExitNumber": [],
                                "ExitStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right"
                                },
                                "GeometryOffset": 701,
                                "Type": "Exit"
                            },
                            {
                                "Distance": 12258,
                                "Duration": 554,
                                "ExitNumber": [],
                                "GeometryOffset": 828,
                                "Type": "Continue"
                            },
                            {
                                "Distance": 18567,
                                "Duration": 1218,
                                "ExitNumber": [],
                                "ExitStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right"
                                },
                                "GeometryOffset": 1282,
                                "Type": "Exit"
                            },
                            {
                                "Distance": 250,
                                "Duration": 28,
                                "ExitNumber": [],
                                "GeometryOffset": 1760,
                                "RampStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right"
                                },
                                "Type": "Ramp"
                            },
                            {
                                "Distance": 4856,
                                "Duration": 245,
                                "ExitNumber": [],
                                "GeometryOffset": 1793,
                                "TurnStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right",
                                    "TurnIntensity": "Typical"
                                },
                                "Type": "Turn"
                            },
                            {
                                "Distance": 3202,
                                "Duration": 165,
                                "ExitNumber": [],
                                "GeometryOffset": 1970,
                                "RoundaboutExitStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right"
                                },
                                "Type": "RoundaboutExit"
                            },
                            {
                                "Distance": 386,
                                "Duration": 51,
                                "ExitNumber": [],
                                "GeometryOffset": 2072,
                                "TurnStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right",
                                    "TurnIntensity": "Typical"
                                },
                                "Type": "Turn"
                            },
                            {
                                "Distance": 98,
                                "Duration": 15,
                                "ExitNumber": [],
                                "GeometryOffset": 2082,
                                "TurnStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right",
                                    "TurnIntensity": "Typical"
                                },
                                "Type": "Turn"
                            },
                            {
                                "Distance": 0,
                                "Duration": 0,
                                "ExitNumber": [],
                                "GeometryOffset": 2085,
                                "Type": "Arrive"
                            }
                        ],
                        "TruckRoadTypes": [],
                        "Zones": []
                    }
                }
            ],
            "MajorRoadLabels": [
                {
                    "RouteNumber": {
                        "Language": "de",
                        "Value": "A111"
                    }
                },
                {
                    "RouteNumber": {
                        "Language": "de",
                        "Value": "B96"
                    }
                }
            ]
        }
    ]
}
```

------
#### [ cURL ]

```
curl --request POST \
  --url 'https://routes.geo.eu-central-1.amazonaws.com/v2/routes?key=Your_key' \
  --header 'Content-Type: application/json' \
  --data '{
  "Origin": [
    13.055211,
    52.704802
  ],
  "Destination": [
    13.551910,
    52.282705
  ],
  "TravelMode": "Car",
  "MaxAlternatives": 2
}'
```

------
#### [ AWS CLI ]

```
aws geo-routes calculate-routes --key ${YourKey} \
--origin 13.055211 52.704802 \
--destination 13.551910 52.282705 \
--travel-mode "Car" \
--max-alternatives 2
```

------

# Come calcolare i pedaggi per un percorso
<a name="calculate-routes-tolls"></a>

L' CalculateRoutes API ti aiuta a trovare i percorsi migliori tra origine e destinazione, nonché le migliori opportunità per riposare l'autista. Supporta modalità di viaggio come auto, camion, pedone e scooter. Supporta anche fino a 25 waypoint (scali) tra cui l'origine e la destinazione, con solo pochi vincoli.

## Casi d'uso potenziali
<a name="potential-use-cases"></a>
+ **Calcola i pedaggi:** puoi calcolare i costi dei pedaggi durante la pianificazione del percorso.
+ **Verifica dei pedaggi:** potrai controllare i costi dei pedaggi dopo il viaggio.

## Esempi
<a name="calculate-routes-tolls-examples"></a>

### Calcola i pedaggi per i tuoi percorsi in Car TravelMode
<a name="calculate-routes-tolls"></a>

------
#### [ Sample request ]

```
{
    "Origin": [
        2.234491,
        48.815704
    ],
    "Destination": [
        5.11412,
        47.260723
    ],
    "TravelMode": "Car",
    "Tolls": {
        "AllTransponders": true,
        "AllVignettes": true
    }
}
```

------
#### [ Sample response ]

```
{
    "LegGeometryFormat": "FlexiblePolyline",
    "Notices": [],
    "Routes": [
        {
            "Legs": [
                {
                    "Geometry": {
                        "Polyline": "Redacted"
                    },
                    "TravelMode": "Car",
                    "Type": "Vehicle",
                    "VehicleLegDetails": {
                        "AfterTravelSteps": [],
                        "Arrival": {
                            "Place": {
                                "ChargingStation": false,
                                "OriginalPosition": [
                                    5.11412,
                                    47.2607229
                                ],
                                "Position": [
                                    5.1128203,
                                    47.2596356
                                ]
                            }
                        },
                        "Departure": {
                            "Place": {
                                "ChargingStation": false,
                                "OriginalPosition": [
                                    2.234491,
                                    48.8157039
                                ],
                                "Position": [
                                    2.2346482,
                                    48.815674
                                ]
                            }
                        },
                        "Incidents": [],
                        "Notices": [],
                        "PassThroughWaypoints": [],
                        "Spans": [],
                        "Tolls": [
                            {
                                "Country": "FRA",
                                "PaymentSites": [
                                    {
                                        "Name": "FLEURY-EN-BIERE",
                                        "Position": [
                                            2.53988,
                                            48.42578
                                        ]
                                    },
                                    {
                                        "Name": "POUILLY-EN-AUXOIS",
                                        "Position": [
                                            4.56112,
                                            47.25244
                                        ]
                                    }
                                ],
                                "Rates": [
                                    {
                                        "Id": "2d680295-fb0f-45aa-a8ed-79d9f0f9ff9f",
                                        "LocalPrice": {
                                            "Currency": "EUR",
                                            "Estimate": false,
                                            "Range": false,
                                            "Value": 21.700000762939453
                                        },
                                        "Name": "APRR",
                                        "PaymentMethods": [
                                            "Cash",
                                            "BankCard",
                                            "CreditCard",
                                            "Transponder",
                                            "TravelCard"
                                        ],
                                        "Transponders": [
                                            {
                                                "SystemName": "BipandGo"
                                            },
                                            {
                                                "SystemName": "BipandGo"
                                            },
                                            {
                                                "SystemName": "BipandGo IDVROOM carpoorling"
                                            },
                                            {
                                                "SystemName": "Cito30"
                                            },
                                            {
                                                "SystemName": "Easytrip pass"
                                            },
                                            {
                                                "SystemName": "Liane 30"
                                            },
                                            {
                                                "SystemName": "Liber-t"
                                            },
                                            {
                                                "SystemName": "Liber-t mobilitis"
                                            },
                                            {
                                                "SystemName": "Pass Pont-Pont"
                                            },
                                            {
                                                "SystemName": "Progressivi'T Maurienne"
                                            },
                                            {
                                                "SystemName": "TopEurop"
                                            },
                                            {
                                                "SystemName": "Tunnel Pass+"
                                            },
                                            {
                                                "SystemName": "Ulys"
                                            },
                                            {
                                                "SystemName": "Ulys Europe"
                                            },
                                            {
                                                "SystemName": "Viaduc-t 30"
                                            }
                                        ]
                                    }
                                ],
                                "Systems": [
                                    0
                                ]
                            }
                        ],
                        "TollSystems": [
                            {
                                "Name": "APRR"
                            }
                        ],
                        "TravelSteps": [
                            {
                                "Distance": 122,
                                "Duration": 21,
                                "ExitNumber": [],
                                "GeometryOffset": 0,
                                "Type": "Depart"
                            },
                            {
                                "Distance": 32,
                                "Duration": 7,
                                "ExitNumber": [],
                                "GeometryOffset": 7,
                                "TurnStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right",
                                    "TurnIntensity": "Typical"
                                },
                                "Type": "Turn"
                            },
                            {
                                "Distance": 74,
                                "Duration": 14,
                                "ExitNumber": [],
                                "GeometryOffset": 8,
                                "TurnStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right",
                                    "TurnIntensity": "Typical"
                                },
                                "Type": "Turn"
                            },
                            {
                                "Distance": 199,
                                "Duration": 33,
                                "ExitNumber": [],
                                "GeometryOffset": 9,
                                "TurnStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right",
                                    "TurnIntensity": "Typical"
                                },
                                "Type": "Turn"
                            },
                            {
                                "Distance": 21,
                                "Duration": 10,
                                "ExitNumber": [],
                                "GeometryOffset": 17,
                                "TurnStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right",
                                    "TurnIntensity": "Typical"
                                },
                                "Type": "Turn"
                            },
                            {
                                "Distance": 461,
                                "Duration": 63,
                                "ExitNumber": [],
                                "GeometryOffset": 20,
                                "TurnStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right",
                                    "TurnIntensity": "Typical"
                                },
                                "Type": "Turn"
                            },
                            {
                                "Distance": 1557,
                                "Duration": 145,
                                "ExitNumber": [],
                                "GeometryOffset": 41,
                                "TurnStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Left",
                                    "TurnIntensity": "Typical"
                                },
                                "Type": "Turn"
                            },
                            {
                                "Distance": 3471,
                                "Duration": 151,
                                "ExitNumber": [],
                                "GeometryOffset": 135,
                                "RoundaboutExitStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right"
                                },
                                "Type": "RoundaboutExit"
                            },
                            {
                                "Distance": 9796,
                                "Duration": 430,
                                "ExitNumber": [],
                                "GeometryOffset": 242,
                                "RampStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right"
                                },
                                "Type": "Ramp"
                            },
                            {
                                "Distance": 2473,
                                "Duration": 112,
                                "ExitNumber": [],
                                "ExitStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right"
                                },
                                "GeometryOffset": 582,
                                "Type": "Exit"
                            },
                            {
                                "Distance": 674,
                                "Duration": 25,
                                "ExitNumber": [],
                                "GeometryOffset": 669,
                                "Type": "Continue"
                            },
                            {
                                "Distance": 253953,
                                "Duration": 7468,
                                "ExitNumber": [],
                                "GeometryOffset": 679,
                                "Type": "Continue"
                            },
                            {
                                "Distance": 37379,
                                "Duration": 1192,
                                "ExitNumber": [],
                                "ExitStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right"
                                },
                                "GeometryOffset": 5701,
                                "Type": "Exit"
                            },
                            {
                                "Distance": 2021,
                                "Duration": 110,
                                "ExitNumber": [],
                                "GeometryOffset": 6695,
                                "RoundaboutExitStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right"
                                },
                                "Type": "RoundaboutExit"
                            },
                            {
                                "Distance": 7380,
                                "Duration": 316,
                                "ExitNumber": [],
                                "GeometryOffset": 6776,
                                "RoundaboutPassStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right"
                                },
                                "Type": "RoundaboutPass"
                            },
                            {
                                "Distance": 4253,
                                "Duration": 156,
                                "ExitNumber": [],
                                "GeometryOffset": 6987,
                                "KeepStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Left"
                                },
                                "Type": "Keep"
                            },
                            {
                                "Distance": 813,
                                "Duration": 54,
                                "ExitNumber": [],
                                "GeometryOffset": 7081,
                                "RampStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right"
                                },
                                "Type": "Ramp"
                            },
                            {
                                "Distance": 1909,
                                "Duration": 109,
                                "ExitNumber": [],
                                "GeometryOffset": 7133,
                                "TurnStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Left",
                                    "TurnIntensity": "Sharp"
                                },
                                "Type": "Turn"
                            },
                            {
                                "Distance": 827,
                                "Duration": 47,
                                "ExitNumber": [],
                                "GeometryOffset": 7182,
                                "Type": "Continue"
                            },
                            {
                                "Distance": 680,
                                "Duration": 41,
                                "ExitNumber": [],
                                "GeometryOffset": 7216,
                                "RoundaboutExitStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right"
                                },
                                "Type": "RoundaboutExit"
                            },
                            {
                                "Distance": 224,
                                "Duration": 12,
                                "ExitNumber": [],
                                "GeometryOffset": 7258,
                                "Type": "Continue"
                            },
                            {
                                "Distance": 25,
                                "Duration": 2,
                                "ExitNumber": [],
                                "GeometryOffset": 7265,
                                "Type": "Continue"
                            },
                            {
                                "Distance": 748,
                                "Duration": 51,
                                "ExitNumber": [],
                                "GeometryOffset": 7267,
                                "Type": "Continue"
                            },
                            {
                                "Distance": 656,
                                "Duration": 46,
                                "ExitNumber": [],
                                "GeometryOffset": 7299,
                                "RoundaboutExitStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right"
                                },
                                "Type": "RoundaboutExit"
                            },
                            {
                                "Distance": 1119,
                                "Duration": 78,
                                "ExitNumber": [],
                                "GeometryOffset": 7329,
                                "Type": "Continue"
                            },
                            {
                                "Distance": 432,
                                "Duration": 26,
                                "ExitNumber": [],
                                "GeometryOffset": 7383,
                                "TurnStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right",
                                    "TurnIntensity": "Typical"
                                },
                                "Type": "Turn"
                            },
                            {
                                "Distance": 1864,
                                "Duration": 100,
                                "ExitNumber": [],
                                "GeometryOffset": 7402,
                                "RoundaboutExitStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right"
                                },
                                "Type": "RoundaboutExit"
                            },
                            {
                                "Distance": 1110,
                                "Duration": 93,
                                "ExitNumber": [],
                                "GeometryOffset": 7470,
                                "RoundaboutExitStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right"
                                },
                                "Type": "RoundaboutExit"
                            },
                            {
                                "Distance": 232,
                                "Duration": 10,
                                "ExitNumber": [],
                                "GeometryOffset": 7563,
                                "Type": "Continue"
                            },
                            {
                                "Distance": 642,
                                "Duration": 29,
                                "ExitNumber": [],
                                "GeometryOffset": 7572,
                                "Type": "Continue"
                            },
                            {
                                "Distance": 357,
                                "Duration": 25,
                                "ExitNumber": [],
                                "GeometryOffset": 7580,
                                "Type": "Continue"
                            },
                            {
                                "Distance": 63,
                                "Duration": 10,
                                "ExitNumber": [],
                                "GeometryOffset": 7600,
                                "TurnStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right",
                                    "TurnIntensity": "Typical"
                                },
                                "Type": "Turn"
                            },
                            {
                                "Distance": 2626,
                                "Duration": 411,
                                "ExitNumber": [],
                                "GeometryOffset": 7602,
                                "TurnStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right",
                                    "TurnIntensity": "Typical"
                                },
                                "Type": "Turn"
                            },
                            {
                                "Distance": 234,
                                "Duration": 37,
                                "ExitNumber": [],
                                "GeometryOffset": 7627,
                                "Type": "Continue"
                            },
                            {
                                "Distance": 0,
                                "Duration": 0,
                                "ExitNumber": [],
                                "GeometryOffset": 7632,
                                "Type": "Arrive"
                            }
                        ],
                        "TruckRoadTypes": [],
                        "Zones": []
                    }
                }
            ],
            "MajorRoadLabels": [
                {
                    "RouteNumber": {
                        "Language": "fr",
                        "Value": "A6"
                    }
                }
            ]
        }
    ]
}
```

------
#### [ cURL ]

```
curl --request POST \
  --url 'https://routes.geo.eu-central-1.amazonaws.com/v2/routes?key=Your_key' \
  --header 'Content-Type: application/json' \
  --data '{
  "Origin": [
    2.234491,
    48.815704
  ],
  "Destination": [
    5.11412,
    47.260723
  ],
  "TravelMode": "Car",
  "Tolls": {
    "AllTransponders": true,
    "AllVignettes": true
  }
}'
```

------
#### [ AWS CLI ]

```
aws geo-routes calculate-routes --key ${YourKey} \
--origin 13.055211 52.704802 \
--destination 13.551910 52.282705 \
--travel-mode "Car" \
--tolls '{"AllTransponders": true, "AllVignettes": true}'
```

------

# Come creare percorsi con elusione personalizzata
<a name="calculate-routes-custom-avoidance-poly"></a>

L' CalculateRoutes API ti aiuta a trovare i percorsi migliori tra origine e destinazione, nonché le migliori opportunità per riposare l'autista. Supporta modalità di viaggio come auto, camion, pedone e scooter. Supporta anche fino a 25 waypoint (scali) tra cui l'origine e la destinazione, con solo pochi vincoli.

## Casi d'uso potenziali
<a name="potential-use-cases"></a>
+ **Calcola i percorsi evitando percorsi personalizzati:** personalizza i percorsi evitandoli per migliorare i percorsi e la pianificazione degli spostamenti.

## Esempi
<a name="calculate-routes-custom-avoidance-examples"></a>

### Usalo CalculateRoutes con un avoid BoundingBox per creare percorsi personalizzati.
<a name="calculate-routes-custom-avoidance-poly"></a>

------
#### [ Sample request ]

```
{
    "Origin": [
        -123.116655,
        49.281538
    ],
    "Destination": [
        -123.01791785749363,
        49.22782762759908
    ],
    "TravelMode": "Car",
    "Avoid": {
        "Areas": [
            {
                "Geometry": {
                    "BoundingBox": [
                        -123.078693,
                        49.238987,
                        -123.054638,
                        49.251694
                    ]
                }
            }
        ]
    }
}
```

------
#### [ Sample response ]

```
{
    "LegGeometryFormat": "FlexiblePolyline",
    "Notices": [],
    "Routes": [
        {
            "Legs": [
                {
                    "Geometry": {
                        "Polyline": "Redacted"
                    },
                    "TravelMode": "Car",
                    "Type": "Vehicle",
                    "VehicleLegDetails": {
                        "AfterTravelSteps": [],
                        "Arrival": {
                            "Place": {
                                "ChargingStation": false,
                                "OriginalPosition": [
                                    -123.0179179,
                                    49.2278276
                                ],
                                "Position": [
                                    -123.0229001,
                                    49.22883
                                ]
                            }
                        },
                        "Departure": {
                            "Place": {
                                "ChargingStation": false,
                                "OriginalPosition": [
                                    -123.116655,
                                    49.281538
                                ],
                                "Position": [
                                    -123.1166332,
                                    49.2815528
                                ]
                            }
                        },
                        "Incidents": [],
                        "Notices": [],
                        "PassThroughWaypoints": [],
                        "Spans": [],
                        "Tolls": [],
                        "TollSystems": [],
                        "TravelSteps": [
                            {
                                "Distance": 1144,
                                "Duration": 85,
                                "ExitNumber": [],
                                "GeometryOffset": 0,
                                "Type": "Depart"
                            },
                            {
                                "Distance": 262,
                                "Duration": 24,
                                "ExitNumber": [],
                                "GeometryOffset": 35,
                                "RampStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right"
                                },
                                "Type": "Ramp"
                            },
                            {
                                "Distance": 433,
                                "Duration": 47,
                                "ExitNumber": [],
                                "GeometryOffset": 40,
                                "TurnStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right",
                                    "TurnIntensity": "Typical"
                                },
                                "Type": "Turn"
                            },
                            {
                                "Distance": 1131,
                                "Duration": 81,
                                "ExitNumber": [],
                                "GeometryOffset": 54,
                                "TurnStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Left",
                                    "TurnIntensity": "Typical"
                                },
                                "Type": "Turn"
                            },
                            {
                                "Distance": 54,
                                "Duration": 4,
                                "ExitNumber": [],
                                "GeometryOffset": 79,
                                "Type": "Continue"
                            },
                            {
                                "Distance": 520,
                                "Duration": 39,
                                "ExitNumber": [],
                                "GeometryOffset": 83,
                                "Type": "Continue"
                            },
                            {
                                "Distance": 1123,
                                "Duration": 111,
                                "ExitNumber": [],
                                "GeometryOffset": 101,
                                "TurnStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right",
                                    "TurnIntensity": "Typical"
                                },
                                "Type": "Turn"
                            },
                            {
                                "Distance": 1131,
                                "Duration": 81,
                                "ExitNumber": [],
                                "GeometryOffset": 141,
                                "TurnStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Left",
                                    "TurnIntensity": "Typical"
                                },
                                "Type": "Turn"
                            },
                            {
                                "Distance": 2843,
                                "Duration": 209,
                                "ExitNumber": [],
                                "GeometryOffset": 167,
                                "Type": "Continue"
                            },
                            {
                                "Distance": 3219,
                                "Duration": 246,
                                "ExitNumber": [],
                                "GeometryOffset": 255,
                                "TurnStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right",
                                    "TurnIntensity": "Typical"
                                },
                                "Type": "Turn"
                            },
                            {
                                "Distance": 64,
                                "Duration": 23,
                                "ExitNumber": [],
                                "GeometryOffset": 332,
                                "TurnStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Left",
                                    "TurnIntensity": "Typical"
                                },
                                "Type": "Turn"
                            },
                            {
                                "Distance": 0,
                                "Duration": 0,
                                "ExitNumber": [],
                                "GeometryOffset": 334,
                                "Type": "Arrive"
                            }
                        ],
                        "TruckRoadTypes": [],
                        "Zones": []
                    }
                }
            ],
            "MajorRoadLabels": [
                {
                    "RoadName": {
                        "Language": "en",
                        "Value": "Boundary Rd"
                    }
                },
                {
                    "RoadName": {
                        "Language": "en",
                        "Value": "Grandview Hwy"
                    }
                }
            ]
        }
    ]
}
```

------
#### [ cURL ]

```
curl --request POST \
  --url 'https://routes.geo.eu-central-1.amazonaws.com/v2/routes?key=Your_key' \
  --header 'Content-Type: application/json' \
  --data '{
  "Origin": [
    -123.116655,
    49.281538
  ],
  "Destination": [
    -123.01791785749363,
    49.22782762759908
  ],
  "TravelMode": "Car",
  "Avoid": {
    "Areas": [
      {
        "Geometry": {
          "BoundingBox": [
            -123.078693,
            49.238987,
            -123.054638,
            49.251694
          ]
        }
      }
    ]
  }
}'
```

------
#### [ AWS CLI ]

```
aws geo-routes calculate-routes --key ${YourKey} \
--origin -123.13277 49.281538 \
--destination -123.01791785749363 49.22782762759908 \
--travel-mode "Car" \
--avoid '{"Areas":[{"Geometry":{"BoundingBox":[-123.054638,49.238987,-123.054638,49.251694]}}]}'
```

------

### Utilizzalo CalculateRoutes con un poligono da evitare per creare percorsi personalizzati.
<a name="calculate-routes-custom-avoidance-poly-polygon"></a>

------
#### [ Sample request ]

```
{
    "Origin": [
        -123.116655,
        49.281538
    ],
    "Destination": [
        -123.01791785749363,
        49.22782762759908
    ],
    "TravelMode": "Car",
    "Avoid": {
        "Areas": [
            {
                "Geometry": {
                    "polygon": [
                        [
                            [
                                -123.06953,
                                49.256419
                            ],
                            [
                                -123.080486,
                                49.242115
                            ],
                            [
                                -123.058573,
                                49.242115
                            ],
                            [
                                -123.06953,
                                49.256419
                            ]
                        ]
                    ]
                }
            }
        ]
    }
}
```

------
#### [ Sample response ]

```
{
    "LegGeometryFormat": "FlexiblePolyline",
    "Notices": [],
    "Routes": [
        {
            "Legs": [
                {
                    "Geometry": {
                        "Polyline": "Redacted"
                    },
                    "TravelMode": "Car",
                    "Type": "Vehicle",
                    "VehicleLegDetails": {
                        "AfterTravelSteps": [],
                        "Arrival": {
                            "Place": {
                                "ChargingStation": false,
                                "OriginalPosition": [
                                    -123.0179179,
                                    49.2278276
                                ],
                                "Position": [
                                    -123.0229001,
                                    49.22883
                                ]
                            }
                        },
                        "Departure": {
                            "Place": {
                                "ChargingStation": false,
                                "OriginalPosition": [
                                    -123.116655,
                                    49.281538
                                ],
                                "Position": [
                                    -123.1166332,
                                    49.2815528
                                ]
                            }
                        },
                        "Incidents": [],
                        "Notices": [],
                        "PassThroughWaypoints": [],
                        "Spans": [],
                        "Tolls": [],
                        "TollSystems": [],
                        "TravelSteps": [
                            {
                                "Distance": 1144,
                                "Duration": 85,
                                "ExitNumber": [],
                                "GeometryOffset": 0,
                                "Type": "Depart"
                            },
                            {
                                "Distance": 262,
                                "Duration": 24,
                                "ExitNumber": [],
                                "GeometryOffset": 35,
                                "RampStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right"
                                },
                                "Type": "Ramp"
                            },
                            {
                                "Distance": 433,
                                "Duration": 47,
                                "ExitNumber": [],
                                "GeometryOffset": 40,
                                "TurnStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right",
                                    "TurnIntensity": "Typical"
                                },
                                "Type": "Turn"
                            },
                            {
                                "Distance": 1131,
                                "Duration": 81,
                                "ExitNumber": [],
                                "GeometryOffset": 54,
                                "TurnStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Left",
                                    "TurnIntensity": "Typical"
                                },
                                "Type": "Turn"
                            },
                            {
                                "Distance": 54,
                                "Duration": 4,
                                "ExitNumber": [],
                                "GeometryOffset": 79,
                                "Type": "Continue"
                            },
                            {
                                "Distance": 520,
                                "Duration": 39,
                                "ExitNumber": [],
                                "GeometryOffset": 83,
                                "Type": "Continue"
                            },
                            {
                                "Distance": 1123,
                                "Duration": 111,
                                "ExitNumber": [],
                                "GeometryOffset": 101,
                                "TurnStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right",
                                    "TurnIntensity": "Typical"
                                },
                                "Type": "Turn"
                            },
                            {
                                "Distance": 1131,
                                "Duration": 81,
                                "ExitNumber": [],
                                "GeometryOffset": 141,
                                "TurnStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Left",
                                    "TurnIntensity": "Typical"
                                },
                                "Type": "Turn"
                            },
                            {
                                "Distance": 448,
                                "Duration": 34,
                                "ExitNumber": [],
                                "GeometryOffset": 167,
                                "Type": "Continue"
                            },
                            {
                                "Distance": 1797,
                                "Duration": 151,
                                "ExitNumber": [],
                                "GeometryOffset": 182,
                                "TurnStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right",
                                    "TurnIntensity": "Typical"
                                },
                                "Type": "Turn"
                            },
                            {
                                "Distance": 2836,
                                "Duration": 224,
                                "ExitNumber": [],
                                "GeometryOffset": 222,
                                "TurnStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Left",
                                    "TurnIntensity": "Typical"
                                },
                                "Type": "Turn"
                            },
                            {
                                "Distance": 339,
                                "Duration": 30,
                                "ExitNumber": [],
                                "GeometryOffset": 326,
                                "TurnStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right",
                                    "TurnIntensity": "Typical"
                                },
                                "Type": "Turn"
                            },
                            {
                                "Distance": 64,
                                "Duration": 23,
                                "ExitNumber": [],
                                "GeometryOffset": 335,
                                "TurnStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Left",
                                    "TurnIntensity": "Typical"
                                },
                                "Type": "Turn"
                            },
                            {
                                "Distance": 0,
                                "Duration": 0,
                                "ExitNumber": [],
                                "GeometryOffset": 337,
                                "Type": "Arrive"
                            }
                        ],
                        "TruckRoadTypes": [],
                        "Zones": []
                    }
                }
            ],
            "MajorRoadLabels": [
                {
                    "RouteNumber": {
                        "Language": "en",
                        "Value": "HWY-1A"
                    }
                },
                {
                    "RoadName": {
                        "Language": "en",
                        "Value": "Nanaimo St"
                    }
                }
            ]
        }
    ]
}
```

------
#### [ cURL ]

```
curl --request POST \
  --url 'https://routes.geo.eu-central-1.amazonaws.com/v2/routes?key=Your_key' \
  --header 'Content-Type: application/json' \
  --data '{
  "Origin": [
    -123.116655,
    49.281538
  ],
  "Destination": [
    -123.01791785749363,
    49.22782762759908
  ],
  "TravelMode": "Car",
  "Avoid": {
    "Areas": [
      {
        "Geometry": {
          "polygon": [
            [
              [
                -123.06953,
                49.256419
              ],
              [
                -123.080486,
                49.242115
              ],
              [
                -123.058573,
                49.242115
              ],
              [
                -123.06953,
                49.256419
              ]
            ]
          ]
        }
      }
    ]
  }
}'
```

------
#### [ AWS CLI ]

```
aws geo-routes calculate-routes --key ${YourKey} \
--origin -123.13277 49.281538 \
--destination -123.01791785749363 49.22782762759908 \
--travel-mode "Car" \
--avoid '{"Areas":[{"Geometry":{"Polygon":[[[-123.06953,49.256419],[-123.05167,49.242115],[-123.02381,49.242115],[-123.06953,49.256419]]]}}]}'
```

------

### Da utilizzare CalculateRoutes con PolylinePolygon per creare percorsi personalizzati.
<a name="calculate-routes-custom-avoidance-poly-polyline"></a>

------
#### [ Sample request ]

```
{
    "Origin": [
        -123.116655,
        49.281538
    ],
    "Destination": [
        -123.01791785749363,
        49.22782762759908
    ],
    "TravelMode": "Car",
    "Avoid": {
        "Areas": [
            {
                "Geometry": {
                    "PolylinePolygon": [
                        "BF0s0sJxglvXr5CvkCAgpEs5CvkC"
                    ]
                }
            }
        ]
    }
}
```

------
#### [ Sample response ]

```
{
    "LegGeometryFormat": "FlexiblePolyline",
    "Notices": [],
    "Routes": [
        {
            "Legs": [
                {
                    "Geometry": {
                        "Polyline": "Redacted"
                    },
                    "TravelMode": "Car",
                    "Type": "Vehicle",
                    "VehicleLegDetails": {
                        "AfterTravelSteps": [],
                        "Arrival": {
                            "Place": {
                                "ChargingStation": false,
                                "OriginalPosition": [
                                    -123.0179179,
                                    49.2278276
                                ],
                                "Position": [
                                    -123.0229001,
                                    49.22883
                                ]
                            }
                        },
                        "Departure": {
                            "Place": {
                                "ChargingStation": false,
                                "OriginalPosition": [
                                    -123.116655,
                                    49.281538
                                ],
                                "Position": [
                                    -123.1166332,
                                    49.2815528
                                ]
                            }
                        },
                        "Incidents": [],
                        "Notices": [],
                        "PassThroughWaypoints": [],
                        "Spans": [],
                        "Tolls": [],
                        "TollSystems": [],
                        "TravelSteps": [
                            {
                                "Distance": 1144,
                                "Duration": 85,
                                "ExitNumber": [],
                                "GeometryOffset": 0,
                                "Type": "Depart"
                            },
                            {
                                "Distance": 262,
                                "Duration": 24,
                                "ExitNumber": [],
                                "GeometryOffset": 35,
                                "RampStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right"
                                },
                                "Type": "Ramp"
                            },
                            {
                                "Distance": 433,
                                "Duration": 47,
                                "ExitNumber": [],
                                "GeometryOffset": 40,
                                "TurnStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right",
                                    "TurnIntensity": "Typical"
                                },
                                "Type": "Turn"
                            },
                            {
                                "Distance": 1131,
                                "Duration": 81,
                                "ExitNumber": [],
                                "GeometryOffset": 54,
                                "TurnStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Left",
                                    "TurnIntensity": "Typical"
                                },
                                "Type": "Turn"
                            },
                            {
                                "Distance": 54,
                                "Duration": 4,
                                "ExitNumber": [],
                                "GeometryOffset": 79,
                                "Type": "Continue"
                            },
                            {
                                "Distance": 520,
                                "Duration": 39,
                                "ExitNumber": [],
                                "GeometryOffset": 83,
                                "Type": "Continue"
                            },
                            {
                                "Distance": 1123,
                                "Duration": 111,
                                "ExitNumber": [],
                                "GeometryOffset": 101,
                                "TurnStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right",
                                    "TurnIntensity": "Typical"
                                },
                                "Type": "Turn"
                            },
                            {
                                "Distance": 1131,
                                "Duration": 81,
                                "ExitNumber": [],
                                "GeometryOffset": 141,
                                "TurnStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Left",
                                    "TurnIntensity": "Typical"
                                },
                                "Type": "Turn"
                            },
                            {
                                "Distance": 448,
                                "Duration": 34,
                                "ExitNumber": [],
                                "GeometryOffset": 167,
                                "Type": "Continue"
                            },
                            {
                                "Distance": 1797,
                                "Duration": 151,
                                "ExitNumber": [],
                                "GeometryOffset": 182,
                                "TurnStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right",
                                    "TurnIntensity": "Typical"
                                },
                                "Type": "Turn"
                            },
                            {
                                "Distance": 2836,
                                "Duration": 224,
                                "ExitNumber": [],
                                "GeometryOffset": 222,
                                "TurnStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Left",
                                    "TurnIntensity": "Typical"
                                },
                                "Type": "Turn"
                            },
                            {
                                "Distance": 339,
                                "Duration": 30,
                                "ExitNumber": [],
                                "GeometryOffset": 326,
                                "TurnStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right",
                                    "TurnIntensity": "Typical"
                                },
                                "Type": "Turn"
                            },
                            {
                                "Distance": 64,
                                "Duration": 23,
                                "ExitNumber": [],
                                "GeometryOffset": 335,
                                "TurnStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Left",
                                    "TurnIntensity": "Typical"
                                },
                                "Type": "Turn"
                            },
                            {
                                "Distance": 0,
                                "Duration": 0,
                                "ExitNumber": [],
                                "GeometryOffset": 337,
                                "Type": "Arrive"
                            }
                        ],
                        "TruckRoadTypes": [],
                        "Zones": []
                    }
                }
            ],
            "MajorRoadLabels": [
                {
                    "RouteNumber": {
                        "Language": "en",
                        "Value": "HWY-1A"
                    }
                },
                {
                    "RoadName": {
                        "Language": "en",
                        "Value": "Nanaimo St"
                    }
                }
            ]
        }
    ]
}
```

------
#### [ cURL ]

```
curl --request POST \
  --url 'https://routes.geo.eu-central-1.amazonaws.com/v2/routes?key=Your_key' \
  --header 'Content-Type: application/json' \
  --data '{
  "Origin": [
    -123.116655,
    49.281538
  ],
  "Destination": [
    -123.01791785749363,
    49.22782762759908
  ],
  "TravelMode": "Car",
  "Avoid": {
    "Areas": [
      {
        "Geometry": {
          "PolylinePolygon": [
            "BF0s0sJxglvXr5CvkCAgpEs5CvkC"
          ]
        }
      }
    ]
  }
}'
```

------
#### [ AWS CLI ]

```
aws geo-routes calculate-routes --key ${YourKey} \
--origin -123.13277 49.281538 \
--destination -123.01791785749363 49.22782762759908 \
--travel-mode "Car" \
--avoid '{"Areas":[{"Geometry":{"PolylinePolygon":["BF0s0sJxglvXr5CvkCAgpEs5CvkC"]}}]}'
```

------

### Da utilizzare CalculateRoutes con avoid Corridor per creare percorsi personalizzati.
<a name="calculate-routes-custom-avoidance-corridor"></a>

------
#### [ Sample request ]

```
{
    "Origin": [
        -123.116655,
        49.281538
    ],
    "Destination": [
        -123.01791785749363,
        49.22782762759908
    ],
    "TravelMode": "Car",
    "Avoid": {
        "Areas": [
            {
                "Geometry": {
                    "PolylineCorridor": {
                        "Polyline": "Redacted",
                        "Radius": 10
                    }
                }
            }
        ]
    }
}
```

------
#### [ Sample response ]

```
{
    "LegGeometryFormat": "FlexiblePolyline",
    "Notices": [],
    "Routes": [
        {
            "Legs": [
                {
                    "Geometry": {
                        "Polyline": "Redacted"
                    },
                    "TravelMode": "Car",
                    "Type": "Vehicle",
                    "VehicleLegDetails": {
                        "AfterTravelSteps": [],
                        "Arrival": {
                            "Place": {
                                "ChargingStation": false,
                                "OriginalPosition": [
                                    -123.0179179,
                                    49.2278276
                                ],
                                "Position": [
                                    -123.0229001,
                                    49.22883
                                ]
                            }
                        },
                        "Departure": {
                            "Place": {
                                "ChargingStation": false,
                                "OriginalPosition": [
                                    -123.116655,
                                    49.281538
                                ],
                                "Position": [
                                    -123.1166332,
                                    49.2815528
                                ]
                            }
                        },
                        "Incidents": [],
                        "Notices": [],
                        "PassThroughWaypoints": [],
                        "Spans": [],
                        "Tolls": [],
                        "TollSystems": [],
                        "TravelSteps": [
                            {
                                "Distance": 1144,
                                "Duration": 85,
                                "ExitNumber": [],
                                "GeometryOffset": 0,
                                "Type": "Depart"
                            },
                            {
                                "Distance": 262,
                                "Duration": 24,
                                "ExitNumber": [],
                                "GeometryOffset": 35,
                                "RampStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right"
                                },
                                "Type": "Ramp"
                            },
                            {
                                "Distance": 1356,
                                "Duration": 134,
                                "ExitNumber": [],
                                "GeometryOffset": 40,
                                "TurnStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right",
                                    "TurnIntensity": "Typical"
                                },
                                "Type": "Turn"
                            },
                            {
                                "Distance": 2468,
                                "Duration": 204,
                                "ExitNumber": [],
                                "GeometryOffset": 90,
                                "KeepStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Left"
                                },
                                "Type": "Keep"
                            },
                            {
                                "Distance": 1100,
                                "Duration": 88,
                                "ExitNumber": [],
                                "GeometryOffset": 170,
                                "TurnStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right",
                                    "TurnIntensity": "Typical"
                                },
                                "Type": "Turn"
                            },
                            {
                                "Distance": 1588,
                                "Duration": 133,
                                "ExitNumber": [],
                                "GeometryOffset": 214,
                                "TurnStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Left",
                                    "TurnIntensity": "Typical"
                                },
                                "Type": "Turn"
                            },
                            {
                                "Distance": 47,
                                "Duration": 14,
                                "ExitNumber": [],
                                "GeometryOffset": 260,
                                "Type": "Continue"
                            },
                            {
                                "Distance": 2478,
                                "Duration": 196,
                                "ExitNumber": [],
                                "GeometryOffset": 265,
                                "TurnStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right",
                                    "TurnIntensity": "Typical"
                                },
                                "Type": "Turn"
                            },
                            {
                                "Distance": 339,
                                "Duration": 30,
                                "ExitNumber": [],
                                "GeometryOffset": 357,
                                "TurnStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right",
                                    "TurnIntensity": "Typical"
                                },
                                "Type": "Turn"
                            },
                            {
                                "Distance": 64,
                                "Duration": 23,
                                "ExitNumber": [],
                                "GeometryOffset": 366,
                                "TurnStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Left",
                                    "TurnIntensity": "Typical"
                                },
                                "Type": "Turn"
                            },
                            {
                                "Distance": 0,
                                "Duration": 0,
                                "ExitNumber": [],
                                "GeometryOffset": 368,
                                "Type": "Arrive"
                            }
                        ],
                        "TruckRoadTypes": [],
                        "Zones": []
                    }
                }
            ],
            "MajorRoadLabels": [
                {
                    "RouteNumber": {
                        "Language": "en",
                        "Value": "HWY-1A"
                    }
                }
            ]
        }
    ]
}
```

------
#### [ cURL ]

```
curl --request POST \
  --url 'https://routes.geo.eu-central-1.amazonaws.com/v2/routes?key=Your_key' \
  --header 'Content-Type: application/json' \
  --data '{
  "Origin": [
    -123.116655,
    49.281538
  ],
  "Destination": [
    -123.01791785749363,
    49.22782762759908
  ],
  "TravelMode": "Car",
  "Avoid": {
    "Areas": [
      {
        "Geometry": {
          "PolylineCorridor": {
            "Polyline": "Redacted",
            "Radius": 10
          }
        }
      }
    ]
  }
}'
```

------
#### [ AWS CLI ]

```
aws geo-routes calculate-routes --key ${YourKey} \
--origin -123.116655 49.281538 \
--destination -123.01791785749363 49.22782762759908 \
--travel-mode "Car" \
--avoid '{"Areas": [{"Geometry": {"PolylineCorridor": {"Polyline": "BF2mysJnmkvX5ekiC", "Radius": 10}}}]}'
```

------

### Usalo CalculateRoutes con un avoid PolylineCorridor per creare percorsi personalizzati.
<a name="calculate-routes-custom-avoidance-polyline-corridor"></a>

------
#### [ Sample request ]

```
{
    "Origin": [
        -123.116655,
        49.281538
    ],
    "Destination": [
        -123.01791785749363,
        49.22782762759908
    ],
    "TravelMode": "Car",
    "Avoid": {
        "Areas": [
            {
                "Geometry": {
                    "Corridor": {
                        "LineString": [
                            [
                                -123.06532243038754,
                                49.245226301868776
                            ],
                            [
                                -123.0547357660333,
                                49.24030469850804
                            ]
                        ],
                        "Radius": 10
                    }
                }
            }
        ]
    }
}
```

------
#### [ Sample response ]

```
{
    "LegGeometryFormat": "FlexiblePolyline",
    "Notices": [],
    "Routes": [
        {
            "Legs": [
                {
                    "Geometry": {
                        "Polyline": "Redacted"
                    },
                    "TravelMode": "Car",
                    "Type": "Vehicle",
                    "VehicleLegDetails": {
                        "AfterTravelSteps": [],
                        "Arrival": {
                            "Place": {
                                "ChargingStation": false,
                                "OriginalPosition": [
                                    -123.0179179,
                                    49.2278276
                                ],
                                "Position": [
                                    -123.0229001,
                                    49.22883
                                ]
                            }
                        },
                        "Departure": {
                            "Place": {
                                "ChargingStation": false,
                                "OriginalPosition": [
                                    -123.116655,
                                    49.281538
                                ],
                                "Position": [
                                    -123.1166332,
                                    49.2815528
                                ]
                            }
                        },
                        "Incidents": [],
                        "Notices": [],
                        "PassThroughWaypoints": [],
                        "Spans": [],
                        "Tolls": [],
                        "TollSystems": [],
                        "TravelSteps": [
                            {
                                "Distance": 1144,
                                "Duration": 85,
                                "ExitNumber": [],
                                "GeometryOffset": 0,
                                "Type": "Depart"
                            },
                            {
                                "Distance": 262,
                                "Duration": 24,
                                "ExitNumber": [],
                                "GeometryOffset": 35,
                                "RampStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right"
                                },
                                "Type": "Ramp"
                            },
                            {
                                "Distance": 1356,
                                "Duration": 134,
                                "ExitNumber": [],
                                "GeometryOffset": 40,
                                "TurnStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right",
                                    "TurnIntensity": "Typical"
                                },
                                "Type": "Turn"
                            },
                            {
                                "Distance": 2468,
                                "Duration": 204,
                                "ExitNumber": [],
                                "GeometryOffset": 90,
                                "KeepStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Left"
                                },
                                "Type": "Keep"
                            },
                            {
                                "Distance": 1100,
                                "Duration": 88,
                                "ExitNumber": [],
                                "GeometryOffset": 170,
                                "TurnStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right",
                                    "TurnIntensity": "Typical"
                                },
                                "Type": "Turn"
                            },
                            {
                                "Distance": 1588,
                                "Duration": 133,
                                "ExitNumber": [],
                                "GeometryOffset": 214,
                                "TurnStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Left",
                                    "TurnIntensity": "Typical"
                                },
                                "Type": "Turn"
                            },
                            {
                                "Distance": 47,
                                "Duration": 14,
                                "ExitNumber": [],
                                "GeometryOffset": 260,
                                "Type": "Continue"
                            },
                            {
                                "Distance": 2478,
                                "Duration": 196,
                                "ExitNumber": [],
                                "GeometryOffset": 265,
                                "TurnStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right",
                                    "TurnIntensity": "Typical"
                                },
                                "Type": "Turn"
                            },
                            {
                                "Distance": 339,
                                "Duration": 30,
                                "ExitNumber": [],
                                "GeometryOffset": 357,
                                "TurnStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right",
                                    "TurnIntensity": "Typical"
                                },
                                "Type": "Turn"
                            },
                            {
                                "Distance": 64,
                                "Duration": 23,
                                "ExitNumber": [],
                                "GeometryOffset": 366,
                                "TurnStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Left",
                                    "TurnIntensity": "Typical"
                                },
                                "Type": "Turn"
                            },
                            {
                                "Distance": 0,
                                "Duration": 0,
                                "ExitNumber": [],
                                "GeometryOffset": 368,
                                "Type": "Arrive"
                            }
                        ],
                        "TruckRoadTypes": [],
                        "Zones": []
                    }
                }
            ],
            "MajorRoadLabels": [
                {
                    "RouteNumber": {
                        "Language": "en",
                        "Value": "HWY-1A"
                    }
                }
            ]
        }
    ]
}
```

------
#### [ cURL ]

```
curl --request POST \
  --url 'https://routes.geo.eu-central-1.amazonaws.com/v2/routes?key=Your_key' \
  --header 'Content-Type: application/json' \
  --data '{
  "Origin": [
    -123.116655,
    49.281538
  ],
  "Destination": [
    -123.01791785749363,
    49.22782762759908
  ],
  "TravelMode": "Car",
  "Avoid": {
    "Areas": [
      {
        "Geometry": {
          "Corridor": {
            "LineString": [
              [
                -123.06532243038754,
                49.245226301868776
              ],
              [
                -123.0547357660333,
                49.24030469850804
              ]
            ],
            "Radius": 10
          }
        }
      }
    ]
  }
}'
```

------
#### [ AWS CLI ]

```
aws geo-routes calculate-routes --key ${YourKey} \
--origin -123.13277 49.281538 \
--destination -123.01791785749363 49.22782762759908 \
--travel-mode "Car" \
--avoid '{"Areas":[{"Geometry":{"Corridor":{"LineString":[[-123.06532243038754,49.245226301868776],[-123.0547357660333,49.24030469850804]],"Radius":10}}}]}'
```

------

# Come creare percorsi evitando in modo personalizzato diversi oggetti potenziali
<a name="calculate-routes-custom-avoidance-multiple"></a>

L' CalculateRoutes API ti aiuta a trovare i percorsi migliori tra origine e destinazione, nonché le migliori opportunità per riposare il conducente. Supporta modalità di viaggio come auto, camion, pedone e scooter. Supporta anche fino a 25 waypoint (scali) tra cui l'origine e la destinazione, con solo pochi vincoli.

## Casi d'uso potenziali
<a name="potential-use-cases"></a>
+ **Calcola i percorsi evitando percorsi personalizzati:** personalizza i percorsi evitandoli per migliorare i percorsi e la pianificazione degli spostamenti.

## Esempi
<a name="calculate-routes-examples"></a>

### Utilizzalo CalculateRoutes evitando pedaggi, inversioni a U, traghetti, autostrade, tunnel e altro ancora.
<a name="calculate-routes-custom-avoidance-tolls-ferries"></a>

------
#### [ Sample request ]

```
{
    "Origin": [
        -123.118105,
        49.282423
    ],
    "Destination": [
        -123.020098,
        49.232872
    ],
    "TravelMode": "Car",
    "Avoid": {
        "TollRoads": true,
        "UTurns": true,
        "Ferries": true,
        "ControlledAccessHighways": true,
        "Tunnels": true
    }
}
```

------
#### [ Sample response ]

```
{
    "LegGeometryFormat": "FlexiblePolyline",
    "Notices": [],
    "Routes": [
        {
            "Legs": [
                {
                    "Geometry": {
                        "Polyline": "Redacted"
                    },
                    "TravelMode": "Car",
                    "Type": "Vehicle",
                    "VehicleLegDetails": {
                        "AfterTravelSteps": [],
                        "Arrival": {
                            "Place": {
                                "ChargingStation": false,
                                "OriginalPosition": [
                                    -123.020098,
                                    49.232872
                                ],
                                "Position": [
                                    -123.0203051,
                                    49.2328499
                                ]
                            }
                        },
                        "Departure": {
                            "Place": {
                                "ChargingStation": false,
                                "OriginalPosition": [
                                    -123.1181051,
                                    49.282423
                                ],
                                "Position": [
                                    -123.1180883,
                                    49.2824349
                                ]
                            }
                        },
                        "Incidents": [],
                        "Notices": [],
                        "PassThroughWaypoints": [],
                        "Spans": [],
                        "Tolls": [],
                        "TollSystems": [],
                        "TravelSteps": [
                            {
                                "Distance": 1288,
                                "Duration": 102,
                                "ExitNumber": [],
                                "GeometryOffset": 0,
                                "Type": "Depart"
                            },
                            {
                                "Distance": 262,
                                "Duration": 24,
                                "ExitNumber": [],
                                "GeometryOffset": 37,
                                "RampStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right"
                                },
                                "Type": "Ramp"
                            },
                            {
                                "Distance": 1356,
                                "Duration": 134,
                                "ExitNumber": [],
                                "GeometryOffset": 42,
                                "TurnStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right",
                                    "TurnIntensity": "Typical"
                                },
                                "Type": "Turn"
                            },
                            {
                                "Distance": 7092,
                                "Duration": 568,
                                "ExitNumber": [],
                                "GeometryOffset": 92,
                                "KeepStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Left"
                                },
                                "Type": "Keep"
                            },
                            {
                                "Distance": 65,
                                "Duration": 26,
                                "ExitNumber": [],
                                "GeometryOffset": 337,
                                "TurnStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Left",
                                    "TurnIntensity": "Typical"
                                },
                                "Type": "Turn"
                            },
                            {
                                "Distance": 50,
                                "Duration": 18,
                                "ExitNumber": [],
                                "GeometryOffset": 339,
                                "TurnStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right",
                                    "TurnIntensity": "Typical"
                                },
                                "Type": "Turn"
                            },
                            {
                                "Distance": 0,
                                "Duration": 0,
                                "ExitNumber": [],
                                "GeometryOffset": 343,
                                "Type": "Arrive"
                            }
                        ],
                        "TruckRoadTypes": [],
                        "Zones": []
                    }
                }
            ],
            "MajorRoadLabels": [
                {
                    "RouteNumber": {
                        "Language": "en",
                        "Value": "HWY-1A"
                    }
                }
            ]
        }
    ]
}
```

------
#### [ cURL ]

```
curl --request POST \
  --url 'https://routes.geo.eu-central-1.amazonaws.com/v2/routes?key=Your_key' \
  --header 'Content-Type: application/json' \
  --data '{
  "Origin": [
    -123.118105,
    49.282423
  ],
  "Destination": [
    -123.020098,
    49.232872
  ],
  "TravelMode": "Car",
  "Avoid": {
    "TollRoads": true,
    "UTurns": true,
    "Ferries": true,
    "ControlledAccessHighways": true,
    "Tunnels": true
  }
}'
```

------
#### [ AWS CLI ]

```
aws geo-routes calculate-routes --key ${YourKey} \
--origin -123.118105 49.282423 \
--destination -123.020098 49.232872 \
--travel-mode "Car" \
--avoid '{"TollRoads": true, "UTurns": true, "Ferries": true, "ControlledAccessHighways": true, "Tunnels": true}'
```

------

# Come trovare il percorso più veloce
<a name="calculate-routes-custom-avoidance-fast"></a>

L' CalculateRoutes API ti aiuta a trovare i percorsi più veloci tra origine e destinazione.

## Casi d'uso potenziali
<a name="calculate-routes-fast-potential-use"></a>
+ **Ottimizza i percorsi per un'efficienza temporale:** migliora le operazioni di consegna calcolando il percorso più veloce. Ciò è utile per ridurre i tempi di viaggio nei servizi di logistica e consegna.

## Esempi
<a name="calculate-routes-fast-examples"></a>

### Calcola il percorso più veloce
<a name="calculate-routes-fast-car"></a>

------
#### [ Sample request ]

```
{
    "Origin": [
        -123.118105,
        49.282423
    ],
    "Destination": [
        -123.020098,
        49.232872
    ],
    "TravelMode": "Car",
    "OptimizeRoutingFor": "FastestRoute"
}
```

------
#### [ Sample response ]

```
{
    "LegGeometryFormat": "FlexiblePolyline",
    "Notices": [],
    "Routes": [
        {
            "Legs": [
                {
                    "Geometry": {
                        "Polyline": "Redacted"
                    },
                    "TravelMode": "Car",
                    "Type": "Vehicle",
                    "VehicleLegDetails": {
                        "AfterTravelSteps": [],
                        "Arrival": {
                            "Place": {
                                "ChargingStation": false,
                                "OriginalPosition": [
                                    -123.020098,
                                    49.232872
                                ],
                                "Position": [
                                    -123.0203051,
                                    49.2328499
                                ]
                            }
                        },
                        "Departure": {
                            "Place": {
                                "ChargingStation": false,
                                "OriginalPosition": [
                                    -123.1181051,
                                    49.282423
                                ],
                                "Position": [
                                    -123.1180883,
                                    49.2824349
                                ]
                            }
                        },
                        "Incidents": [],
                        "Notices": [],
                        "PassThroughWaypoints": [],
                        "Spans": [],
                        "Tolls": [],
                        "TollSystems": [],
                        "TravelSteps": [
                            {
                                "Distance": 1288,
                                "Duration": 102,
                                "ExitNumber": [],
                                "GeometryOffset": 0,
                                "Type": "Depart"
                            },
                            {
                                "Distance": 262,
                                "Duration": 24,
                                "ExitNumber": [],
                                "GeometryOffset": 37,
                                "RampStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right"
                                },
                                "Type": "Ramp"
                            },
                            {
                                "Distance": 1356,
                                "Duration": 134,
                                "ExitNumber": [],
                                "GeometryOffset": 42,
                                "TurnStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right",
                                    "TurnIntensity": "Typical"
                                },
                                "Type": "Turn"
                            },
                            {
                                "Distance": 7092,
                                "Duration": 568,
                                "ExitNumber": [],
                                "GeometryOffset": 92,
                                "KeepStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Left"
                                },
                                "Type": "Keep"
                            },
                            {
                                "Distance": 65,
                                "Duration": 26,
                                "ExitNumber": [],
                                "GeometryOffset": 337,
                                "TurnStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Left",
                                    "TurnIntensity": "Typical"
                                },
                                "Type": "Turn"
                            },
                            {
                                "Distance": 50,
                                "Duration": 18,
                                "ExitNumber": [],
                                "GeometryOffset": 339,
                                "TurnStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right",
                                    "TurnIntensity": "Typical"
                                },
                                "Type": "Turn"
                            },
                            {
                                "Distance": 0,
                                "Duration": 0,
                                "ExitNumber": [],
                                "GeometryOffset": 343,
                                "Type": "Arrive"
                            }
                        ],
                        "TruckRoadTypes": [],
                        "Zones": []
                    }
                }
            ],
            "MajorRoadLabels": [
                {
                    "RouteNumber": {
                        "Language": "en",
                        "Value": "HWY-1A"
                    }
                }
            ]
        }
    ]
}
```

------
#### [ cURL ]

```
curl --request POST \
  --url 'https://routes.geo.eu-central-1.amazonaws.com/v2/routes?key=Your_key' \
  --header 'Content-Type: application/json' \
  --data '{
  "Origin": [
    -123.118105,
    49.282423
  ],
  "Destination": [
    -123.020098,
    49.232872
  ],
  "TravelMode": "Car",
  "OptimizeRoutingFor": "FastestRoute"
}'
```

------
#### [ AWS CLI ]

```
aws geo-routes calculate-routes --key ${YourKey} \
--origin -123.118105 49.282423 \
--destination -123.020098 49.232872 \
--travel-mode "Car" \
--optimize-routing-for "FastestRoute"
```

------

# Come trovare i percorsi più brevi
<a name="calculate-routes-custom-avoidance-shortest"></a>

L' CalculateRoutes API ti aiuta a trovare i percorsi più brevi tra origine e destinazione.

## Casi d'uso potenziali
<a name="calculate-routes-short-potential-use"></a>
+ **Ottimizza i percorsi per un'efficienza temporale:** migliora le operazioni di consegna calcolando il percorso più breve. Ciò è utile per ridurre la distanza di viaggio nei servizi di logistica e consegna.

## Esempi
<a name="calculate-routes-short-examples"></a>

### Utilizzalo CalculateRoutes per trovare il percorso più breve e risparmiare sulla distanza da percorrere.
<a name="calculate-routes-shortest"></a>

------
#### [ Sample request ]

```
{
    "Origin": [
        -123.118105,
        49.282423
    ],
    "Destination": [
        -123.020098,
        49.232872
    ],
    "TravelMode": "Car",
    "OptimizeRoutingFor": "ShortestRoute"
}
```

------
#### [ Sample response ]

```
{
    "LegGeometryFormat": "FlexiblePolyline",
    "Notices": [],
    "Routes": [
        {
            "Legs": [
                {
                    "Geometry": {
                        "Polyline": "Redacted"
                    },
                    "TravelMode": "Car",
                    "Type": "Vehicle",
                    "VehicleLegDetails": {
                        "AfterTravelSteps": [],
                        "Arrival": {
                            "Place": {
                                "ChargingStation": false,
                                "OriginalPosition": [
                                    -123.020098,
                                    49.232872
                                ],
                                "Position": [
                                    -123.0203051,
                                    49.2328499
                                ]
                            }
                        },
                        "Departure": {
                            "Place": {
                                "ChargingStation": false,
                                "OriginalPosition": [
                                    -123.1181051,
                                    49.282423
                                ],
                                "Position": [
                                    -123.1180883,
                                    49.2824349
                                ]
                            }
                        },
                        "Incidents": [],
                        "Notices": [],
                        "PassThroughWaypoints": [],
                        "Spans": [],
                        "Tolls": [],
                        "TollSystems": [],
                        "TravelSteps": [
                            {
                                "Distance": 1288,
                                "Duration": 102,
                                "ExitNumber": [],
                                "GeometryOffset": 0,
                                "Type": "Depart"
                            },
                            {
                                "Distance": 262,
                                "Duration": 24,
                                "ExitNumber": [],
                                "GeometryOffset": 37,
                                "RampStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right"
                                },
                                "Type": "Ramp"
                            },
                            {
                                "Distance": 1356,
                                "Duration": 134,
                                "ExitNumber": [],
                                "GeometryOffset": 42,
                                "TurnStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right",
                                    "TurnIntensity": "Typical"
                                },
                                "Type": "Turn"
                            },
                            {
                                "Distance": 7092,
                                "Duration": 568,
                                "ExitNumber": [],
                                "GeometryOffset": 92,
                                "KeepStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Left"
                                },
                                "Type": "Keep"
                            },
                            {
                                "Distance": 65,
                                "Duration": 26,
                                "ExitNumber": [],
                                "GeometryOffset": 337,
                                "TurnStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Left",
                                    "TurnIntensity": "Typical"
                                },
                                "Type": "Turn"
                            },
                            {
                                "Distance": 50,
                                "Duration": 18,
                                "ExitNumber": [],
                                "GeometryOffset": 339,
                                "TurnStepDetails": {
                                    "Intersection": [],
                                    "SteeringDirection": "Right",
                                    "TurnIntensity": "Typical"
                                },
                                "Type": "Turn"
                            },
                            {
                                "Distance": 0,
                                "Duration": 0,
                                "ExitNumber": [],
                                "GeometryOffset": 343,
                                "Type": "Arrive"
                            }
                        ],
                        "TruckRoadTypes": [],
                        "Zones": []
                    }
                }
            ],
            "MajorRoadLabels": [
                {
                    "RouteNumber": {
                        "Language": "en",
                        "Value": "HWY-1A"
                    }
                }
            ]
        }
    ]
}
```

------
#### [ cURL ]

```
curl --request POST \
  --url 'https://routes.geo.eu-central-1.amazonaws.com/v2/routes?key=Your_key' \
  --header 'Content-Type: application/json' \
  --data '{
    "Origin": [
        -123.118105,
        49.282423
    ],
    "Destination": [
        -123.020098,
        49.232872
    ],
    "TravelMode": "Car",
    "OptimizeRoutingFor": "ShortestRoute"
}'
```

------
#### [ AWS CLI ]

```
aws geo-routes calculate-routes --key ${YourKey} \
--origin -123.118105 49.282423 \
--destination -123.020098 49.232872 \
--travel-mode "Scooter" \
--optimize-routing-for "ShortestRoute"
```

------

# Scopri come usare CalculateIsolines
<a name="calculate-isolines-how-to"></a>

In questa sezione imparerai a utilizzare `CalculateIsolines` con intervalli di tempo o distanza, nonché a impostare le aree da evitare.

**Topics**
+ [Come calcolare un'area di servizio in base a intervalli di tempo](calculate-service-area-based-on-time.md)
+ [Come calcolare un'area di servizio in base agli intervalli di distanza](calculate-service-area-based-on-distance.md)
+ [Come calcolare un'area di servizio in base all'evitamento](calculate-service-area-based-on-avoidance.md)

# Come calcolare un'area di servizio in base a intervalli di tempo
<a name="calculate-service-area-based-on-time"></a>

L' CalculateIsolines API consente di determinare le aree di servizio raggiungibili entro intervalli di tempo o distanza specifici, tenendo conto delle reti stradali e delle condizioni del traffico. Questa funzionalità supporta le applicazioni per la definizione delle aree di servizio per ristoranti, negozi di alimentari o altri fornitori di servizi che possono aiutare a pianificare l'efficienza del carburante e definire aree accessibili per la copertura del servizio.

## Casi d'uso potenziali
<a name="calculate-service-area-time-potential-use"></a>
+ **Pianifica le aree di servizio:** utilizza questa API per pianificare aree accessibili per servizi come ristoranti o consegne di generi alimentari in base al tempo o alla distanza di viaggio.

## Esempi
<a name="calculate-service-area-time-examples"></a>

### Calcola un'area di servizio in base a un intervallo di tempo con Car TravelMode
<a name="calculate-service-area-time"></a>

------
#### [ Sample request ]

```
{
    "Origin": [
        -123.11679620827039,
        49.28147612192166
    ],
    "DepartureTime": "2024-10-28T21:27:56Z",
    "Thresholds": {
        "Time": [
            500,
            1000,
            1500
        ]
    },
    "TravelMode": "Car"
}
```

------
#### [ Sample response ]

```
{
    "DepartureTime": "2024-10-28T14:27:56-07:00",
    "IsolineGeometryFormat": "FlexiblePolyline",
    "Isolines": [
        {
            "Connections": [],
            "Geometries": [
                {
                    "PolylinePolygon": [
                        "Redacted"
                    ]
                }
            ],
            "TimeThreshold": 500
        },
        {
            "Connections": [],
            "Geometries": [
                {
                    "PolylinePolygon": [
                        "Redacted"
                    ]
                }
            ],
            "TimeThreshold": 1000
        },
        {
            "Connections": [],
            "Geometries": [
                {
                    "PolylinePolygon": [
                        "Redacted"
                    ]
                }
            ],
            "TimeThreshold": 1500
        }
    ],
    "SnappedOrigin": [
        -123.11687,
        49.2813999
    ]
}
```

------
#### [ cURL ]

```
curl --request POST \
  --url 'https://routes.geo.eu-central-1.amazonaws.com/v2/isolines?key=Your_key' \
  --header 'Content-Type: application/json' \
  --data '{
    "Origin": [
        -123.11679620827039,
        49.28147612192166
    ],
    "DepartureTime": "2024-10-28T21:27:56Z",
    "Thresholds": {
        "Time": [
            500,
            1000,
            1500
        ]
    },
    "TravelMode": "Car"
}'
```

------
#### [ AWS CLI ]

```
aws geo-routes calculate-isolines --key ${YourKey} \
--origin -123.11679620827039 49.28147612192166 \
--departure-time "2024-10-28T21:27:56Z" \
--thresholds '{"Time": [500, 1000, 1500]}' \
--travel-mode "Car"
```

------

# Come calcolare un'area di servizio in base agli intervalli di distanza
<a name="calculate-service-area-based-on-distance"></a>

L' CalculateIsolines API consente di determinare le aree di servizio raggiungibili entro intervalli di tempo o distanza specifici, tenendo conto delle reti stradali e delle condizioni del traffico. Questa funzionalità supporta le applicazioni per la definizione delle aree di servizio per ristoranti, negozi di alimentari o altri fornitori di servizi che possono aiutare a pianificare l'efficienza del carburante e definire aree accessibili per la copertura del servizio.

## Casi d'uso potenziali
<a name="calculate-service-area-distance-potential-use"></a>
+ **Pianifica le aree di servizio:** utilizza questa API per pianificare aree accessibili per servizi come ristoranti o consegne di generi alimentari in base al tempo o alla distanza di viaggio.

## Esempi
<a name="calculate-service-area-distance-examples"></a>

### Calcola un'area di servizio in base agli intervalli di distanza con Car TravelMode
<a name="calculate-service-area-distance"></a>

------
#### [ Sample request ]

```
{
    "Origin": [
        -123.11679620827039,
        49.28147612192166
    ],
    "DepartureTime": "2024-10-28T21:27:56Z",
    "Thresholds": {
        "Distance": [
            1000,
            2000,
            3000
        ]
    },
    "TravelMode": "Car"
}
```

------
#### [ Sample response ]

```
{
    "DepartureTime": "2024-10-28T14:27:56-07:00",
    "IsolineGeometryFormat": "FlexiblePolyline",
    "Isolines": [
        {
            "Connections": [],
            "DistanceThreshold": 1000,
            "Geometries": [
                {
                    "PolylinePolygon": [
                        "Redacted"
                    ]
                }
            ]
        },
        {
            "Connections": [],
            "DistanceThreshold": 2000,
            "Geometries": [
                {
                    "PolylinePolygon": [
                        "Redacted"
                    ]
                }
            ]
        },
        {
            "Connections": [],
            "DistanceThreshold": 3000,
            "Geometries": [
                {
                    "PolylinePolygon": [
                        "Redacted"
                    ]
                }
            ]
        }
    ],
    "SnappedOrigin": [
        -123.11687,
        49.2813999
    ]
}
```

------
#### [ cURL ]

```
curl --request POST \
  --url 'https://routes.geo.eu-central-1.amazonaws.com/v2/isolines?key=Your_key' \
  --header 'Content-Type: application/json' \
  --data '{
    "Origin": [
        -123.11679620827039,
        49.28147612192166
    ],
    "DepartureTime": "2024-10-28T21:27:56Z",
    "Thresholds": {
        "Distance": [
            1000,
            2000,
            3000
        ]
    },
    "TravelMode": "Car"
}'
```

------
#### [ AWS CLI ]

```
aws geo-routes calculate-isolines --key ${YourKey} \
--origin -123.11679620827039 49.28147612192166 \
--departure-time "2024-10-28T21:27:56Z" \
--thresholds '{"Distance": [1000, 2000, 3000]}' \
--travel-mode "Car"
```

------

# Come calcolare un'area di servizio in base all'evitamento
<a name="calculate-service-area-based-on-avoidance"></a>

L' CalculateIsolines API consente di determinare le aree di servizio raggiungibili entro intervalli di tempo o distanza specifici, tenendo conto delle reti stradali e delle condizioni del traffico da evitare. Questa funzionalità supporta le applicazioni per la definizione delle aree di servizio per ristoranti, negozi di alimentari o altri fornitori di servizi che possono aiutare a pianificare l'efficienza del carburante e definire aree accessibili per la copertura del servizio.

## Casi d'uso potenziali
<a name="calculate-service-area-avoidance-potential-use"></a>
+ **Pianifica le aree di servizio:** utilizza questa API per pianificare aree accessibili per servizi come ristoranti o consegne di generi alimentari in base all'evitamento.

## Esempi
<a name="calculate-service-area-avoidance-examples"></a>

### Calcola un'area di servizio in base all'evitamento con Car TravelMode
<a name="calculate-service-area-avoidance-car"></a>

------
#### [ Sample request ]

```
{
    "Origin": [
        -123.11679620827039,
        49.28147612192166
    ],
    "DepartureTime": "2024-10-28T21:27:56Z",
    "Thresholds": {
        "Distance": [
            4000
        ]
    },
    "Avoid": {
        "TollRoads": true,
        "UTurns": true,
        "ControlledAccessHighways": true,
        "Ferries": true,
        "DirtRoads": true,
        "SeasonalClosure": true,
        "CarShuttleTrains": true,
        "TollTransponders": true,
        "ZoneCategories": [
            {
                "Category": "Environmental"
            }
        ]
    },
    "TravelMode": "Car"
}
```

------
#### [ Sample response ]

```
{
    "DepartureTime": "2024-10-28T14:27:56-07:00",
    "IsolineGeometryFormat": "FlexiblePolyline",
    "Isolines": [
        {
            "Connections": [],
            "DistanceThreshold": 4000,
            "Geometries": [
                {
                    "PolylinePolygon": [
                        "Redacted"
                    ]
                }
            ]
        }
    ],
    "SnappedOrigin": [
        -123.11687,
        49.2813999
    ]
}
```

------
#### [ cURL ]

```
curl --request POST \
  --url 'https://routes.geo.eu-central-1.amazonaws.com/v2/isolines?key=Your_key' \
  --header 'Content-Type: application/json' \
  --data '{
    "Origin": [
        -123.11679620827039,
        49.28147612192166
    ],
    "DepartureTime": "2024-10-28T21:27:56Z",
    "Thresholds": {
        "Distance": [
            4000
        ]
    },
    "Avoid": {
        "TollRoads": true,
        "UTurns": true,
        "ControlledAccessHighways": true,
        "Ferries": true,
        "DirtRoads": true,
        "SeasonalClosure": true,
        "CarShuttleTrains": true,
        "TollTransponders": true,
        "ZoneCategories": [
            {
                "Category": "Environmental"
            }
        ]
    },
    "TravelMode": "Car"
}'
```

------
#### [ AWS CLI ]

```
aws geo-routes calculate-isolines --key ${YourKey} \
--origin -123.11679620827039 49.28147612192166 \
--departure-time "2024-10-28T21:27:56Z" \
--thresholds '{"Distance": [4000]}' \
--avoid '{"TollRoads": true, "UTurns": true, "ControlledAccessHighways": true, "Ferries": true, "DirtRoads": true, "SeasonalClosure": true, "CarShuttleTrains": true, "TollTransponders": true, "ZoneCategories": [{"Category": "Environmental"}]}' \
--travel-mode "Car"
```

------

### Calcola un'area di servizio in base all'evitamento con Truck TravelMode
<a name="calculate-service-area-avoidance-truck"></a>

------
#### [ Sample request ]

```
{
    "Origin": [
        -123.11679620827039,
        49.28147612192166
    ],
    "DepartureTime": "2024-10-28T21:27:56Z",
    "Thresholds": {
        "Distance": [
            4000
        ]
    },
    "Avoid": {
        "TollRoads": true,
        "UTurns": true,
        "ControlledAccessHighways": true,
        "Ferries": true,
        "DirtRoads": true,
        "SeasonalClosure": true,
        "CarShuttleTrains": true,
        "TollTransponders": true,
        "ZoneCategories": [
            {
                "Category": "Environmental"
            }
        ]
    },
    "TravelMode": "Truck"
}
```

------
#### [ Sample response ]

```
{
    "DepartureTime": "2024-10-28T14:27:56-07:00",
    "IsolineGeometryFormat": "FlexiblePolyline",
    "Isolines": [
        {
            "Connections": [],
            "DistanceThreshold": 4000,
            "Geometries": [
                {
                    "PolylinePolygon": [
                        "Redacted"
                    ]
                }
            ]
        }
    ],
    "SnappedOrigin": [
        -123.11687,
        49.2813999
    ]
}
```

------
#### [ cURL ]

```
curl --request POST \
  --url 'https://routes.geo.eu-central-1.amazonaws.com/v2/isolines?key=Your_key' \
  --header 'Content-Type: application/json' \
  --data '{
    "Origin": [
        -123.11679620827039,
        49.28147612192166
    ],
    "DepartureTime": "2024-10-28T21:27:56Z",
    "Thresholds": {
        "Distance": [
            4000
        ]
    },
    "Avoid": {
        "TollRoads": true,
        "UTurns": true,
        "ControlledAccessHighways": true,
        "Ferries": true,
        "DirtRoads": true,
        "SeasonalClosure": true,
        "CarShuttleTrains": true,
        "TollTransponders": true,
        "ZoneCategories": [
            {
                "Category": "Environmental"
            }
        ]
    },
    "TravelMode": "Truck"
}'
```

------
#### [ AWS CLI ]

```
aws geo-routes calculate-isolines --key ${YourKey} \
--origin -123.11679620827039 49.28147612192166 \
--departure-time "2024-10-28T21:27:56Z" \
--thresholds '{"Distance": [4000]}' \
--avoid '{"TollRoads": true, "UTurns": true, "ControlledAccessHighways": true, "Ferries": true, "DirtRoads": true, "SeasonalClosure": true, "CarShuttleTrains": true, "TollTransponders": true, "ZoneCategories": [{"Category": "Environmental"}]}' \
--travel-mode "Truck"
```

------

### Calcola un'area di servizio in base all'evitamento dei pedoni
<a name="calculate-service-area-avoidance-truck"></a>

------
#### [ Sample request ]

```
{
    "Origin": [
        -123.11679620827039,
        49.28147612192166
    ],
    "DepartureTime": "2024-10-28T21:27:56Z",
    "Thresholds": {
        "Distance": [
            4000
        ]
    },
    "Avoid": {
        "TollRoads": true,
        "ControlledAccessHighways": true,
        "Ferries": true,
        "DirtRoads": true,
        "SeasonalClosure": true,
        "CarShuttleTrains": true,
        "TollTransponders": true,
        "ZoneCategories": [
            {
                "Category": "Environmental"
            }
        ]
    },
    "TravelMode": "Pedestrian"
}
```

------
#### [ Sample response ]

```
{
    "DepartureTime": "2024-10-28T14:27:56-07:00",
    "IsolineGeometryFormat": "FlexiblePolyline",
    "Isolines": [
        {
            "Connections": [],
            "DistanceThreshold": 4000,
            "Geometries": [
                {
                    "PolylinePolygon": [
                        "Redacted"
                    ]
                }
            ]
        }
    ],
    "SnappedOrigin": [
        -123.11687,
        49.2813999
    ]
}
```

------
#### [ cURL ]

```
curl --request POST \
  --url 'https://routes.geo.eu-central-1.amazonaws.com/v2/isolines?key=Your_key' \
  --header 'Content-Type: application/json' \
  --data '{
    "Origin": [
        -123.11679620827039,
        49.28147612192166
    ],
    "DepartureTime": "2024-10-28T21:27:56Z",
    "Thresholds": {
        "Distance": [
            4000
        ]
    },
    "Avoid": {
        "TollRoads": true,
        "ControlledAccessHighways": true,
        "Ferries": true,
        "DirtRoads": true,
        "SeasonalClosure": true,
        "CarShuttleTrains": true,
        "TollTransponders": true,
        "ZoneCategories": [
            {
                "Category": "Environmental"
            }
        ]
    },
    "TravelMode": "Pedestrian"
}'
```

------
#### [ AWS CLI ]

```
aws geo-routes calculate-isolines --key ${YourKey} \
--origin -123.11679620827039 49.28147612192166 \
--departure-time "2024-10-28T21:27:56Z" \
--thresholds '{"Distance": [4000]}' \
--avoid '{"TollRoads": true, "ControlledAccessHighways": true, "Ferries": true, "DirtRoads": true, "SeasonalClosure": true, "CarShuttleTrains": true, "TollTransponders": true, "ZoneCategories": [{"Category": "Environmental"}]}' \
--travel-mode "Pedestrian"
```

------

### Calcola un'area di servizio in base all'evitamento con Scooter TravelMode
<a name="calculate-service-area-avoidance-scooter"></a>

------
#### [ Sample request ]

```
{
    "Origin": [
        -123.11679620827039,
        49.28147612192166
    ],
    "DepartureTime": "2024-10-28T21:27:56Z",
    "Thresholds": {
        "Distance": [
            4000
        ]
    },
    "Avoid": {
        "TollRoads": true,
        "ControlledAccessHighways": true,
        "DifficultTurns": false,
        "Ferries": true,
        "DirtRoads": true,
        "SeasonalClosure": true,
        "CarShuttleTrains": true,
        "TollTransponders": true,
        "ZoneCategories": [
            {
                "Category": "Environmental"
            }
        ]
    },
    "TravelMode": "Scooter"
}
```

------
#### [ Sample response ]

```
{
    "DepartureTime": "2024-10-28T14:27:56-07:00",
    "IsolineGeometryFormat": "FlexiblePolyline",
    "Isolines": [
        {
            "Connections": [],
            "DistanceThreshold": 4000,
            "Geometries": [
                {
                    "PolylinePolygon": [
                        "Redacted"
                    ]
                }
            ]
        }
    ],
    "SnappedOrigin": [
        -123.11687,
        49.2813999
    ]
}
```

------
#### [ cURL ]

```
curl --request POST \
  --url 'https://routes.geo.eu-central-1.amazonaws.com/v2/isolines?key=Your_key' \
  --header 'Content-Type: application/json' \
  --data '{
    "Origin": [
        -123.11679620827039,
        49.28147612192166
    ],
    "DepartureTime": "2024-10-28T21:27:56Z",
    "Thresholds": {
        "Distance": [
            4000
        ]
    },
    "Avoid": {
        "TollRoads": true,
        "ControlledAccessHighways": true,
        "Ferries": true,
        "DirtRoads": true,
        "SeasonalClosure": true,
        "CarShuttleTrains": true,
        "TollTransponders": true,
        "ZoneCategories": [
            {
                "Category": "Environmental"
            }
        ]
    },
    "TravelMode": "Scooter"
}'
```

------
#### [ AWS CLI ]

```
aws geo-routes calculate-isolines --key ${YourKey} \
--origin -123.11679620827039 49.28147612192166 \
--departure-time "2024-10-28T21:27:56Z" \
--thresholds '{"Distance": [4000]}' \
--avoid '{"TollRoads": true, "ControlledAccessHighways": true, "Ferries": true, "DirtRoads": true, "SeasonalClosure": true, "CarShuttleTrains": true, "TollTransponders": true, "ZoneCategories": [{"Category": "Environmental"}]}' \
--travel-mode "Scooter"
```

------

# Scopri come usare CalculateRouteMatrix
<a name="calculate-route-matrix-how-to"></a>

In questa sezione imparerai a usare `CalculateRouteMatrix` per trovare percorsi efficienti per più origini e destinazioni.

**Topics**
+ [Come calcolare una matrice di percorso di distanza e tempo per più origini e destinazioni](calculate-route-matrix-distance.md)
+ [Come calcolare la matrice dei percorsi evitando](calculate-route-matrix-with-avoidance.md)

# Come calcolare una matrice di percorso di distanza e tempo per più origini e destinazioni
<a name="calculate-route-matrix-distance"></a>

L' CalculateRouteMatrix API calcola i percorsi e fornisce il tempo di viaggio e la distanza di viaggio per ogni combinazione di origini e destinazioni. Questa funzionalità è utile per le applicazioni che richiedono la pianificazione e l'ottimizzazione dei percorsi in più sedi.

La risposta è `Distance` espressa in metri e `Duration` in secondi per ogni coppia origine-destinazione.

## Casi d'uso potenziali
<a name="calculate-route-matrix-potential-use"></a>
+ **Ottimizza la pianificazione del percorso:** utilizza la matrice degli itinerari come input per il software di ottimizzazione dei percorsi per migliorare l'efficienza del servizio e ridurre i tempi di viaggio.

## Esempi
<a name="calculate-route-matrix-examples"></a>

### CalculateRouteMatrix con un limite di routing illimitato
<a name="calculate-route-matrix-unbounded"></a>

------
#### [ Sample request ]

```
{
    "Origins": [
        {
            "Position": [-123.11679620827039, 49.28147612192166]
        },
        {
            "Position": [-123.11179620827039, 49.3014761219]
        }
    ],
    "Destinations": [
        {
            "Position": [-123.112317039, 49.28897192166]
        }
    ],
    "DepartureTime": "2024-05-28T21:27:56Z",
    "RoutingBoundary": {
        "Unbounded": true
    }
}
```

------
#### [ Sample response ]

```
{
    "ErrorCount": 0,
    "RouteMatrix": [
        [
            {
                "Distance": 1907,
                "Duration": 343
            }
        ],
        [
            {
                "Distance": 5629,
                "Duration": 954
            }
        ]
    ],
    "RoutingBoundary": {
        "Unbounded": true
    }
}
```

------
#### [ cURL ]

```
curl --request POST \
  --url 'https://routes.geo.eu-central-1.amazonaws.com/v2/route-matrix?key=Your_key' \
  --header 'Content-Type: application/json' \
  --data '{
    "Origins": [
        {
            "Position": [-123.11679620827039, 49.28147612192166]
        },
        {
            "Position": [-123.11179620827039, 49.3014761219]
        }
    ],
    "Destinations": [
        {
            "Position": [-123.112317039, 49.28897192166]
        }
    ],
    "DepartureTime": "2024-05-28T21:27:56Z",
    "RoutingBoundary": {
        "Unbounded": true
    }
}'
```

------
#### [ AWS CLI ]

```
aws geo-routes calculate-route-matrix --key ${YourKey} \
--origins '[{"Position": [-123.11679620827039, 49.28147612192166]}, {"Position": [-123.11179620827039, 49.3014761219]}]' \
--destinations '[{"Position": [-123.11179620827039, 49.28897192166]}]' \
--departure-time "2024-05-28T21:27:56Z" \
--routing-boundary '{"Unbounded": true}'
```

------

### CalculateRouteMatrix con un limite di routing basato sulla geometria
<a name="calculate-route-matrix-geometry"></a>

------
#### [ Sample request ]

```
{
    "Origins": [
        {
            "Position": [-123.11679620827039, 49.28147612192166]
        },
        {
            "Position": [-123.11179620827039, 49.3014761219]
        }
    ],
    "Destinations": [
        {
            "Position": [-123.112317039, 49.28897192166]
        }
    ],
    "DepartureTime": "2024-05-28T21:27:56Z",
    "RoutingBoundary": {
        "Geometry": {
            "AutoCircle": {
                "Margin": 10000,
                "MaxRadius": 30000
            }
        }
    }
}
```

------
#### [ Sample response ]

```
{
    "ErrorCount": 0,
    "RouteMatrix": [
        [
            {
                "Distance": 1907,
                "Duration": 344
            }
        ],
        [
            {
                "Distance": 5629,
                "Duration": 950
            }
        ]
    ],
    "RoutingBoundary": {
        "Geometry": {
            "Circle": {
                "Center": [
                    -123.1142962082704,
                    49.29147612191083
                ],
                "Radius": 11127
            }
        },
        "Unbounded": false
    }
}
```

------
#### [ cURL ]

```
curl --request POST \
  --url 'https://routes.geo.eu-central-1.amazonaws.com/v2/route-matrix?key=Your_key' \
  --header 'Content-Type: application/json' \
  --data '{
    "Origins": [
        {
            "Position": [-123.11679620827039, 49.28147612192166]
        },
        {
            "Position": [-123.11179620827039, 49.3014761219]
        }
    ],
    "Destinations": [
        {
            "Position": [-123.112317039, 49.28897192166]
        }
    ],
    "DepartureTime": "2024-05-28T21:27:56Z",
    "RoutingBoundary": {
        "Geometry": {
            "AutoCircle": {
                "Margin": 10000,
                "MaxRadius": 30000
            }
        }
    }
}'
```

------
#### [ AWS CLI ]

```
aws geo-routes calculate-route-matrix --key ${YourKey} \
--origins '[{"Position": [-123.11679620827039, 49.28147612192166]}, {"Position": [-123.11179620827039, 49.3014761219]}]' \
--destinations '[{"Position": [-123.11179620827039, 49.28897192166]}]' \
--departure-time "2024-05-28T21:27:56Z" \
--routing-boundary '{"Geometry": {"AutoCircle": {"Margin": 10000, "MaxRadius": 30000}}}'
```

------

# Come calcolare la matrice dei percorsi evitando
<a name="calculate-route-matrix-with-avoidance"></a>

L' CalculateRouteMatrix API calcola i percorsi e restituisce il tempo di viaggio e la distanza da ciascuna origine a ciascuna destinazione negli elenchi specificati. La risposta è `Distance` espressa in metri e `Duration` in secondi. L'API può essere utilizzata per impostare opzioni di evitamento per aree o caratteristiche stradali specifiche, garantendo che i percorsi evitino zone o condizioni specifiche. Se un percorso alternativo non è possibile, la preferenza di evitamento può essere ignorata.

## Casi d'uso potenziali
<a name="calculate-route-matrix-potential-use"></a>
+ **Pianificazione e ottimizzazione del percorso:** utilizza la matrice dei percorsi come input per il software che richiede percorsi di viaggio ottimizzati evitando determinate aree o caratteristiche stradali.

## Esempi
<a name="calculate-route-matrix-examples"></a>

### CalculateRouteMatrix con un'area di evitamento
<a name="calculate-route-matrix-avoidance-area"></a>

------
#### [ Sample request ]

```
{
    "Origins": [
        {
            "Position": [-123.11679620827039, 49.28147612192166]
        }
    ],
    "Destinations": [
        {
            "Position": [-123.112317039, 49.28897192166]
        }
    ],
    "Avoid": {
        "Areas": [
            {
                "Geometry": {
                    "BoundingBox": [
                         -123.116561,
                         49.281517,
                         -123.110165,
                         49.285689
                    ]
                }
            }
        ]
    },
    "RoutingBoundary": {
        "Unbounded": true
    }
}
```

------
#### [ Sample response ]

```
{
    "ErrorCount": 0,
    "RouteMatrix": [
        [
            {
                "Distance": 1855,
                "Duration": 295
            }
        ]
    ],
    "RoutingBoundary": {
        "Unbounded": true
    }
}
```

------
#### [ cURL ]

```
curl --request POST \
  --url 'https://routes.geo.eu-central-1.amazonaws.com/v2/route-matrix?key=Your_key' \
  --header 'Content-Type: application/json' \
  --data '{
    "Origins": [
        {
            "Position": [-123.11679620827039, 49.28147612192166]
        }
    ],
    "Destinations": [
        {
            "Position": [-123.112317039, 49.28897192166]
        }
    ],
    "Avoid": {
        "Areas": [
            {
                "Geometry": {
                    "BoundingBox": [
                         -123.116561,
                         49.281517,
                         -123.110165,
                         49.285689
                    ]
                }
            }
        ]
    },
    "RoutingBoundary": {
        "Unbounded": true
    }
}'
```

------
#### [ AWS CLI ]

```
aws geo-routes calculate-route-matrix --key ${YourKey} \
--origins '[{"Position": [-123.11679620827039, 49.28147612192166]}]' \
--destinations '[{"Position": [-123.112317039, 49.28897192166]}]' \
--avoid '{"Areas": [{"Geometry": {"BoundingBox": [-123.116561, 49.281517, -123.110165, 49.285689]}}]}' \
--routing-boundary '{"Unbounded": true}'
```

------

### CalculateRouteMatrix evitando strade a pedaggio, autostrade e traghetti
<a name="calculate-route-matrix-avoidance-features"></a>

------
#### [ Sample request ]

```
{
    "Origins": [
        {
            "Position": [-123.11679620827039, 49.28147612192166]
        }
    ],
    "Destinations": [
        {
            "Position": [-123.112317039, 49.28897192166]
        }
    ],
    "Avoid": {
        "TollRoads": true,
        "ControlledAccessHighways": true,
        "Ferries": true    
    },
    "RoutingBoundary": {
        "Unbounded": true
    }
}
```

------
#### [ Sample response ]

```
{
    "ErrorCount": 0,
    "RouteMatrix": [
        [
            {
                "Distance": 1855,
                "Duration": 295
            }
        ]
    ],
    "RoutingBoundary": {
        "Unbounded": true
    }
}
```

------
#### [ cURL ]

```
curl --request POST \
  --url 'https://routes.geo.eu-central-1.amazonaws.com/v2/route-matrix?key=Your_key' \
  --header 'Content-Type: application/json' \
  --data '{
    "Origins": [
        {
            "Position": [-123.11679620827039, 49.28147612192166]
        }
    ],
    "Destinations": [
        {
            "Position": [-123.112317039, 49.28897192166]
        }
    ],
    "Avoid": {
        "TollRoads": true,
        "ControlledAccessHighways": true,
        "Ferries": true    
    },
    "RoutingBoundary": {
        "Unbounded": true
    }
}'
```

------
#### [ AWS CLI ]

```
aws geo-routes calculate-route-matrix --key ${YourKey} \
--origins '[{"Position": [-123.11679620827039, 49.28147612192166]}]' \
--destinations '[{"Position": [-123.112317039, 49.28897192166]}]' \
--avoid '{"TollRoads": true, "ControlledAccessHighways": true, "Ferries": true}' \
--routing-boundary '{"Unbounded": true}'
```

------

# Scopri come usare OptimizeWaypoints
<a name="optimize-waypoints-how-to"></a>

Scopri come utilizzarlo per `OptimizeWaypoints` trovare i percorsi migliori per ridurre al minimo i tempi o la distanza di viaggio.

**Topics**
+ [Come ottimizzare i waypoint per un percorso](optimize-waypoints.md)
+ [Come ottimizzare i waypoint per un percorso con la consapevolezza del traffico](optimize-waypoints-traffic-awareness.md)
+ [Come ottimizzare i waypoint per un percorso tenendo conto degli orari di accesso](optimize-waypoints-access-hours.md)

# Come ottimizzare i waypoint per un percorso
<a name="optimize-waypoints"></a>

L' OptimizeWaypoints API calcola il percorso più efficiente tra una serie di waypoint, riducendo al minimo il tempo di viaggio o la distanza totale. Questa API risolve il problema del venditore ambulante considerando le reti stradali e le condizioni del traffico per determinare il percorso ottimale.

## Casi d'uso potenziali
<a name="optimize-waypoints-potential-use"></a>
+ **Analizza i modelli delle aree di servizio:** utilizza l'ottimizzazione dei waypoint per prendere decisioni informate sulle aree di servizio aziendali e migliorare l'efficienza logistica.

## Esempi
<a name="optimize-waypoints-examples"></a>

### Ottimizza i waypoint utilizzando Car TravelMode
<a name="optimize-waypoints-car"></a>

------
#### [ Sample Request ]

```
{
    "Origin": [
        -123.095740,
        49.274426
    ],
    "Waypoints": [
        {
            "Position": [
                -123.115193,
                49.280596
            ]
        },
        {
            "Position": [
                -123.089557,
                49.271774
            ]
        }
    ],
    "DepartureTime": "2024-10-25T18:13:42Z",
    "Destination": [
        -123.095185,
        49.263728
    ],
    "TravelMode": "Car"
}
```

------
#### [ Sample Response ]

```
{
    "Connections": [
        {
            "Distance": 1989,
            "From": "Origin",
            "RestDuration": 0,
            "To": "Waypoint0",
            "TravelDuration": 258,
            "WaitDuration": 0
        },
        {
            "Distance": 3010,
            "From": "Waypoint0",
            "RestDuration": 0,
            "To": "Waypoint1",
            "TravelDuration": 298,
            "WaitDuration": 0
        },
        {
            "Distance": 2371,
            "From": "Waypoint1",
            "RestDuration": 0,
            "To": "Destination",
            "TravelDuration": 311,
            "WaitDuration": 0
        }
    ],
    "Distance": 7370,
    "Duration": 867,
    "ImpedingWaypoints": [],
    "OptimizedWaypoints": [
        {
            "DepartureTime": "2024-10-25T18:13:42Z",
            "Id": "Origin",
            "Position": [
                -123.09574,
                49.274426
            ]
        },
        {
            "DepartureTime": "2024-10-25T18:18:00Z",
            "Id": "Waypoint0",
            "Position": [
                -123.115193,
                49.280596
            ]
        },
        {
            "DepartureTime": "2024-10-25T18:22:58Z",
            "Id": "Waypoint1",
            "Position": [
                -123.089557,
                49.271774
            ]
        },
        {
            "ArrivalTime": "2024-10-25T18:28:09Z",
            "Id": "Destination",
            "Position": [
                -123.095185,
                49.263728
            ]
        }
    ],
    "TimeBreakdown": {
        "RestDuration": 0,
        "ServiceDuration": 0,
        "TravelDuration": 867,
        "WaitDuration": 0
    }
}
```

------
#### [ cURL ]

```
curl --request POST \
  --url 'https://routes.geo.eu-central-1.amazonaws.com/v2/optimize-waypoints?key=Your_key' \
  --header 'Content-Type: application/json' \
  --data '{
    "Origin": [
        -123.095740,
        49.274426
    ],
    "Waypoints": [
        {
            "Position": [
                -123.115193,
                49.280596
            ]
        },
        {
            "Position": [
                -123.089557,
                49.271774
            ]
        }
    ],
    "DepartureTime": "2024-10-25T18:13:42Z",
    "Destination": [
        -123.095185,
        49.263728
    ],
    "TravelMode": "Car"
}'
```

------
#### [ AWS CLI ]

```
aws geo-routes optimize-waypoints --key ${YourKey} \
--origin -123.095740 49.274426 \
--waypoints '[{"Position": [-123.115193 , 49.280596]}, {"Position": [-123.089557 , 49.271774]}]' \
--destination -123.095185 49.263728 \
--departure-time "2024-10-25T18:13:42Z" \
--travel-mode "Car"
```

------

# Come ottimizzare i waypoint per un percorso con la consapevolezza del traffico
<a name="optimize-waypoints-traffic-awareness"></a>

L' OptimizeWaypoints API calcola il percorso ottimale tra più waypoint per ridurre al minimo il tempo di viaggio o la distanza totale. Utilizza algoritmi avanzati per risolvere il problema del venditore ambulante, determinando il percorso più efficiente e tenendo conto di fattori quali le reti stradali e le condizioni del traffico in tempo reale.

## Potenziali casi d'uso
<a name="optimize-waypoints-potential-use"></a>
+ **Ottimizza i percorsi con più fermate per un'efficienza delle consegne:** migliora le operazioni di consegna calcolando il percorso più breve o più veloce tra più fermate. Ciò è utile per ridurre i costi operativi, il consumo di carburante e i tempi di viaggio nei servizi di logistica e consegna.

## Esempi
<a name="optimize-waypoints-examples"></a>

### Ottimizza i waypoint con la consapevolezza del traffico utilizzando l'auto TravelMode
<a name="optimize-waypoints-traffic-car"></a>

------
#### [ Sample request ]

```
{
    "Origin": [
        -123.095740,
        49.274426
    ],
    "Waypoints": [
        {
            "Position": [
                -123.115193,
                49.280596
            ]
        },
        {
            "Position": [
                -123.089557,
                49.271774
            ]
        }
    ],
    "DepartureTime": "2024-10-25T18:13:42Z",
    "Destination": [
        -123.095185,
        49.263728
    ],
    "TravelMode": "Car",
    "Traffic": {
        "Usage": "UseTrafficData"
    }
}
```

------
#### [ Sample response ]

```
{
    "Connections": [
        {
            "Distance": 1989,
            "From": "Origin",
            "RestDuration": 0,
            "To": "Waypoint0",
            "TravelDuration": 324,
            "WaitDuration": 0
        },
        {
            "Distance": 2692,
            "From": "Waypoint0",
            "RestDuration": 0,
            "To": "Waypoint1",
            "TravelDuration": 338,
            "WaitDuration": 0
        },
        {
            "Distance": 2371,
            "From": "Waypoint1",
            "RestDuration": 0,
            "To": "Destination",
            "TravelDuration": 395,
            "WaitDuration": 0
        }
    ],
    "Distance": 7052,
    "Duration": 1057,
    "ImpedingWaypoints": [],
    "OptimizedWaypoints": [
        {
            "DepartureTime": "2024-10-25T18:13:42Z",
            "Id": "Origin",
            "Position": [
                -123.09574,
                49.274426
            ]
        },
        {
            "ArrivalTime": "2024-10-25T18:19:06Z",
            "DepartureTime": "2024-10-25T18:19:06Z",
            "Id": "Waypoint0",
            "Position": [
                -123.115193,
                49.280596
            ]
        },
        {
            "ArrivalTime": "2024-10-25T18:24:44Z",
            "DepartureTime": "2024-10-25T18:24:44Z",
            "Id": "Waypoint1",
            "Position": [
                -123.089557,
                49.271774
            ]
        },
        {
            "ArrivalTime": "2024-10-25T18:31:19Z",
            "Id": "Destination",
            "Position": [
                -123.095185,
                49.263728
            ]
        }
    ],
    "TimeBreakdown": {
        "RestDuration": 0,
        "ServiceDuration": 0,
        "TravelDuration": 1057,
        "WaitDuration": 0
    }
}
```

------
#### [ cURL ]

```
curl --request POST \
  --url 'https://routes.geo.eu-central-1.amazonaws.com/v2/optimize-waypoints?key=Your_key' \
  --header 'Content-Type: application/json' \
  --data '{
    "Origin": [
        -123.095740,
        49.274426
    ],
    "Waypoints": [
        {
            "Position": [
                -123.115193,
                49.280596
            ]
        },
        {
            "Position": [
                -123.089557,
                49.271774
            ]
        }
    ],
    "DepartureTime": "2024-10-25T18:13:42Z",
    "Destination": [
        -123.095185,
        49.263728
    ],
    "TravelMode": "Car",
    "Traffic": {
        "Usage": "UseTrafficData"
    }
}'
```

------
#### [ AWS CLI ]

```
aws geo-routes optimize-waypoints --key ${YourKey} \
--origin -123.095740 49.274426 \
--waypoints '[{"Position": [-123.115193 , 49.280596]}, {"Position": [-123.089557 , 49.271774]}]' \
--destination -123.095185 49.263728 \
--departure-time "2024-10-25T18:13:42Z" \
--travel-mode "Car" \
--traffic '{"Usage": "UseTrafficData"}'
```

------

# Come ottimizzare i waypoint per un percorso tenendo conto degli orari di accesso
<a name="optimize-waypoints-access-hours"></a>

L' OptimizeWaypoints API calcola anche il percorso ottimale tra una serie di waypoint, con l'obiettivo di ridurre al minimo il tempo di viaggio o la distanza totale percorsa. Risolve il problema del venditore ambulante di determinare il percorso più efficiente, tenendo conto di fattori quali la rete stradale e le condizioni del traffico.

## Potenziali casi d'uso
<a name="optimize-waypoints-access-hours-potential-use"></a>
+ **Analizza gli orari di accesso dei clienti:** pianifica l'efficienza in base agli orari di accesso dei clienti.

## Esempi
<a name="optimize-waypoints-examples"></a>

### Ottimizza i waypoint con la consapevolezza degli orari di accesso utilizzando Car TravelMode
<a name="optimize-waypoints-car"></a>

------
#### [ Sample Request ]

```
{
    "Origin": [
        -123.095740,
        49.274426
    ],
    "Waypoints": [
        {
            "Position": [
                -123.115193,
                49.280596
            ],
            "SideOfStreet": {
                "Position": [
                    -123.089557,
                    49.271774
                ],
                "UseWith": "AnyStreet"
            },
            "AccessHours": {
                "From": {
                    "DayOfWeek": "Saturday",
                    "TimeOfDay": "00:02:42Z"
                },
                "To": {
                    "DayOfWeek": "Friday",
                    "TimeOfDay": "1:33:36+02:50"
                }
            },
            "Heading": "250",
            "ServiceDuration": "200"
        },
        {
            "Position": [
                -123.089557,
                49.271774
            ],
            "AccessHours": {
                "From": {
                    "DayOfWeek": "Monday",
                    "TimeOfDay": "00:02:42Z"
                },
                "To": {
                    "DayOfWeek": "Tuesday",
                    "TimeOfDay": "1:33:36+02:50"
                }
            },
            "ServiceDuration": "200"
        }
    ],
    "DepartureTime": "2024-10-25T18:13:42Z",
    "Destination": [
        -123.095185,
        49.263728
    ],
    "TravelMode": "Car"
}
```

------
#### [ Sample Response ]

```
{
    "Connections": [
        {
            "Distance": 1989,
            "From": "Origin",
            "RestDuration": 0,
            "To": "Waypoint0",
            "TravelDuration": 258,
            "WaitDuration": 20682
        },
        {
            "Distance": 3360,
            "From": "Waypoint0",
            "RestDuration": 0,
            "To": "Waypoint1",
            "TravelDuration": 378,
            "WaitDuration": 172222
        },
        {
            "Distance": 2371,
            "From": "Waypoint1",
            "RestDuration": 0,
            "To": "Destination",
            "TravelDuration": 311,
            "WaitDuration": 0
        }
    ],
    "Distance": 7720,
    "Duration": 194251,
    "ImpedingWaypoints": [],
    "OptimizedWaypoints": [
        {
            "DepartureTime": "2024-10-25T18:13:42Z",
            "Id": "Origin",
            "Position": [
                -123.09574,
                49.274426
            ]
        },
        {
            "ArrivalTime": "2024-10-25T18:18:00Z",
            "DepartureTime": "2024-10-26T00:06:02Z",
            "Id": "Waypoint0",
            "Position": [
                -123.115193,
                49.280596
            ]
        },
        {
            "ArrivalTime": "2024-10-26T00:12:20Z",
            "DepartureTime": "2024-10-28T00:06:02Z",
            "Id": "Waypoint1",
            "Position": [
                -123.089557,
                49.271774
            ]
        },
        {
            "ArrivalTime": "2024-10-28T00:11:13Z",
            "Id": "Destination",
            "Position": [
                -123.095185,
                49.263728
            ]
        }
    ],
    "TimeBreakdown": {
        "RestDuration": 0,
        "ServiceDuration": 400,
        "TravelDuration": 947,
        "WaitDuration": 192904
    }
}
```

------
#### [ cURL ]

```
curl --request POST \
  --url 'https://routes.geo.eu-central-1.amazonaws.com/v2/optimize-waypoints?key=Your_key' \
  --header 'Content-Type: application/json' \
  --data '{
    "Origin": [
        -123.095740,
        49.274426
    ],
    "Waypoints": [
        {
            "Position": [
                -123.115193,
                49.280596
            ],
            "SideOfStreet": {
                "Position": [
                    -123.089557,
                    49.271774
                ],
                "UseWith": "AnyStreet"
            },
            "AccessHours": {
                "From": {
                    "DayOfWeek": "Saturday",
                    "TimeOfDay": "00:02:42Z"
                },
                "To": {
                    "DayOfWeek": "Friday",
                    "TimeOfDay": "1:33:36+02:50"
                }
            },
            "Heading": "250",
            "ServiceDuration": "200"
        },
        {
            "Position": [
                -123.089557,
                49.271774
            ],
            "AccessHours": {
                "From": {
                    "DayOfWeek": "Monday",
                    "TimeOfDay": "00:02:42Z"
                },
                "To": {
                    "DayOfWeek": "Tuesday",
                    "TimeOfDay": "1:33:36+02:50"
                }
            },
            "ServiceDuration": "200"
        }
    ],
    "DepartureTime": "2024-10-25T18:13:42Z",
    "Destination": [
        -123.095185,
        49.263728
    ],
    "TravelMode": "Car"
}'
```

------
#### [ AWS CLI ]

```
aws geo-routes optimize-waypoints --key ${YourKey} \
--origin -123.095740 49.274426 \
--waypoints '[{"Position": [-123.115193 , 49.280596], "SideOfStreet": {"Position": [-123.089557, 49.271774], "UseWith": "AnyStreet"}, "AccessHours": {"From": {"DayOfWeek": "Saturday", "TimeOfDay": "00:02:42Z"}, "To": {"DayOfWeek": "Friday", "TimeOfDay": "1:33:36+02:50"}}, "Heading": 250, "ServiceDuration": 200}, {"Position": [-123.089557, 49.271774], "AccessHours": {"From": {"DayOfWeek": "Monday", "TimeOfDay": "00:02:42Z"}, "To": {"DayOfWeek": "Tuesday", "TimeOfDay": "1:33:36+02:50"}}, "ServiceDuration": 200}]' \
--destination -123.095185 49.263728 \
--departure-time "2024-10-25T18:13:42Z" \
--travel-mode "Car"
```

------

# Scopri come usare SnapToRoads
<a name="snap-to-roads-how-to"></a>

 Questo argomento spiega come `SnapToRoads` allineare le tracce GPS con le reti stradali, migliorando la precisione di posizionamento per le applicazioni di navigazione e gestione del parco veicoli. Questa API corregge la deriva del GPS e la perdita di segnale inviando le coordinate ai segmenti stradali più vicini, rispettando al contempo le restrizioni relative alla modalità di viaggio. Gli esempi illustrano usi pratici, come sovrapporre le tracce GPS, colmare le lacune nei dati e ridurre il rumore per una visualizzazione più chiara del percorso.

**Topics**
+ [Come abbinare le tracce GPS a una rete stradale](how-to-match-gps-traces.md)

# Come abbinare le tracce GPS a una rete stradale
<a name="how-to-match-gps-traces"></a>

L' SnapToRoads API consente di abbinare le tracce GPS alla rete stradale. Una traccia GPS include posizioni e metadati come timestamp, velocità e direzione che vengono registrati utilizzando un dispositivo GPS. Queste tracce presentano spesso un margine di errore, il che le rende difficili da utilizzare direttamente per l'analisi e la visualizzazione.

SnapToRoads tiene conto delle restrizioni legali e temporali per la modalità di viaggio specificata durante l'abbinamento delle tracce. Se la traccia suggerisce fortemente una violazione delle restrizioni, viene mantenuto il percorso effettivo seguito.

## Casi d'uso potenziali
<a name="potential-use"></a>
+ **Sovrapponi le tracce GPS alle strade con maggiore probabilità di guida:** questa funzione aiuta ad allineare i dati GPS al percorso più preciso sulla rete stradale, supportando una visualizzazione dei dati più chiara.
+ **Interpola le lacune nelle tracce GPS:** SnapToRoads può colmare le lacune associando le coordinate ai segmenti stradali, creando un set di dati più continuo e utile per le applicazioni.
+ **Filtra rumore e anomalie:** collegandosi alla strada più vicina, questa API può aiutare a rimuovere i valori anomali e ridurre il rumore del GPS, migliorando l'affidabilità dei dati per l'analisi.

## Esempi
<a name="examples"></a>

### Abbina la traccia GPS utilizzando la modalità auto
<a name="match-gps-car-mode"></a>

------
#### [ Sample request ]

```
{
  "TracePoints": [
    {
      "Position": [8.53404,50.16364],
      "Timestamp": "2024-05-22T18:13:42Z"
    },
    {
      "Position": [8.53379056,50.16352417],
      "Speed": 20,
      "Timestamp": "2024-05-22T18:13:59Z"
    }
  ],
  "TravelMode": "Car"
}
```

------
#### [ Sample response ]

```
{
    "Notices": [],
    "SnappedGeometry": {
        "Polyline": "Redacted"
    },
    "SnappedGeometryFormat": "FlexiblePolyline",
    "SnappedTracePoints": [
        {
            "Confidence": 1,
            "OriginalPosition": [8.53404, 50.16364],
            "SnappedPosition": [8.53402, 50.16367]
        },
        {
            "Confidence": 0.86,
            "OriginalPosition": [8.53379056, 50.16352417],
            "SnappedPosition": [8.53375, 50.16356]
        }
    ]
}
```

------
#### [ cURL ]

```
curl --request POST \
  --url 'https://routes.geo.eu-central-1.amazonaws.com/v2/snap-to-roads?key=Your_key' \
  --header 'Content-Type: application/json' \
  --data '{
  "TracePoints": [
    {
      "Position": [8.53404,50.16364],
      "Timestamp": "2024-05-22T18:13:42Z"
    },
    {
      "Position": [8.53379056,50.16352417],
      "Speed": 20,
      "Timestamp": "2024-05-22T18:13:59Z"
    }
  ],
  "TravelMode": "Car"
}'
```

------
#### [ AWS CLI ]

```
aws geo-routes snap-to-roads --key ${YourKey} \
--trace-points '[{"Position": [8.53404, 50.16364], "Timestamp": "2024-05-22T18:13:42Z"}, {"Position": [8.53379056, 50.16352417], "Speed": 20, "Timestamp": "2024-05-22T18:13:59Z"}]' \
--travel-mode "Car"
```

------

### Abbina la traccia GPS utilizzando la modalità camion con opzioni
<a name="match-gps-truck-mode-options"></a>

------
#### [ Sample request ]

```
{
  "TracePoints": [
    {
      "Position": [8.53404,50.16364],
      "Timestamp": "2024-05-22T18:13:42Z"
    },
    {
      "Position": [8.53379056,50.16352417],
      "Speed": 20,
      "Timestamp": "2024-05-22T18:13:59Z"
    }
  ],
  "TravelMode": "Truck",
  "TravelModeOptions": {
    "Truck": {
      "GrossWeight": 10000
    }
  }
}
```

------
#### [ Sample response ]

```
{
    "Notices": [],
    "SnappedGeometry": {
        "Polyline": "Redacted"
    },
    "SnappedGeometryFormat": "FlexiblePolyline",
    "SnappedTracePoints": [
        {
            "Confidence": 1,
            "OriginalPosition": [8.53404, 50.16364],
            "SnappedPosition": [8.53402, 50.16367]
        },
        {
            "Confidence": 0.86,
            "OriginalPosition": [8.53379056, 50.16352417],
            "SnappedPosition": [8.53375, 50.16356]
        }
    ]
}
```

------
#### [ cURL ]

```
curl --request POST \
  --url 'https://routes.geo.eu-central-1.amazonaws.com/v2/snap-to-roads?key=Your_key' \
  --header 'Content-Type: application/json' \
  --data '{
  "TracePoints": [
    {
      "Position": [8.53404,50.16364],
      "Timestamp": "2024-05-22T18:13:42Z"
    },
    {
      "Position": [8.53379056,50.16352417],
      "Speed": 20,
      "Timestamp": "2024-05-22T18:13:59Z"
    }
  ],
  "TravelMode": "Truck",
  "TravelModeOptions": {
    "Truck": {
      "GrossWeight": 10000
    }
  }
}'
```

------
#### [ AWS CLI ]

```
aws geo-routes snap-to-roads --key ${YourKey} \
--trace-points '[{"Position": [8.53404, 50.16364], "Timestamp": "2024-05-22T18:13:42Z"}, {"Position": [8.53379056, 50.16352417], "Speed": 20, "Timestamp": "2024-05-22T18:13:59Z"}]' \
--travel-mode "Truck" \
--travel-mode-options '{"Truck": {"GrossWeight": 10000}}'
```

------

# Gestione dei costi e dell'utilizzo
<a name="routes-whats-next"></a>

Man mano che continui a conoscere i percorsi di Amazon Location, è importante capire come gestire la capacità del servizio, assicurarti di rispettare i limiti di utilizzo e ottenere i migliori risultati attraverso l'ottimizzazione delle quote e delle API. Applicando le migliori pratiche in termini di prestazioni e precisione, puoi personalizzare la tua applicazione per gestire in modo efficiente le query relative al luogo e massimizzare le tue richieste API.

**Topics**
+ [Best practice](routes-best-practices.md)
+ [Prezzi delle tratte](routes-pricing.md)
+ [Quota e utilizzo dei percorsi](routes-quota-usage.md)

# Best practice
<a name="routes-best-practices"></a>

Questa sezione descrive le migliori pratiche per l'utilizzo della compressione e la scelta tra Simple (GeoJSON) FlexiblePolyline e formati durante l'interazione con l'API, fornendo indicazioni sull'ottimizzazione delle prestazioni, della larghezza di banda e della gestione dei dati.

## Compressione
<a name="compression"></a>

Per migliorare le prestazioni e l'efficienza delle applicazioni durante l'interazione con la nostra API, si consiglia di abilitare la compressione delle risposte, soprattutto quando si ha a che fare con payload di testo di grandi dimensioni. Puoi attivare la compressione includendo l'`Accept-Encoding`intestazione nelle tue richieste API, specificando il metodo di compressione preferito. Supportiamo `gzip` e sosteniamo `deflate` le loro capacità di compressione, offrendo `gzip` in genere rapporti di compressione migliori.

### Quando abilitare la compressione
<a name="when-to-enable-compression"></a>

**Risposte ampie**  
Abilita la compressione per risposte di testo di grandi dimensioni per ridurre l'utilizzo della larghezza di banda e migliorare i tempi di caricamento.

**Vincoli di rete**  
Se l'applicazione funziona su reti a larghezza di banda limitata o ad alta latenza, la compressione può migliorare l'efficienza del trasferimento dei dati.

### Come utilizzare la compressione in modo efficace
<a name="how-to-use-compression-effectively"></a>

**Imposta l'intestazione Accept-Encoding**  
Includi `Accept-Encoding: gzip, deflate` nelle tue richieste HTTP per informare la nostra API che supporti questi metodi di compressione. Il metodo per abilitare e gestire la compressione varia in base all'[SDK AWS](https://docs.aws.amazon.com/sdkref/latest/guide/overview.html) e al linguaggio di programmazione. Ad esempio, l'[SDK AWS per Java](https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/ClientConfiguration.html#withGzip-boolean-) v1 utilizza `withGzip` il metodo della classe per abilitare gzip, mentre `ClientConfiguration` l'SDK AWS for Go richiede l'aggiunta di un middleware specifico per la gestione della compressione. Per altre informazioni SDKs, consulta la [AWS SDK Reference Guide](https://docs.aws.amazon.com/sdkref/latest/guide/overview.html) per istruzioni dettagliate.

**Gestisci correttamente la decompressione**  
Assicurati che la tua applicazione client possa decomprimere correttamente le risposte in base all'`Content-Encoding`intestazione restituita dalla nostra API.

**Test e monitoraggio**  
Valuta regolarmente l'impatto della compressione sulle prestazioni dell'applicazione, bilanciando i vantaggi di dimensioni ridotte del payload con eventuali sovraccarichi aggiuntivi della CPU derivanti dai processi di decompressione.

## Polilinea
<a name="polyline"></a>

Le migliori pratiche per scegliere tra Simple (GeoJSON) FlexiblePolyline e formati quando si interagisce con la nostra API, per ottimizzare sia le prestazioni che l'usabilità dei dati geospaziali.

### Usa il formato semplice (GeoJSON)
<a name="use-simple-format"></a>

**Leggibilità e standardizzazione**  
Utilizzalo quando hai bisogno di un formato ampiamente riconosciuto e leggibile dall'uomo per facilitare il debug e l'interoperabilità con vari strumenti geospaziali.

**Precisione**  
Scegli il formato Simple quando la tua applicazione richiede un'elevata precisione per le coordinate, poiché GeoJSON mantiene la massima precisione decimale senza perdite.

**Set di dati più piccoli**  
Il formato semplice è ideale quando si lavora con set di dati di coordinate più piccoli in cui i vantaggi della compressione in termini di riduzione delle dimensioni sono minimi.

### Usa il FlexiblePolyline formato
<a name="use-flexiblepolyline-format"></a>

**Riduzione delle dimensioni dei dati**  
FlexiblePolyline è ideale quando è necessario ridurre al minimo la quantità di dati trasmessi, soprattutto per elenchi di coordinate di grandi dimensioni, sfruttando tecniche di compressione con perdita di dati.

**Sicurezza degli URL**  
FlexiblePolyline fornisce una stringa compatta e sicura per gli URL che può essere utilizzata direttamente nei parametri di query senza codifica aggiuntiva.

**Ottimizzazione delle prestazioni**  
FlexiblePolyline aiuta a ridurre le dimensioni del payload, portando a un trasferimento dati più rapido e a un minore utilizzo della larghezza di banda, il che lo rende fondamentale per le applicazioni ad alte prestazioni o per quelle che operano su reti vincolate.

# Prezzi delle tratte
<a name="routes-pricing"></a>

Di seguito sono riportati i prezzi fissi per ciascuna API:

## Calcola i percorsi
<a name="calculate-routes-price"></a>

Questo prezzo si basa sul numero di richieste API. `CalculateRoutes`ha tre fasce di prezzo: Core, Advanced e Premium.

**Core**  
Questa fascia di prezzo supporta le modalità di viaggio Auto, Camion e Pedone, senza calcolare i costi di pedaggio.

**Avanzata**  
Questa fascia di prezzo supporta modalità di viaggio alternative come Scooter, senza calcolare i costi di pedaggio.

**premio**  
Questa fascia di prezzo supporta il calcolo dei costi di pedaggio. Ti verrà addebitato il prezzo Premium quando richiedi il calcolo del costo del pedaggio impostando i parametri della richiesta `LegAdditionalFeatures["Tolls"]` o`SpanAdditionalFeatures["TollSystems"]`, indipendentemente dalla modalità di viaggio.

## Calcola la matrice del percorso
<a name="calculate-route-matri-price"></a>

Questo prezzo si basa sul numero di percorsi calcolati. Il numero di rotte calcolato in ogni richiesta è uguale al numero di origini moltiplicato per il numero di destinazioni,`Number of Routes = Number of origins x Number of Destinations`. Ad esempio, quando si utilizza una matrice di 300 origini per 100 destinazioni, il numero totale di rotte calcolato è 30.000 (300 x 100 = 30.000).

**Nota**  
I calcoli del percorso vengono fatturati per ogni coppia di origine e destinazione. Se utilizzi un'ampia matrice di origini e destinazioni, i costi aumenteranno di conseguenza.

`CalculateRouteMatrix`ha 2 fasce di prezzo: Core e Advanced.

**Core**  
Questa fascia di prezzo supporta le modalità di viaggio Auto, Camion e Pedone.

**Avanzata**  
Questa fascia di prezzo supporta modalità di viaggio alternative, come Scooter.

## Ottimizza Waypoint
<a name="optimize-waypoint-price"></a>

Questo prezzo si basa sul numero di richieste API. `OptimizeWaypoint`ha 2 fasce di prezzo: Advanced e Premium.

**Avanzata**  
 Questa fascia tariffaria supporta fino a 30 waypoint in una singola richiesta; modalità di viaggio per auto, camion e pedone, con il riquadro di delimitazione dei punti di ingresso entro 200 km e senza parametri opzionali come,,,`Avoid`,, `Clustering` `Driver``Exclude.Countries`, e senza waypoint o vincoli di destinazione aggiuntivi come `TravelModeOptions.Truck.HazardousCargos``TravelModeOptions.Truck.TunnelRestrictionCode`,,,,,. `AccessHours` `AppointmentTime` `Before` `Heading` `ServiceDuration` `SideOfStreet`  
Il clustering automatico potrebbe verificarsi quando i waypoint sono nelle immediate vicinanze, ma è comunque considerato una fascia tariffaria avanzata.

**premio**  
 Questa fascia tariffaria supporta fino a 50 waypoint in una singola richiesta, senza restrizioni sulle modalità di viaggio, riquadro di delimitazione dei punti di ingresso entro 500 km e con parametri opzionali come`Avoid`,,,,`Clustering`,`Driver`. `Exclude.Countries` `TravelModeOptions.Truck.HazardousCargos` `TravelModeOptions.Truck.TunnelRestrictionCode` Inoltre, questa fascia tariffaria supporta vincoli opzionali in termini di waypoint e destinazione,,,,. `AccessHours` `AppointmentTime` `Before` `Heading` `ServiceDuration` `SideOfStreet`   
Una singola richiesta può supportare solo fino a 20 waypoint se viene applicato uno dei vincoli opzionali di waypoint e destinazione.

## S nap-to-road
<a name="snap-to-road-price"></a>

Questo prezzo si basa sul numero di richieste API. `SnaptoRoad`ha 2 fasce di prezzo: Advanced e Premium.

**Avanzata**  
Questa fascia tariffaria supporta le modalità di viaggio Auto, Camion e Pedone, con un `TracePoints` numero massimo di 200 e una distanza massima tra `TracePoints` le compagnie aeree di 100 chilometri.

**premio**  
Questa fascia tariffaria non ha restrizioni sulle modalità di viaggio, fino a 5.000 `TracePoints` punti.

## Calcola Isoline
<a name="calculate-isoline-price"></a>

Questo prezzo si basa sul numero di isoline calcolato nella risposta. `CalculateIsolines`ha 2 fasce di prezzo: Advanced e Premium.

**Avanzata**  
Questa fascia tariffaria supporta le modalità di viaggio Auto, Camion e Pedone, con `Thresholds.Time` valori fino a 60 minuti o `Thresholds.Distance` valori fino a 100 chilometri.

**premio**  
Questa fascia tariffaria non ha restrizioni sulle modalità di viaggio, con `Thresholds.Time` valori fino a 180 minuti o `Thresholds.Distance` valori fino a 300 KM.

# Quota e utilizzo dei percorsi
<a name="routes-quota-usage"></a>

## Quota servizio
<a name="service-quota"></a>

Amazon Location Service APIs ha quote predefinite. Puoi aumentare le quote utilizzando la console delle [quote di servizio](https://console.aws.amazon.com/servicequotas/home#!/services/geo/quotas). Per limiti superiori al doppio del valore predefinito, richiedi tramite la console self-service o contatta l'assistenza.


**Limiti delle quote di servizio**  

| Nome API | Predefinita | Limite massimo regolabile | Limite massimo regolabile più che | 
| --- | --- | --- | --- | 
| [Calcola percorsi](calculate-routes.md) | 20 | 40 | Richiedi sulla [console delle quote di servizio](https://console.aws.amazon.com/servicequotas/home#!/services/geo/quotas) o contatta il team di supporto | 
| [Calcola isolinee](calculate-isolines.md) | 20 | 40 | Richiedi una [console per le quote di servizio](https://console.aws.amazon.com/servicequotas/home#!/services/geo/quotas) o contatta il team di supporto | 
| [Snap to Roads](snap-to-roads.md) | 20 | 40 | Richiedi una [console per le quote di servizio](https://console.aws.amazon.com/servicequotas/home#!/services/geo/quotas) o contatta il team di supporto | 
| [Calcola la matrice del percorso](calculate-route-matrix.md) | 5 | 10 | Richiedi una [console per le quote di servizio](https://console.aws.amazon.com/servicequotas/home#!/services/geo/quotas) o contatta il team di supporto | 
| [Ottimizza i waypoint](actions-optimize-waypoints.md) | 5 | 10 | Richiedi una [console per le quote di servizio](https://console.aws.amazon.com/servicequotas/home#!/services/geo/quotas) o contatta il team di supporto | 

## Altri limiti di utilizzo
<a name="other-usage-limits"></a>

Oltre alle quote di servizio, si applicano i seguenti limiti di utilizzo dell'API:


**Altri limiti di utilizzo**  

| Nome API | Limite | Valore | 
| --- | --- | --- | 
| [Snap to Roads](snap-to-roads.md) | Somma della distanza geodetica tra tutte TracePoints | 500 KM | 
| [Ottimizza i waypoint](actions-optimize-waypoints.md) | Somma della distanza geodetica tra l'origine, i waypoint nell'ordine fornito e la destinazione | 100 KM | 
| [Ottimizza i waypoint](actions-optimize-waypoints.md) | Perimetro del riquadro di delimitazione che circonda l'origine, i waypoint e la destinazione | 500 KM | 
| [Calcola la matrice del percorso](calculate-route-matrix.md) | Distanza massima tra origini e destinazioni per il routing illimitato (se si utilizza Avoid o TravelModeOptions .Truck) | 60 KM | 
| [Calcola la matrice del percorso](calculate-route-matrix.md) | Distanza massima tra origini e destinazioni per il routing illimitato | 10000 KM | 
| [Calcola percorsi](calculate-routes.md) | Dimensione del carico utile di risposta dopo la compressione | 6 MB | 
| [Calcola la matrice del percorso](calculate-route-matrix.md) | Dimensione del payload di risposta dopo la compressione | 6 MB | 
| [Calcola isolinee](calculate-isolines.md) | Dimensione del payload di risposta dopo la compressione | 6 MB | 
| [Ottimizza i waypoint](actions-optimize-waypoints.md) | Dimensione del payload di risposta dopo la compressione | 6 MB | 
| [Snap to Roads](snap-to-roads.md) | Dimensione del payload di risposta dopo la compressione | 6 MB | 

## Fasi successive
<a name="next-steps"></a>

Si prega di controllare quanto segue per ulteriori dettagli:
+ [Attribuzione](https://docs.aws.amazon.com/location/latest/developerguide/data-attribution.html): informazioni sui requisiti di attribuzione dei dati per Amazon Location Service.
+ [SLA](https://aws.amazon.com/location/sla/): l'accordo sul livello di servizio per Amazon Location Service, inclusi gli impegni di uptime e i tempi di risposta.
+ [Termini di servizio](https://aws.amazon.com/service-terms/): termini che regolano l'uso di Amazon Location Service, incluse restrizioni e limitazioni.