Questo argomento descrive come aggiungere una mappa di base a un'app per Android dopo aver configurato il progetto per l'utilizzo di Maps SDK for Android. Dopo aver aggiunto una mappa, puoi modificarne il tipo di mappa e le funzionalità.
Panoramica
Maps SDK for Android offre diversi corsi che la tua app può utilizzare per gestire il ciclo di vita, la funzionalità e i dati di una mappa. Queste classi supportano le interazioni degli utenti in base al modello di UI di Android, ad esempio l'impostazione dello stato iniziale della mappa e la risposta all'input tramite gesti dell'utente in fase di runtime.
L'interfaccia principale e le classi per la gestione delle mappe:
GoogleMap
: il punto di accesso per la gestione di dati e funzionalità della mappa sottostanti. La tua app può accedere a un oggettoGoogleMap
solo dopo che è stato recuperato da un oggettoSupportMapFragment
oMapView
.SupportMapFragment
: un frammento per la gestione del ciclo di vita di un oggettoGoogleMap
.MapView
: una visualizzazione per la gestione del ciclo di vita di un oggettoGoogleMap
.OnMapReadyCallback
: un'interfaccia di callback che gestisce gli eventi e l'interazione dell'utente per l'oggettoGoogleMap
.
Un oggetto GoogleMap
esegue automaticamente le seguenti operazioni:
- Connessione al servizio Google Maps in corso.
- Download dei riquadri della mappa in corso...
- Visualizzazione dei riquadri sullo schermo del dispositivo.
- Visualizzazione di vari controlli, ad esempio panoramica e zoom.
- Risposta ai gesti di panoramica e zoom spostando la mappa e aumentando o diminuendo lo zoom.
Per utilizzare un oggetto GoogleMap
nella tua app, devi utilizzare un oggetto
SupportMapFragment
o MapView
come oggetto contenitore per la mappa, quindi
recuperare l'oggetto GoogleMap
dal container. Poiché le classi
di container derivano da un frammento o una vista Android, forniscono alla mappa
la gestione del ciclo di vita e le funzionalità UI delle loro classi base Android.
La classe SupportMapFragment
è il container più moderno e comune per un
oggetto GoogleMap
.
Visualizza il codice
Il seguente codice proviene dall'attività Java completa utilizzata in questo argomento durante l'aggiunta di un frammento in modo statico. Il progetto Android è stato creato a partire dal modello di progetto vuoto, quindi è stato aggiornato in base alla guida alla configurazione del progetto. Dopo aver eseguito i passaggi in questo argomento, il codice potrebbe differire in base al modello di progetto.
package com.example.mapsetup; import androidx.appcompat.app.AppCompatActivity; import android.os.Bundle; import com.google.android.gms.maps.GoogleMap; import com.google.android.gms.maps.OnMapReadyCallback; import com.google.android.gms.maps.SupportMapFragment; import com.google.android.gms.maps.model.LatLng; import com.google.android.gms.maps.model.MarkerOptions; // Implement OnMapReadyCallback. public class MainActivity extends AppCompatActivity implements OnMapReadyCallback { @Override protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); // Set the layout file as the content view. setContentView(R.layout.activity_main); // Get a handle to the fragment and register the callback. SupportMapFragment mapFragment = (SupportMapFragment) getSupportFragmentManager() .findFragmentById(R.id.map); mapFragment.getMapAsync(this); } // Get a handle to the GoogleMap object and display marker. @Override public void onMapReady(GoogleMap googleMap) { googleMap.addMarker(new MarkerOptions() .position(new LatLng(0, 0)) .title("Marker")); } }
Per aggiungere una mappa
Questa sezione descrive come aggiungere una mappa di base utilizzando un frammento come container delle mappe. Tuttavia, puoi utilizzare una vista. Ad esempio, vedi RawMapViewDemoActivity su GitHub.
Passaggi di base:
Per ottenere l'SDK, ottenere una chiave API e aggiungere i framework richiesti, segui i passaggi in:
Aggiungi un oggetto
SupportMapFragment
all'attività che gestirà la mappa. Puoi aggiungere il frammento in modo statico o dinamico.Implementa l'interfaccia
OnMapReadyCallback
.Imposta il file di layout come visualizzazione dei contenuti.
Se hai aggiunto il frammento in modo statico, ottieni un handle.
Registra il callback.
Recupera un handle per l'oggetto
GoogleMap
.
Aggiungi un oggetto SupportMapFragment
Puoi aggiungere un oggetto SupportMapFragment
alla tua app in modo statico o dinamico.
Il modo più semplice consiste nel aggiungerlo in modo statico. Se aggiungi il frammento in modo dinamico, puoi eseguire azioni aggiuntive sul frammento, ad esempio rimuoverlo e sostituirlo in fase di runtime.
Aggiungere un frammento in modo statico
Nel file di layout dell'attività che gestirà la mappa:
- Aggiungi un elemento
fragment
. - Aggiungi la dichiarazione del nome
xmlns:map="http://schemas.android.com/apk/res-auto"
. Consente l'utilizzo degli attributi XML personalizzatimaps
. - Nell'elemento
fragment
, imposta l'attributoandroid:name
sucom.google.android.gms.maps.SupportMapFragment
. - Nell'elemento
fragment
, aggiungi l'attributoandroid:id
e impostalo sull'ID risorsa R.id.map (@+id/map
).
Ad esempio, ecco un file di layout completo che include un elemento fragment
:
<?xml version="1.0" encoding="utf-8"?>
<fragment xmlns:android="http://schemas.android.com/apk/res/android"
xmlns:map="http://schemas.android.com/apk/res-auto"
android:name="com.google.android.gms.maps.SupportMapFragment"
android:id="@+id/map"
android:layout_width="match_parent"
android:layout_height="match_parent"/>
ad aggiungere un frammento in modo dinamico.
Nell'attività:
- Crea un'istanza
SupportMapFragment
. - Esegui il commit di una transazione che aggiunge il frammento all'attività. Per maggiori informazioni, consulta la pagina Transazioni con frammenti.
Ad esempio:
Kotlin
val mapFragment = SupportMapFragment.newInstance() supportFragmentManager .beginTransaction() .add(R.id.my_container, mapFragment) .commit()
Java
SupportMapFragment mapFragment = SupportMapFragment.newInstance(); getSupportFragmentManager() .beginTransaction() .add(R.id.my_container, mapFragment) .commit();
Implementa l'interfaccia OnMapReadyCallback
Aggiorna la dichiarazione delle attività come segue:
Kotlin
class MainActivity : AppCompatActivity(), OnMapReadyCallback { // ... }
Java
class MainActivity extends AppCompatActivity implements OnMapReadyCallback { // ... }
Impostare la visualizzazione dei contenuti
Nel metodo onCreate
della tua attività, chiama il
metodo setContentView
e imposta il file di layout come visualizzazione dei contenuti.
Ad esempio, se il file di layout è denominato main.xml
:
Kotlin
override fun onCreate(savedInstanceState: Bundle?) { super.onCreate(savedInstanceState) setContentView(R.layout.main) }
Java
@Override protected void onCreate(@Nullable Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.main); }
Ottieni un handle sul frammento e registra il callback
Per ottenere un handle al frammento, chiama il metodo
FragmentManager.findFragmentById
e passalo l'ID risorsa del frammento nel file di layout. Se hai aggiunto il frammento in modo dinamico, salta questo passaggio perché hai già recuperato l'handle.Chiama il metodo
getMapAsync
per impostare il callback sul frammento.
Ad esempio, se hai aggiunto il frammento in modo statico:
Kotlin
val mapFragment = supportFragmentManager .findFragmentById(R.id.map) as SupportMapFragment mapFragment.getMapAsync(this)
Java
SupportMapFragment mapFragment = (SupportMapFragment) getSupportFragmentManager() .findFragmentById(R.id.map); mapFragment.getMapAsync(this);
Ottieni un handle per l'oggetto GoogleMap
Utilizza il metodo di callback onMapReady
per ottenere un handle
per l'oggetto GoogleMap
. Il callback viene attivato quando la mappa è pronta a ricevere
un input utente. Fornisce un'istanza non null della classe GoogleMap
che puoi utilizzare per aggiornare la mappa.
In questo esempio, il callback onMapReady
recupera un handle all'oggetto GoogleMap
,
quindi viene aggiunto un indicatore alla mappa:
Kotlin
override fun onMapReady(googleMap: GoogleMap) { googleMap.addMarker( MarkerOptions() .position(LatLng(0.0, 0.0)) .title("Marker") ) }
Java
@Override public void onMapReady(GoogleMap googleMap) { googleMap.addMarker(new MarkerOptions() .position(new LatLng(0, 0)) .title("Marker")); }
Dopo aver creato ed eseguito correttamente l'app, verrà visualizzata una mappa con un indicatore su Null Island (zero gradi di latitudine e zero gradi di longitudine).
Visualizza il codice per l'attività completa:
Visualizza l'attività completa
Passaggi successivi
Dopo aver completato questi passaggi, puoi configurare le impostazioni della mappa.