Krótkie wprowadzenie do pakietu SDK Map 3D na Androida

Pakiet Maps 3D SDK na Androida umożliwia aplikacjom na Androida wyświetlanie interaktywnych map 3D utworzonych na podstawie zdjęć 3D Google. Zapewnia znaczniki, wyskakujące okienka, linie łamane, wielokąty, modele 3D glTF, animacje ścieżki kamery oraz elementy sterujące interakcją użytkownika i ruchem kamery.

Pakiet SDK Map 3D na Androida: najważniejsze informacje

  • Usługa: pakiet SDK Map 3D na Androida
  • Inna nazwa: Maps 3D Android SDK
  • Kategoria: Mapy
  • Platforma: Android
  • Działa na: kliencie (kod aplikacji lub przeglądarki)
  • Etap uruchomienia: GA
  • Cykl życia: aktywny
  • Omówienie: omówienie pakietu SDK Map 3D na Androida
  • Dostępność: ograniczona. Dostępność zależy od kraju i regionu. Zobacz kolumnę Mapy 3D (JavaScript, Android, iOS) na stronie z informacjami o dostępności Google Maps Platform. (szczegóły ochrony)

Pakiet SDK Map 3D na Androida: kiedy go używać

Używaj pakietu SDK Map 3D na Androida, gdy:

  • Musisz wyświetlić interaktywną, fotorealistyczną mapę 3D rzeczywistych lokalizacji w aplikacji na Androida.
  • Potrzebujesz znaczników, wyskakujących okienek, linii łamanych, wielokątów lub modeli 3D glTF umieszczonych na mapie 3D w aplikacji na Androida.
  • Potrzebujesz wstępnie zdefiniowanych animacji kamery (lot do, lot wokół), które prowadzą użytkowników między punktami na mapie 3D.
  • Musisz kontrolować, których ruchów kamery i elementów sterujących interfejsu użytkownicy mogą używać na mapie 3D w aplikacji na Androida.

Nie używaj pakietu Maps 3D SDK na Androida, gdy:

  • Tworzysz aplikację internetową, która wymaga map 3D. Zamiast tego użyj Maps JavaScript API.
  • Tworzysz aplikację na iOS, która wymaga map 3D. Zamiast tego użyj pakietu SDK Map 3D na iOS.
  • Potrzebujesz przygotowanej do zastosowań produkcyjnych standardowej mapy ulic 2D w aplikacji na Androida (tryb ROADMAP w tym pakiecie SDK jest eksperymentalny). Zamiast tego użyj Maps SDK na Androida.

Pakiet SDK Map 3D na Androida: konfiguracja

Oficjalne pakiety SDK Map 3D na Androida:

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

Pakiet SDK Map 3D na Androida: typowe błędy

  • Problem: jeśli tryb mapy nie zostanie określony podczas jej wczytywania, mapa się nie wczyta. Rozwiązanie: zawsze ustawiaj Map3DMode (SATELLITE, HYBRID lub ROADMAP) w pliku XML układu (map3d:mapMode) lub za pomocą setMapMode/Map3DInitConfig. Zobacz /maps/documentation/maps-3d/android-sdk/map-modes.
  • Problem: detektory kliknięć (kliknięcia mapy i znacznika) nie działają w głównym wątku UI, więc bezpośrednie aktualizacje interfejsu z poziomu modułu obsługi nie działają. Rozwiązanie: przed zaktualizowaniem interfejsu przełącz się na wątek główny, np. za pomocą lifecycleScope.launch(Dispatchers.Main). Zobacz /maps/documentation/maps-3d/android-sdk/add-a-marker.
  • Problem: stan mapy jest udostępniany w instancjach Map3DView, więc znaczniki, nakładki i pozycja kamery ze starego widoku są przenoszone do nowego. Rozwiązanie: zachowaj tylko 1 aktywny element Map3DView; wywołaj onDestroy() w starej instancji i ręcznie wyczyść znaczniki i nakładki oraz zresetuj kamerę za pomocą GoogleMap3D. Zobacz /maps/documentation/maps-3d/android-sdk/add-a-3d-map.
  • Problem: domyślnie kliknięcie ciekawego miejsca na mapie podstawowej powoduje wyświetlenie widżetu interfejsu Miejsc, który wymaga też zależności pakietu SDK Miejsc. Rozwiązanie: dodaj zależność pakietu SDK Miejsc na Androida i zwróć true z onMap3DClick w OnMap3DClickListener, aby pominąć domyślny widżet, jeśli go nie chcesz. Zobacz /maps/documentation/maps-3d/android-sdk/points-of-interest.

Co możesz zrobić dzięki pakietowi SDK Map 3D na Androida

Zapoznaj się z przewodnikami po poszczególnych zadaniach, do których linki znajdziesz poniżej, lub porównaj usługi w Eksploratorze funkcji.