Le SDK Navigation pour Android ajoute des fonctionnalités de navigation au SDK Maps pour Android. Si votre application Android optimisée par Google Maps a besoin de fonctionnalités de navigation, elle doit dépendre du SDK Navigation pour Android.
Cela dit, la plupart des fonctions du SDK Maps pour Android se comportent de la même manière dans le SDK Navigation pour Android. Vous y accédez à l'aide du même package com.google.android.gms.maps, quelle que soit la dépendance du SDK que vous utilisez.
Cela signifie que si votre application dépendait auparavant du SDK Maps pour Android, vous pouvez modifier sa dépendance pour le SDK Navigation pour Android sans affecter les fonctionnalités existantes de votre application, à deux exceptions notables :
- API qui génèrent une exception.
- API qui ne fonctionnent pas dans le NavSDK et n'ont aucun impact lorsqu'elles sont appelées.
Ces exceptions sont décrites ci-dessous.
API qui génèrent une exception
La fonction suivante génère une exception si votre application l'active :
API sans fonctionnalité dans le SDK Navigation
Les API suivantes n'ont aucune fonctionnalité dans le SDK Navigation, mais n'ont pas non plus d'impact si votre code les appelle. Elles se répartissent dans les catégories suivantes :
- API pour l'activité des wearables.
- Activez plutôt le flux TBT si vous souhaitez bénéficier de cette fonctionnalité dans le SDK Navigation pour Android.
- Autres API.
API pour les wearables
GoogleMapOptions.ambientEnabled(boolean enabled) vous permet normalement d'activer ou de désactiver le mode ambiant pour les applications Wearable. De plus, les méthodes onEnterAmbient et onExitAmbient existent dans MapView et MapFragment, mais n'ont aucun impact lorsqu'elles sont appelées. Pour les accessoires connectés, utilisez plutôt le flux TBT.
Autres API
- Définir un LocationSource personnalisé n'a aucun effet dans le NavSDK.
- Toutes les API MapsInitializer.
- RuntimeRemoteException.
API destinées uniquement aux 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 :
NavigationTransactionRecorder.pickup()NavigationTransactionRecorder.dropoff()NavigationTransactionRecorder.generatedTransactionId()Navigator.fetchRouteInfo()Navigator.setTransactionIds()