Bonnes pratiques concernant les interactions avec Google Maps
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Cette page décrit les bonnes pratiques à suivre pour interagir avec l'objet GoogleMap
dans votre application.
Implémenter les fonctionnalités GoogleMap
sur la même instance Maps
Les API Maps sont également disponibles dans le SDK Navigation, que vous pouvez utiliser pour créer des expériences spécifiques aux cartes (non liées à la navigation). Si votre application inclut à la fois une expérience cartographique sans navigation et une expérience de navigation, nous vous recommandons d'utiliser l'API Maps et Navigation sur la même instance de carte.
Utilisez getMapAsync
pour obtenir l'instance GoogleMap
.
Vous pouvez obtenir un objet GoogleMap
à l'aide de SupportNavigationFragment#getMapAsync
ou de NavigationView#getMapAsync
. Nous vous recommandons cette méthode plutôt que de conserver l'instance GoogleMap
qui pourrait devenir obsolète une fois que NavigationView
sous-jacent est recréé.
Veillez également à nettoyer le GoogleMap
récupéré à partir de cette méthode lorsqu'il n'est plus nécessaire. Pour en savoir plus, consultez les bonnes pratiques de nettoyage des instances.
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/08/31 (UTC).
[null,null,["Dernière mise à jour le 2025/08/31 (UTC)."],[[["\u003cp\u003eImplement \u003ccode\u003eGoogleMap\u003c/code\u003e features on a separate map instance from navigation experiences to avoid conflicts and optimize performance.\u003c/p\u003e\n"],["\u003cp\u003eUse \u003ccode\u003egetMapAsync\u003c/code\u003e to retrieve the \u003ccode\u003eGoogleMap\u003c/code\u003e object instead of holding onto an instance, ensuring you have the most up-to-date map object and preventing stale data.\u003c/p\u003e\n"],["\u003cp\u003eRemember to clean up the \u003ccode\u003eGoogleMap\u003c/code\u003e object after use to prevent memory leaks and maintain optimal app performance, referring to the Instance cleanup best practices for detailed guidance.\u003c/p\u003e\n"]]],[],null,["# GoogleMap interaction best practices\n\nThis page explains best practices for interacting with the `GoogleMap` object in\nyour app.\n\nImplement `GoogleMap` features on the same maps instance\n--------------------------------------------------------\n\nMaps APIs are also available as part of Navigation SDK, which you can use to\nbuild map specific (non-navigation) experiences. If your app includes both a\nnon-navigation map experience and a navigation experience, we recommend using\nthe Maps and Navigation API on the same map instance.\n\nUse `getMapAsync` to obtain the `GoogleMap` instance\n----------------------------------------------------\n\nYou can obtain a `GoogleMap` object using either\n`SupportNavigationFragment#getMapAsync` or `NavigationView#getMapAsync`. We\nrecommend this method over holding onto the `GoogleMap` instance that might\nbecome stale once the `NavigationView` underneath is recreated.\n\nAlso be sure to clean up the `GoogleMap` retrieved from this method after it is\nno longer needed. For more information, see [Instance cleanup best\npractices](/maps/documentation/navigation/android-sdk/instance-cleanup-best-practices)."]]