Riferimento rapido di Maps 3D SDK for Android

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à ROADMAP in questo SDK è sperimentale). Utilizza invece Maps SDK for Android.

SDK Maps 3D per Android: configurazione

Pacchetti ufficiali di Maps 3D SDK for Android:

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

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, HYBRID o ROADMAP) nel layout XML (map3d:mapMode) o con setMapMode/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 solo Map3DView; chiama onDestroy() sulla vecchia istanza e cancella manualmente indicatori, overlay e reimposta la fotocamera tramite GoogleMap3D. 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 true da onMap3DClick in OnMap3DClickListener per 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.