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à.
# Scopri come usare OptimizeWaypoints
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
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
+ **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
### Ottimizza i waypoint utilizzando Car TravelMode
------
#### [ 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
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
+ **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
### Ottimizza i waypoint con la consapevolezza del traffico utilizzando l'auto TravelMode
------
#### [ 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
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
+ **Analizza gli orari di accesso dei clienti:** pianifica l'efficienza in base agli orari di accesso dei clienti.
## Esempi
### Ottimizza i waypoint con la consapevolezza degli orari di accesso utilizzando Car TravelMode
------
#### [ 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"
```
------