Pomoc dotycząca systemu operacyjnego i oprogramowania Google Maps Platform

Zasady obsługi wersji mobilnego systemu operacyjnego

Wraz z rozwojem mobilnych systemów operacyjnych oraz wprowadzaniem funkcji i aktualizacji Google Maps Platform wstrzymujemy obsługę starszych wersji mobilnych systemów operacyjnych.

Ograniczenie obsługi wersji pakietu SDK Google Maps Platform do określonych wersji Androida i iOS pomaga Google w określaniu zakresu i skali testowania pakietu SDK.

W tej sekcji opisujemy zasady pomocy Google Maps Platform dotyczące platform mobilnych. Te zasady obejmują tylko produkty ogólnie dostępne (GA).

Wstrzymanie obsługi systemu operacyjnego nie jest objęte 12-miesięcznym okresem powiadomienia o zakończeniu świadczenia usług, zgodnie z definicją w Warunkach korzystania z usługi Google Maps Platform.

Właściciele projektów otrzymują proaktywne powiadomienia o zmianach, które mają wpływ na poszczególne projekty. Bądź na bieżąco z najważniejszymi aktualizacjami, wycofywaniem funkcji i innymi zmianami.

Terminologia

Podsumowanie tabeli obsługiwanych minimalnych wersji systemu operacyjnego Android

  Najnowsza wersja pakietu SDK, która jest kompilowana z tą wersją systemu operacyjnego (data wydania)
Wersja Androida Maps SDK (biblioteka klienta) Nav SDK SDK Miejsc Driver SDK Pakiet SDK dla konsumentów
Android Nougat – poziom interfejsu API 24 (2016) Najnowsze Najnowsze Najnowsze Najnowsze Najnowsze
Android Marshmallow – poziom interfejsu API 23 (2015 r.) Najnowsze 6.3 (18.06.25) 4.4.1 (7.06.2025) 6.2 (18.06.2025) Najnowsze
Android Lollipop – poziom interfejsu API 21 (2014 r.) 19.2.0 (14.04.2025) 4,99 PLN (6 lipca 2023 r.) 3.5.0 (28.05.2024) 4,99 PLN (9.08.2023) 1.99.1 (31.08.2023)
Android KitKat – poziom 19 interfejsu API (2013 r.) 18.2(18.10.2023) 3.2(10/07/2021) 2.7.0(11/01/2021) 3.0.4 (28.07.2021) 0.9.28 (18.05.2021)

Podsumowanie tabeli obsługi minimalnej wersji systemu iOS

  Najnowsza wersja pakietu SDK, która jest kompilowana z tą wersją systemu operacyjnego (data wydania)
Wersja iOS Pakiety SDK Map i Nawigacji SDK Miejsc Pakiety SDK dla konsumentów i kierowców
16 (2022) i nowsze Najnowsze Najnowsze Najnowsze
15 (2021) 9.4 (18.03.2025) 9.4 (10.03.2025) 9.2.1 (28.03.2025)
14 (2020) 8.5 (1 kwietnia 2024 r.) 8.5 (1 kwietnia 2024 r.) 3.3.0 (6.3.2024)
13 (2019) 7.4 (27.02.2023) 7.4 (27.02.2023) 2.2.1 (17.04.2023)
12 (2018) 6.2 (25.04.2022) 6.2 (25.04.2022)  

Zasady pomocy dotyczące systemu operacyjnego Android

Nowe wersje pakietów SDK Google Maps Platform na Androida obsługują wersję Androida (poziom interfejsu API, np. 29 i 30) przez co najmniej 6 lat od jej wprowadzenia. Zawieszenia systemu operacyjnego mogą być wprowadzane bez zwiększania numeru wersji głównej.

Na przykład w przypadku wersji Androida wydanej w 2020 r. nowe wersje pakietu Places SDK na Androida będą obsługiwać tę wersję co najmniej do 2026 r.

Od czasu do czasu, gdy korzystanie z Androida w wersji starszej niż 6-letnia wystarczająco zmaleje:

  • Google wstrzyma obsługę tej wersji Androida, a w nowych wersjach pakietów SDK na Androida minimalną obsługiwaną wersją systemu operacyjnego będzie wersja o 1 wyższa.

  • W związku z tym musisz zdecydować, czy:

    • Zastosuj najnowszą wersję pakietu SDK i zwiększ minimalną obsługiwaną wersję systemu operacyjnego w przypadku nowych wersji aplikacji. Odpowiednio określ wersje zależności kompilacji.
    • Możesz też pozostać przy poprzedniej wersji pakietu SDK, co może ograniczyć możliwość otrzymywania poprawek błędów w sposób wstecznie zgodny zgodnie z sekcją dotyczącą pomocy w zakresie pakietu SDK.

    Na przykład Google może wstrzymać obsługę Androida 7 (poziom API 25, wydany w 2016 r.), co sprawi, że Android 8 (poziom API 26) będzie minimalnym obsługiwanym systemem operacyjnym w nowych wersjach pakietów Google Maps Platform SDK na Androida. Wersje aplikacji utworzone za pomocą starszych wersji pakietu SDK będą nadal działać na urządzeniach z Androidem 7, a wersje aplikacji utworzone za pomocą wersji pakietu SDK wydanych po tym terminie nie będą mogły działać na urządzeniach z Androidem 7.

Wyjątkiem od harmonogramu zamrażania wersji systemu operacyjnego jest pakiet Maps SDK na Androida, który jest dostarczany w ramach usług Google Play.

