Le SDK Navigation pour Android ajoute des fonctionnalités de navigation au SDK Maps pour Android. Si votre application Android basée sur Google Maps nécessite des 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 remplacer cette dépendance par le SDK Navigation pour Android sans affecter les fonctionnalités existantes de votre application, à deux exceptions notables près :
- API qui génèrent une exception.
- API qui ne fonctionnent pas dans le SDK Navigation 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 accessoires connectés.
- Activez plutôt le flux de navigation détaillée si vous souhaitez bénéficier de cette fonctionnalité dans le SDK Navigation pour Android.
- Autres API.
API pour les accessoires connectés
GoogleMapOptions.ambientEnabled(boolean enabled) vous permet normalement d'activer ou de désactiver le mode ambiant pour les applis pour wearables. 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 de navigation détaillée.
Autres API
- Définir un LocationSource personnalisé n'a aucun effet dans le SDK Navigation.
- Toutes les API MapsInitializer.
- RuntimeRemoteException.
API destinées uniquement aux clients des services de mobilité
Le SDK Navigation contient plusieurs API destinées uniquement aux clients des services de mobilité, qui sont facturés par Google par transaction. Si vous n'êtes pas un client Mobility Services, les méthodes suivantes sont des opérations sans effet :
NavigationTransactionRecorder.pickup()NavigationTransactionRecorder.dropoff()NavigationTransactionRecorder.generatedTransactionId()Navigator.fetchRouteInfo()Navigator.setTransactionIds()