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 API de Routes para mejorar la ruta y la experiencia del conductor. Esto es útil en casos como la entrega de comida o los viajes compartidos, en los que el punto de partida o de llegada puede ser ambiguo sin la intervención 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 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 devuelve 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, al SDK de Navigation para iOS o a la API de Routes, donde se crea un punto de referencia 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.

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 de punto de navegación y el token de 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 transporte 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 hacia el 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 trazar una ruta precisa para el conductor.

Ejemplos de apps para consumidores y conductores

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:

Consumidor eligiendo un punto de entrega

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 backend de la app proporciona el token de punto de navegación a la API de Routes para calcular la ruta y recuperar un token de ruta.

Por último, tanto el token de punto de navegación como el token de ruta se pasan a una app para conductores para 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