Planifica una ruta

A veces, es posible que quieras planificar la ruta que tu app proporciona a los usuarios. Usar un token de ruta de la API de Routes, la API de Routes Preferred o la API de Route Optimization puede ayudarte a especificar dos aspectos de la ruta planificada:

  • Una polilínea para la ruta

  • Tus objetivos de ruta

Por ejemplo, estos son algunos objetivos de enrutamiento que puedes tener:

  • Minimizar el tiempo de entrega: Una empresa que entrega comida podría querer minimizar el tiempo que tarda en entregarla.

  • Minimizar el tiempo de viaje o el consumo de combustible: Una empresa de logística podría querer mejorar la eficiencia de sus conductores y reducir sus costos de combustible.

  • Minimizar el tiempo hasta el destino: Una operación de despacho de servicios podría querer minimizar el tiempo que tardan los operadores en llegar a una solicitud de trabajo.

  • Reducir los costos y mejorar la seguridad: Una empresa de viajes compartidos podría querer encontrar una ruta que cueste menos para los pasajeros y evite ciertas áreas por motivos de seguridad.

Para obtener más información sobre cómo planificar una ruta con un token de ruta, consulta Solicita un token de ruta en la API de Routes y Transición de polilíneas y tokens de ruta en la API de Route Optimization.

Por qué usar un token de ruta para los objetivos de ruta

Con un token de ruta de la API de Routes, la API de Routes Preferred o la API de Route Optimization, tienes más control sobre la ruta proporcionada:

  • Planifica una ruta con anticipación para que el SDK de Navigation la use cuando sea posible.

  • Elige la mejor ruta para que la use el SDK de Navigation. Si solicitas tokens de ruta cuando generas rutas en la API de Routes, obtendrás un token de ruta para cada ruta generada. Luego, puedes elegir el token de la ruta que quieres usar cuando lo pases al SDK de Navigation.

  • Estima el precio con anticipación, incluidas las estimaciones de la hora de llegada estimada y la distancia. Si bien el costo y el tiempo reales pueden variar, esta estimación reduce la brecha entre el costo de ruta esperado y el real.

  • Especifica objetivos de ruta más avanzados, como el enrutamiento ecológico o la ruta más corta.

Cómo funcionan los tokens de ruta

Puedes usar la API de Routes, la API de Routes Preferred o la API de Route Optimization para planificar una ruta con objetivos de ruta. Puedes pasar un token de ruta que se muestra desde cualquiera de estas APIs al SDK de Navigation para guiar cómo enruta tu vehículo.

Esto es lo que sucede cuando solicitas y usas un token de ruta:

  1. La API de Routes, la API de Routes Preferred o la API de Route Optimization muestra un token de ruta encriptado que incluye la polilínea de la ruta y los objetivos de la ruta.

  2. Pasas el token de ruta al SDK de Navigation.

  3. El SDK de Navigation recupera la ruta o, si la ruta no está disponible debido a las condiciones cambiantes, recupera la ruta que mejor coincide.

  4. Mientras conduces por la ruta, si el tráfico o las condiciones de la ruta cambian, o si un vehículo se desvía de la ruta planificada, las rutas modificadas intentan continuamente coincidir con la mejor ruta en función de los objetivos de la ruta en el token.

Este proceso maximiza la cercanía de la ruta real a la ruta planificada.

Por qué es posible que no se siga exactamente una ruta planificada

Piensa en tu ruta planificada y en los objetivos de la ruta como lineamientos que debes seguir: no son prescriptivos. Es posible que veas una diferencia entre la ruta planificada y la ruta que proporciona la navegación guiada debido a las diferencias en las condiciones de la ruta, la ubicación de inicio o cualquier otro parámetro que haya cambiado desde que creaste la ruta planificada. Esta diferencia puede provocar una falta de coincidencia entre tus objetivos planificados y reales para la distancia y la hora de llegada estimada, entre otras cualidades importantes del viaje.

Planifica una ruta con un token de ruta

Puedes planificar una ruta creando un token de ruta y, luego, pasándolo al SDK de Navigation, como se describe en los siguientes pasos:

