Un componente Mappa in un'app. Questo frammento è il modo più semplice per inserire una mappa in un'applicazione. È un wrapper attorno a una visualizzazione di una mappa per gestire automaticamente le esigenze del ciclo di vita necessarie. Essendo un frammento, questo componente può essere aggiunto a un file di layout di attività semplicemente con il codice XML seguente.
<fragment class="com.google.android.libraries.maps.SupportMapFragment" android:layout_width="match_parent" android:layout_height="match_parent"/>È necessario acquisire una
GoogleMap
utilizzando getMapAsync(OnMapReadyCallback)
. Questa classe inizializza automaticamente il sistema di mappe e la visualizzazione.
Una vista può essere rimossa quando viene richiamato il metodo onDestroyView()
di SupportMapFragment; viene inoltre impostata l'opzione useViewLifecycleInFragment(boolean)
. In questo caso, SupportMapFragment non è più valido finché la vista non viene ricreata in un secondo momento quando viene richiamato il metodo onCreateView(LayoutInflater, ViewGroup, Bundle)
di SupportMapFragment.
Tutti gli oggetti ottenuti da GoogleMap
sono associati alla vista. È importante non trattenere gli oggetti (ad esempio Marker
) al di là della vita della vista. In caso contrario, si verificherà una perdita di memoria perché non è possibile rilasciare la vista.
Per utilizzare questo corso, devi includere la libreria di assistenza Android nel percorso della build.
Guida per gli sviluppatori
Per ulteriori informazioni, consulta la guida per gli sviluppatori dell'SDK Google Maps per Android.
Riepilogo pubblico costruzione
SupportMapFragment()
Crea un frammento di mappa.
|
Riepilogo del metodo pubblico
nullo |
getMapAsync(callback OnMapReadyCallback)
Imposta un oggetto di callback che verrà attivato quando l'istanza
GoogleMap è pronta per essere utilizzata. |
Static SupportMapFragment | |
Static SupportMapFragment |
newInstance()
Crea un frammento di mappa, utilizzando le opzioni predefinite.
|
nullo |
onActivityCreated(Set savedInstanceState)
|
nullo |
onAttach(Attività attività)
|
nullo |
onConfigurationChanged (configurazione della configurazione)
|
nullo |
onCreate(Set savedInstanceState)
|
Visualizza |
onCreateView(gonfiatore LayoutInflater, container ViewGroup, bundle savedInstanceState)
|
nullo | |
nullo | |
finale null |
onEnterAmbient(Bundle ambientDetails)
Devi chiamare questo metodo dal metodo corrispondente dell'attività indossabile principale.
|
finale null |
onExitAmbient()
Devi chiamare questo metodo dal metodo corrispondente dell'attività indossabile principale.
|
nullo |
onInflate(Attività attività, attributi AttributeSet, Bundle savedInstanceState)
Analizza gli attributi durante l'inflazione da una gerarchia di visualizzazione negli argomenti che gestiamo.
|
nullo | |
nullo |
onpause()
|
nullo | |
nullo |
onSaveInstanceState(Pacchetto outState)
Fornisce un elemento
Bundle per archiviare lo stato del frammento prima che venga eliminato. |
nullo |
onStart()
|
nullo |
onStop()
|
nullo |
setArguments(argomenti dei set)
|
Riepilogo del metodo ereditato
Costruttori pubblici
pubblica SupportMapFragment ()
Crea un frammento di mappa. Questo costruttore è pubblico solo per l'uso di un dispositivo di gonfiaggio. Usa newInstance()
per creare un SupportMapFragment in modo programmatico.
Metodi pubblici
pubblico void getMapAsync ( callback OnOnReadyReadyCallback)
Imposta un oggetto di callback che verrà attivato quando l'istanza GoogleMap
è pronta per essere utilizzata.
Tieni presente che:
- Questo metodo deve essere chiamato dal thread principale.
- Il callback verrà eseguito nel thread principale.
- Nel caso in cui Google Play Services non sia installato sul dispositivo dell'utente, il callback non verrà attivato finché l'utente non lo installa.
- Nel raro caso in cui Google Maps venga distrutto immediatamente dopo la creazione, il callback non viene attivato.
- L'oggetto
GoogleMap
fornito dal callback non è null.
Parametri
callback | L'oggetto callback che verrà attivato quando la mappa è pronta per essere utilizzata. |
---|
pubblica statica SupportMapFragment newInstance (Opzioni GoogleMapOptions)
Crea un frammento di mappa con le opzioni specificate.
Parametri
opzioni |
---|
pubblica statica SupportMapFragment newInstance ()
Crea un frammento di mappa, utilizzando le opzioni predefinite.
public void onActivityCreated (Bundle savedInstanceState)
Parametri
savedInstanceState |
---|
pubblica void onAttach (Attività di attività)
Parametri
attività |
---|
public void onConfigurationChanged (Configuration config)
Parametri
config |
---|
public void onCreate (Bundle savedInstanceState)
Parametri
savedInstanceState |
---|
pubblico Visualizza onCreateView (gonfiatore LayoutInflater, container ViewGroup, bundle savedInstanceState)
Parametri
gonfiatore | |
---|---|
container | |
savedInstanceState |
pubblica void onDestroy ()
pubblica void onDestroyView ()
public final void onEnterAmbient (Bundle ambientDetails)
Devi chiamare questo metodo dal metodo corrispondente dell'attività indossabile principale.
Parametri
dettagli ambientali |
---|
public final void onExitAmbient ()
Devi chiamare questo metodo dal metodo corrispondente dell'attività indossabile principale.
public void onInflate (Attività attività, attributi AttributeSet, bundle savedInstanceState)
Analizza gli attributi durante l'inflazione da una gerarchia di visualizzazione negli argomenti che gestiamo.
Parametri
attività | |
---|---|
Attributi | |
savedInstanceState |
pubblica void onlowMemory ()
pubblica void onpause ()
pubblica void onRiprendi ()
public void onSaveInstanceState (Bundle outState)
Fornisce un elemento Bundle
per archiviare lo stato del frammento prima che venga eliminato. Può essere recuperato in un secondo momento quando viene richiamato onCreate(Bundle)
.
Parametri
stato esterno |
---|
pubblica void onStart ()
pubblico void onStop ()
public void setArguments (Set di argomenti)
Parametri
arg |
---|