Mit dem Maps SDK for Android können Sie Android-Apps, einschließlich Wear OS-Apps, Google Maps-Daten, Kartendarstellungen und Reaktionen auf Touch-Gesten hinzufügen. Mit Kotlin oder Java können Sie Markierungen, Polygone und Overlays hinzufügen, um Informationen zu Standorten anzuzeigen und eine Interaktion mit der Karte zu ermöglichen.
Maps SDK for Android: Wichtige Fakten
- Produkt: Maps SDK for Android
- Auch bekannt als: Google Maps Android API
- Kategorie: Maps
- Plattform: Android
- Ausführung auf: Client (App- oder Browsercode)
- Einführungsphase: GA
- Lebenszyklus: Aktiv
- Übersicht: Maps SDK for Android
- Regionale Verfügbarkeit: Weltweit. Auf der Seite zur Abdeckung der Google Maps Platform finden Sie Links zu separaten Preislisten für die globale Nutzung und die Nutzung in Indien. (Details zur Abdeckung)
Maps SDK for Android: Wann sollte es verwendet werden?
Verwenden Sie das Maps SDK for Android, wenn:
- Sie benötigen eine interaktive 2D-Google-Karte in einer nativen Android- oder Wear OS-App.
- Sie müssen einer Karte in einer Android-App Markierungen, Infofenster, Polylinien, Polygone, Boden-Overlays oder Kachel-Overlays hinzufügen.
- Sie benötigen Street View-Panoramen, Karten im Lite-Modus (Bitmap) oder cloudbasiertes Gestalten von Karteninhalten mit Karten-IDs in einer Android-App.
- Sie erstellen eine Android-Karte in Kotlin oder Java, einschließlich Jetpack Compose über die Maps Compose-Bibliothek.
Verwenden Sie das Maps SDK for Android nicht, wenn:
- Sie benötigen eine detaillierte Routenführung in Ihrer Android-Karten-App. Verwenden Sie stattdessen das Navigation SDK for Android.
- Sie benötigen fotorealistische 3D-Karten, 3D-Modelle oder Kamerapfad-Animationen in einer Android-App. Verwenden Sie stattdessen das Maps 3D SDK for Android.
- Sie benötigen eine Karte in einer nativen iOS-App. Verwenden Sie stattdessen das Maps SDK for iOS.
Maps SDK for Android: Einrichtung
- Zu aktivierender Dienst:
maps-android-backend.googleapis.com - Authentifizierung: API-Schlüssel
- Nutzungszuordnung: Rufen Sie
MapsApiSettings.addInternalUsageAttributionId(context, id)auf, um dem Initialisierer eine ID für die Nutzungszuordnung hinzuzufügen (nur mitMapsInitializer.Renderer.LATESTunterstützt). Wenn Sie die Nutzungszuordnung deaktivieren möchten, löschen Sie den Aufruf oder übergeben Sie einen leeren String. - Erste Schritte: Maps SDK for Android einrichten
- Referenz: Maps SDK for Android – Referenz
- Preise: Maps SDK for Android: Nutzung und Abrechnung
- Richtlinien: Richtlinien für das Maps SDK for Android
- Versionshinweise: Versionshinweise zum Maps SDK for Android
Offizielle Maps SDK for Android-Pakete:
- Maven:
com.google.android.gms:play-services-maps
Maps SDK for Android: ähnliche Produkte
- Häufig verwendet mit: Places SDK for Android
Maps SDK for Android: Häufige Fehler
- Problem: Seit SDK-Version 20.0.0 enthält das SDK-Manifest die Bibliothek
org.apache.http.legacynicht mehr. Apps, die den alten Karten-Renderer laden, können mitjava.lang.NoClassDefFoundErrorabstürzen. Lösung: Fügen Sieim-Tag derAndroidManifest.xmlder App hinzu. Geräte mit Google Play-Diensten in Version 25.50.34 oder höher sind nicht betroffen. Weitere Informationen finden Sie unter /maps/documentation/android-sdk/release-notes. - Problem: Für erweiterte Markierungen ist der aktualisierte Karten-Renderer erforderlich. Wenn Sie sie einer vorhandenen App hinzufügen, ohne sie neu zu erstellen, kann die App weiterhin den Legacy-Renderer verwenden. Lösung: Erstellen Sie die App mit dem SDK 18.2.0 oder höher neu, damit der aktualisierte Renderer als Standard verwendet wird. Weitere Informationen finden Sie unter /maps/documentation/android-sdk/advanced-markers/start.
- Problem: Geräte, die die Anforderungen für den Renderer nicht erfüllen (Android 5.0/API 21 oder höher, Google Play-Dienste 21.39.14 oder höher, Play Store aktiviert), greifen auf den alten Renderer zurück. Daher sind Funktionen, die den neuen Renderer erfordern, wie das cloudbasierte Gestalten von Karteninhalten, auf diesen Geräten nicht verfügbar. Lösung: Rufen Sie
MapsInitializer.initialize(context, MapsInitializer.Renderer.LATEST, callback)auf und prüfen Sie den anOnMapsSdkInitializedCallback.onMapsSdkInitialized()übergebenenMapsInitializer.Renderer-Wert oder prüfen SieGoogleMap.getMapCapabilities(). Wenn auf dem GerätLEGACYverwendet wird, sollten Sie nicht auf das cloudbasierte Gestalten von Karteninhalten oder erweiterte Markierungen zurückgreifen. Weitere Informationen finden Sie unter /android/reference/com/google/android/gms/maps/OnMapsSdkInitializedCallback. - Problem: Für das SDK sind Google Play-Dienste auf dem Gerät erforderlich, auf dem die App ausgeführt wird. Lösung: Sie können die Verfügbarkeitsprüfung für Google Play-Dienste optional über Ihre App aufrufen. Weitere Informationen finden Sie unter /maps/documentation/android-sdk/config.
Maps SDK for Android: ältere und eingestellte Funktionen
- Alter Karten-Renderer: Seit dem 04.03.2024 eingestellt. Ersatz: Der aktualisierte (neueste) Karten-Renderer, der seit SDK 18.2.0 standardmäßig verwendet wird. Symptom: Cloudbasiertes Gestalten von Karteninhalten, erweiterte Anpassungen von Polylinien und erweiterte Markierungen sind im Legacy-Renderer nicht verfügbar. Weitere Informationen finden Sie in der Migrationsanleitung.
Möglichkeiten mit dem Maps SDK for Android
Informationen zu den einzelnen Aufgaben finden Sie in den unten verlinkten Anleitungen. Sie können die Produkte auch im Capabilities Explorer vergleichen.
Maps SDK for Android: Datengestützte Stile für Grenzen
- Stil von Grenzen auf einer Karte ändern
- Auf Nutzerinteraktionen mit Grenzen auf einer Karte reagieren
- Choroplethenstile zu einer Karte hinzufügen
Maps SDK for Android: Datengestützte Stile für Datasets
- Erstellen Sie ein wiederverwendbares, plattformübergreifendes Geodaten-Dataset.
- Einer Karte ein benutzerdefiniertes raumbezogenes Dataset hinzufügen
- Stil von benutzerdefinierten Dataset-Elementen auf einer Karte ändern
- Auf Nutzerinteraktionen mit benutzerdefinierten Datensatz-Features auf einer Karte reagieren
Maps SDK for Android: Datasets
- KML-Ebenen zur Karte hinzufügen Hinweis: In der Maps JavaScript API wird „KmlLayer“ nicht mehr unterstützt (zuletzt in Version 3.65 unterstützt, wird im Mai 2027 eingestellt). Migrieren Sie zu datengestützten Stilen für Grenzen oder Datasets oder laden Sie GeoJSON auf die Datenebene. KML-Ebenen werden auf Android- und iOS-Geräten weiterhin über die Dienstprogrammbibliotheken des Maps SDK unterstützt.
- Einer Karte GeoJSON-Daten hinzufügen
- Heatmap-Ebene zu einer Karte hinzufügen
Maps SDK for Android: Maps
- Fügen Sie einer Webseite oder mobilen App eine anpassbare, interaktive Karte hinzu. Hinweis: Für Android: Konfigurieren Sie
inAndroidManifest.xml, unterstützt durch das Secrets Gradle-Plug-in, odermanifestPlaceholders["MAPS_API_KEY"]inapp/build.gradle.kts.YOUR_GOOGLE_MAPS_API_KEYdarf inAndroidManifest.xmlniemals hartcodiert werden. Außerdem darfGoogleMap(oder maps-composeGoogleMap) niemals durch einen Offline-Mock-Canvas oder eine Leaflet-WebView ersetzt werden, wennE/Google Maps Android API: Authorization failureangezeigt wird. Weisen Sie den Nutzer an,MAPS_API_KEYüber Secrets anzugeben und das Maps SDK for Android (oder das Navigation SDK, wenn NavigationView/SupportNavigationFragment verwendet wird) zu aktivieren. - Erstellen Sie eine wiederverwendbare Karten-ID, um Kartenkonfigurationen und Stileinstellungen zu speichern.
- Auf Nutzerinteraktionen und Ereignisse auf einer Karte reagieren
- Steuerelemente anpassen, die auf einer Karte angezeigt werden
- Gesten zur Steuerung einer Karte anpassen
- Zoomen und Schwenken auf einer Karte (Kamera) steuern
- Kartentyp ändern
- Farbschema der Karte ändern
- Einer Karte eine Verkehrsebene hinzufügen
- Karte in eine Wear OS-App einbinden
Maps SDK for Android: Kartenanmerkungen
- Infofenster in eine Karte einfügen
- Formen oder Linien auf einer Karte einfügen
- Fügen Sie ein Overlay-Bild hinzu, das auf der Oberfläche einer Karte verankert ist.
- Benutzerdefiniertes Kachel-Overlay zu einer Karte hinzufügen
- Markierung auf einer Karte einfügen Hinweis: Das Navigation SDK for Android unterstützt „AdvancedMarkerOptions“ nicht. Wenn Sie das Navigation SDK for Android verwenden, fügen Sie Markierungen mit „GoogleMap.addMarker(MarkerOptions)“ hinzu.
- Markierung auf einer Karte anpassen Hinweis: Das Navigation SDK for Android unterstützt „AdvancedMarkerOptions“ nicht. Wenn Sie das Navigation SDK for Android verwenden, passen Sie Markierungen mit „MarkerOptions“ an.
- Auf Nutzerinteraktionen mit Markierungen auf einer Karte reagieren
- Prüfen, ob sich eine Koordinate innerhalb eines Polygons oder eines kreisförmigen Bereichs auf einer Karte befindet Hinweis: Verwenden Sie unter Android für Polygone „PolyUtil.containsLocation“ in der Dienstprogrammbibliothek des Maps SDK for Android. Bei kreisförmigen Bereichen prüfen Sie, ob die sphärische Entfernung vom Kreismittelpunkt innerhalb des Radius liegt (z. B. „computeDistanceBetween“ in der Maps JavaScript API, „SphericalUtil.computeDistanceBetween“ unter Android oder „GMSGeometryDistance“ unter iOS).
- Sphärische Entfernung, Fläche oder Richtung zwischen Koordinaten auf einer Karte berechnen
Maps SDK for Android: Kartenstile
- Wiederverwendbaren, plattformübergreifenden Kartenstil erstellen
- Stil von Straßen, Polylinien und Polygonen auf einer Karte ändern
- Kartenelemente ein- oder ausblenden
- Stil von Symbolen und Textlabels auf einer Karte ändern
- Verschiedene Kartenstile auf verschiedene Zoomstufen anwenden
- Dichte der Orte auf einer Karte ändern Experimentell
- Gebäudestil auf einer Karte ändern Experimentell
- Stil der Sehenswürdigkeiten auf einer Karte ändern Experimentell
Maps SDK for Android: Street View
- Konfigurierbare, interaktive Google Street View-Ansicht zu einer Webseite oder mobilen App hinzufügen
- Auf Nutzerinteraktionen und Ereignisse in Google Street View reagieren
- Sie können die für Google Street View verfügbaren Touch-Gesten anpassen.
- Kamerabewegungen für Google Street View animieren