Visualizzare una mappa di base

Immagine di Visualizza una mappa di base.

In questo esempio viene creata una mappa utilizzando un elemento SupportMapFragment da Maps SDK for Android.

Per saperne di più, consulta la documentazione.

Inizia

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

Visualizza il codice

Kotlin



class BasicMapDemoActivity : AppCompatActivity(), OnMapReadyCallback {

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

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_basic_map_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))
        }
    }
}

      

Java


public class BasicMapDemoActivity extends AppCompatActivity implements OnMapReadyCallback {

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

        SupportMapFragment mapFragment =
                (SupportMapFragment) getSupportFragmentManager().findFragmentById(R.id.map);
        mapFragment.getMapAsync(this);
    }

    /**
     * This is where we can add markers or lines, add listeners or move the camera. In this case,
     * we
     * just add a marker near Africa.
     */
    @Override
    public void onMapReady(GoogleMap map) {
        map.addMarker(new MarkerOptions().position(new LatLng(0, 0)).title("Marker"));
    }
}

      

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 git@github.com: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 tuo progetto utilizzando lo strumento di creazione Gradle.
  4. Crea un file secrets.properties vuoto nella stessa directory del file local.properties del progetto. Per saperne di più, consulta Aggiungere la chiave API al progetto.
  5. Aggiungi la stringa seguente a secrets.properties, sostituendo YOUR_API_KEY con il valore della tua chiave API:

    MAPS_API_KEY=YOUR_API_KEY
  6. Esegui l'app.