Maps SDK na Androida

Pakiet Maps SDK na Androida nie jest objęty tymi zasadami dotyczącymi obsługi wersji systemu operacyjnego. Środowisko wykonawcze pakietu Maps SDK na Androida jest częścią usług Google Play (znanych też jako „Usługi mobilne Google” lub „GMS Core”), które są wymagane do uruchamiania aplikacji Google na urządzeniach z Androidem. Usługi Google Play mają własny harmonogram obsługi poziomów interfejsu API Androida (co ilustruje ten komunikat), więc harmonogram obsługi pakietu Maps SDK na Androida zależy od obsługi systemu operacyjnego przez Usługi Google Play. Informacje o wersjach interfejsu Android API, na których działają Usługi Google Play, znajdziesz w artykule Konfigurowanie Usług Google Play.

Biblioteka klienta pakietu Maps SDK na Androida (fasada interfejsu API), która współpracuje ze środowiskiem wykonawczym map w Usługach Google Play, jest jednak wersjonowana i obsługiwana na określonych poziomach interfejsu API Androida zgodnie z zasadami pomocy dotyczącej systemu operacyjnego Android. Podczas tworzenia aplikacji za pomocą pakietu Maps SDK na Androida deweloperzy ustawiają wersję biblioteki klienta jako zależność.

Jeśli aplikacja używa nowszej wersji biblioteki klienta, ale jest uruchamiana na urządzeniu ze starszą wersją Usług Google Play, żadne nowsze funkcje nie będą na tych urządzeniach działać. Nie występują awarie ani wyjątki aplikacji.

Usługi Google Play mogą okresowo ograniczać publikowanie aplikacji utworzonych przy użyciu starszych wersji biblioteki klienta (fasady interfejsu API). W takim przypadku podczas publikowania aplikacji w Sklepie Play otrzymasz ostrzeżenie i możesz mieć zablokowaną możliwość publikowania kolejnych wersji do czasu zaktualizowania biblioteki. Więcej informacji znajdziesz w Centrum pomocy Konsoli Play.

Więcej informacji o wersjach Androida znajdziesz w artykule Wersje platformy Android SDK.

Zasady pomocy dotyczące iOS

Nowe wersje pakietów SDK Google Maps Platform na iOS obsługują wersję systemu operacyjnego iOS przez co najmniej 3 lata od jej pierwszej publikacji. Zawieszenia systemu operacyjnego mogą być wprowadzane bez zwiększania numeru wersji głównej. Przykłady znajdziesz w zasadach pomocy dotyczących systemu operacyjnego Android.

Obsługa pakietu SDK

Gdy Google opublikuje nową wersję pakietu SDK do urządzeń mobilnych Google Maps Platform:

  • Firma Google przetestowała tę wersję pod kątem zgodności z wersjami systemu operacyjnego aż do podanej minimalnej obsługiwanej wersji systemu operacyjnego.
  • Poprawki pakietu SDK w ciągu 12 miesięcy od pierwszej publikacji tej wersji głównej będą wstecznie zgodne* z tą wersją.
    • * Z wyjątkiem 1. brak zgodności wstecznej, który może być spowodowany zależnościami pakietu SDK, np. Kotlinem; Niekompatybilność wsteczna wynikająca z minimalnej obsługiwanej wersji systemu operacyjnego. Zmiany te mogą zostać wprowadzone bez zwiększania numeru wersji głównej.
  • Po upływie 12 miesięcy od daty pierwszej publikacji tej wersji głównej poprawki pakietu SDK mogą nie być wstecznie zgodne z tą wersją.
  • Google będzie rozwiązywać problemy z backendem spowodowane przez usługi Google Maps Platform do momentu wycofania wersji pakietu SDK.

Obsługa IDE

Pakiety SDK Google Maps Platform na iOS są zgodne z programowaniem na iOS w zintegrowanym środowisku programistycznym Xcode firmy Apple. Różne wersje Xcode zawierają różne wersje języka programowania Swift oraz pakiety SDK dla różnych wersji systemów operacyjnych Apple.

Google okresowo podnosi minimalną wersję Xcode obsługiwaną w nowych wersjach głównych pakietów SDK Google Maps Platform na iOS. Zapoznaj się z informacjami o wersji i tematami dotyczącymi obsługiwanego oprogramowania, aby sprawdzić minimalną obsługiwaną wersję Xcode dla wersji pakietu SDK, której chcesz użyć do kompilacji.

Obsługa przeglądarek

Interfejsy Maps JavaScript API i Maps Embed API obsługują następujące przeglądarki:

Komputer
  • Aktualna wersja Microsoft Edge (Windows), z wyjątkiem trybu IE.
  • Dwie najnowsze stabilne wersje główne przeglądarki Firefox (Windows, macOS, Linux).
  • Dwie najnowsze główne stabilne wersje Chrome (Windows, macOS, Linux).
  • dwie najnowsze główne stabilne wersje Safari (macOS);
Android
  • Aktualna wersja Chrome na Androidzie 4.1 lub nowszym.
  • Chrome WebView na Androidzie 4.4 lub nowszym.
iOS
  • Mobile Safari w aktualnej i poprzedniej głównej wersji iOS.
  • UIWebView i WKWebView w bieżącej i poprzedniej głównej wersji iOS.
  • Aktualna wersja Chrome na iOS.