Obtén un token de ruta

Desarrolladores del Espacio Económico Europeo (EEE)

Si tu dirección de facturación se encuentra en el Espacio Económico Europeo, a partir del 8 de julio de 2025, se aplicarán las Condiciones del Servicio de Google Maps Platform para el EEE al uso que hagas de los Servicios. La funcionalidad varía según la región. Obtén más información.

Para solicitar que Compute Routes devuelva tokens de ruta para las rutas generadas, sigue estos pasos:

1. Establece los siguientes parámetros obligatorios para devolver un token de ruta:
   • Establece travelMode en DRIVE o TWO_WHEELER.
   • Establece routingPreference en TRAFFIC_AWARE o TRAFFIC_AWARE_OPTIMAL.
2. Especifica las ubicaciones de origen y destino. Puedes especificar ubicaciones para que se adapten a tu caso de uso con lo siguiente: coordenadas de latitud y longitud, cadenas de direcciones, tokens de puntos de navegación o IDs de lugar. Consulta las opciones para especificar la ubicación.
3. Verifica que ninguno de los puntos de ruta sean puntos de Via.

4. Especifica la máscara de campo routes.routeToken para devolver un token de ruta:

   X-Goog-FieldMask: routes.routeToken
   

Nota: Debido a las condiciones dinámicas de la ruta, las rutas generadas con un token determinado pueden diferir de la ruta planificada. Para minimizar las diferencias, usa el token minutos después de generarlo.

Puedes usar el token de ruta para la ruta planificada en el SDK de Navigation. Para obtener más información, consulta los siguientes recursos:

• Cómo planificar una ruta (Android)
• Cómo planificar una ruta (iOS)

Ejemplo de token de ruta

Este es un ejemplo del cuerpo de una solicitud de curl para una ruta de un solo origen y un solo destino. Usa máscaras de campo para solicitar un token de ruta, junto con la duración, la distancia y la polilínea de la ruta:

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'

Para obtener más detalles, consulta la referencia de la API de Compute Routes.