Riferimento rapido di Maps SDK for Android

Maps SDK for Android aggiunge dati di Google Maps, visualizzazioni di mappe e risposte ai gesti sulle mappe alle app per Android, incluse le app per Wear OS. Puoi aggiungere indicatori, poligoni e overlay per mostrare informazioni sulle località della mappa e supportare l'interazione degli utenti, utilizzando Kotlin o Java.

Maps SDK for Android: informazioni chiave

  • Prodotto: Maps SDK for Android
  • Nota anche come: API di Google Maps per Android
  • Category: Maps
  • Piattaforma: Android
  • Esecuzione su: client (codice dell'app o del browser)
  • Fase di lancio: GA
  • Ciclo di vita: Attivo
  • Panoramica: Panoramica di Maps SDK for Android
  • Disponibilità regionale: ovunque. Consulta la pagina sulla copertura di Google Maps Platform. I link alla pagina Utilizzo e fatturazione separano i listini prezzi globali da quelli per l'India. (dettagli sulla copertura)

Maps SDK for Android: quando utilizzarlo

Utilizza Maps SDK for Android quando:

  • Hai bisogno di una mappa Google 2D interattiva in un'app nativa per Android o Wear OS.
  • Devi aggiungere indicatori, finestre informative, polilinee, poligoni, overlay del terreno o overlay di riquadri a una mappa in un'app per Android.
  • Hai bisogno di panoramiche in Street View, mappe in modalità Lite (bitmap) o personalizzazione delle mappe basata su cloud con ID mappa in un'app per Android.
  • Puoi creare una mappa Android in Kotlin o Java, incluso Jetpack Compose tramite la libreria Maps Compose.

Non utilizzare Maps SDK for Android quando:

  • Hai bisogno della navigazione passo passo nella tua app per mappe Android. Utilizza invece l'SDK Navigation per Android.
  • Hai bisogno di mappe 3D fotorealistiche, modelli 3D o animazioni del percorso della fotocamera in un'app per Android. Utilizza invece l'SDK Maps 3D per Android.
  • Hai bisogno di una mappa in un'app per iOS nativa. Utilizza invece Maps SDK for iOS.

Maps SDK for Android: configurazione

Pacchetti Maps SDK for Android ufficiali:

  • maven: com.google.android.gms:play-services-maps

Maps SDK for Android: errori comuni

  • Problema: dalla versione 20.0.0 dell'SDK, il manifest dell'SDK non include più la libreria org.apache.http.legacy. Le app che caricano il renderer di mappe precedente possono arrestarsi in modo anomalo con java.lang.NoClassDefFoundError. Correzione: aggiungi all'interno del tag del file AndroidManifest.xml dell'app. I dispositivi con Google Play Services 25.50.34 o versioni successive non sono interessati. Consulta /maps/documentation/android-sdk/release-notes.
  • Problema: i marker avanzati richiedono il renderer di mappe aggiornato. Se li aggiungi a un'app esistente senza ricrearla, l'app può comunque utilizzare il renderer precedente. Correzione: ricrea l'app con l'SDK 18.2.0 o versioni successive in modo che il renderer di cui è stato eseguito l'upgrade sia quello predefinito. Consulta /maps/documentation/android-sdk/advanced-markers/start.
  • Problema: i dispositivi che non soddisfano i requisiti del renderer (Android 5.0/API 21 o versioni successive, Google Play Services 21.39.14 o versioni successive, Play Store abilitato) tornano al renderer precedente, pertanto le funzionalità che richiedono il nuovo renderer, come la personalizzazione delle mappe basata su cloud, non sono disponibili. Correzione: chiama MapsInitializer.initialize(context, MapsInitializer.Renderer.LATEST, callback) e controlla il valore MapsInitializer.Renderer passato a OnMapsSdkInitializedCallback.onMapsSdkInitialized() oppure controlla GoogleMap.getMapCapabilities(). Se il dispositivo utilizza LEGACY, non fare affidamento sulla personalizzazione delle mappe basata su cloud o sugli indicatori avanzati. Consulta /android/reference/com/google/android/gms/maps/OnMapsSdkInitializedCallback.
  • Problema: l'SDK richiede Google Play Services sul dispositivo su cui viene eseguita l'app. Correzione: facoltativamente, chiama il controllo della disponibilità di Google Play Services dalla tua app. Consulta /maps/documentation/android-sdk/config.

Maps SDK for Android: funzionalità legacy e deprecate

  • Renderer di mappe precedente: ritirato dal 4 marzo 2024. Sostituzione: renderer di mappe aggiornato (più recente), che è l'impostazione predefinita dall'SDK 18.2.0. Sintomo: la personalizzazione delle mappe basata su cloud, le personalizzazioni avanzate delle polilinee e gli indicatori avanzati non sono disponibili nel renderer precedente. Consulta la guida alla migrazione.

Cosa puoi fare con Maps SDK for Android

Consulta le guide collegate di seguito per ogni attività o confronta i prodotti in Capabilities Explorer.

Maps SDK for Android: stili basati sui dati per i confini

Maps SDK for Android: stile basato sui dati per i set di dati

Maps SDK for Android: set di dati

Maps SDK for Android: Maps

Maps SDK for Android: annotazioni di Maps

Maps SDK for Android: stile di mappa

Maps SDK for Android: Street View