Questions fréquentes
Infos sur le produit
- Comment l'avis concernant les conditions d'utilisation du SDK Navigation doit-il s'afficher ?
- Dans quelles langues le guidage vocal est-il disponible ?
- Le cap est-il maintenu lorsque le conducteur quitte le mode de navigation ?
- Les polylignes sont-elles disponibles pour démarrer ou modifier un itinéraire ?
- Les utilisateurs de l'application doivent-ils avoir installé Google Maps pour mobile ?
- Le SDK Navigation peut-il identifier les parkings à proximité de restaurants et d'autres destinations ?
- Le SDK Navigation affiche-t-il le sens de circulation dans les voies à l'approche d'un point de départ ?
Problèmes
- Dans Xcode 12, les applications ne se compilent pas correctement pour le simulateur. Comment résoudre ce problème ?
GMSMapView
ne se charge pas.
Réseau
- Comment le SDK Navigation gère-t-il une mauvaise connectivité ?
- Un mode hors connexion est-il disponible ?
Données
- Puis-je récupérer tous les arrêts/destinations d'un trajet avant de le commencer ?
- La navigation détaillée est-elle disponible au début d'un itinéraire ?
- Comment l'heure d'arrivée estimée (ETA) est-elle communiquée aux utilisateurs de l'application ?
- Le
RoadSnappedLocationProvider
peut-il être utilisé pour obtenir la position ancrée actuelle du conducteur si la navigation n'est pas au premier plan ? - Le SDK Navigation est-il compatible avec le géorepérage ?
- Puis-je désactiver les notifications lorsque l'application Navigation est en arrière-plan ?
Personnalisation de l'interface utilisateur
- Puis-je appliquer un code couleur à la meilleure option d'itinéraire ?
- Le SDK Navigation peut-il afficher l'heure d'arrivée prévue pour la destination finale ?
- Comment masquer les mises à jour de l'heure d'arrivée prévue ?
- Quelles personnalisations de l'interface utilisateur sont disponibles pour les fiches d'en-tête et de pied de page ?
Routage
- Puis-je fournir un itinéraire spécifique à un conducteur ou supprimer d'autres itinéraires ?
- Puis-je présenter au conducteur un libellé différent de celui de la destination par défaut ?
- Puis-je utiliser le SDK Navigation pour suivre les déviations par rapport à un tracé défini ?
- Le conducteur peut-il quitter la navigation sans terminer l'itinéraire ?
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
surYES
. -
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
auExcluded 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:
- Récupérez la durée et la distance de tous les points de cheminement à l'aide de
Navigator.getTimeAndDistanceList()
. - 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:
- Récupérez les étapes du trajet à l'aide de
Navigator.getRouteSegments()
. - Appelez
GMSNavigator.timeToNextDestination
pour chaque étape du trajet. - Transférez les informations de temps à l'application cliente, comme vous le faites actuellement pour l'heure d'arrivée prévue du conducteur.
- Récupérez la durée et la distance de tous les points de cheminement à l'aide de
-
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
surTRUE
. - 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
.- Définissez le seuil pour déterminer la fréquence des rappels.
- 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:
- Récupérez la durée et la distance de tous les points de cheminement à l'aide de
Navigator.getTimeAndDistanceList()
. - Masquez l'heure d'arrivée prévue du point de cheminement actuel à l'aide de
NavigationFragment.setEtaCardEnabled(false)
. - Affichez l'heure d'arrivée prévue finale.
Sous iOS, utilisez le code suivant:
- Appelez
GMSNavigator.routeLegs(read)
. - Avec la dernière section, appelez
GMSNavigator.timeToNextDestination
. - Masquez l'heure d'arrivée prévue du point de cheminement actuel en utilisant
MSMapView.settings.navigationFooterEnabled=NO
sur FALSE. - Affichez l'heure d'arrivée prévue finale.
- Récupérez la durée et la distance de tous les points de cheminement à l'aide de
- 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
.
- Sous Android, utilisez
-
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 membresetHeaderEnabled
etsetFooterEnabled
deNavigationFragment
.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ésnavigationFooterEnabled
etnavigationHeaderEnabled
deGMSUISettings
.
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 leNavigationMap
.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é:- Enregistrez un écouteur qui vérifie la position de l'appareil sur l'itinéraire à l'aide de la méthode
Navigator.setRouteChangedListener
. - 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:- Sur le contrôleur de vue de la carte, implémentez les protocoles
GMSNavigatorListener
etGMSRoadSnappedLocationProviderListener
. - Implémentez
GMSNavigatorListener.navigatorDidChangeRoute
. - Accédez à la nouvelle route à l'aide des propriétés
routeLegs
etcurrentRouteLeg
deGMSNavigator
.
- Enregistrez un écouteur qui vérifie la position de l'appareil sur l'itinéraire à l'aide de la méthode
-
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éthodesimulateLocationsAlongExistingRoute
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 utiliserGMSLocationSimulator.simulateLocationsAlongExistingRoute
ouGMSLocationSimulator.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)
. Leresume intent
se déclenche lorsque l'utilisateur de l'application clique sur la notification. En règle générale, leNavigator.startguidance(getIntent())
est appelé à partir de l'activité principale, qui rappelle l'activité lorsque l'utilisateur de l'application clique sur la notification.