Navega por rutas para vehículos grandes

A quién se dirige esta guía: Lee esta guía si eres desarrollador de aplicaciones para dispositivos móviles y te encargas de crear la experiencia de navegación paso a paso para los conductores de camiones, autobuses o cualquier otro vehículo comercial grande.

Temas que se abordan en esta guía: En esta guía, se explica cómo tomar una ruta específica para camiones generada por la API de Routes o la API de Route Optimization y usarla para potenciar una sesión de navegación paso a paso con el SDK de Navigation para iOS.

Qué aprenderás

Aprenderás a realizar las siguientes tareas:

  • Usa un routeToken para conectar la planificación de rutas de backend con la experiencia de navegación en la app.
  • Configura el SDK de Navigation para usar una ruta de camiones planificada previamente.
  • Comprende cómo aparecen las restricciones específicas para camiones al conductor en la IU de navegación.

Requisitos previos

Antes de comenzar, asegúrate de cumplir con los siguientes requisitos:

1. Solicita acceso para tu proyecto

La planificación de rutas para vehículos grandes está disponible para un conjunto limitado de clientes. Para expresar tu interés y solicitar acceso a tu proyecto de Google Cloud, completa el formulario de contacto. Un representante de Google se comunicará contigo para indicarte los próximos pasos.

Una vez que Google te otorgue acceso, asegúrate de que tu proyecto de Google Cloud esté aprovisionado para el enrutamiento de vehículos grandes.

Si tu organización usa proyectos de Google Cloud separados para las APIs de enrutamiento de backend y el SDK de Navigation para dispositivos móviles, comunícate con Google para aprovisionar cada proyecto.

2. Configura la generación de rutas de backend y obtén un token de ruta

Antes de iniciar la navegación en el dispositivo, tu servidor de backend debe generar una ruta para camiones y obtener un objeto routeToken con una de las siguientes APIs:

Tu solicitud de backend debe especificar travelMode: TRUCK junto con los atributos físicos del vehículo (altura, ancho, longitud, peso, cantidad de ejes y carga de materiales peligrosos). La API de Routing devuelve un routeToken en su respuesta, que el servidor de backend pasa a tu app para dispositivos móviles.

3. Cumple con los requisitos mínimos del SDK y del sistema

Tu app debe usar la versión mínima requerida del SDK de Navigation 5.4.0 o una posterior.

Además, tu proyecto debe cumplir con los requisitos de configuración estándar del SDK de Navigation.

Limitaciones y lineamientos operativos

Antes de comenzar, ten en cuenta las siguientes limitaciones y lineamientos operativos:

  • Disponibilidad geográfica: La planificación de rutas para vehículos grandes está disponible en los 48 estados contiguos de Estados Unidos (disponibilidad general) y en Japón (experimental). No está disponible en Alaska, Hawái ni en los territorios de EE.UU.
  • Seguridad y asesoramiento para el conductor: Los conductores no deben confiar únicamente en las rutas que muestra el SDK de Navigation para garantizar su seguridad o legalidad. Es posible que las rutas no sean adecuadas para el vehículo en todas las condiciones de la ruta, y seguirlas podría exponer a los conductores a peligros, como espacios libres bajos o rutas con restricciones de peso. Los conductores deben permanecer siempre alerta y obedecer las señales de tránsito y las reglamentaciones locales.
  • Rutas de mejor esfuerzo: Cuando la API de Routing no puede encontrar una ruta que cumpla con todas las restricciones del vehículo, devuelve una ruta de "mejor esfuerzo" que aún podría atravesar tramos restringidos. Por ejemplo, la API de Routes establece la marca routeRestrictionsPartiallyIgnored en su respuesta. Cuando se navega por estas rutas, el SDK de Navigation muestra llamadas de ruta para destacar las restricciones pertinentes. En estos casos, planifica las rutas con cuidado y no uses una ruta marcada como única fuente de información para la planificación o la navegación.
  • Funciones no admitidas: El enrutamiento de vehículos grandes no admite las siguientes funciones:
    • Precios de peajes para camiones
    • Límites de velocidad específicos para camiones o vehículos pesados
    • Rutas para materiales peligrosos radioactivos
  • Límites de uso: Las solicitudes realizadas al SDK de Navigation siguen los límites de uso y de cuota estándar. Para obtener más información, consulta Uso y facturación.

Mostrar la IU específica para camiones (avisos de ruta)

El SDK de Navigation muestra automáticamente advertencias visuales, llamadas avisos de ruta, en el mapa para alertar a los conductores sobre las próximas restricciones para camiones. Las llamadas aparecen para las restricciones que se producen a lo largo de la ruta planificada, pero no se muestran en otras rutas cercanas.

El SDK de Navigation incluye llamadas para las siguientes restricciones:

Restricción Ícono y texto de texto destacado Condiciones para la visualización
Altura Un ícono amarillo de restricción de altura
Amarillo = Advertencia: Tu vehículo está cerca de la altura máxima permitida
Un ícono rojo de restricción de altura
Rojo = Tu vehículo supera la altura máxima permitida 		Aparece una llamada amarilla cuando la altura del vehículo se acerca a la restricción.
Un mapa que muestra una advertencia de restricción de altura
Aparece una llamada roja si la ruta no cumple con los requisitos y viola una restricción de altura.
Un mapa que muestra un incumplimiento de restricción de altura
Peso Ícono de restricción de peso Aparece una llamada roja cuando el peso del vehículo supera el límite de la ruta.
Un mapa que muestra un ícono de restricción de peso
Camiones prohibidos Ícono de camiones prohibidos Aparece una llamada roja cuando se viaja por un tramo de ruta con una restricción para camiones comerciales.
Un mapa que muestra un ícono de camiones prohibidos
Bienes peligrosos Ícono de bienes peligrosos Aparece una llamada roja cuando se prohíbe la carga de materiales peligrosos del vehículo en un tramo de la ruta.
Un mapa en el que se muestra un ícono de bienes peligrosos

