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.MapFragment" 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 chiamato il metodo onDestroyView()
di MapFragment e viene impostata l'opzione useViewLifecycleInFragment(boolean)
. In questo caso, il MapFragment non è più valido finché la vista non viene ricreata in un secondo momento quando viene chiamato il metodo onCreateView(LayoutInflater, ViewGroup, Bundle)
di MapFragment.
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.
Utilizza questa classe solo se hai scelto come target l'API 12 e versioni successive. In caso contrario, utilizza SupportMapFragment aggiungendo la libreria di assistenza Android al percorso di build.
Guida per gli sviluppatori
Per ulteriori informazioni, consulta la guida per gli sviluppatori dell'SDK Google Maps per Android.
Riepilogo costante ereditato
Riepilogo pubblico costruzione
MapFragment()
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. |
statico MapFragment | |
statico MapFragment |
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 MapFragment ()
Crea un frammento di mappa. Questo costruttore è pubblico solo per l'uso di un dispositivo di gonfiaggio. Usa newInstance()
per creare un MapFragment 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. |
---|
public static MapFragment newInstance (opzioni di GoogleMapOptions)
Crea un frammento di mappa con le opzioni specificate.
Parametri
opzioni |
---|
pubblica statica MapFragment 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 |
---|