Configurazione utilità di Maps SDK for Android

In questa pagina viene descritto come configurare SDK Maps per Android libreria di utilità ed eseguire l'app demo inclusa nella libreria.

Prerequisiti e note

La libreria di utilità di Maps SDK for Android supporta Android API livello 15 o superiore. Quando imposti il target di build del progetto, assicurati di utilizzare la versione Livello API Android.

La riferimento documentazione è disponibile su GitHub.

Passaggio 1. Installa la libreria dell'utilità di Maps SDK for Android

Aggiungi la seguente dipendenza al file build.gradle.kts 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.2")
}

Utilizza una delle utilità della libreria, ad esempio indicatore clustering, mappe termiche o l'altro utilità.

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

La libreria di utilità di Maps SDK for Android è dotata di estensioni Kotlin corrispondenti (KTX). Questa libreria fornisce funzionalità del linguaggio Kotlin, come le funzioni di estensione, e argomenti predefiniti per consentirti di scrivere Kotlin conciso e idiomatico. Se non sei sviluppare 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 della tua app:

dependencies {

    // KTX for the Maps SDK for Android Utility Library
    implementation("com.google.maps.android:maps-utils-ktx:5.1.1")
}

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

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

Poiché la libreria di utilità è open source, puoi scaricare android-maps-utils nella tua macchina per personalizzarla, visualizzare l'app demo o semplicemente all'operatività della biblioteca. A tale scopo, procedi nel seguente modo: clonare il repository (consigliato, di ricevere aggiornamenti automatici) o download un file ZIP. Se vuoi personalizzare la raccolta, devi esegui il fork del repository.

Il repository include:

• Un'applicazione demo, nella directory demo.
• La libreria delle utilità, nella directory library.
• Vari file contenenti licenze, collaboratori e informazioni sul file readme.
• 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 esempi le implementazioni di ogni utilità. Segui questi passaggi per eseguire l'app demo su il tuo dispositivo Android.

1. Scarica il repository utilizzando una delle opzioni indicate sopra.
2. In Android Studio, scegli File -> Nuovo -> Importa progetto.
3. Individua e seleziona (fai doppio clic) sul android-maps-utils creata durante ha clonato la libreria di utilità. Android Studio ora crea il progetto.
4. Se utilizzi un dispositivo Android anziché un emulatore, assicurati di attivare la modalità sviluppatore. Dopodiché collega il dispositivo Android al computer.

5. Aggiungi a local.properties una singola riga che abbia il seguente aspetto:

   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 e mostrare un elenco di utilità tra cui clustering, poyutil, Heatmap e altro ancora. Puoi trovare l'app anche in il tuo elenco di app, sotto il nome Maps Utils Demo.