Ottenere un token di route

Sviluppatori dello Spazio economico europeo (SEE)

Se il tuo indirizzo di fatturazione si trova nello Spazio economico europeo, a partire dall'8 luglio 2025, i Termini di servizio di Google Maps Platform per il SEE si applicheranno al tuo utilizzo dei servizi. La funzionalità varia in base alla regione. Scopri di più.

Per richiedere che Compute Routes restituisca i token di route per le route generate, segui questi passaggi:

1. Imposta i seguenti parametri richiesti per restituire un token di route:
   • Imposta travelMode su DRIVE o TWO_WHEELER.
   • Imposta routingPreference su TRAFFIC_AWARE o TRAFFIC_AWARE_OPTIMAL.
2. Specifica le località di partenza e di destinazione. Puoi specificare le località in base al tuo caso d'uso utilizzando le seguenti opzioni: coordinate di latitudine e longitudine, stringhe di indirizzi, token di punti di navigazione o ID luogo. Scopri le opzioni per la specifica della località.
3. Verifica che nessuno dei waypoint della route sia un waypoint Via.

4. Specifica la maschera del campo routes.routeToken per restituire un token di route:

   X-Goog-FieldMask: routes.routeToken
   

Nota: a causa delle condizioni stradali dinamiche, le route generate con un determinato token potrebbero differire dalla route pianificata. Per ridurre al minimo le differenze, utilizza il token entro pochi minuti dalla sua generazione.

Puoi utilizzare il token di route per la route pianificata nell'SDK Navigation. Per ulteriori dettagli, vedi:

• Pianificare una route (Android)
• Pianificare una route (iOS)

Esempio di token di route

Ecco un esempio di corpo della richiesta curl per una route con un'unica origine e un'unica destinazione. Utilizza le maschere dei campi per richiedere un token di route, insieme alla durata, alla distanza e alla polilinea della route:

curl -X POST -d
{"origin":{
    "location": {
        "latLng":{
            "latitude":  -37.8167,
            "longitude": 144.9619
        }
    }
},
"destination":{
    "location": {
        "latLng":{
            "latitude":-37.8155,
            "longitude": 144.9663
        }
    }
},
"routingPreference":"TRAFFIC_AWARE",
"travelMode":"DRIVE"
}
-H 'X-Goog-Api-Key: YOUR_API_KEY' \
-H X-Goog-FieldMask: routes.routeToken,routes.duration,routes.distanceMeters,routes.polyline.encodedPolyline
'https://routes.googleapis.com/directions/v2:computeRoutes'

Per ulteriori dettagli, consulta la documentazione di riferimento dell'API Compute Routes.