Skrócony przewodnik po pakiecie Maps SDK na iOS

Maps SDK na iOS umożliwia dodawanie do aplikacji na iOS map opartych na danych Map Google. Pakiet SDK obsługuje dostęp do serwerów Map Google, wyświetlanie mapy i reagowanie na gesty użytkownika, a także umożliwia dodawanie do mapy znaczników, linii łamanych, nakładek naziemnych i okien informacyjnych.

Maps SDK na iOS: najważniejsze informacje

  • Usługa: Maps SDK na iOS
  • Inna nazwa: Google Maps SDK 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 Maps SDK na iOS
  • Dostępność: cały świat. Zobacz stronę z informacjami o dostępności Google Maps Platform. Na stronie z informacjami o użyciu i płatnościach znajdziesz linki do osobnych cenników dla Indii i reszty świata. (szczegóły dotyczące zakresu ochrony)

Maps SDK na iOS: kiedy używać

Używaj pakietu Maps SDK na iOS, gdy:

  • Potrzebujesz interaktywnej mapy Google z obsługą gestów w natywnej aplikacji na iOS.
  • Musisz dodać znaczniki, linie łamane, nakładki naziemne lub okna informacyjne do mapy w aplikacji na iOS.
  • Chcesz wyświetlać panoramy Street View w aplikacji na iOS.
  • Musisz wykonać odwrotne geokodowanie współrzędnych na adresy z aplikacji na iOS, która wyświetla mapę.

Nie używaj pakietu Maps SDK na iOS, gdy:

  • Potrzebujesz fotorealistycznych map 3D w aplikacji na iOS. Użyj pakietu SDK Map 3D na iOS.
  • Wystarczy, że otworzysz lokalizację lub wskazówki dojazdu w aplikacji Mapy Google, zamiast renderować mapę w aplikacji. Zamiast tego użyj adresów URL Map.

Maps SDK na iOS: konfiguracja

Oficjalne pakiety Maps SDK na iOS:

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

Maps SDK na iOS: typowe błędy

  • Problem: pakiet SDK nie obsługuje bibliotek scalanych. Włączenie opcji Build Mergeable Library (Utwórz bibliotekę scaloną) w Xcode powoduje błędy konsolidatora w kompilacjach do publikacji. Rozwiązanie: ustaw opcję Build Mergeable Library (Utwórz bibliotekę możliwą do scalenia) na No (Nie) (ustawienie domyślne). Zobacz /maps/documentation/ios-sdk/config.
  • Problem: bez wpisów LSApplicationQueriesSchemes kliknięcie logo Google na mapie powoduje zarejestrowanie błędów -canOpenURL dla comgooglemaps:// i googlechromes://. Rozwiązanie: dodaj googlechromes i comgooglemaps do LSApplicationQueriesSchemes w Info.plist. Zobacz /maps/documentation/ios-sdk/config.
  • Problem: używanie pakietu SDK w rozszerzeniach aplikacji na iOS (np. niestandardowej klawiaturze) prawdopodobnie nie będzie działać ze względu na rygorystyczne ograniczenia pamięci. Rozwiązanie: używaj pakietu SDK w głównej aplikacji, a nie w rozszerzeniach aplikacji. Zobacz /maps/documentation/ios-sdk/overview.
  • Problem: pakiet SDK nie jest zoptymalizowany pod kątem wielu okien lub jednoczesnych instancji w systemie iPadOS 13 lub nowszym i może działać w niezdefiniowany sposób. Rozwiązanie: dokładnie przetestuj scenariusze z wieloma oknami na iPadzie lub unikaj wielu jednoczesnych instancji mapy. Zobacz /maps/documentation/ios-sdk/overview.

Maps SDK na iOS: funkcje starszego typu i wycofane

  • Mechanizm renderowania OpenGL i setMetalRendererEnabled: wycofane 19 maja 2025 r. Zamiennik: mechanizm renderowania Metal (domyślny od wersji 8.0.0); usuń setMetalRendererEnabled. Objaw: wycofano w wersji 9.0.0 (28.05.2024) i usunięto w wersji 10.0.0; GMSServices nie zawiera już setMetalRendererEnabled:.
  • Moduł GoogleMapsM4B: wycofany od 19 maja 2025 r. Zastąpienie: usuń pod lub platformę GoogleMapsM4B, ponieważ dotyczy nieaktualnego abonamentu. Objaw: wycofano 20 lutego 2024 r.; usunięto z pakietu Swift w wersji 9.0.0 i z pakietu SDK w wersji 10.0.0.
  • Dystrybucja CocoaPods: wycofana 6 sierpnia 2026 r. Zamiennik: Swift Package Manager. Objaw: tryb konserwacji od 18 sierpnia 2025 r.; wycofany od wersji 11.0.0. Zobacz przewodnik po migracji.
  • Instalacja Carthage: wycofana 27 czerwca 2022 r. Zamiennik: Swift Package Manager. Objaw: Carthage nie obsługuje bibliotek przeznaczonych na iOS 13 lub nowszy. Najnowsza wersja dostępna w Carthage to 6.2.1. Zobacz przewodnik po migracji.

Co można zrobić za pomocą pakietu Maps SDK 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.

Maps SDK na iOS: styl oparty na danych dla granic

Maps SDK na iOS: styl oparty na danych w przypadku zbiorów danych

Maps SDK na iOS: zbiory danych

Maps SDK na iOS: geokodowanie

Maps SDK na iOS: Mapy

Maps SDK na iOS: adnotacje na mapach

Maps SDK na iOS: styl mapy

Maps SDK na iOS: Street View