Kurzübersicht zum Maps 3D SDK für iOS

Mit dem Maps 3D SDK for iOS können Sie 3D-Karten in iOS-Apps mit 3D-Bildern von Google erstellen. Sie bietet SwiftUI APIs für Markierungen, Pop-over, Polylinien, Polygone, 3D-Modelle (glTF), Kamerapfad-Animationen sowie Kamera- und Interaktionssteuerelemente.

Maps 3D SDK für iOS: Wichtige Fakten

  • Produkt: Maps 3D SDK für iOS
  • Kategorie: Maps
  • Plattform: iOS
  • Ausführung auf: Client (App- oder Browsercode)
  • Einführungsphase: GA
  • Lebenszyklus: Aktiv
  • Übersicht: Maps 3D SDK for iOS

Maps 3D SDK für iOS: Wann sollte es verwendet werden?

Verwenden Sie das Maps 3D SDK für iOS, wenn:

  • Sie benötigen eine interaktive, fotorealistische 3D-Karte in einer nativen iOS-App (SwiftUI).
  • Sie müssen Markierungen, Popover, Polylinien, Polygone oder glTF-3D-Modelle auf einer 3D-Karte in iOS platzieren.
  • Sie benötigen Kameraanimationen für den Flug zu oder um einen Ort oder Kamerabeschränkungen auf einer 3D-Karte in iOS.
  • Nutzer sollen auf POIs in der 3D-Karte tippen und über das integrierte Places UI Kit-Widget Ortsdetails sehen können.

In folgenden Fällen sollten Sie das Maps 3D SDK für iOS nicht verwenden:

  • Sie benötigen eine 3D-Karte in einer Android-App. Verwenden Sie stattdessen das Maps 3D SDK for Android.
  • Sie benötigen eine 3D-Karte auf einer Webseite. Verwenden Sie stattdessen die Maps JavaScript API.
  • Sie benötigen eine standardmäßige 2D-Karte in einer iOS-App. Verwenden Sie stattdessen das Maps SDK for iOS.

Maps 3D SDK für iOS: Einrichtung

Offizielle Maps 3D SDK für iOS-Pakete:

  • swift_package: https://github.com/googlemaps/ios-maps-3d-sdk (product GoogleMaps3D)
  • swift_package: https://github.com/googlemaps/ios-maps-3d-sdk (product GoogleMaps3DKit, for POI taps with the Places UI Kit widget)

Maps 3D SDK für iOS: Häufige Fehler

  • Problem: Wenn beim Laden der Karte kein Kartenmodus festgelegt ist, kann die Karte nicht geladen werden. Lösung: Übergeben Sie beim Erstellen des Map immer einen Modus, z. B. Map(mode: .hybrid). Weitere Informationen finden Sie unter /maps/documentation/maps-3d/ios-sdk/map-modes.
  • Problem: Wenn der API-Schlüssel sowohl im App-Einstiegspunkt als auch in einzelnen Kartenansichten festgelegt wird, wird ein Konsolenfehler erzeugt. Lösung: Legen Sie Map.apiKey nur an einer Stelle fest: im Einstiegspunkt der App oder in jeder Kartenansicht. Weitere Informationen finden Sie unter /maps/documentation/maps-3d/ios-sdk/setup.
  • Problem: Camera altitudeMode wird außerhalb von Kameraanimationen ignoriert und gilt nur für flyCameraTo und flyCameraAround. Lösung: Verwenden Sie flyCameraTo oder flyCameraAround, wenn Sie auf Camera altitudeMode angewiesen sind. Weitere Informationen finden Sie unter /maps/documentation/maps-3d/ios-sdk/custom-camera-paths.
  • Problem: In GoogleMaps3DKit wird das Places-UI-Widget standardmäßig angezeigt, wenn ein Nutzer auf einen POI tippt. Lösung: Verwenden Sie placeInformationEnabled(false) oder geben Sie .none von onPlaceTap(_:) zurück, um das Widget zu unterdrücken. Weitere Informationen finden Sie unter /maps/documentation/maps-3d/ios-sdk/points-of-interest.

Möglichkeiten mit dem Maps 3D SDK für iOS

In den unten verlinkten Anleitungen finden Sie Informationen zu den einzelnen Aufgaben. Sie können die Produkte auch im Capabilities Explorer vergleichen.