Questions fréquentes

Infos sur le produit

Problèmes

Réseau

Données

Personnalisation de l'interface utilisateur

Routage

Simulateur

Workflows

Infos sur le produit

Votre application doit implémenter une boîte de dialogue contenant la notification des conditions d'utilisation du SDK Navigation que chaque conducteur doit accepter. Cette boîte de dialogue permet au conducteur d'accepter les conditions d'utilisation. Un fichier texte contenant les termes est fourni avec le SDK Navigation.
Dans Android, utilisez la méthode NavigationApi.showTermsAndConditionsDialog pour afficher la boîte de dialogue contenant les termes.
Dans iOS, appelez GMSNavigationServices.showTermsAndConditionsDialogIfNeededWithCompanyName.
Toutes les langues compatibles avec Google Maps pour mobile sont automatiquement disponibles pour le SDK Navigation. Un appareil dispose d'une langue système par défaut et une application ne peut pas modifier ce paramètre. Toutefois, l'application a accès à plus de 70 langues.

Oui. Dans Android, une fois démarré, le LocationListener continue de s'exécuter en arrière-plan. Votre application continue à ajuster la position de la route et maintient l'orientation.

Dans iOS, pour continuer à recevoir des mises à jour de position et d'orientation en arrière-plan, implémentez l'ancrage de la route et définissez allowsBackgroundLocationUpdates sur YES.

Oui. Lorsqu'une route est créée ou modifiée, RouteChangeListener fournit des polylignes.

Non, le SDK Navigation ne nécessite pas l'installation de Google Maps Mobile sur l'appareil.
Non, le SDK Navigation ne fournit pas cette fonctionnalité pour le moment.
Oui. Le sens de circulation est disponible et affiché par défaut.

Problèmes

Dans Xcode 12, les applications ne se compilent pas correctement pour le simulateur. Comment résoudre ce problème ?

Pour résoudre ce problème, ouvrez les paramètres "Build Settings" de votre projet Xcode et ajoutez arm64 au Excluded Architectures pour les builds "iOS Simulator" uniquement.

Pour plus d'informations, consultez ce fil de discussion StackOverflow.

GMSMapView ne se charge pas.

Si GMSMapView ne se charge pas:

  • Vérifiez que NavSDK est activé dans la console Cloud.
  • Si le SDK Nav est installé, mais que votre projet n'utilise pas les API du SDK Nav, supprimez-le du binaire.

Réseau

Comment le SDK Navigation gère-t-il une mauvaise connectivité ?
Le SDK Navigation met en pré-cache l'itinéraire pour chaque trajet. Les informations mises en pré-cache incluent des informations d'itinéraire pendant 15 à 20 minutes, ainsi que des itinéraires alternatifs au cas où le conducteur s'écarte de l'itinéraire. Le SDK Navigation détermine la position approximative à l'aide du GPS et des capteurs de l'appareil.
Un mode hors connexion est-il disponible ?
Non, le SDK Navigation ne propose pas de mode hors connexion pour le moment. Toutefois, le SDK fournit des informations mises en pré-cache pour les trajets.

Données

Puis-je récupérer tous les arrêts/destinations d'un trajet avant de le commencer ?

Oui. Dans Android, pour récupérer l'itinéraire d'un itinéraire, appelez Navigator.getRouteSegments().

Dans iOS, appelez GMSNavigator.routeLegs(read).

La navigation détaillée est-elle disponible au début d'un itinéraire ?
Oui. Le SDK Navigation fournit une liste de segments d'itinéraire. De plus, le conducteur peut faire défiler la carte d'itinéraire de l'en-tête pour voir chaque manœuvre.
Comment l'heure d'arrivée prévue est-elle communiquée aux utilisateurs de l'application ?

Sous Android, procédez comme suit pour fournir des informations sur l'heure d'arrivée prévue aux utilisateurs de l'application:

  1. Récupérez la durée et la distance de tous les points de cheminement à l'aide de Navigator.getTimeAndDistanceList().
  2. Transférez ces informations à l'application cliente, comme vous le faites actuellement pour l'heure d'arrivée prévue du conducteur.

