Questions fréquentes

Informations sur le produit

Réseau et connectivité

Données

Personnalisation de l'interface utilisateur

Routage

Simulateur

Workflows

Services de mobilité

Informations sur le produit

Votre application doit implémenter une boîte de dialogue avec l'avis relatif aux conditions d'utilisation du SDK Navigation que chaque utilisateur doit accepter. Cette boîte de dialogue permet à l'utilisateur d'accepter les conditions d'utilisation. Un fichier texte contenant les conditions d'utilisation est fourni avec le SDK Navigation. Utilisez la méthode NavigationApi.showTermsAndConditionsDialog pour afficher la boîte de dialogue contenant les conditions d'utilisation.
Toutes les langues acceptées par Google Maps Mobile sont automatiquement disponibles pour le SDK Navigation. Un appareil possède une langue système par défaut qu'une application ne peut pas modifier. Toutefois, l'application a accès à plus de 70 langues.

Oui. Une fois démarré, LocationListener continue de s'exécuter en arrière-plan. Votre application continue d'accrocher la position à la route et de conserver le cap.

Oui. Lorsqu'un itinéraire est créé ou modifié, 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 propose pas cette fonctionnalité pour le moment.
Oui. Le sens de circulation est disponible et affiché par défaut.
Quelles versions du JDK sont compatibles avec le SDK Navigation ?
Le SDK Navigation est compatible avec les versions LTS de Java SE qui sont activement prises en charge par Oracle. Ces versions sont listées comme bénéficiant de l'assistance Premier sur la feuille de route de la compatibilité de Java SE avec Oracle.

Réseau et connectivité

Comment le SDK Navigation gère-t-il une mauvaise connectivité réseau ?
Le SDK Navigation prémet en cache l'itinéraire de chaque trajet. Les informations pré-mises en cache incluent les informations de routage pour 15 à 20 minutes, ainsi que des itinéraires alternatifs au cas où l'utilisateur s'écarte de l'itinéraire. Le SDK Navigation estime la position à l'aide du GPS et des capteurs de l'appareil.
Comment le SDK Navigation gère-t-il les signaux GPS faibles ou perdus ?

Une fois la navigation lancée et le SDK Navigation ayant reçu un signal GPS au moins une fois, le message "Recherche du signal GPS..." s'affiche dans les situations suivantes :

  • Si plus de 10 secondes se sont écoulées depuis la dernière réception d'un signal GPS.
  • Si la position de routage a changé de plus de 500 mètres depuis la dernière réception d'un signal GPS.

Si le SDK ne reçoit pas de signal GPS pendant une période prolongée, la progression le long de l'itinéraire, indiquée dans l'application par la position du chevron, peut ralentir jusqu'à s'arrêter complètement. Dans ce cas, le chevron sur la carte restera à l'emplacement indiqué par le dernier signal GPS. Le SDK ne quitte pas automatiquement le mode navigation en l'absence de signal GPS. Toutefois, il est possible qu'il ne puisse pas fournir d'indications tant qu'il n'aura pas reçu de nouveau signal.

Existe-t-il un mode hors connexion ?
Non, le SDK Navigation ne propose pas de mode hors connexion pour le moment. Toutefois, il fournit des informations pré-mises en cache pour un trajet.

Données

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

Oui. Pour récupérer l'itinéraire d'un trajet, appelez Navigator.getRouteSegments().

Le guidage routier détaillé est-il disponible au début d'un itinéraire ?
Oui. Le SDK Navigation fournit une liste de segments de route. L'utilisateur peut également balayer la fiche d'itinéraire dans l'en-tête pour voir chaque manœuvre.
Comment le temps estimé à l'arrivée est-il communiqué aux utilisateurs de l'application ?

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

  1. Récupérez la durée et la distance pour tous les points de cheminement à l'aide de Navigator.getTimeAndDistanceList().
  2. Transmettez ces informations à l'application cliente, comme vous le faites pour l'estimation de l'heure d'arrivée du chauffeur.
Le RoadSnappedLocationProvider peut-il être utilisé pour obtenir la position actuelle de l'utilisateur si la navigation n'est pas au premier plan ?

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

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 zone géographique. Il est possible que la géocible ne tienne pas compte de la géométrie des routes et qu'elle ne soit pas centrée sur le point exact vers lequel l'utilisateur se dirige.

Vous pouvez approximer 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 définir un seuil plus petit pour recevoir des rappels plus fréquents. Ensuite, vérifiez la distance restante pour déterminer si vous êtes suffisamment proche du lieu de prise en charge ou de dépose.

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

Oui. Utilisez Navigator.setHeadsUpNotificationEnabled pour contrôler les notifications. Cette méthode comporte un argument booléen. FALSE désactive les notifications, tandis que TRUE les active.

L'enregistreur de transactions suit les collectes et les déposes avec un identifiant unique, que Google enregistre à des fins d'analyse des produits. Si vous êtes client Mobility Services, Google vous recommande d'implémenter NavigationTransactionRecorder pour enregistrer vos transactions.

Personnalisation de l'interface utilisateur

