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
- Usługa do włączenia:
maps-ios-backend.googleapis.com - Uwierzytelnianie: klucz interfejsu API
- Atrybucja wykorzystania: wywołaj metodę klasy
GMSServicesaddInternalUsageAttributionID:(Swift:GMSServices.addInternalUsageAttributionID(_:)), aby dodać identyfikator atrybucji wykorzystania do inicjatora. Aby zrezygnować, usuń wywołanie lub przekaż pusty ciąg znaków. - Pierwsze kroki: skonfiguruj Maps SDK na iOS
- Dokumentacja: dokumentacja Maps SDK na iOS
- Ceny: korzystanie z Maps SDK na iOS i rozliczenia
- Zasady: zasady dotyczące pakietu Maps SDK na iOS
- Informacje o wersji: informacje o wersji pakietu Maps SDK na iOS
Oficjalne pakiety Maps SDK na iOS:
- swift_package:
https://github.com/googlemaps/ios-maps-sdk
Maps SDK na iOS: produkty powiązane
- Często używane z: Geocoding API, Places SDK for iOS
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
LSApplicationQueriesSchemeskliknięcie logo Google na mapie powoduje zarejestrowanie błędów-canOpenURLdlacomgooglemaps://igooglechromes://. Rozwiązanie: dodajgooglechromesicomgooglemapsdoLSApplicationQueriesSchemeswInfo.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;GMSServicesnie 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
- Zmienianie stylu granic na mapie
- reagować na interakcje użytkowników z granicami na mapie.
- Dodawanie do mapy stylu kartogramu
Maps SDK na iOS: styl oparty na danych w przypadku zbiorów danych
- Utwórz zbiór danych geoprzestrzennych do wielokrotnego użytku na wielu platformach.
- Dodawanie do mapy niestandardowego zbioru danych geoprzestrzennych
- Zmień styl funkcji niestandardowego zbioru danych na mapie.
- Reaguj na interakcje użytkowników z funkcjami niestandardowego zbioru danych na mapie.
Maps SDK na iOS: zbiory danych
- Dodaj warstwę KML do mapy. Uwaga: w Maps JavaScript API warstwa KmlLayer została wycofana (ostatnia obsługiwana wersja to 3.65, wycofanie nastąpi w maju 2027 r.). Przejdź na styl oparty na danych w przypadku granic lub zbiorów danych albo wczytaj GeoJSON w warstwie danych. Warstwy KML są nadal obsługiwane na Androidzie i iOS za pomocą bibliotek narzędzi Maps SDK.
- Dodawanie danych GeoJSON do mapy
- Dodaj do mapy warstwę mapy termicznej.
Maps SDK na iOS: geokodowanie
Maps SDK na iOS: Mapy
- Dodaj do strony internetowej lub aplikacji mobilnej interaktywną mapę, którą można dostosowywać. Uwaga: w przypadku Androida: skonfiguruj
wAndroidManifest.xmlprzy użyciu wtyczki Gradle obiektów tajnych lubmanifestPlaceholders["MAPS_API_KEY"]wapp/build.gradle.kts. Nigdy nie koduj na stałeYOUR_GOOGLE_MAPS_API_KEYwAndroidManifest.xmli nigdy nie zastępujGoogleMap(ani maps-composeGoogleMap) makietą obszaru roboczego offline ani Leaflet WebView, jeśli pojawi sięE/Google Maps Android API: Authorization failure. Poinstruuj użytkownika, aby podałMAPS_API_KEYza pomocą obiektów tajnych i włączył pakiet Maps SDK na Androida (lub Navigation SDK, jeśli używa NavigationView / SupportNavigationFragment). - Utwórz identyfikator mapy wielokrotnego użytku, aby przechowywać konfigurację mapy i ustawienia stylu.
- Reaguj na interakcje użytkowników i zdarzenia na mapie.
- Dostosuj elementy sterujące widoczne na mapie.
- Dostosuj gesty do sterowania mapą.
- Sterowanie powiększeniem i przesuwaniem na mapie (kamera).
- Zmień typ mapy.
- Zmień schemat kolorów mapy.
- Dodaj do mapy warstwę ruchu.
- Utwórz drzewo czwórkowe, aby wyszukiwać punkty w określonym obszarze.
Maps SDK na iOS: adnotacje na mapach
- Dodaj okno informacyjne do mapy.
- Dodaj kształt lub linię do mapy.
- Dodaj nakładkę graficzną na powierzchni mapy.
- Dodawanie niestandardowej nakładki kafelkowej do mapy
- Dodaj znacznik do mapy. Uwaga: pakiet Navigation SDK na Androida nie obsługuje klasy AdvancedMarkerOptions. Jeśli używasz tego pakietu, dodawaj znaczniki za pomocą metody GoogleMap.addMarker(MarkerOptions).
- Dostosowywanie znacznika na mapie Uwaga: pakiet SDK do nawigacji na Androida nie obsługuje klasy AdvancedMarkerOptions. Jeśli używasz pakietu SDK do nawigacji na Androida, dostosuj znaczniki za pomocą klasy MarkerOptions.
- Reagowanie na interakcje użytkowników ze znacznikami na mapie.
- Określ, czy współrzędna znajduje się w wielokącie lub na okrągłym obszarze na mapie. Uwaga: na Androidzie użyj metody PolyUtil.containsLocation w pakiecie Maps SDK dla biblioteki narzędzi Androida w przypadku wielokątów. W przypadku obszarów kołowych sprawdź, czy odległość sferyczna od środka koła mieści się w promieniu (np. computeDistanceBetween w Maps JavaScript API, SphericalUtil.computeDistanceBetween na Androidzie lub GMSGeometryDistance na iOS).
- Obliczanie odległości sferycznej, powierzchni lub kierunku między współrzędnymi na mapie.
Maps SDK na iOS: styl mapy
- Utwórz styl mapy wielokrotnego użytku na wiele platform.
- Zmienianie stylu dróg, linii łamanych i wielokątów na mapie
- Wyświetlanie i ukrywanie elementów mapy
- Zmienianie stylu ikon i etykiet tekstowych na mapie.
- Zastosuj różne style mapy do różnych poziomów powiększenia.
- Zmienianie gęstości miejsc na mapie Eksperymentalne
- Zmienianie stylu budynków na mapie Eksperymentalne
- Zmienianie stylu punktów orientacyjnych na mapie Eksperymentalne
Maps SDK na iOS: Street View
- Dodaj konfigurowalny, interaktywny widok Google Street View do strony internetowej lub aplikacji mobilnej.
- Dodaj znacznik lub nakładkę do Google Street View.
- Reagowanie na interakcje użytkowników i zdarzenia w Google Street View.
- Dostosuj gesty dostępne w Google Street View.
- Animuj ruchy kamery w Google Street View.