Sous iOS, procédez comme suit pour fournir des informations sur l'heure d'arrivée prévue aux utilisateurs de l'application:

  1. Récupérez les étapes du trajet à l'aide de Navigator.getRouteSegments().
  2. Appelez GMSNavigator.timeToNextDestination pour chaque étape du trajet.
  3. Transférez les informations de temps à l'application cliente, comme vous le faites actuellement pour l'heure d'arrivée prévue du conducteur.
Le RoadSnappedLocationProvider peut-il être utilisé pour obtenir la position fixe actuelle du conducteur si la navigation n'est pas au premier plan ?

Oui. Dans Android, RoadSnappedLocationProvider s'exécute par défaut en arrière-plan.

Dans iOS, pour que la navigation continue de s'exécuter en arrière-plan, implémentez l'écouteur pour GMSRoadSnappedLocationProviderListener et définissez la propriété allowsBackgroundLocationUpdates sur TRUE.

Le SDK Navigation est-il compatible avec le géorepérage ?

Non. Dans le contexte de la navigation, remainingTimeOrdistanceChangeListener présente un avantage par rapport à une simple zone de géorepérage. Il est possible que la zone de géorepérage ne prenne pas en compte la géométrie de la route et qu'elle ne soit pas centrée sur le point exact vers lequel le conducteur se dirige.

Vous pouvez obtenir une approximation de cette fonctionnalité à l'aide de remainingTimeOrdistanceChangeListener.

  1. Définissez le seuil pour déterminer la fréquence des rappels.
  2. Vérifiez la distance restante jusqu'à la destination.

Par exemple, si vous définissez le seuil sur 100 m, vous recevez un rappel lorsque la distance jusqu'à la destination change de 100 m. À mesure que la distance diminue, vous pouvez réduire ce seuil et recevoir des rappels plus fréquents. Examinez ensuite la distance restante pour déterminer si vous êtes suffisamment proche du lieu de prise en charge/dépose.

Dans iOS, implémentez l'écouteur GMSNavigatorListener.didUpdateRemainingDistance pour gérer la distance entre les notifications.

Puis-je désactiver les notifications lorsque l'application Navigation est exécutée en arrière-plan ?

Oui. Dans Android, utilisez Navigator.setHeadsUpNotificationEnabled pour contrôler les notifications. Cette méthode comporte un argument booléen. FALSE désactive les notifications ; TRUE active les notifications.

Dans iOS, désactivez les notifications en arrière-plan pour les emplacements avec signalement de la route en définissant GMSRoadSnappedLocationProvider.allowsBackgroundLocationUpdates sur NO.

Pour désactiver le traitement en arrière-plan pour d'autres notifications de localisation, appelez GMSNavigator.sendsBackgroundNotifications(NO).

Personnalisation de l'interface utilisateur

Puis-je appliquer un code couleur au meilleur itinéraire ?
Non. Le codage couleur pour une option d'itinéraire spécifique n'est pas disponible pour le moment.
Le SDK Navigation peut-il afficher l'heure d'arrivée prévue pour la destination finale ?

Oui. Dans Android, utilisez les méthodes suivantes:

  1. Récupérez la durée et la distance de tous les points de cheminement à l'aide de Navigator.getTimeAndDistanceList().
  2. Masquez l'heure d'arrivée prévue du point de cheminement actuel à l'aide de NavigationFragment.setEtaCardEnabled(false).
  3. Affichez l'heure d'arrivée prévue finale.

Sous iOS, utilisez le code suivant:

  1. Appelez GMSNavigator.routeLegs(read).
  2. Avec la dernière section, appelez GMSNavigator.timeToNextDestination.
  3. Masquez l'heure d'arrivée prévue du point de cheminement actuel en utilisant MSMapView.settings.navigationFooterEnabled=NO sur FALSE.
  4. Affichez l'heure d'arrivée prévue finale.
Comment masquer les mises à jour de l'heure d'arrivée prévue ?

Vous pouvez désactiver les cartes d'heure d'arrivée prévue à l'aide des méthodes suivantes:

  • Sous Android, utilisez navigationView.setEtaCardEnabled(false).
  • Sous iOS, utilisez GMSMapView.settings.navigationFooterEnabled=NO.
Quelles personnalisations de l'interface utilisateur sont disponibles pour les fiches d'en-tête et de pied de page ?

