Questions fréquentes

Infos produit

Réseau

Données

Personnalisation de l'interface utilisateur

Itinéraires

Simulateur

Workflows

Infos produit

Votre application doit implémenter une boîte de dialogue avec les 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 conditions d'utilisation 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 utilise 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 lancé, LocationListener continue de s'exécuter en arrière-plan. Votre application poursuit l'ancrage de la position de la route et maintient l'orientation.

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

Oui. Lorsqu'un itinéraire est créé ou modifié, le RouteChangeListener fournit des polylignes.

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

Réseau

Comment le SDK Navigation gère-t-il la mauvaise connectivité ?
Le SDK Navigation met en cache l'itinéraire pour chaque trajet. Les informations pré-mises en cache incluent les informations d'itinéraire pendant 15 à 20 minutes, ainsi que des itinéraires alternatifs si le conducteur s'écarte de celui-ci. 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, il fournit des informations en pré-cache pour un parcours.

Données

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

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. En outre, le conducteur peut parcourir la fiche d'itinéraire dans 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 ?

Dans 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 le temps 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 temporelles à l'application cliente, comme vous le faites actuellement pour l'heure d'arrivée prévue du pilote.
Le RoadSnappedLocationProvider peut-il être utilisé pour obtenir la position actuelle du conducteur si la navigation n'est pas au premier plan ?

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

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

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

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

Vous pouvez estimer 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. Lorsque la distance diminue, vous pouvez définir une valeur inférieure pour 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épôt.

Dans iOS, implémentez le délégué GMSNavigatorDelegate.didUpdateRemainingDistance pour gérer la distance entre les notifications.

Puis-je désactiver les notifications lorsque l'application Navigation est 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 les active.

Dans iOS, désactivez la notification en arrière-plan pour les lieux signalés par une route en définissant GMSRoadSnappedLocationProviderDelegate.allowsBackgroundLocationUpdates sur "NON".

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

L'enregistreur de transactions suit les lieux de prise en charge et de dépose à l'aide d'un identifiant unique, que Google enregistre pour la facturation. Pour en savoir plus, consultez les instructions de test d'implémentation pour votre plate-forme:

Pour en savoir plus sur le codage des transactions de facturation, consultez la page Transactions facturables.

Personnalisation de l'interface utilisateur

Puis-je attribuer un code couleur au meilleur itinéraire ?
Non. Le codage couleur d'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. Sous Android, utilisez les méthodes suivantes:

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

Dans iOS, utilisez le code suivant:

  1. Appelez GMSNavigator.routeLegs(read).
  2. Pour la dernière section, appelez GMSNavigator.timeToNextDestination.
  3. Masquer 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 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 la couleur d'arrière-plan. Pour masquer ou afficher l'en-tête et le pied de page, utilisez les fonctions membres setHeaderEnabled et setFooterEnabled de NavigationFragment.

Sous 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.

Itinéraires

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 l'itinéraire le plus rapide est prioritaire. Vous pouvez modifier l'itinéraire par défaut en ajoutant des préférences à votre requête, telles que "Éviter les autoroutes et les péages". L'ajout de points de cheminement affecte également l'itinéraire.
Puis-je indiquer à l'utilisateur de l'application un libellé différent de celui de l'emplacement de destination par défaut ?

Oui. Dans Android, créez un 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 écarts par rapport à un chemin 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 la route à 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 à gérer lorsque le conducteur s'éloigne de l'itinéraire prévu.

Dans iOS, utilisez GMSNavigator et ses délégués pour recevoir des notifications lorsqu'un itinéraire change ou qu'un nouvel itinéraire est recommandé:

  1. Sur le contrôleur de vue de la carte, implémentez les protocoles GMSNavigatorDelegate et GMSRoadSnappedLocationProviderDelegate.
  2. Implémentez GMSNavigatorDelegate.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 terminer 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 prend-il en charge les modifications d'itinéraire ?

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 avec 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, Navigator.startguidance(getIntent()) est appelé à partir de l'activité principale, qui le rappelle lorsque l'utilisateur de l'application clique sur la notification.