Paso 1: Crea un token de ruta con la API de Routes, la API de Routes Preferred o la API de Route Optimization

  1. Solicita un token de ruta con uno de los siguientes métodos:

    • API de Routes: computeRoutes. Para obtener más información sobre cómo solicitar un token de ruta en la API de Routes, consulta Calcula una ruta y Solicita un token de ruta.

    • API de Routes Preferred: computeCustomRoutes. Para obtener más información sobre cómo solicitar un token de ruta en la API de Routes Preferred, consulta Planifica una ruta.

    • API de Route Optimization: optimizeTours o batchOptimizeTours. Para obtener más información sobre cómo solicitar un token de ruta en la API de Route Optimization, consulta Transición de polilíneas y tokens de ruta.

  2. Configura tu solicitud a la API de Routes o a la API de Routes Preferred para cumplir con los requisitos para usar un token de ruta:

    • Establece travel_mode en DRIVE o TWO_WHEELER.
    • Establece routing_preference en TRAFFIC_AWARE o TRAFFIC_AWARE_OPTIMAL.
    • NO uses puntos de referencia Via.

Paso 2: Pasa el token de ruta al SDK de Navigation

  1. Almacena el token de ruta: En el SDK de Navigation, configura una cadena para almacenar el token de ruta. Por ejemplo:

    let routeToken = "route token returned by Routes API"

    Ejemplo de un token de ruta que se muestra:

    {
// Other fields
"routeToken": "CqMBCjoKCJQOor5DHcwiEhBon3XpHXFnVvDeWMwd9PpAGgz6wtnFDKIBrAHTARpCApUDSggAAAAACjcrP3gBEAQaTApKChgKDQoCCAERAAAAAACAZkAR3SQGgZUXdUASEggAEAMQBhATEBIYAkIEGgIIBSIYChZ2VEJiWlBPSkk1aU5wUVRzNTV5d0FRKAEiFQBcJuds-Efh-2QZhOMTtUCCxEVL_g",
}

  2. Pasa el token de ruta al SDK de Navigation con el método mapView.navigator setDestinations y especifica los mismos puntos de referencia de destino que usaste cuando creaste el token de ruta:

    mapView.navigator?.continueToNextDestination([waypoint1, waypoint2], routeToken: routeToken, callback: {...})

    El método Navigator.continueToNextDestination muestra el estado de la solicitud. Si se encuentra una ruta desde la ubicación del usuario hasta el destino determinado, se muestra RouteStatus.OK.

Situaciones de varias paradas

Puedes configurar un máximo de 25 puntos de referencia.

El método setDestinations no admite viajes con varias paradas. Usa continueToNextDestination() para avanzar el punto de referencia a la siguiente etapa del viaje.

Ejemplo

En los siguientes ejemplos de código, se muestra cómo recuperar una ruta planificada.

Swift

let location = CLLocationCoordinate2D(latitude: 47.67, longitude: -122.20)
let waypoint1 = GMSNavigationWaypoint(location: location, title: "waypoint from location")!
let waypoint2 = GMSNavigationWaypoint(placeID: "samplePlaceID", title: "waypoint from Place ID")!

let routeToken = "route token returned by Routes API"
mapView.navigator?.setDestinations([waypoint1, waypoint2], routeToken: routeToken, callback: {...})

Objective-C

CLLocationCoordinate2D location = CLLocationCoordinate2DMake(47.67, -122.20);
GMSNavigationWaypoint *waypoint1 = [[GMSNavigationWaypoint alloc] initWithLocation:coordinate title:@"waypoint from location"];
GMSNavigationWaypoint *waypoint2 = [[GMSNavigationWaypoint alloc] initWithPlaceID:@"samplePlaceID"
                                                                            title:@"waypoint from Place ID"];
NSString *routeToken = @"route token returned by Routes API";

[mapView.navigator continueToNextDestination:@[waypoint1, waypoint2]
                         routeToken:routeToken
                           callback:^(GMSRouteStatus routeStatus){...}];

Cómo interactúan los tokens de ruta y el SDK de Navigation

A continuación, se explica cómo interactúan la ruta generada por el SDK de Navigation y la ruta planificada en el token de ruta:

  • Anula cualquier destino establecido anteriormente.

  • Usa la ubicación de inicio del vehículo.

  • Se ajusta a las condiciones de la ruta y el tráfico. Consulta Por qué es posible que no se siga exactamente una ruta planificada.

  • Ignora las siguientes opciones relacionadas con el enrutamiento como innecesarias:

    • avoidsHighways
    • avoidsTolls
    • avoidsFerries
    • licensePlateRestriction

  • Sigue lo siguiente:

    • Opciones relacionadas con los puntos de referencia, como la preferencia de lado de la ruta.

    • Objetivos de ruta. Si el SDK de Navigation tiene que ajustar la ruta que se muestra, usa los objetivos de la ruta que especificaste cuando solicitaste el token de ruta. Por este motivo, debes usar las mismas opciones relacionadas con los puntos de referencia que especificaste en la API de Routes.