Configurazione utilità di Maps SDK for Android

Seleziona la piattaforma: Android iOS

In questa pagina viene descritto 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 Android 15 e versioni successive. Quando imposti la destinazione di build del progetto, assicurati di utilizzare il livello API Android più recente.

La documentazione di riferimento è disponibile su GitHub.

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

Aggiungi la dipendenza seguente al file build.gradle dell'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.8.0'
}

Utilizza una delle utilità della libreria, come il clustering degli indicatori, le mappe termiche o le altre utilità.

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

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

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

dependencies {

    // KTX for the Maps SDK for Android Utility Library
    implementation 'com.google.maps.android:maps-utils-ktx:5.0.0'
}

Consulta la pagina GitHub di Maps KTX per ulteriori informazioni su questa libreria.

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 la libreria. Puoi farlo clonando il repository (opzione consigliata, per ricevere aggiornamenti automatici) o scaricando un file ZIP. Se vuoi personalizzare la libreria, devi fork il 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 file Leggimi.
• Configurazione di build 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 indicate sopra.
2. In Android Studio, scegli File -> Nuovo -> Importa progetto.
3. Sfoglia e seleziona (fai doppio clic) la directory android-maps-utils creata al momento della clonazione della libreria di utilità. Android Studio ora crea il progetto.
4. Se usi un dispositivo Android anziché un emulatore, assicurati di attivare la modalità sviluppatore. Quindi collega il dispositivo Android al computer.

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

   MAPS_API_KEY=YOUR_API_KEY

   Dove YOUR_API_KEY è la chiave API che hai ottenuto, come descritto in Utilizzare le chiavi API.

6. Crea ed esegui l'app demo.

L'app dovrebbe aprirsi sul dispositivo Android e visualizzare un elenco di utilità, tra cui clustering, poyutil, mappa termica e altre ancora. Puoi trovare l'app anche nel tuo elenco di app, sotto il nome Maps Utils Demo (Demo di Maps Utils).