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
GoogleMapfornito 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 |
|---|