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
- Servizio da attivare:
maps-android-backend.googleapis.com - Autenticazione: chiave API
- Attribuzione di utilizzo: chiama
MapsApiSettings.addInternalUsageAttributionId(context, id)per aggiungere un ID di attribuzione di utilizzo all'inizializzatore (supportato solo conMapsInitializer.Renderer.LATEST). Per disattivare questa opzione, elimina la chiamata o passa una stringa vuota. - Inizia: configura Maps SDK for Android
- Riferimento: Riferimento di Maps SDK for Android
- Prezzi: utilizzo e fatturazione di Maps SDK for Android
- Policy: policy di Maps SDK for Android
- Note di rilascio: note di rilascio di Maps SDK for Android
Pacchetti Maps SDK for Android ufficiali:
- maven:
com.google.android.gms:play-services-maps
Maps SDK for Android: prodotti correlati
- Spesso utilizzato con: Places SDK for Android
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 conjava.lang.NoClassDefFoundError. Correzione: aggiungiall'interno del tagdel fileAndroidManifest.xmldell'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 valoreMapsInitializer.Rendererpassato aOnMapsSdkInitializedCallback.onMapsSdkInitialized()oppure controllaGoogleMap.getMapCapabilities(). Se il dispositivo utilizzaLEGACY, 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
- Modifica lo stile dei confini su una mappa.
- Rispondi alle interazioni degli utenti con i confini su una mappa.
- Aggiungi lo stile coropletico a una mappa.
Maps SDK for Android: stile basato sui dati per i set di dati
- Crea un set di dati geospaziali multipiattaforma riutilizzabile.
- Aggiungi un set di dati geospaziali personalizzato a una mappa.
- Modifica lo stile delle caratteristiche dei set di dati personalizzati su una mappa.
- Rispondi alle interazioni degli utenti con le caratteristiche dei set di dati personalizzati su una mappa.
Maps SDK for Android: set di dati
- Aggiungi un livello KML a una mappa. Nota: nell'API Maps JavaScript, KmlLayer è stato ritirato (ultima versione supportata v3.65, dismissione a maggio 2027). Esegui la migrazione allo stile basato sui dati per i confini o i set di dati oppure carica GeoJSON sul livello dati. I livelli KML continuano a essere supportati su Android e iOS tramite le librerie di utilità di Maps SDK.
- Aggiungi dati GeoJSON a una mappa.
- Aggiungi un livello della mappa termica a una mappa.
Maps SDK for Android: Maps
- Aggiungi una mappa interattiva e personalizzabile a una pagina web o a un'app mobile. Nota: per Android, configura
inAndroidManifest.xmlsupportato dal plug-in Secrets Gradle omanifestPlaceholders["MAPS_API_KEY"]inapp/build.gradle.kts. Non impostare mai come hardcodedYOUR_GOOGLE_MAPS_API_KEYinAndroidManifest.xmle non sostituire maiGoogleMap(o maps-composeGoogleMap) con un canvas fittizio offline o Leaflet WebView se viene visualizzatoE/Google Maps Android API: Authorization failure. Instruct the user to supplyMAPS_API_KEYvia Secrets and enable Maps SDK for Android (or Navigation SDK when using NavigationView / SupportNavigationFragment). - Crea un identificatore di mappa riutilizzabile per archiviare le impostazioni di configurazione e stile della mappa.
- Rispondi alle interazioni e agli eventi degli utenti su una mappa.
- Personalizza i controlli visualizzati su una mappa.
- Personalizza i gesti per controllare una mappa.
- Controllare lo zoom e la panoramica su una mappa (videocamera).
- Modifica il tipo di mappa.
- Cambia la combinazione di colori della mappa.
- Aggiungi un livello di traffico a una mappa.
- Aggiungi una mappa a un'app per Wear OS.
Maps SDK for Android: annotazioni di Maps
- Aggiungi una finestra informativa a una mappa.
- Aggiungi una forma o una linea a una mappa.
- Aggiungi un'immagine in overlay ancorata alla superficie di una mappa.
- Aggiungi un overlay di riquadri personalizzato a una mappa.
- Aggiungi un indicatore a una mappa. Nota: l'SDK Navigation per Android non supporta AdvancedMarkerOptions; quando utilizzi l'SDK Navigation per Android, aggiungi gli indicatori con GoogleMap.addMarker(MarkerOptions).
- Personalizza un indicatore su una mappa. Nota: l'SDK Navigation per Android non supporta AdvancedMarkerOptions. Quando utilizzi l'SDK Navigation per Android, personalizza gli indicatori con MarkerOptions.
- Rispondi alle interazioni degli utenti con gli indicatori su una mappa.
- Determinare se una coordinata si trova all'interno di un poligono o di un'area circolare su una mappa. Nota: su Android, utilizza PolyUtil.containsLocation nella libreria di utilità di Maps SDK for Android per i poligoni. Per le aree circolari, verifica se la distanza sferica dal centro del cerchio rientra nel raggio (ad esempio, computeDistanceBetween nell'API Maps JavaScript, SphericalUtil.computeDistanceBetween su Android o GMSGeometryDistance su iOS).
- Calcola la distanza sferica, l'area o la direzione tra le coordinate su una mappa.
Maps SDK for Android: stile di mappa
- Crea uno stile di mappa multipiattaforma riutilizzabile.
- Modifica lo stile di strade, polilinee e poligoni su una mappa.
- Visualizza o nascondi gli elementi della mappa.
- Modifica lo stile delle icone e delle etichette di testo su una mappa.
- Applica stili di mappa diversi a livelli di zoom diversi.
- Modifica la densità dei luoghi su una mappa. Sperimentale
- Modifica lo stile degli edifici su una mappa. Sperimentale
- Modifica lo stile dei punti di riferimento su una mappa. Sperimentale
Maps SDK for Android: Street View
- Aggiungi una visualizzazione Google Street View configurabile e interattiva a una pagina web o a un'app mobile.
- Rispondi alle interazioni e agli eventi degli utenti in Google Street View.
- Personalizza i gesti disponibili per Google Street View.
- Anima i movimenti della videocamera per Google Street View.