Cómo generar rutas con tokens de puntos de navegación

Desarrolladores del Espacio Económico Europeo (EEE)

Los tokens de puntos de navegación te permiten enviar información contextual clave sobre un destino al SDK de Navigation para Android, al SDK de Navigation para iOS o a la Routes API 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.

Para crear y pasar un token de punto de navegación, usa el método 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 método Destinations de la API de Geocoding.

Luego, puedes pasar el token del punto de navegación, que contiene tanto las coordenadas de destino como la información contextual, al SDK de Navigation para Android, al SDK de Navigation para iOS o a la Routes API, en los que se crea un punto de referencia para el enrutamiento preciso. El SDK de Navigation destacará el destino para el conductor según el lugar con el que se asocia el token.

Ejemplo: Caso de uso de viajes compartidos

Descripción general

En este ejemplo, se muestra cómo combinar la API de Geocoding, la API de Routes y el SDK de Navigation para iOS o Android para crear una app de viajes compartidos que calcule el precio de la ruta y dirija a los conductores al punto de partida correcto.

Estos son los pasos generales:

  1. Recupera un token de punto de navegación a través de la API de Geocoding.
  2. Usa la API de Routes para calcular una ruta y codificarla en un token de ruta.
  3. Pasa el token del punto de navegación y el token de la ruta al SDK de Navigation.
  4. Usa el SDK de Navigation para dirigir al conductor al punto de partida correcto.

Consulta la sección Lecturas adicionales para obtener vínculos a la documentación pertinente de la API de Routes, el SDK de Navigation para iOS y el SDK de Navigation para Android.

En este diagrama, se muestra cómo una app de viajes compartidos o de entrega usaría la API de Geocoding, la API de Routes y el SDK de Navigation para iOS o Android para dirigir a un conductor con un token de ruta y un token de punto de navegación:

Diagrama de caso de uso de viajes compartidos o entregas
Diagrama de un caso de uso de viajes compartidos o entregas

Ejemplo de viaje compartido

Imagina una situación de viaje compartido en la que hay una app para que el consumidor reserve el viaje y una segunda app para que el conductor reciba la notificación del viaje y la información de la ruta al destino.

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.

Ejemplos de apps para conductores y consumidores

Cuando un consumidor abre la aplicación para consumidores, esta llama al método Destinations de la API de Geocoding y le proporciona al consumidor una selección de posibles puntos de navegación:

El consumidor elige un punto de entrega

El usuario elige su punto preferido, que es uno de los navigationPoints del array en el cuerpo de 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 backend de la app proporciona el token del punto de navegación a la API de Routes para calcular la ruta y recuperar un token de ruta.

Por último, tanto el token del punto de navegación como el token de la ruta se pasan a una app para conductores de dispositivos móviles que usa el SDK de Navigation para iOS o Android para crear un punto de referencia que dirija al conductor al punto de partida correcto.

Lecturas adicionales