Los tokens de puntos de navegación te permiten enviar información contextual clave sobre un destino al SDK de Navigation para Android o al SDK de Navigation para iOS para mejorar la ruta y la experiencia 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 intervención del usuario.
En esta imagen, se muestran ejemplos de una app de uso compartido de viajes 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 método Destinations de la API de Geocoding para permitir que tus 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 muestra el método Destinations de la API de Geocoding. Luego, puedes pasar el token de punto de navegación, que contiene las coordenadas de destino y la información contextual, al SDK de Navigation para Android o al SDK de Navigation para iOS, donde se crea un punto de ruta para una ruta precisa. El SDK de Navigation destacará el destino para el conductor según el lugar con el que esté asociado el token.
Por ejemplo, imagina un caso de uso de uso compartido de viajes, en el que hay una app para que el consumidor reserve el viaje y una segunda app para que el conductor reciba una notificación del viaje y la información de ruta al destino.
Cuando un consumidor abre la app para consumidores, esta llama a el método 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 en el array de navigationPoints en el cuerpo de la respuesta de una solicitud SearchDestinations:
"navigationPoints": [ { "navigationPointToken": <encoded navigation point token>, "displayName": "South Entrance", "travelModes": ["DRIVE"], "usages": ["PICKUP","DROPOFF"], "location": { "lat": 37.3940894, "lng": -122.0788389 } } ]
El token de punto de navegación de la respuesta se pasa a una app para conductores para dispositivos móviles que usa el SDK de Navigation para Android o iOS para crear un punto de ruta para dirigir al conductor al punto de partida correcto.
- Consulta la documentación del punto de navegación del SDK de Navigation para Android.
- Consulta la documentación del punto de navegación del SDK de Navigation para iOS.