Un flux de données de navigation détaillée fournit uniquement des informations de navigation aux appareils non conçu pour le guidage de navigation basé sur une carte. Il fournit aux manœuvres à venir que vous fournissez:
- Icônes (gauche, droite, demi-tour)
- tournez les numéros sur les ronds-points
- noms des routes
- les distances et la durée estimées avant la prochaine étape de navigation ou la dernière destination
Vous pouvez utiliser le flux détaillé pour créer des expériences où les utilisateurs L'interface du SDK Navigation n'est pas appropriée (par exemple, pour Android Auto ou pour les lorsqu'aucune pile Android complète n'est disponible. Par exemple : vous pourriez l'utiliser pour les conducteurs de deux-roues, où vous pouvez projeter des conseils de navigation pour les aider à atteindre leur destination plus rapidement et plus encore en toute confiance avec le moins de distractions possible.
Pour utiliser le SDK, vous devez créer un service et l'enregistrer auprès du SDK Navigation pour Android afin de recevoir de nouvelles informations de navigation en temps réel (environ une fois par seconde pendant la navigation).
Ce document explique comment créer et enregistrer un service de navigation qui reçoit les informations de navigation du SDK et fournit l'état de navigation à l'appareil récepteur.
Présentation
Cette section explique comment ajouter la bibliothèque TurnByTurn à vos projets et résume le processus général de création d'une fonctionnalité de navigation détaillée.
Ajouter la bibliothèque TurnByTurn à votre projet à l'aide de Maven (recommandé)
Pour utiliser une version autonome de la bibliothèque TurnByTurn, procédez comme suit:
- Configurez votre environnement pour accéder au dépôt Maven de l'hôte:
<ph type="x-smartling-placeholder">
</ph> Maven
Ajoutez le code ci-dessous à votre fichier
pom.xml
:<project> ... <repositories> <repository> <id>google-maven-repository</id> <url>https://maven.google.com</url> </repository> </repositories> ... </project>
Gradle
Ajoutez le code ci-dessous à votre fichier
build.gradle
:repositories { ... google() }
Ajoutez la dépendance suivante à votre configuration Maven ou Gradle:
-
Maven
<dependencies> ... <dependency> <groupId>com.google.android.maps</groupId> <artifactId>google_turnbyturn</artifactId> <version>1.0.0</version> </dependency> </dependencies>
Gradle
dependencies { ... implementation 'com.google.android.maps:google_turnbyturn:1.0.0' }
Ajouter la bibliothèque TurnByTurn à votre projet en utilisant un fichier JAR téléchargé (alternative)
La bibliothèque TurnByTurn est disponible sous forme de fichier JAR dans ce dossier SDK. Si ce n'est pas le cas, contactez votre représentant.
- Téléchargez et décompressez
google_turnbyturn_*.jar
. - Copiez le fichier JAR téléchargé dans le répertoire
app/libs
de votre projet. Ajoutez les éléments suivants à votre fichier
build.gradle
pour inclure le fichier JAR dans votre build.dependencies { ... api fileTree(include: ['*.jar'], dir: 'libs') }
Utiliser la bibliothèque TurnByTurn
Vous trouverez ci-dessous les principales étapes à suivre pour activer la fonctionnalité de navigation détaillée. La qui suivent fournissent des informations sur chaque étape.
Créez un service pour recevoir des informations sur la navigation.
Consultez un exemple d'affichage de navigation qui montre les éléments essentiels.
Créer un service pour recevoir des informations sur la navigation
Le SDK Navigation se lie à votre service TurnByTurn et et lui envoie des mises à jour de navigation via l'application Android Chat + pour en savoir plus. Vous pouvez créer un service de navigation pour ces mises à jour ou utiliser un service existant Google Cloud.
L'avantage d'utiliser un service pour recevoir des mises à jour de navigation est que le service peut se trouver dans un processus d'arrière-plan distinct.
Dans l'exemple suivant, le service reçoit des informations de navigation et utilise
TurnByTurnManager
pour convertir les données en un objet NavInfo
qui
contenant les détails de navigation.
/** * Receives turn-by-turn navigation information forwarded from NavSDK. */ public class NavInfoReceivingService extends Service { /** The messenger used by the service to receive nav step updates. */ private Messenger incomingMessenger; private TurnByTurnManager turnByTurnManager; private final class IncomingNavStepHandler extends Handler { public IncomingNavStepHandler(Looper looper) { super(looper); } @Override public void handleMessage(Message msg) { // Identify the message through the msg.what field. if (TurnByTurnManager.MSG_NAV_INFO == msg.what) { // Extract the NavInfo object using the TurnByTurnManager. NavInfo navInfo = turnByTurnManager .readNavInfoFromBundle(msg.getData())); // Do something with the NavInfo } } } @Nullable @Override public IBinder onBind(Intent intent) { return incomingMessenger.getBinder(); } @Override public void onCreate() { turnByTurnManager = TurnByTurnManager.createInstance(); HandlerThread thread = new HandlerThread("NavInfoReceivingService", Process.THREAD_PRIORITY_DEFAULT); thread.start(); incomingMessenger = new Messenger( new IncomingNavStepHandler(thread.getLooper())); }
Codes des messages
Les messages NavInfo
peuvent être identifiés via le
Message.what
de la classe Message
, qui est défini sur la valeur de
TurnByTurnManager.MSG_NAV_INFO
Enregistrer le service pour les mises à jour de la navigation
L'extrait de code suivant enregistre le service de navigation.
boolean isNavInfoReceivingServiceRegistered = navigator.registerServiceForNavUpdates( getPackageName(), NavInfoReceivingService.class.getName(), numNextStepsToPreview);
Démarrer et arrêter le service
Le service de navigation est actif tant que le
Le SDK Navigation s'y lie. Vous pouvez appeler manuellement
startService()
et stopService()
pour contrôler la durée de service de la navigation.
mais lorsque vous enregistrez votre service
le SDK Navigation, votre service démarre automatiquement et
ne s'arrête que lorsque vous annulez l'enregistrement. Selon la configuration de votre application, vous pouvez
vous pouvez envisager de démarrer un service de premier plan, décrit dans le
documentation Services
présentation.
Annuler l'enregistrement du service
Pour ne plus recevoir de notifications de navigation, annulez l'enregistrement du service dans SDK Navigation.
navigator.unregisterServiceForNavUpdates();
Comprendre les états de navigation
Utilisez NavInfo.getNavState()
pour obtenir l'état actuel de la navigation, à savoir
des éléments suivants:
En route : l'état
ENROUTE
signifie que la navigation guidée est actuellement actif et l'utilisateur sur la route fournie. Informations sur la la prochaine étape est disponible.Nouveau calcul d'itinéraire :
REROUTING
signifie que la navigation est en cours, mais que la recherche un nouvel itinéraire. La prochaine étape n'est pas disponible, car il n'y a pas encore de nouvel itinéraire. Dans l'application exemple, le message "Rerouter..." (Reroutage...) s'affiche dans l'affichage des informations de navigation. Une fois qu'une route est trouvée, un messageNavInfo
est envoyé avec l'étatENROUTE
.Arrêtée :
STOPPED
signifie que la navigation est terminée. Par exemple, la navigation s'arrête lorsque l'utilisateur quitte la navigation dans l'application. Dans l'application exemple, L'étatSTOPPED
efface l'affichage des informations de navigation pour éviter que l'étape ne se prolonge les instructions ne s'affichent pas.
Remplir l'affichage du flux
Maintenant que vous avez configuré votre service de navigation détaillée, cette section aborde les visuels et textuels que vous pouvez utiliser pour remplir les fiches d'aide flux détaillé.
Champs d'informations de la carte de navigation
Lorsque l'utilisateur entre dans la navigation guidée, une carte de navigation apparaît en haut, contenant des données de navigation SDK Navigation. L'image associée montre un exemple ces éléments de navigation essentiels.
Ce tableau présente les champs des informations de navigation et leur emplacement.
Champs pour chaque étape de navigation | Champs pour le trajet global |
---|---|
Trouvé dans StepInfo |
Trouvé dans NavInfo |
Nom complet de la route | Temps restant |
Icône de manœuvre | Distance jusqu'à la destination |
Distance jusqu'à l'étape suivante | |
Champs d'indication de voie |
Indication de voie
Le SDK Navigation représente les voies dans la navigation
activer et désactiver
Voie
et
LaneDirection
objets de données. Un objet Lane
représente une voie spécifique pendant la navigation.
contient une liste d'objets LaneDirection
décrivant tous les changements de direction
faite à partir de cette voie.
La direction recommandée à l'utilisateur sur une voie est indiquée par le isRecommended .
Exemple d'indication de voie
L'extrait de code suivant illustre la représentation des données des voies affichées ci-dessus.
// Lane 1
LaneDirections = [{/*laneShape=*/ STRAIGHT, /*isRecommended=*/ false},
{/*laneShape=*/ SLIGHT_LEFT, /*isRecommended=*/ true}]
// Lane 2
LaneDirections = [{/*laneShape=*/ STRAIGHT, /*isRecommended=*/ false}]
Créer des icônes pour les manœuvres
La
Maneuver
définit chaque manœuvre pouvant se produire pendant la navigation, et vous
peut obtenir la manœuvre d'une étape donnée à partir de la méthode StepInfo.getManeuver()
.
Vous devez créer des icônes de manœuvre et les associer aux manœuvres qui leur sont associées.
Pour certaines manœuvres, vous pouvez définir un mappage "un à un" avec une icône, par exemple
DESTINATION_LEFT
et DESTINATION_RIGHT
. Cependant, puisque certaines
manœuvres sont
similaire, vous pouvez mapper plusieurs manœuvres
à une seule icône. Pour
Par exemple, TURN_LEFT
et ON_RAMP_LEFT
peuvent tous deux correspondre à l'icône de virage à gauche.
Certaines manœuvres contiennent un libellé clockwise
ou counterclockwise
supplémentaire,
que le SDK détermine en fonction
du côté conducteur d'un pays. Par exemple, dans
pays où la conduite se fait du côté gauche de la route, les conducteurs prennent
sur un rond-point ou en demi-tour dans le sens des aiguilles d'une montre,
les pays tournent dans le sens des aiguilles d'une montre. Le SDK Navigation détecte
si une manœuvre se produit dans le trafic de gauche ou de droite et génère la valeur
la manœuvre appropriée. Par conséquent, l'icône de manœuvre peut être différente pour chaque fonction.
dans le sens des aiguilles d'une montre et
dans le sens inverse des aiguilles d'une montre.
Développer pour voir des exemples d'icônes pour différentes manœuvres
Icône d'exemple | Manœuvres de tour par tour |
---|---|
![]() |
DEPART UNKNOWN |
![]() |
STRAIGHT ON_RAMP_UNSPECIFIED OFF_RAMP_UNSPECIFIED NAME_CHANGE
|
![]() |
TURN_RIGHT ON_RAMP_RIGHT
|
![]() |
TURN_LEFT ON_RAMP_LEFT
|
![]() |
TURN_SLIGHT_RIGHT ON_RAMP_SLIGHT_RIGHT OFF_RAMP_SLIGHT_RIGHT
|
![]() |
TURN_SLIGHT_LEFT ON_RAMP_SLIGHT_LEFT OFF_RAMP_SLIGHT_LEFT
|
![]() |
TURN_SHARP_RIGHT ON_RAMP_SHARP_RIGHT OFF_RAMP_SHARP_RIGHT
|
![]() |
TURN_SHARP_LEFT ON_RAMP_SHARP_LEFT OFF_RAMP_SHARP_LEFT
|
![]() |
TURN_U_TURN_COUNTERCLOCKWISE ON_RAMP_U_TURN_COUNTERCLOCKWISE OFF_RAMP_U_TURN_COUNTERCLOCKWISE
|
![]() |
TURN_U_TURN_CLOCKWISE ON_RAMP_U_TURN_CLOCKWISE OFF_RAMP_U_TURN_CLOCKWISE
|
![]() |
ROUNDABOUT_SHARP_RIGHT_COUNTERCLOCKWISE
|
![]() |
ROUNDABOUT_SHARP_RIGHT_CLOCKWISE
|
![]() |
ROUNDABOUT_RIGHT_COUNTERCLOCKWISE
|
![]() |
ROUNDABOUT_RIGHT_CLOCKWISE
|
![]() |
ROUNDABOUT_SLIGHT_RIGHT_COUNTERCLOCKWISE
|
![]() |
ROUNDABOUT_SLIGHT_RIGHT_CLOCKWISE
|
![]() |
ROUNDABOUT_STRAIGHT_COUNTERCLOCKWISE
|
![]() |
ROUNDABOUT_STRAIGHT_CLOCKWISE
|
![]() |
ROUNDABOUT_SLIGHT_LEFT_COUNTERCLOCKWISE
|
![]() |
ROUNDABOUT_SLIGHT_LEFT_CLOCKWISE
|
![]() |
ROUNDABOUT_LEFT_COUNTERCLOCKWISE
|
![]() |
ROUNDABOUT_LEFT_CLOCKWISE
|
![]() |
ROUNDABOUT_SHARP_LEFT_COUNTERCLOCKWISE
|
![]() |
ROUNDABOUT_SHARP_LEFT_CLOCKWISE
|
![]() |
ROUNDABOUT_U_TURN_COUNTERCLOCKWISE
|
![]() |
ROUNDABOUT_U_TURN_CLOCKWISE
|
![]() |
ROUNDABOUT_COUNTERCLOCKWISE
|
![]() |
ROUNDABOUT_CLOCKWISE
|
![]() |
ROUNDABOUT_EXIT_COUNTERCLOCKWISE
|
![]() |
ROUNDABOUT_EXIT_CLOCKWISE
|
![]() |
MERGE_RIGHT OFF_RAMP_RIGHT
|
![]() |
MERGE_LEFT OFF_RAMP_LEFT
|
![]() |
FORK_RIGHT TURN_KEEP_RIGHT ON_RAMP_KEEP_RIGHT OFF_RAMP_KEEP_RIGHT
|
![]() |
FORK_LEFT TURN_KEEP_LEFT ON_RAMP_KEEP_LEFT OFF_RAMP_KEEP_LEFT
|
![]() |
MERGE_UNSPECIFIED
|
![]() |
DESTINATION
|
![]() |
DESTINATION_RIGHT
|
![]() |
DESTINATION_LEFT
|
![]() |
FERRY_BOAT
|
![]() |
FERRY_TRAIN
|
Utiliser des icônes générées
Pour faciliter les cas d'utilisation d'Android Auto, Le SDK Navigation permet de générer des manœuvres et des voies des icônes de guidage. Ces icônes correspondent aux conseils de taille d'image d'Android Auto Bibliothèque Car App, qui recommande de cibler un cadre de délimitation de 500 x 74 dp. Voir setsLaneImage et CarIcon dans la documentation de référence Android.
Exemple de génération d'icônes
NavigationUpdatesOptions options =
NavigationUpdatesOptions.builder()
.setNumNextStepsToPreview(numNextStepsToPreview)
.setGeneratedStepImagesType(GeneratedStepImagesType.BITMAP)
.setDisplayMetrics(getResources().getDisplayMetrics())
.build();
boolean isRegistered =
navigator.registerServiceForNavUpdates(
getPackageName(),
NavInfoReceivingService.class.getName(),
options);
Une fois que vous avez activé la génération d'icônes, l'objet StepInfo
TurnbyTurn remplit le champ
Champs maneuverBitmap et lanesBitmap avec les icônes.
Étape suivante
- Pour les applications Android Auto: