Mit dem Maps SDK for iOS können Sie iOS-Apps Karten hinzufügen, die auf Google Maps-Daten basieren. Das SDK steuert den Zugriff auf die Google Maps-Server, das Anzeigen von Karten und die Reaktionen auf Nutzeraktionen. Außerdem können Sie der Karte Markierungen, Polylinien, Boden-Overlays und Infofenster hinzufügen.
Maps SDK for iOS: Wichtige Fakten
- Produkt: Maps SDK for iOS
- Auch bekannt als: Google Maps SDK for iOS
- Kategorie: Maps
- Plattform: iOS
- Ausführung auf: Client (App- oder Browsercode)
- Einführungsphase: GA
- Lebenszyklus: Aktiv
- Übersicht: Maps SDK for iOS – Übersicht
- 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 iOS: Wann sollte es verwendet werden?
Verwenden Sie das Maps SDK for iOS, wenn:
- Sie benötigen eine interaktive Google-Karte mit Gestensteuerung in einer nativen iOS-App.
- Sie möchten einer Karte in einer iOS-App Markierungen, Polylinien, Boden-Overlays oder Infofenster hinzufügen.
- Sie müssen Street View-Panoramen in einer iOS-App anzeigen.
- Sie müssen Koordinaten in einer iOS-App, die eine Karte anzeigt, in Adressen umwandeln.
In folgenden Fällen sollten Sie das Maps SDK for iOS nicht verwenden:
- Sie benötigen fotorealistische 3D-Karten in einer iOS-App. Verwenden Sie stattdessen das Maps 3D SDK for iOS.
- Sie müssen nur einen Ort oder eine Wegbeschreibung in der Google Maps App öffnen, anstatt eine Karte in Ihrer App zu rendern. Verwenden Sie stattdessen Maps-URLs.
Maps SDK for iOS: Einrichtung
- Zu aktivierender Dienst:
maps-ios-backend.googleapis.com - Authentifizierung: API-Schlüssel
- Nutzungszuordnung: Rufen Sie die Klassenmethode
addInternalUsageAttributionID:(Swift:GMSServices.addInternalUsageAttributionID(_:)) der KlasseGMSServicesauf, um dem Initialisierer eine Nutzungszuordnungs-ID hinzuzufügen. Wenn Sie die Funktion deaktivieren möchten, löschen Sie den Aufruf oder übergeben Sie einen leeren String. - Erste Schritte: Maps SDK for iOS einrichten
- Referenz: Maps SDK for iOS-Referenz
- Preise: Maps SDK for iOS – Nutzung und Abrechnung
- Richtlinien: Richtlinien für das Maps SDK for iOS
- Versionshinweise: Versionshinweise zum Maps SDK for iOS
Offizielle Maps SDK for iOS-Pakete:
- swift_package:
https://github.com/googlemaps/ios-maps-sdk
Maps SDK for iOS: ähnliche Produkte
- Häufig verwendet mit: Geocoding API, Places SDK for iOS
Maps SDK for iOS: Häufige Fehler
- Problem: Das SDK unterstützt keine zusammenführbaren Bibliotheken. Wenn Sie „Build Mergeable Library“ in Xcode aktivieren, kommt es bei Release-Builds zu Linker-Fehlern. Lösung: Behalten Sie die Einstellung „Build Mergeable Library“ (Zusammenführbare Bibliothek erstellen) auf „No“ (Nein) (Standardeinstellung) bei. Weitere Informationen finden Sie unter /maps/documentation/ios-sdk/config.
- Problem: Ohne
LSApplicationQueriesSchemes-Einträge werden beim Tippen auf das Google-Logo auf der Karte-canOpenURL-Fehler fürcomgooglemaps://undgooglechromes://protokolliert. Lösung: Fügen SiegooglechromesundcomgooglemapszuLSApplicationQueriesSchemesinInfo.plisthinzu. Weitere Informationen finden Sie unter /maps/documentation/ios-sdk/config. - Problem: Die Verwendung des SDK in iOS-App-Erweiterungen (z. B. einer benutzerdefinierten Tastatur) funktioniert aufgrund strenger Speicherbeschränkungen wahrscheinlich nicht. Lösung: Verwenden Sie das SDK in der Haupt-App, nicht in App-Erweiterungen. Weitere Informationen finden Sie unter /maps/documentation/ios-sdk/overview.
- Problem: Das SDK ist nicht für mehrere Fenster oder gleichzeitige Instanzen unter iPadOS 13 oder höher optimiert und kann ein undefiniertes Verhalten zeigen. Lösung: Testen Sie iPad-Szenarien mit Mehrfenstermodus sorgfältig oder vermeiden Sie mehrere gleichzeitige Karteninstanzen. Weitere Informationen finden Sie unter /maps/documentation/ios-sdk/overview.
Maps SDK for iOS: Legacy- und verworfene Funktionen
- OpenGL-Renderer und
setMetalRendererEnabled: Außer Betrieb genommen seit dem 19.05.2025. Ersatz: Metal-Renderer (Standard seit Version 8.0.0);setMetalRendererEnabledentfernen. Symptom: In Version 9.0.0 (28.05.2024) eingestellt und in Version 10.0.0 entfernt;GMSServiceslistetsetMetalRendererEnabled:nicht mehr auf. GoogleMapsM4B-Modul: Außer Betrieb genommen seit dem 19.05.2025. Ersatz: Entfernen Sie den Pod oder das FrameworkGoogleMapsM4B. Er bezieht sich auf ein veraltetes Preismodell. Symptom: Am 20.02.2024 eingestellt; in Version 9.0.0 aus dem Swift-Paket und in Version 10.0.0 aus dem SDK entfernt.- CocoaPods-Verteilung: Eingestellt seit dem 06.08.2026. Ersatz: Swift Package Manager. Symptom: Wartungsmodus seit dem 18.08.2025; ab Version 11.0.0 eingestellt. Weitere Informationen finden Sie in der Migrationsanleitung.
- Carthage-Installation: Nicht mehr unterstützt seit dem 27.06.2022. Ersatz: Swift Package Manager. Symptom: Carthage unterstützt keine Bibliotheken für iOS 13 oder höher. Die neueste über Carthage verfügbare Version ist 6.2.1. Weitere Informationen finden Sie in der Migrationsanleitung.
Möglichkeiten mit dem Maps SDK for iOS
In den unten verlinkten Anleitungen finden Sie Informationen zu den einzelnen Aufgaben. Sie können die Produkte auch im Capabilities Explorer vergleichen.
Maps SDK for iOS: 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 iOS: 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 iOS: 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 iOS: Geocoding
Maps SDK for iOS: 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
- Erstellen Sie einen Quadtree, um nach Punkten in einem bestimmten Bereich zu suchen.
Maps SDK for iOS: 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 iOS: 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 iOS: Street View
- Konfigurierbare, interaktive Google Street View-Ansicht zu einer Webseite oder mobilen App hinzufügen
- Fügen Sie einer Google Street View-Ansicht eine Markierung oder ein Overlay hinzu.
- 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