Puis-je attribuer un code couleur à la meilleure option d'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 à la destination finale ?

Oui. Utilisez les méthodes suivantes :

  1. Récupérez la durée et la distance pour tous les points de cheminement à l'aide de Navigator.getTimeAndDistanceList().
  2. Masquez l'heure d'arrivée prévue du point de repère actuel à l'aide de NavigationFragment.setEtaCardEnabled(false).
  3. Affichez l'heure d'arrivée prévue à la destination finale.
Comment masquer les mises à jour de l'heure d'arrivée estimée ?

Vous pouvez désactiver les cartes d'estimation de l'heure d'arrivée en appelant navigationView.setEtaCardEnabled(false).

Quelles personnalisations de l'UI sont disponibles pour les cartes d'en-tête et de pied de page ?

Utilisez StylingOptions pour définir le style de 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.

Routage

Puis-je fournir un itinéraire spécifique à un utilisateur ou supprimer des itinéraires alternatifs ?
Non. Par défaut, plusieurs itinéraires sont proposés 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, comme "éviter les autoroutes et les péages". L'ajout de points de repère affecte également l'itinéraire.
Puis-je afficher un libellé différent pour la destination de l'utilisateur de l'application par rapport à la destination par défaut ?

Oui. 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 NavigationMap.

Puis-je utiliser le SDK Navigation pour suivre les écarts par rapport à un itinéraire défini ?

Oui. 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 les informations actualisées sur l'heure d'arrivée prévue et la distance.
    • Suivre la position de l'appareil
    • [facultatif] Ajoutez d'autres fonctionnalités requises par votre application pour gérer les cas où l'utilisateur s'écarte de l'itinéraire prescrit.
L'utilisateur peut-il quitter la navigation sans terminer l'itinéraire ?

Oui. Appelez la méthode Navigator.stopGuidance() pour arrêter la navigation.

Simulateur

Le simulateur est-il compatible avec les changements d'itinéraire ?

Oui. Appelez simulateLocationsAlongNewRoute pour simuler un trajet incluant un changement d'itinéraire. La méthode simulateLocationsAlongExistingRoute ignore les modifications apportées à la route existante.

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). L'événement 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 rappelle l'activité lorsque l'utilisateur de l'application clique sur la notification.

Services de mobilité

En quoi l'utilisation du SDK Navigation est-elle différente pour les clients des services de mobilité ?

Les services de mobilité Google Maps Platform proposent un ensemble d'API et de SDK pour répondre aux besoins des entreprises de transport et de logistique. Pour les clients Mobility Services, le SDK Navigation est généralement utilisé en association avec des services associés pour l'optimisation des itinéraires, la répartition, le suivi des tâches, l'analyse du parc automobile et plus encore. Le SDK Navigation est également facturé différemment pour les clients Mobility Services. Pour en savoir plus, consultez la documentation Mobility Services.

Les produits de mobilité ne sont actuellement disponibles que pour certains clients. Pour en savoir plus, contactez votre conseiller commercial.

Comment savoir si je suis client des services de mobilité ?
Si vous n'êtes pas sûr d'implémenter actuellement le SDK Navigation en tant que client Mobility Services, recherchez un appel ReportBillableEvent dans votre code. Seuls les clients Mobility Services doivent appeler la méthode ReportBillableEvent.

Comment le SDK Navigation est-il facturé aux clients Mobility Services ?
Pour les clients Mobility Services, la facturation et les tarifs du SDK Navigation dépendent du contrat de service que vous avez conclu avec Google Maps Platform. Pour savoir comment vérifier que l'implémentation de vos services de mobilité est facturée correctement, consultez la section Validation de la facturation. Pour en savoir plus sur la facturation des services de mobilité, contactez votre conseiller commercial.

Quelles API Navigation SDK ne doivent être utilisées que par les clients des services de mobilité ?

Le SDK Navigation contient plusieurs API qui sont uniquement destinées aux clients Mobility Services, qui sont facturés par Google par transaction. Si vous n'êtes pas client de Mobility Services, les méthodes suivantes sont des no-ops :

Si je suis client Mobility Services, puis-je également utiliser une implémentation non Mobility Services du SDK Navigation ?

Oui, les clients Mobility Services peuvent utiliser les implémentations Mobility Services et non Mobility Services du SDK Navigation. Toutefois, vous ne pouvez utiliser qu'un seul type d'implémentation à la fois dans une application. Vous devez également créer un compte de facturation, un projet Google Cloud et une clé API distincts de ceux que vous utilisez avec votre implémentation Mobility Services. Pour en savoir plus, consultez la présentation de la configuration du SDK Navigation.

Pour en savoir plus sur l'utilisation d'une implémentation du SDK Navigation autre que Mobility Services, y compris sur la migration d'une application d'un type d'implémentation à un autre, contactez votre responsable de compte Google.

Remarque : Si vous n'êtes pas encore client des services de mobilité et que vous souhaitez en savoir plus sur la collection d'API et de SDK des services de mobilité, contactez l'équipe commerciale Google Maps Platform.