Suivre des itinéraires pour véhicules imposants

Remarque : Le calcul d'itinéraires pour les véhicules de grande taille est disponible pour un nombre limité de clients. Contactez-nous pour nous faire part de votre intérêt.

À qui s'adresse ce guide : lisez ce guide si vous êtes un développeur mobile chargé de créer l'expérience de navigation détaillée pour les conducteurs de camions, de bus ou d'autres grands véhicules utilitaires.

Contenu de ce guide : ce guide explique comment utiliser un itinéraire spécifique aux camions généré par l'API Routes ou l'API Route Optimization pour alimenter une session de navigation détaillée avec le SDK Navigation pour iOS.

Points abordés

Vous allez apprendre à effectuer les tâches suivantes :

• Utilisez un routeToken pour connecter la planification d'itinéraires backend à l'expérience de navigation intégrée à l'application.
• Configurez le SDK Navigation pour utiliser un itinéraire de camion préplanifié.
• Comprendre comment les restrictions spécifiques aux camions s'affichent pour le conducteur dans l'interface utilisateur de navigation.

Prérequis

Avant de commencer, assurez-vous de remplir les conditions suivantes :

1. Demander l'accès pour votre projet

Le routage pour les gros véhicules est disponible pour un nombre limité de clients. Pour exprimer votre intérêt et demander l'accès pour votre projet Google Cloud, remplissez le formulaire de contact. Un représentant Google vous contactera pour vous indiquer la marche à suivre.

Une fois que Google vous a accordé l'accès, assurez-vous que votre projet Google Cloud est provisionné pour le calcul d'itinéraires pour les véhicules de grande taille.

Si votre organisation utilise des projets Google Cloud distincts pour les API de routage de backend et le SDK Navigation pour mobile, contactez Google pour provisionner chaque projet.

2. Configurer la génération d'itinéraires de backend et obtenir un jeton d'itinéraire

Avant de lancer la navigation sur l'appareil, votre serveur backend doit générer un itinéraire pour camion et obtenir un routeToken à l'aide de l'une des API suivantes :

• API Routes : recommandée pour calculer des itinéraires de camions individuels entre des points de départ et des destinations. Pour obtenir des instructions de configuration, consultez Générer des itinéraires et des heures d'arrivée prévues pour les véhicules de grande taille.
• API Route Optimization : recommandée pour optimiser les itinéraires à arrêts multiples d'une flotte. Pour en savoir plus, consultez le guide de l'API Route Optimization sur le routage des véhicules de grande taille.

Votre requête de backend doit spécifier travelMode: TRUCK ainsi que les attributs physiques du véhicule (hauteur, largeur, longueur, poids, nombre d'essieux et cargaison de matières dangereuses). L'API Routes renvoie un routeToken dans sa réponse, que votre serveur backend transmet à votre application mobile.

3. Respecter les exigences minimales concernant le SDK et le système

Votre application doit utiliser la version minimale requise du SDK Navigation, à savoir la version 5.4.0 ou une version ultérieure.

De plus, votre projet doit répondre aux exigences standards de configuration du SDK Navigation.

Limites et consignes opérationnelles

Avant de commencer, tenez compte des limites et des consignes opérationnelles suivantes :

• Disponibilité géographique : le routage des véhicules de grande taille est disponible dans les 48 États contigus des États-Unis (disponibilité générale) et au Japon (expérimental). Il n'est pas disponible en Alaska, à Hawaï ni dans les territoires des États-Unis.
• Conseils et sécurité pour les conducteurs : les conducteurs ne doivent pas se fier uniquement aux itinéraires renvoyés par le SDK Navigation pour garantir leur sécurité ou respecter la loi. Il est possible que les itinéraires ne soient pas adaptés au véhicule dans toutes les conditions de circulation, et les suivre pourrait exposer les conducteurs à des dangers tels que des hauteurs de passage insuffisantes ou des routes à restriction de poids. Les conducteurs doivent toujours rester vigilants et respecter les panneaux de signalisation et les réglementations locales.
• Itinéraires optimisés au mieux : lorsque l'API Routes ne trouve pas d'itinéraire entièrement conforme aux restrictions du véhicule, elle renvoie un itinéraire "optimisé au mieux" qui peut toujours traverser des segments restreints. Par exemple, l'API Routes définit l'option routeRestrictionsPartiallyIgnored dans sa réponse. Lors de la navigation sur ces itinéraires, le SDK Navigation affiche des accroches d'itinéraire pour mettre en évidence les restrictions pertinentes. Dans ce cas, planifiez soigneusement vos itinéraires et n'utilisez pas un itinéraire signalé comme source unique de vérité pour la planification ou la navigation.
• Fonctionnalités non compatibles : le routage des véhicules de grande taille n'est pas compatible avec les fonctionnalités suivantes :
  • Tarifs des péages pour les camions
  • Limitations de vitesse spécifiques aux camions ou aux véhicules lourds
  • Itinéraire pour les matières radioactives dangereuses
• Limites d'utilisation : les requêtes envoyées au SDK Navigation sont soumises aux limites d'utilisation et aux quotas standards. Pour en savoir plus, consultez Utilisation et facturation.

Afficher l'UI spécifique aux camions (accroches d'itinéraire)

Le SDK Navigation affiche automatiquement des avertissements visuels, appelés accroches d'itinéraire, sur la carte pour alerter les conducteurs des restrictions à venir concernant les camions. Les accroches s'affichent pour les restrictions qui se produisent le long de l'itinéraire planifié, mais pas sur les autres routes à proximité.

