Krótkie wprowadzenie do pakietu SDK Map 3D na iOS

Pakiet Maps 3D SDK na iOS umożliwia tworzenie map 3D w aplikacjach na iOS przy użyciu zdjęć 3D Google. Zapewnia interfejsy SwiftUI API do znaczników, wyskakujących okienek, linii łamanych, wielokątów, modeli 3D (glTF), animacji ścieżki kamery oraz elementów sterujących kamerą i interakcjami.

Pakiet SDK Map 3D na iOS: najważniejsze informacje

  • Usługa: pakiet SDK Map 3D na iOS
  • Kategoria: Mapy
  • Platforma: iOS
  • Działa na: kliencie (kod aplikacji lub przeglądarki)
  • Etap uruchomienia: GA
  • Cykl życia: aktywny
  • Omówienie: omówienie pakietu SDK Map 3D na iOS

Pakiet SDK Map 3D na iOS: kiedy warto z niego korzystać

Kiedy używać pakietu SDK Map 3D na iOS:

  • Potrzebujesz interaktywnej, fotorealistycznej mapy 3D w natywnej aplikacji na iOS (SwiftUI).
  • Musisz umieścić znaczniki, wyskakujące okienka, linie łamane, wielokąty lub modele 3D glTF na mapie 3D w iOS.
  • Potrzebujesz animacji kamery typu przelot lub przelot wokół albo ograniczeń kamery na mapie 3D na iOS.
  • Użytkownicy muszą klikać punkty na mapie 3D i wyświetlać informacje o miejscu za pomocą wbudowanego widżetu Places UI Kit.

Nie używaj pakietu SDK Map 3D na iOS, gdy:

Pakiet SDK Map 3D na iOS: konfiguracja

Oficjalne pakiety SDK Map 3D na iOS:

  • 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)

Pakiet SDK Map 3D na iOS: typowe błędy

  • Problem: jeśli podczas wczytywania mapy nie jest ustawiony tryb mapy, mapa nie zostanie wczytana. Rozwiązanie: podczas tworzenia Map zawsze przekazuj tryb, na przykład Map(mode: .hybrid). Zobacz /maps/documentation/maps-3d/ios-sdk/map-modes.
  • Problem: ustawienie klucza interfejsu API zarówno w punkcie wejścia aplikacji, jak i w poszczególnych widokach mapy powoduje błąd konsoli. Rozwiązanie: ustaw Map.apiKey tylko w jednym miejscu: w punkcie wejścia aplikacji lub w każdym widoku mapy. Zobacz /maps/documentation/maps-3d/ios-sdk/setup.
  • Problem: Camera altitudeMode jest ignorowany poza animacjami kamery; dotyczy tylko flyCameraTo i flyCameraAround. Rozwiązanie: użyj flyCameraTo lub flyCameraAround, gdy korzystasz z Camera altitudeMode. Zobacz /maps/documentation/maps-3d/ios-sdk/custom-camera-paths.
  • Problem: w GoogleMaps3DKit widżet interfejsu Miejsc jest domyślnie wyświetlany, gdy użytkownik kliknie interesujące miejsce. Rozwiązanie: użyj placeInformationEnabled(false) lub zwróć .none z onPlaceTap(_:), aby ukryć widżet. Zobacz /maps/documentation/maps-3d/ios-sdk/points-of-interest.

Co można zrobić za pomocą pakietu SDK Map 3D na iOS

Zapoznaj się z przewodnikami po poszczególnych zadaniach, do których linki znajdziesz poniżej, lub porównaj usługi w Eksploratorze funkcji.