Visualizzare una mappa di base

Questo esempio crea una mappa utilizzando un oggetto SupportMapFragment da Maps SDK for Android.

Per saperne di più, consulta Aggiungi una mappa alla tua app per Android.

Inizia

Prima di poter provare il codice campione, devi configurare l'ambiente di sviluppo. Per saperne di più, consulta gli esempi di codice di Maps SDK for Android.

Visualizza il codice

Kotlin

class BasicMapDemoActivity :
    SamplesBaseActivity(),
    OnMapReadyCallback {

    val SYDNEY = LatLng(-33.862, 151.21)
    val ZOOM_LEVEL = 13f

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.basic_demo)
        val mapFragment: SupportMapFragment? =
            supportFragmentManager.findFragmentById(R.id.map) as? SupportMapFragment
        mapFragment?.getMapAsync(this)
    }

    /**
     * This is where we can add markers or lines, add listeners or move the camera. In this case,
     * we just move the camera to Sydney and add a marker in Sydney.
     */
    override fun onMapReady(googleMap: GoogleMap) {
        with(googleMap) {
            moveCamera(CameraUpdateFactory.newLatLngZoom(SYDNEY, ZOOM_LEVEL))
            addMarker(MarkerOptions().position(SYDNEY).title("Sydney"))
        }
    }
}

      

Java

public class BasicMapDemoActivity extends SamplesBaseActivity implements OnMapReadyCallback {

    private static final LatLng SYDNEY = new LatLng(-33.862, 151.21);
    private static final float ZOOM_LEVEL = 13.0f;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(com.example.common_ui.R.layout.basic_demo);

        SupportMapFragment mapFragment =
                (SupportMapFragment)
                        getSupportFragmentManager()
                                .findFragmentById(com.example.common_ui.R.id.map);
        mapFragment.getMapAsync(this);
        applyInsets(findViewById(com.example.common_ui.R.id.map_container));
    }

    /**
     * This is where we can add markers or lines, add listeners or move the camera. In this case, we
     * move the camera to Sydney and add a marker at Sydney.
     */
    @Override
    public void onMapReady(GoogleMap map) {
        map.moveCamera(CameraUpdateFactory.newLatLngZoom(SYDNEY, ZOOM_LEVEL));
        map.addMarker(new MarkerOptions().position(SYDNEY).title("Sydney"));
    }
}

      

Clona ed esegui gli esempi

Per eseguire questo esempio in locale è necessario Git. Il comando seguente clona il repository dell'applicazione di esempio.

git clone [e-mail]:googlemaps-samples/android-samples.git

Importa il progetto di esempio in Android Studio:

1. In Android Studio, seleziona File > Nuovo > Importa progetto.

2. Vai alla posizione in cui hai salvato il repository e seleziona la directory del progetto per Kotlin o Java:

   • Kotlin: PATH-REPO/android-samples/ApiDemos/kotlin
   • Java: PATH-REPO/android-samples/ApiDemos/java
3. Seleziona Apri. Android Studio crea il progetto utilizzando lo strumento di build Gradle.
4. Crea un file secrets.properties vuoto nella stessa directory del file local.properties del progetto. Per saperne di più su questo file, consulta Aggiungi la chiave API al progetto.
5. Ottieni una chiave API dal tuo progetto con Maps SDK for Android abilitato.

6. Aggiungi la seguente stringa a secrets.properties, sostituendo YOUR_API_KEY con il valore della tua chiave API:

   MAPS_API_KEY=YOUR_API_KEY

7. Esegui l'app.