Los tokens de puntos de navegación te permiten enviar información contextual clave sobre un destino al SDK de Navigation para Android para mejorar la experiencia de enrutamiento y del conductor. Esto es útil en casos como la entrega de comida o el uso compartido de viajes, en los que el punto de partida o de destino puede ser ambiguo sin la entrada del usuario.
En esta imagen, se muestran ejemplos de una app de viajes compartidos para consumidores en la que se selecciona el punto de navegación y una app para conductores que usa el SDK de Navigation para Android para dirigir al conductor con precisión.
Para crear y pasar un token de punto de navegación, usa el extremo Destinations de la API de Geocoding para permitir que los usuarios seleccionen una ubicación preferida de una lista de puntos de navegación. La selección del usuario se convierte en un punto de navegación que devuelve el extremo Destinations de la API de Geocoding. Luego, puedes pasar el token del punto de navegación, que contiene las coordenadas de destino y la información contextual, al SDK de Navigation para Android, en el que se crea un waypoint para generar rutas precisas. El SDK de Navigation destacará el destino para el conductor según el lugar con el que se asocia el token.
Por ejemplo, imagina un caso de uso de viajes compartidos, en el que hay una app para que el consumidor reserve el viaje y una segunda app para que el conductor reciba notificaciones del viaje y la información de la ruta al destino.
Cuando un consumidor abre la app para consumidores, esta llama al endpoint Destinations de la API de Geocoding y le proporciona al consumidor una selección de posibles puntos de navegación:
El usuario elige su punto preferido, que es uno de los navigationPoints del array en el cuerpo de la respuesta de una solicitud de SearchDestinations:
"navigationPoints": [ { "navigationPointToken": <encoded navigation point token>, "displayName": "South Entrance", "travelModes": ["DRIVE"], "usages": ["PICKUP","DROPOFF"], "location": { "lat": 37.3940894, "lng": -122.0788389 } } } ]
El token del punto de navegación de la respuesta se pasa a una app para conductores de dispositivos móviles que usa el SDK de Navigation para Android para crear un Waypoint y dirigir al conductor al punto de partida correcto.