Maps SDK 3D per Android consente alle app per Android di visualizzare mappe 3D interattive create a partire dalle immagini 3D di Google. Fornisce indicatori, popover, polilinee, poligoni, modelli 3D glTF, animazioni dei percorsi della videocamera e controlli per l'interazione dell'utente e il movimento della videocamera.
SDK Maps 3D per Android: informazioni chiave
- Prodotto: SDK Maps 3D per Android
- Noto anche come: SDK Android Maps 3D
- 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 3D SDK for Android
- Disponibilità regionale: limitata. La disponibilità varia in base al paese e alla regione; consulta la colonna Maps 3D (JavaScript, Android, iOS) nella pagina di copertura di Google Maps Platform. (dettagli sulla copertura)
SDK Maps 3D per Android: quando utilizzarlo
Utilizza Maps 3D SDK for Android quando:
- Devi mostrare una mappa 3D interattiva e fotorealistica di località reali in un'app per Android.
- Devi posizionare indicatori, popover, polilinee, poligoni o modelli 3D glTF su una mappa 3D in un'app per Android.
- Hai bisogno di animazioni della videocamera predefinite (volo verso, volo intorno) che guidino gli utenti tra i punti di una mappa 3D.
- Devi controllare quali movimenti della fotocamera e controlli UI possono essere utilizzati dagli utenti su una mappa 3D in un'app per Android.
Non utilizzare Maps 3D SDK for Android quando:
- Stai creando un'app web che richiede mappe 3D. Utilizza invece l'API Maps JavaScript.
- Stai creando un'app per iOS che richiede mappe 3D. Utilizza invece Maps 3D SDK for iOS.
- Hai bisogno di una mappa stradale 2D standard pronta per la produzione in un'app per Android (la modalità
ROADMAPin questo SDK è sperimentale). Utilizza invece Maps SDK for Android.
SDK Maps 3D per Android: configurazione
- Servizio da attivare:
mapsandroid.googleapis.com - Autenticazione: chiave API
- Inizia: configura Maps 3D SDK for Android
- Riferimento: Riferimento dell'SDK Maps 3D per Android
- Prezzi: utilizzo e fatturazione di Maps 3D SDK for Android
- Policy: policy dell'SDK Maps 3D per Android
- Note di rilascio: note di rilascio dell'SDK Maps 3D per Android
Pacchetti ufficiali di Maps 3D SDK for Android:
- maven:
com.google.android.gms:play-services-maps3d
SDK Maps 3D per Android: prodotti correlati
- Spesso utilizzato con: Places SDK for Android
SDK Maps 3D per Android: errori comuni
- Problema: se la modalità mappa non viene specificata al momento del caricamento della mappa, quest'ultima non viene caricata. Correzione: imposta sempre un
Map3DMode(SATELLITE,HYBRIDoROADMAP) nel layout XML (map3d:mapMode) o consetMapMode/Map3DInitConfig. Consulta /maps/documentation/maps-3d/android-sdk/map-modes. - Problema: i click listener (clic su mappa e indicatori) non vengono eseguiti sul thread dell'interfaccia utente principale, pertanto gli aggiornamenti diretti dell'interfaccia utente dal gestore non vanno a buon fine. Correzione: passa al thread principale prima di aggiornare la UI, ad esempio con
lifecycleScope.launch(Dispatchers.Main). Consulta /maps/documentation/maps-3d/android-sdk/add-a-marker. - Problema: lo stato della mappa è condiviso tra le istanze di
Map3DView, quindi gli indicatori, gli overlay e la posizione della fotocamera di una visualizzazione precedente vengono trasferiti a una nuova. Correzione: mantieni attivo un soloMap3DView; chiamaonDestroy()sulla vecchia istanza e cancella manualmente indicatori, overlay e reimposta la fotocamera tramiteGoogleMap3D. Consulta /maps/documentation/maps-3d/android-sdk/add-a-3d-map. - Problema: per impostazione predefinita, toccando un punto d'interesse della mappa base viene visualizzato il widget UI di Places, che richiede anche la dipendenza di Places SDK. Correzione: aggiungi la dipendenza Places SDK for Android e restituisci
truedaonMap3DClickinOnMap3DClickListenerper eliminare il widget predefinito se non lo vuoi. Consulta /maps/documentation/maps-3d/android-sdk/points-of-interest.
Cosa puoi fare con Maps 3D SDK for Android
Consulta le guide collegate di seguito per ogni attività o confronta i prodotti in Capabilities Explorer.
- Aggiungi una mappa 3D fotorealistica interattiva a una pagina web.
- Aggiungi un indicatore a una mappa 3D fotorealistica.
- Personalizza un indicatore su una mappa 3D fotorealistica.
- Aggiungi un modello 3D a una mappa 3D fotorealistica.
- Aggiungi una polilinea 3D a una mappa 3D fotorealistica.
- Aggiungi un poligono 3D a una mappa 3D fotorealistica.
- Rispondi alle interazioni e agli eventi degli utenti su una mappa 3D fotorealistica.
- Personalizza i controlli visualizzati su una mappa 3D fotorealistica.
- Controlla il percorso della videocamera e le animazioni su una mappa 3D fotorealistica.
- Controlla le limitazioni della videocamera su una mappa 3D fotorealistica.