Best practice per l'interazione con Google Maps
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Questa pagina illustra le best practice per interagire con l'oggetto GoogleMap nella tua app.
Implementare le funzionalità di GoogleMap nella stessa istanza di Maps
Le API Maps sono disponibili anche nell'SDK Navigation, che puoi utilizzare per
creare esperienze specifiche per le mappe (non di navigazione). Se la tua app include sia un'esperienza
di mappa non di navigazione sia un'esperienza di navigazione, ti consigliamo di utilizzare
l'API Maps e l'API Navigation nella stessa istanza della mappa.
Utilizza getMapAsync per ottenere l'istanza GoogleMap
Puoi ottenere un oggetto GoogleMap utilizzando SupportNavigationFragment#getMapAsync o NavigationView#getMapAsync. Consigliamo questo metodo rispetto al mantenimento dell'istanza GoogleMap che potrebbe diventare obsoleta una volta ricreato l'elemento NavigationView sottostante.
Assicurati inoltre di pulire il GoogleMap recuperato con questo metodo dopo che non è più necessario. Per saperne di più, consulta le best practice per la pulizia delle istanze.
Salvo quando diversamente specificato, i contenuti di questa pagina sono concessi in base alla licenza Creative Commons Attribution 4.0, mentre gli esempi di codice sono concessi in base alla licenza Apache 2.0. Per ulteriori dettagli, consulta le norme del sito di Google Developers. Java è un marchio registrato di Oracle e/o delle sue consociate.
Ultimo aggiornamento 2025-08-31 UTC.
[null,null,["Ultimo aggiornamento 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)."]]