Le SDK Navigation inclut des accroches pour les restrictions suivantes :

Restriction	Icône et texte d'accroche	Conditions d'affichage
Height	Jaune = Avertissement, votre véhicule est proche de la hauteur maximale autorisée Rouge = Votre véhicule dépasse la hauteur maximale autorisée	Un encadré jaune s'affiche lorsque la hauteur du véhicule est proche de la limite. Un encadré rouge s'affiche si l'itinéraire n'est pas conforme et ne respecte pas une restriction de hauteur.
Pondération		Un texte de légende rouge s'affiche lorsque le poids du véhicule dépasse la limite de la route.
Camions interdits		Un message rouge s'affiche lorsque vous circulez sur un segment de route soumis à une restriction pour les camions.
Marchandises dangereuses		Un encadré rouge s'affiche lorsque le transport de matières dangereuses par le véhicule est interdit sur un segment de route.

Fonctionnement des jetons d'itinéraire

Un routeToken est un instantané chiffré d'un itinéraire créé par le backend de routage de Google. Il encapsule la géométrie de l'itinéraire planifié, ainsi que les dimensions physiques et le profil de restriction du véhicule.

Le workflow comprend les étapes suivantes :

1. Demander un itinéraire : votre serveur backend demande un itinéraire pour camion à l'API Routes (ou à l'API Route Optimization).
2. Recevoir le jeton : l'API Routes calcule l'itinéraire conforme et renvoie un routeToken à votre serveur backend.
3. Transférer le jeton : votre serveur backend transmet le routeToken et les coordonnées de destination à votre application mobile.
4. Transmettre au SDK : l'application mobile transmet le routeToken au SDK Navigation.
5. Démarrer le guidage : le SDK Navigation gère tous les aspects de l'expérience de navigation détaillée, y compris l'affichage des repères d'itinéraire et la gestion du changement d'itinéraire dynamique en fonction des restrictions du véhicule.

Recalculs et réacheminements dynamiques

Pendant la navigation active, les conditions de circulation, les routes fermées ou les changements de direction manqués peuvent entraîner une déviation du véhicule par rapport à l'itinéraire prévu.

Lorsqu'un nouvel itinéraire est calculé :

• Le SDK Navigation recalcule automatiquement l'itinéraire vers la destination.
• Le SDK conserve les attributs et les dimensions du véhicule encodés dans le routeToken d'origine.
• Le nouvel itinéraire recalculé évite les ponts à faible hauteur ou à charge limitée, ainsi que les routes interdites aux camions commerciaux.

Implémentation : démarrer un trajet spécifique aux camions

Suivez ces étapes pour initialiser et démarrer la navigation détaillée avec un jeton d'itinéraire pour grand véhicule.

Étape 1 : Obtenez le jeton d'itinéraire auprès de votre backend

Votre application mobile reçoit la chaîne routeToken ainsi que les coordonnées de destination de votre serveur backend. Pour savoir comment générer ce jeton sur votre serveur, consultez Générer des itinéraires et des heures d'arrivée prévues pour les véhicules de grande taille dans la documentation de l'API Routes.

Le code suivant est un exemple de jeton de route :

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

Étape 2 : Transmettre le jeton au navigateur

Transmettez les points de cheminement routeToken et de destination à la méthode mapView.navigator setDestinations.

Lorsque vous configurez des points de cheminement et transmettez le jeton d'itinéraire, tenez compte des points suivants :

• Exigence de correspondance de la destination : les coordonnées de destination transmises à setDestinations doivent correspondre aux coordonnées de destination utilisées lors de la génération de routeToken. La spécification d'une autre destination entraîne une erreur.
• Itinéraires côté route : les grands véhicules commerciaux ne peuvent pas facilement faire demi-tour dans les rues étroites. Pour vous assurer que le camion s'approche de la destination du bon côté de la route, définissez preferSameSideOfRoad = true sur vos points de cheminement.
• Arrêts du véhicule : pour guider le camion vers un emplacement approprié pour s'arrêter ou décharger, définissez vehicleStopover = true sur vos points de cheminement.
• Points de navigation : si votre destination dispose d'une entrée de fret ou d'un quai de chargement désignés, spécifiez-les à l'aide d'un jeton de point de navigation.

Étape 3 : Gérer l'état de l'itinéraire et démarrer le guidage

Évaluez le GMSRouteStatus renvoyé dans le rappel setDestinations. Lorsque l'état est .OK (GMSRouteStatusOK), définissez isGuidanceActive = true (guidanceActive = YES) pour lancer la navigation détaillée active.

Exemple de code

Transmettez le jeton de route au SDK Navigation à l'aide de la méthode mapView.navigator setDestinations, en spécifiant les mêmes points de cheminement de destination que ceux que vous avez utilisés lors de la création du jeton de route :

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

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

Écrans embarqués

Vous pouvez afficher la session de navigation pour les grands véhicules sur les écrans du tableau de bord à l'aide de la navigation pour CarPlay.

Étapes suivantes

• Modifier l'interface utilisateur de navigation : personnalisez les commandes d'interface utilisateur et les éléments visuels intégrés, tels que la boussole, le bouton de recentrage et la perspective de la caméra.
• Écouter les événements de navigation : gérez les mises à jour de navigation et les événements de cycle de vie, tels que la progression de l'itinéraire, les changements d'heure d'arrivée prévue et les changements d'itinéraire.