Cómo funcionan los tokens de ruta

Un routeToken es una instantánea encriptada de una ruta creada por el backend de rutas de Google. Encapsula la geometría de la ruta planificada, así como las dimensiones físicas y el perfil de restricciones del vehículo.

El flujo de trabajo sigue estos pasos:

  1. Solicitud de ruta: Tu servidor de backend solicita una ruta de camiones a la API de Routes (o a la API de Route Optimization).
  2. Recibe el token: La API de Routing calcula la ruta que cumple con los requisitos y devuelve un routeToken a tu servidor de backend.
  3. Token de reenvío: Tu servidor de backend pasa las coordenadas de routeToken y de destino a tu app para dispositivos móviles.
  4. Pasa al SDK: La app para dispositivos móviles pasa el routeToken al SDK de Navigation.
  5. Orientación para comenzar: El SDK de Navigation controla todos los aspectos de la experiencia de navegación paso a paso, lo que incluye renderizar indicaciones de ruta y controlar el cambio de ruta dinámico según las restricciones del vehículo.

Recálculo y cambio de ruta dinámicos

Durante la navegación activa, las condiciones del tráfico, los cierres de rutas o los giros perdidos pueden hacer que el vehículo se desvíe de la ruta planificada.

Cuando se produce un cambio de ruta:

  • El SDK de Navigation recalcula automáticamente la ruta al destino.
  • El SDK conserva los atributos y las dimensiones del vehículo codificados en el routeToken original.
  • La ruta recién recalculada evita los espacios libres bajos, los puentes con límite de peso y las rutas prohibidas para camiones comerciales.

Implementación: Inicia un viaje específico para camiones

Sigue estos pasos para inicializar y comenzar la navegación paso a paso con un token de ruta de vehículo grande.

Paso 1: Obtén el token de ruta desde tu backend

Tu app para dispositivos móviles recibe la cadena routeToken junto con las coordenadas de destino de tu servidor de backend. Para obtener detalles sobre cómo generar este token en tu servidor, consulta Cómo generar rutas y horas estimadas de llegada para vehículos grandes en la documentación de la API de Routes.

El siguiente código es un ejemplo de token de ruta:

{
  "routeToken": "CqMBCjoKCJQOor5DHcwiEhBon3XpHXFnVvDeWMwd9PpAGgz6wtnFDKIBrAHTARpCApUDSggAAAAACjcrP3gBEAQaTApKChgKDQoCCAERAAAAAACAZkAR3SQGgZUXdUASEggAEAMQBhATEBIYAkIEGgIIBSIYChZ2VEJiWlBPSkk1aU5wUVRzNTV5d0FRKAEiFQBcJuds-Efh-2QZhOMTtUCCxEVL_g"
}

Paso 2: Pasa el token al navegador

Pasa los puntos de referencia de routeToken y el destino al método setDestinations de mapView.navigator.

Cuando configures paradas intermedias y pases el token de ruta, ten en cuenta las siguientes consideraciones:

  • Requisito de coincidencia del destino: Las coordenadas del destino que se pasan a setDestinations deben coincidir con las coordenadas del destino que se usan cuando se genera el routeToken. Si se especifica un destino diferente, se produce un error.
  • Rutas al costado de la ruta: Los vehículos comerciales grandes no pueden hacer giros en U fácilmente en calles angostas. Para asegurarte de que el camión se acerque al destino por el lado correcto de la ruta, establece preferSameSideOfRoad = true en tus puntos de referencia.
  • Paradas del vehículo: Para guiar el camión a una ubicación adecuada para detenerse o descargar, establece vehicleStopover = true en tus puntos de referencia.
  • Puntos de navegación: Si tu destino tiene una entrada de carga o un muelle de carga designados, especifícalos con un token de punto de navegación.

Paso 3: Controla el estado de la ruta y comienza la guía

Evalúa el GMSRouteStatus que se devolvió en la devolución de llamada setDestinations. Cuando el estado es .OK (GMSRouteStatusOK), establece isGuidanceActive = true (guidanceActive = YES) para comenzar la guía activa paso a paso.

Ejemplo de código

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

// Obtain the routeToken string from your backend
let routeToken = "route token returned by Routes API"

mapView.navigator?.setDestinations([destination], routeToken: routeToken, callback: {...})

Pantallas en el vehículo

Puedes mostrar la sesión de navegación para vehículos grandes en las pantallas integradas en el tablero con Navegación para CarPlay.

Próximos pasos

  • Modifica la IU de navegación: Personaliza los controles de la IU y los elementos visuales integrados, como la brújula, el botón para volver a centrar y la perspectiva de la cámara.
  • Detecta eventos de navegación: Controla las actualizaciones de navegación y los eventos de ciclo de vida, como el progreso de la ruta, los cambios en la ETA y los cambios de ruta.