Dans Android, vous utilisez StylingOptions pour définir le style de couleur de l'arrière-plan. Pour masquer ou afficher l'en-tête et le pied de page, utilisez les fonctions de membre setHeaderEnabled et setFooterEnabled de NavigationFragment.

Dans iOS, utilisez GMSMapView.settings.navigationHeaderPrimaryBackgroundColor pour définir le style de la couleur d'arrière-plan. Pour masquer ou afficher l'en-tête et le pied de page, utilisez les propriétés navigationFooterEnabled et navigationHeaderEnabled de GMSUISettings.

Routage

Puis-je fournir un itinéraire spécifique à un conducteur ou supprimer d'autres itinéraires ?
Non. Par défaut, plusieurs routes sont fournies, et la route la plus rapide est prioritaire. Vous pouvez modifier l'itinéraire par défaut en ajoutant des préférences à votre requête (par exemple, "Éviter les autoroutes et les péages"). L'ajout de points de cheminement affecte également l'itinéraire.
Puis-je présenter à l'utilisateur de l'application un libellé différent de celui de l'emplacement de destination par défaut ?

Oui. Dans Android, créez une Marker avec un titre personnalisé pour la destination et la latitude/longitude. Le SDK Navigation affiche le titre personnalisé et les coordonnées sur le NavigationMap.

Dans iOS, vous créez et affichez un GMSMarker pour la destination.

Puis-je utiliser le SDK Navigation pour suivre les déviations par rapport à un tracé défini ?

Oui. Dans Android, utilisez Navigator.setRouteChangedListener pour recevoir des notifications lorsqu'un itinéraire change ou qu'un nouvel itinéraire est recommandé:

  1. Enregistrez un écouteur qui vérifie la position de l'appareil sur l'itinéraire à l'aide de la méthode Navigator.setRouteChangedListener.
  2. Ajoutez du code au gestionnaire d'événements de rappel, onRouteChanged :
    • Envoyez un message à l'utilisateur de l'application avec des informations actualisées sur l'heure d'arrivée prévue et la distance.
    • Suivez la position de l'appareil.
    • [Facultatif] Ajoutez d'autres fonctionnalités requises par votre application pour gérer le conducteur qui quitte l'itinéraire prescrit.

Dans iOS, utilisez GMSNavigator et ses écouteurs pour recevoir des notifications lorsqu'une route change ou qu'une nouvelle route est recommandée:

  1. Sur le contrôleur de vue de la carte, implémentez les protocoles GMSNavigatorListener et GMSRoadSnappedLocationProviderListener.
  2. Implémentez GMSNavigatorListener.navigatorDidChangeRoute.
  3. Accédez à la nouvelle route à l'aide des propriétés routeLegs et currentRouteLeg de GMSNavigator.
Le conducteur peut-il quitter la navigation sans avoir terminé l'itinéraire ?

Oui. Dans Android, appelez la méthode Navigator.stopGuidance() pour arrêter la navigation.

Dans iOS, appelez GMSNavigator.clearDestinations.

Simulateur

Le simulateur est-il compatible avec les modifications d'itinéraires ?

Oui. Dans Android, appelez simulateLocationsAlongNewRoute pour simuler un trajet comprenant un changement d'itinéraire. La méthode simulateLocationsAlongExistingRoute ignore les modifications apportées à la route existante.

Dans iOS, utilisez GMSLocationSimulator.simulateAlongNewRouteToDestinations pour simuler un trajet comprenant un changement d'itinéraire. Si vous ne prévoyez aucun changement d'itinéraire, vous pouvez utiliser GMSLocationSimulator.simulateLocationsAlongExistingRoute ou GMSLocationSimulator.simulateAlongNewRouteToDestinations.

Workflows

Comment ignorer la notification après avoir fermé une activité contenant un fragment de navigation ?

La notification de navigation reste visible pendant la navigation, lorsque l'activité est fermée. Lorsque le véhicule arrive à destination, la navigation s'arrête et la notification disparaît.

Pour gérer les clics sur la notification, utilisez Navigator.startGuidance(intent resumeIntent). Le resume intent se déclenche lorsque l'utilisateur de l'application clique sur la notification. En règle générale, le Navigator.startguidance(getIntent()) est appelé à partir de l'activité principale, qui rappelle l'activité lorsque l'utilisateur de l'application clique sur la notification.