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:
- Potrzebujesz szczegółowych wskazówek dojazdu w aplikacji mapowej na Androida. Użyj pakietu Navigation SDK na Androida.
- Potrzebujesz fotorealistycznych map 3D, modeli 3D lub animacji ścieżki kamery w aplikacji na Androida. Zamiast tego użyj pakietu SDK Map 3D na Androida.
- Potrzebujesz mapy w natywnej aplikacji na iOS. Użyj Maps SDK na iOS.
Maps SDK na Androida: konfiguracja
- Usługa do włączenia:
maps-android-backend.googleapis.com - Uwierzytelnianie: klucz interfejsu API
- Atrybucja wykorzystania: wywołaj
MapsApiSettings.addInternalUsageAttributionId(context, id), aby dodać identyfikator atrybucji wykorzystania do inicjatora (obsługiwane tylko w przypadkuMapsInitializer.Renderer.LATEST). Aby zrezygnować, usuń wywołanie lub przekaż pusty ciąg znaków. - Pierwsze kroki: skonfiguruj pakiet SDK Map na Androida
- Dokumentacja: dokumentacja Maps SDK na Androida
- Ceny: korzystanie z Maps SDK na Androida i płatności
- Zasady: zasady dotyczące pakietu Maps SDK na Androida
- Informacje o wersji: informacje o wersji pakietu Maps SDK na Androida
Oficjalne pakiety Maps SDK na Androida:
- maven:
com.google.android.gms:play-services-maps
Maps SDK na Androida: produkty powiązane
- Często używane z: pakietem SDK Miejsc na Androida
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łędujava.lang.NoClassDefFoundError. Rozwiązanie: dodajw taguw plikuAndroidManifest.xmlaplikacji. 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.Rendererprzekazaną doOnMapsSdkInitializedCallback.onMapsSdkInitialized()lub sprawdźGoogleMap.getMapCapabilities(). Jeśli urządzenie korzysta zLEGACY, 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
- Zmienianie stylu granic na mapie
- reagować na interakcje użytkowników z granicami na mapie.
- Dodawanie do mapy stylu kartogramu
Maps SDK na Androida: styl oparty na danych w przypadku zbiorów danych
- Utwórz zbiór danych geoprzestrzennych do wielokrotnego użytku na wielu platformach.
- Dodawanie do mapy niestandardowego zbioru danych geoprzestrzennych
- Zmień styl funkcji niestandardowego zbioru danych na mapie.
- Reaguj na interakcje użytkowników z funkcjami niestandardowego zbioru danych na mapie.
Maps SDK na Androida: zbiory danych
- Dodaj warstwę KML do mapy. Uwaga: w Maps JavaScript API warstwa KmlLayer została wycofana (ostatnia obsługiwana wersja to 3.65, wycofanie nastąpi w maju 2027 r.). Przejdź na styl oparty na danych w przypadku granic lub zbiorów danych albo wczytaj GeoJSON w warstwie danych. Warstwy KML są nadal obsługiwane na Androidzie i iOS za pomocą bibliotek narzędzi Maps SDK.
- Dodawanie danych GeoJSON do mapy
- Dodaj do mapy warstwę mapy termicznej.
Maps SDK na Androida: Mapy
- Dodaj do strony internetowej lub aplikacji mobilnej interaktywną mapę, którą można dostosowywać. Uwaga: w przypadku Androida: skonfiguruj
wAndroidManifest.xmlprzy użyciu wtyczki Gradle obiektów tajnych lubmanifestPlaceholders["MAPS_API_KEY"]wapp/build.gradle.kts. Nigdy nie koduj na stałeYOUR_GOOGLE_MAPS_API_KEYwAndroidManifest.xmli nigdy nie zastępujGoogleMap(ani maps-composeGoogleMap) makietą obszaru roboczego offline ani Leaflet WebView, jeśli pojawi sięE/Google Maps Android API: Authorization failure. Poinstruuj użytkownika, aby podałMAPS_API_KEYza pomocą obiektów tajnych i włączył pakiet Maps SDK na Androida (lub Navigation SDK, jeśli używa NavigationView / SupportNavigationFragment). - Utwórz identyfikator mapy wielokrotnego użytku, aby przechowywać konfigurację mapy i ustawienia stylu.
- Reaguj na interakcje użytkowników i zdarzenia na mapie.
- Dostosuj elementy sterujące widoczne na mapie.
- Dostosuj gesty do sterowania mapą.
- Sterowanie powiększeniem i przesuwaniem na mapie (kamera).
- Zmień typ mapy.
- Zmień schemat kolorów mapy.
- Dodaj do mapy warstwę ruchu.
- Dodaj mapę do aplikacji na Wear OS.
Maps SDK na Androida: adnotacje na mapach
- Dodaj okno informacyjne do mapy.
- Dodaj kształt lub linię do mapy.
- Dodaj nakładkę graficzną na powierzchni mapy.
- Dodawanie niestandardowej nakładki kafelkowej do mapy
- Dodaj znacznik do mapy. Uwaga: pakiet Navigation SDK na Androida nie obsługuje klasy AdvancedMarkerOptions. Jeśli używasz tego pakietu, dodawaj znaczniki za pomocą metody GoogleMap.addMarker(MarkerOptions).
- Dostosowywanie znacznika na mapie Uwaga: pakiet SDK do nawigacji na Androida nie obsługuje klasy AdvancedMarkerOptions. Jeśli używasz pakietu SDK do nawigacji na Androida, dostosuj znaczniki za pomocą klasy MarkerOptions.
- Reagowanie na interakcje użytkowników ze znacznikami na mapie.
- Określ, czy współrzędna znajduje się w wielokącie lub na okrągłym obszarze na mapie. Uwaga: na Androidzie użyj metody PolyUtil.containsLocation w pakiecie Maps SDK dla biblioteki narzędzi Androida w przypadku wielokątów. W przypadku obszarów kołowych sprawdź, czy odległość sferyczna od środka koła mieści się w promieniu (np. computeDistanceBetween w Maps JavaScript API, SphericalUtil.computeDistanceBetween na Androidzie lub GMSGeometryDistance na iOS).
- Obliczanie odległości sferycznej, powierzchni lub kierunku między współrzędnymi na mapie.
Maps SDK na Androida: styl mapy
- Utwórz styl mapy wielokrotnego użytku na wiele platform.
- Zmienianie stylu dróg, linii łamanych i wielokątów na mapie
- Wyświetlanie i ukrywanie elementów mapy
- Zmienianie stylu ikon i etykiet tekstowych na mapie.
- Zastosuj różne style mapy do różnych poziomów powiększenia.
- Zmienianie gęstości miejsc na mapie Eksperymentalne
- Zmienianie stylu budynków na mapie Eksperymentalne
- Zmienianie stylu punktów orientacyjnych na mapie Eksperymentalne
Maps SDK for Android: Street View
- Dodaj konfigurowalny, interaktywny widok Google Street View do strony internetowej lub aplikacji mobilnej.
- Reagowanie na interakcje użytkowników i zdarzenia w Google Street View.
- Dostosuj gesty dostępne w Google Street View.
- Animuj ruchy kamery w Google Street View.