Skrócony przewodnik po pakiecie Maps SDK na Androida

Maps SDK na Androida dodaje do aplikacji na Androida, w tym do aplikacji na Wear OS, dane Map Google, wyświetlanie map i reakcje na gesty na mapie. Możesz dodawać znaczniki, wielokąty i nakładki, aby wyświetlać informacje o lokalizacjach na mapie i umożliwiać interakcję z użytkownikiem, korzystając z języka Kotlin lub Java.

Maps SDK na Androida: najważniejsze informacje

  • Produkt: Maps SDK na Androida
  • Inna nazwa: Google Maps Android API
  • Kategoria: Mapy
  • Platforma: Android
  • Działa na: kliencie (kod aplikacji lub przeglądarki)
  • Etap uruchomienia: GA
  • Cykl życia: aktywny
  • Omówienie: omówienie pakietu Maps SDK na Androida
  • Dostępność: cały świat. Zobacz stronę z informacjami o dostępności Google Maps Platform. Na stronie z informacjami o użyciu i płatnościach znajdziesz linki do osobnych cenników dla Indii i reszty świata. (szczegóły ochrony)

Maps SDK na Androida: kiedy go używać

Używaj pakietu Maps SDK na Androida, gdy:

  • Potrzebujesz interaktywnej mapy Google 2D w natywnej aplikacji na Androida lub Wear OS.
  • Musisz dodać do mapy w aplikacji na Androida znaczniki, okna informacyjne, linie łamane, wielokąty, nakładki naziemne lub nakładki kafelkowe.
  • Potrzebujesz panoram Street View, map w wersji uproszczonej (bitmap) lub definiowania stylów map w Google Cloud z identyfikatorami map w aplikacji na Androida.
  • Mapę na Androida możesz utworzyć w języku Kotlin lub Java, w tym za pomocą Jetpack Compose i biblioteki Maps Compose.

Kiedy nie używać pakietu Maps SDK na Androida:

Maps SDK na Androida: konfiguracja

Oficjalne pakiety Maps SDK na Androida:

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

Maps SDK na Androida: typowe błędy

  • Problem: od wersji 20.0.0 pakietu SDK plik manifestu pakietu SDK nie zawiera już biblioteki org.apache.http.legacy. Aplikacje, które wczytują starszą wersję mechanizmu renderowania map, mogą ulec awarii z powodu błędu java.lang.NoClassDefFoundError. Rozwiązanie: dodaj w tagu w pliku AndroidManifest.xml aplikacji. Nie dotyczy to urządzeń z Usługami Google Play w wersji 25.50.34 lub nowszej. Zobacz /maps/documentation/android-sdk/release-notes.
  • Problem: znaczniki zaawansowane wymagają ulepszonego mechanizmu renderowania map. Jeśli dodasz je do istniejącej aplikacji bez jej ponownego kompilowania, aplikacja może nadal używać starszego mechanizmu renderowania. Rozwiązanie: ponownie utwórz aplikację, używając pakietu SDK w wersji 18.2.0 lub nowszej, aby ulepszony mechanizm renderowania był domyślny. Zobacz /maps/documentation/android-sdk/advanced-markers/start.
  • Problem: urządzenia, które nie spełniają wymagań renderera (Android 5.0 / interfejs API 21 lub nowszy, Usługi Google Play 21.39.14 lub nowsze, włączony Sklep Play), wracają do starszego renderera, więc funkcje, które wymagają nowego renderera, takie jak definiowanie stylów map w Google Cloud, nie są na nich dostępne. Rozwiązanie: wywołaj MapsInitializer.initialize(context, MapsInitializer.Renderer.LATEST, callback) i sprawdź wartość MapsInitializer.Renderer przekazaną do OnMapsSdkInitializedCallback.onMapsSdkInitialized() lub sprawdź GoogleMap.getMapCapabilities(). Jeśli urządzenie korzysta z LEGACY, nie polegaj na definiowaniu stylów map w Google Cloud ani na zaawansowanych znacznikach. Zobacz /android/reference/com/google/android/gms/maps/OnMapsSdkInitializedCallback.
  • Problem: pakiet SDK wymaga Usług Google Play na urządzeniu, na którym działa aplikacja. Rozwiązanie: opcjonalnie wywołaj z aplikacji sprawdzanie dostępności Usług Google Play. Zobacz /maps/documentation/android-sdk/config.

Maps SDK na Androida: funkcje starszego typu i wycofane

  • Starsza wersja mechanizmu renderowania mapy: wycofana 4 marca 2024 r. Zamiennik: ulepszony (najnowszy) mechanizm renderowania map, który jest domyślny od wersji pakietu SDK 18.2.0. Objaw: definiowanie stylów map w Google Cloud, zaawansowane opcje dostosowywania linii łamanych i zaawansowane znaczniki nie są dostępne w starszej wersji mechanizmu renderowania. Zobacz przewodnik po migracji.

Co można zrobić za pomocą pakietu Maps SDK 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.

Maps SDK na Androida: styl oparty na danych dla granic

Maps SDK na Androida: styl oparty na danych w przypadku zbiorów danych

Maps SDK na Androida: zbiory danych

Maps SDK na Androida: Mapy

Maps SDK na Androida: adnotacje na mapach

Maps SDK na Androida: styl mapy

Maps SDK for Android: Street View