Configurazione utilità di Maps SDK for Android

Seleziona la piattaforma: Android iOS

Questa pagina descrive come configurare la libreria di utilità di Maps SDK for Android e come eseguire l'app demo inclusa nella libreria.

Prerequisiti e note

La libreria di utilità di Maps SDK for Android supporta il livello API 15 e versioni successive. Quando imposti la destinazione di build del progetto, assicurati di utilizzare l'ultimo livello API Android.

La documentazione di riferimento è disponibile su GitHub.

Passaggio 1: Installa la libreria di utilità di Maps SDK for Android

Aggiungi la seguente dipendenza al file build.gradle.kts della tua app:

dependencies {


    // Utility Library for Maps SDK for Android
    // You do not need to add a separate dependency for the Maps SDK for Android
    // since this library builds in the compatible version of the Maps SDK.
    implementation("com.google.maps.android:android-maps-utils:3.19.0")
}

Utilizza una delle utilità della libreria, ad esempio il clustering dei marcatori, le mappe termiche o le altre utilità.

Passaggio 2: (Facoltativo) Installa la libreria KTX di utilità di Maps SDK for Android

La libreria di utilità di Maps SDK for Android include una libreria di estensioni Kotlin (KTX) corrispondente. Questa libreria fornisce funzionalità del linguaggio Kotlin, come funzioni di estensione, argomenti denominati e predefiniti, per consentirti di scrivere codice Kotlin conciso e idiomatico. Se non sviluppi in Kotlin, puoi saltare questo passaggio.

Per utilizzare questa libreria, aggiungi la seguente dipendenza, oltre alla dipendenza android-maps-utils, al file build.gradle.kts dell'app:

dependencies {

    // KTX for the Maps SDK for Android Utility Library
    implementation(libs.maps.utils.ktx)
}

Per ulteriori informazioni su questa libreria, consulta la pagina GitHub di Maps KTX.

Passaggio 3: Visualizza il codice sorgente della libreria di utilità di Maps SDK for Android

Poiché la libreria di utilità è open source, puoi scaricare la libreria android-maps-utils sul tuo computer per personalizzarla, visualizzare l'app demo o semplicemente per capire come funziona. Puoi farlo clonando il repository (consigliato per ricevere aggiornamenti automatici) o scaricando un file zip. Se vuoi personalizzare la libreria, devi creare un fork del repository.

Il repository include:

  • Un'applicazione demo nella directory demo.
  • La libreria di utilità, nella directory library.
  • Vari file contenenti informazioni su licenza, collaboratori e readme.
  • Configurazione di compilazione Gradle, da utilizzare con Android Studio.

Esegui l'app demo dell'utilità

Il repository GitHub per la libreria di utilità viene fornito con un'app demo che include implementazioni di esempio di ogni utilità. Segui questi passaggi per eseguire l'app demo sul tuo dispositivo Android.

  1. Scarica il repository utilizzando una delle opzioni menzionate sopra.
  2. In Android Studio, scegli File -> New -> Import Project.
  3. Sfoglia e seleziona (fai doppio clic) la directory android-maps-utils creata quando hai clonato la libreria di utilità. Android Studio ora compila il progetto.
  4. Se utilizzi un dispositivo Android anziché un emulatore, assicurati di attivare la modalità sviluppatore. Poi collega il dispositivo Android al computer.

  5. Aggiungi una singola riga a local.properties simile alla seguente:

    MAPS_API_KEY=YOUR_API_KEY

    dove YOUR_API_KEY è la chiave API che hai ottenuto come descritto in Utilizzo delle chiavi API.

  6. Crea ed esegui l'app demo.

L'app dovrebbe aprirsi sul dispositivo Android, mostrando un elenco di utilità tra cui clustering, polyutil, mappa termica e altro ancora. Puoi trovare l'app anche nell'elenco delle app, con il nome Maps Utils Demo.