Maps SDK for iOS – Kurzübersicht

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

Offizielle Maps SDK for iOS-Pakete:

  • swift_package: https://github.com/googlemaps/ios-maps-sdk

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ür comgooglemaps:// und googlechromes:// protokolliert. Lösung: Fügen Sie googlechromes und comgooglemaps zu LSApplicationQueriesSchemes in Info.plist hinzu. 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); setMetalRendererEnabled entfernen. Symptom: In Version 9.0.0 (28.05.2024) eingestellt und in Version 10.0.0 entfernt; GMSServices listet setMetalRendererEnabled: nicht mehr auf.
  • GoogleMapsM4B-Modul: Außer Betrieb genommen seit dem 19.05.2025. Ersatz: Entfernen Sie den Pod oder das Framework GoogleMapsM4B. 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

Maps SDK for iOS: Datengestützte Stile für Datasets

Maps SDK for iOS: Datasets

Maps SDK for iOS: Geocoding

Maps SDK for iOS: Maps

Maps SDK for iOS: Kartenanmerkungen

Maps SDK for iOS: Kartenstile

Maps SDK for iOS: Street View