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 modificare il tipo di mappa e le funzionalità.
Panoramica
Maps SDK for Android offre diverse classi che la tua app può utilizzare per gestire il ciclo di vita, le funzionalità e i dati di una mappa. Le classi supportano le interazioni degli utenti in base al modello di UI Android, ad esempio l'impostazione dello stato iniziale della mappa e la risposta all'input dei 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 dei dati e delle funzionalità sottostanti della mappa. La tua app può accedere a un oggettoGoogleMap
solo dopo che è stato recuperato da un oggettoSupportMapFragment
oMapView
.SupportMapFragment
: un frammento per gestire il ciclo di vita di un oggettoGoogleMap
.MapView
: una vista per gestire il ciclo di vita di un oggettoGoogleMap
.OnMapReadyCallback
: un'interfaccia di callback che gestisce gli eventi e le interazioni dell'utente per l'oggettoGoogleMap
.
Un oggetto GoogleMap
esegue automaticamente queste 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, come panoramica e zoom.
- Rispondere ai gesti di panoramica e zoom spostando la mappa e aumentando o diminuendo lo zoom.
Per utilizzare un oggetto GoogleMap
nell'app, devi utilizzare un oggetto
SupportMapFragment
o MapView
come oggetto container per la mappa, quindi
recuperare l'oggetto GoogleMap
dal container. Poiché le classi container derivano da un frammento o da una visualizzazione Android, forniscono alla mappa le funzionalità di gestione del ciclo di vita e di 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 dal modello di progetto vuoto e quindi aggiornato in base alla guida alla configurazione del progetto. Dopo aver eseguito i passaggi descritti in questo argomento, il codice potrebbe variare 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")); } }
Aggiungere una mappa
Questa sezione descrive come aggiungere una mappa di base utilizzando un frammento come contenitore della mappa; tuttavia, puoi utilizzare una vista. Per un esempio, vedi RawMapViewDemoActivity su GitHub.
Passaggi di base:
Per ottenere l'SDK, ottenere una chiave API e aggiungere i framework richiesti, segui questi passaggi:
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 per il frammento.
Registra il callback.
Acquisisci 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 è aggiungerlo in modo statico. Se aggiungi il frammento in modo dinamico, puoi eseguire altre azioni sul frammento, come 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 di utilizzare gli attributi XML personalizzati dimaps
. - 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 (@+id/map
) di R.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"/>
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 ulteriori informazioni, consulta la sezione Transazioni relative ai 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 di attività come segue:
Kotlin
class MainActivity : AppCompatActivity(), OnMapReadyCallback { // ... }
Java
class MainActivity extends AppCompatActivity implements OnMapReadyCallback { // ... }
Impostare la visualizzazione dei contenuti
Nel metodo onCreate
dell'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 per il frammento e registra il callback
Per ottenere un handle per il frammento, chiama il metodo
FragmentManager.findFragmentById
e trasmettilo all'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 per ricevere
l'input dell'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 per l'oggetto GoogleMap
e poi 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")); }
Una volta creata ed eseguita 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:
Passaggi successivi
Dopo aver completato questi passaggi, puoi configurare le impostazioni della mappa.