Elementy wycofane

Na tej stronie znajdziesz listę wszystkich usług i funkcji Google Maps Platform, które są obecnie wycofywane. Obejmuje to usługi z sekcji Mapy, Trasy i Miejsca.

Jak działa wycofywanie

Okres wycofywania usługi, funkcji lub wersji rozpoczyna się w dniu ogłoszenia ich wycofania. Usługa, funkcja lub wersja będą nadal dostępne przez cały okres wycofywania (zwykle przez 12 miesięcy). Po upływie okresu wycofywania usługa, funkcja lub wersja powinny zostać wycofane i przestaną być dostępne.

Właściciele projektów, którzy mają monitorowane adresy e-mail, otrzymują aktywne powiadomienia o zmianach, które wpływają na ich projekty. Bądź na bieżąco z głównymi aktualizacjami, wycofywaniami i innymi zmianami.

Wycofanie wersji pakietu SDK

W pakietach SDK i interfejsie Maps JavaScript API wycofanie funkcji jest powiązane z dostępnością wersji. Nowe główne wersje deklarują zmiany powodujące niezgodność, w tym wycofania funkcji oraz informacje o wersji, wskazują maksymalną obsługiwaną wersję każdej wycofanej funkcji. Możesz używać tej funkcji tak długo, jak dostępna będzie jej maksymalna obsługa. Aby uaktualnić pakiet SDK do następnej wersji głównej, musisz usunąć z kodu możliwość korzystania z wycofanej funkcji lub przeprowadzić migrację do jej nowej wersji.

Dowiedz się więcej o dostępności wersji interfejsu Maps JavaScript API, która obejmuje harmonogram publikowania kwartalnego i wycofywania.

Zobacz wskazówki zarządzania zależnościami wersji za pomocą pakietu SDK Map Google na Androida, pakietu Maps SDK na iOS, pakietu Places SDK na Androida i pakietu Places SDK na iOS.

Aktywne wycofane elementy

Ta sekcja zawiera listę wszystkich usług i funkcji, które są obecnie wycofane.


google.maps.Marker w interfejsie Maps JavaScript API (wycofane od lutego 2023 r.)

Znaczniki zaawansowane (google.maps.marker.AdvancedMarkerElement) są lepsze od google.maps.Marker pod każdym względem: łatwiejsze w użyciu, wydajniejsze, bardziej dostępne, bogate w funkcje i bardziej konfigurowalne. W wersji 3.56 opcja google.maps.Marker w interfejsie Maps JavaScript API została wycofana.

Co muszę zrobić? Minimalna wersja interfejsu Maps JavaScript API z atrybutem google.maps.marker.AdvancedMarkerElement to 3.53.2. Wycofujemy obecnie tag google.maps.Marker, ale zamiast google.maps.Marker zalecamy stosowanie klasy google.maps.marker.AdvancedMarkerElement. Mimo że google.maps.Marker będzie nadal otrzymywać poprawki błędów poważnych regresji, istniejące błędy w google.maps.Marker nie będą naprawiane. O zakończeniu udzielania pomocy powiadomimy Cię z co najmniej 12-miesięcznym wyprzedzeniem.


Ograniczenia, lokalizacja i promień w usłudze autouzupełniania miejsc w interfejsie Maps JavaScript API (wycofana od maja 2023 r.)

W maju 2023 r. w przypadku usługi autouzupełniania miejsc w interfejsie Maps JavaScript API wycofaliśmy te opcje żądań: granice, lokalizację i promień. Użyj funkcji LocationBias i LocationRestriction.

Funkcja będzie nadal działać, a przed zakończeniem wsparcia wyślemy do Ciebie powiadomienie z 12-miesięcznym wyprzedzeniem.


Biblioteka lokalnego kontekstu, Maps JavaScript API (wycofane od wersji 3.51.2)

Ze względu na ograniczone wykorzystanie tej funkcji beta od wersji 3.51.2 biblioteka kontekstu lokalnego została wycofana. Biblioteka lokalnego kontekstu zostanie wycofana w styczniu 2024 r. Do tego czasu udostępnimy poprawki poważnych błędów i incydentów.

Jeśli chcesz samodzielnie utworzyć środowisko przypominające bibliotekę lokalnego kontekstu, skorzystaj z rozwiązania „Odkrywanie okolicy” w narzędziu Quick Builder lub skorzystaj z biblioteki miejsc oraz interfejsu Maps JavaScript API. Mogą Ci się przydać przykłady kodu i ćwiczenia z programowania dotyczące Biblioteki miejsc.


Biblioteka zgodności Miejsc dla pakietu Places SDK na Androida (od 31 marca 2022 r.)

Wszystkie wersje biblioteki zgodności Miejsc dla pakietu SDK Miejsc na Androida zostały wycofane 31 marca 2022 r. Wstrzymujemy prace nad biblioteką zgodności Miejsc w pakiecie SDK Miejsc na Androida w wersji 2.6.0 (określonej w zależnościach jako com.google.android.libraries.places:places-compat:2.6.0).

Po tej dacie nie będą publikowane żadne nowe wersje tej biblioteki. Jedynym sposobem na uzyskanie dostępu do funkcji i poprawek błędów w pakiecie Places SDK dla Androida w wersji nowszej niż 2.6.0 będzie skorzystanie z pakietu Places SDK dla Androida.

W styczniu 2019 r. wprowadziliśmy bibliotekę zgodności Miejsc, aby ułatwić migrację ze starszego pakietu SDK (dostępnego w Usługach Google Play) do samodzielnego pakietu SDK Miejsc na Androida.

Postępuj zgodnie z przewodnikiem po migracji, aby bezpośrednio użyć pakietu Places SDK na Androida. Niektóre kody stanu, nazwy metod i nazwy klas autouzupełniania różnią się między biblioteką zgodności Miejsc a pakietem Places SDK na Androida. Informacje o określaniu i utrzymywaniu zależności od wersji pakietu SDK Miejsc na Androida znajdziesz w dokumentacji wersji.

Obecnie nie planujemy wycofać biblioteki zgodności Miejsc. Jeśli jednak nadal zdecydujesz się korzystać z dostępnych wersji biblioteki zgodności Miejsc, zwróć uwagę na ograniczenia obsługi starych wersji pakietu SDK.


Aktualizacja Content Security Policy (21 marca – maj 2023 r.)

Obsługa witryn korzystających z Content Security Policy (CSP), które nie określają wartości googleapis.com w interfejsie Maps JavaScript API, jest wycofywana od wersji 3.49. Nie będzie ona już obsługiwana od wersji 3.50. Ostatnia obsługiwana wersja – 3.49 – zostanie wycofana w II kwartale 2023 r.. Po jej zakończeniu interfejs Maps JavaScript API będzie odrzucać wszystkie żądania korzystające z dyrektyw CSP, które nie określają googleapis.com.

Aby uniknąć przerw w działaniu witryny, określ googleapis.com w CSP. Wszystkie obecnie dostępne wersje interfejsu Maps JavaScript API obsługują CSP.


Usługi gier Google Maps Platform (18 października – 31 grudnia 2022 r.)

Usługi gier Google Maps Platform zostały wycofane 18 października 2021 r. i zostaną wycofane 31 grudnia 2022 r. W okresie wycofywania Google będzie nadal zapewniać pomoc i naprawiać poważne błędy i awarie. Zapoznaj się z przewodnikiem przenoszenia usług gier, aby uzyskać materiały, które pomogą Ci zaplanować kolejne kroki w projektach.


Nieaktualne identyfikatory miejsc (16 marca – 30 marca 2022 r.)

30 marca 2022 r. wszystkie interfejsy API Google Maps Platform przestaną akceptować niektóre przestarzałe identyfikatory miejsc. Od 30 marca 2022 r. wszystkie żądania wysyłane z wykorzystaniem nieaktualnych identyfikatorów miejsc będą odrzucane i będą zwracać kod błędu INVALID_REQUEST. Aby uniknąć spadku wygody użytkowników, odśwież wszystkie identyfikatory miejsc starsze niż 12 miesięcy przed 30 marca 2022 r.


Moduł Mapy w google.load (13 października – 13 października 2021 r.)

Usługa udostępniająca moduł „Mapy” dla aplikacji google.load została wycofana 13 października 2020 r. i zostanie wyłączona 13 października 2021 r. Kolejne żądania wczytania modułu „Mapy” w przeglądarce google.load będą wiązać się z błędem i nie wczytaniem mapy. Więcej informacji znajdziesz w przewodniku po migracji.


Pakiet SDK Miejsc na iOS GMSPlaceField używa teraz makra NS_OPTIONS (od wersji 4.0.0)

Począwszy od pakietu Places SDK na iOS v4.0.0, GMSPlaceField, aby zapewnić lepszą obsługę Swift, teraz korzysta się z makra NS_OPTIONS zamiast NS_ENUM. Dowiedz się więcej o migracji do GMSPlaceField jako NS_OPTIONS.

Aby nadal używać GMSPlaceField jako NS_ENUM, określ w zależnościach wersję v3.10.0 lub wcześniejszą.


Pakiet Places SDK dla metod iOS: setAutocompleteBoundsUsingNorthEastCorner:SouthWestCorner, initWithBounds:filter (v3.10.0–4.0.0)

Metoda pomocnicza setAutocompleteBoundsUsingNorthEastCorner:SouthWestCorner została wycofana od v3.10.0 i nie jest obsługiwana w wersjach v4.0.0 i nowszych. Zamiast tego użyj funkcji locationBias lub locationRestriction.

Metoda initWithBounds:filter jest wycofana od v3.10.0 i nie jest obsługiwana w wersjach v4.0.0 i nowszych. Zamiast tego użyj initWithFilter: w GMSAutocompleteFetcher.

Maksymalna obsługiwana wersja tych wycofanych metod to v3.10.0.

Szczegółowe informacje o metodach zastępowania znajdziesz w Dodatku 1.


GMSCoordinateBounds w autouzupełnianiu miejsc (3.9.0–4.0.0)

Niektóre właściwości/parametry korzystające z GMSCoordinateBounds w usłudze autouzupełniania Miejsc SDK na iOS zostały wycofane v3.9.0 i nie są obsługiwane w wersji v4.0.0 ani nowszych. Maksymalna obsługiwana wersja wycofanych usług/parametrów to v3.10.0.

Ograniczenia w: GMSAutocompleteViewController

Te właściwości GMSAutocompleteViewController zostały wycofane:

Aby uzyskać podobną funkcjonalność, użyj właściwości GMSAutocompleteViewController.autocompleteFilter z GMSAutocompleteFilter.locationBias lub GMSAutocompleteFilter.locationRestriction. Minimalną wersją pakietu Places SDK dla iOS z tymi nowymi właściwościami jest wersja 3.8.0.

Ograniczenia w tych krajach: findAutocompletePredictionsFromQuery i autocompleteQuery

Aby uzyskać podobną funkcjonalność, użyj właściwości findAutocompletePredictionsFromQuery:filter:sessionToken:callback z GMSAutocompleteFilter.locationBias lub GMSAutocompleteFilter.locationRestriction. Minimalna wersja pakietu Places SDK na iOS z tymi zamiennikami to v3.8.0.

Szczegółowe informacje o metodach zastępowania znajdziesz w Dodatku 1.


Pole Miejsca GMSPlace.openNowStatus (wersja 3.0.0–4.0.0)

Pole/właściwość Miejsc GMSPlace.openNowStatus w pakiecie SDK Miejsc na iOS jest wycofywana od v3.0.0 i nie jest już obsługiwana w wersji v4.0.0 i nowszych. Maksymalna obsługiwana wersja wycofanego pola to v3.10.0.

Zamiast tego używaj funkcji GMSPlace.isOpen lub GMSPlace.isOpenAtDate. Minimalną wersją pakietu Places SDK na iOS z tymi funkcjami zamiennymi jest v3.3.0.


Pole Miejsca: permanently_closed (wycofane 26 maja 2020 r.)

Pole Places permanently_closed w interfejsie Places API i bibliotece Places API oraz Maps JavaScript API zostało wycofane i nie należy go używać. Zamiast tego używaj interfejsu business_status (Places API) lub business_status (biblioteka Miejsc), aby sprawdzać stan operacyjny firm. Minimalną wersją biblioteki miejsc (Map JavaScript API z business_status) jest v3.40.


Pola miejsc open_now, utc_offset (wycofane 20 listopada 2019 r.)

Pola Miejsca open_now i utc_offset z biblioteki Miejsc oraz Mapy JavaScript API zostały wycofane 20 listopada 2019 r. i nie należy ich używać.

Te pola zostały wycofane tylko w bibliotece Miejsc Google i interfejsie Maps JavaScript API.

  • Pole open_now w szczegółach miejsca zostało zastąpione wartością PlaceResult.opening_hours.isOpen(). W przypadku wyszukiwania w pobliżu i wyszukiwania tekstowego możesz użyć parametru żądania openNow:true, aby filtrować miejsca, które są obecnie otwarte. Nie podano odpowiednika funkcji Znajdź miejsce. Aby uzyskać tę wartość, musisz przesłać żądanie informacji o miejscu.
  • Pole utc_offset w szczegółach miejsca zostało zastąpione wartością PlaceResult.utc_offset_minutes.

Więcej informacji znajdziesz w artykule na temat migracji pól Miejsc.


Maps JavaScript API: google.maps.event.addDomListener() i google.maps.event.addDomListenerOnce() (wycofany 7 kwietnia 2022 r.)

Funkcje [google.maps.event.addDomListener()](/maps/documentation/javascript/reference/event#event.addDomListener) i [google.maps.event.addDomListenerOnce()](/maps/documentation/javascript/reference/event#event.addDomListenerOnce) w interfejsie Maps JavaScript API zostały wycofane i nie należy ich używać. Zamiast tego użyj standardowej metody addEventListener().

Te metody będą nadal działać i nie ma planów ich wycofania.


Wycofane wycofane

W tej sekcji wymienione są wszystkie usługi i funkcje, które zostały wycofane. Te usługi i funkcje nie są już dostępne.


Maps SDK na iOS w wersji 2.5 lub starszej (styczeń–styczeń 2023 r.)

W styczniu 2023 r. wycofaliśmy pakiet Maps SDK na iOS w wersji 2.5 i starszych, co spowodowało podniesienie minimalnej wersji systemu operacyjnego obsługiwanego przez pakiet SDK Maps SDK na iOS do wersji iOS 8, a minimalne obsługiwane środowisko IDE – do Xcode 8.

Zachęcamy do określenia i używania najnowszej wersji pakietu Maps SDK na iOS.


Maps JavaScript API w wersji 2 (19 maja – 26 maja 2021 r.)

Od 26 maja 2021 r. wersja 2 interfejsu Maps JavaScript API nie jest już dostępna. W efekcie mapy w wersji 2 witryny przestaną działać i zostaną zwrócone błędy JavaScriptu. Aby nadal korzystać z map w swojej witrynie, przejdź na interfejs Maps JavaScript API w wersji 3. Dowiedz się więcej o uaktualnianiu aplikacji Maps JavaScript API z wersji 2 do 3.


Pola miejsc: reference, id, alt_id, scope (3 września – 10 sierpnia 2020 r.)

Pola id, alt_id i scope w Miejscach są niedostępne od 10 sierpnia 2020 r. Pole Miejsca reference nie jest używane i nie należy go używać.

  • Pole odpowiedzi id zostało zastąpione polem odpowiedzi place_id.
  • Pole odpowiedzi reference zostało zastąpione odpowiedzią place_id i nie powinno być używane.
  • pola alt_id i scope nie mają odpowiednika, ponieważ były używane tylko w przypadku usługi „Place Add”, która została wyłączona w lipcu 2018 r.

Więcej informacji znajdziesz w artykule Przenoszenie pól.


iOS w wersji 10, 32-bitowa architektura ARMv7 w pakiecie Maps SDK na iOS 5.0

Od pakietu SDK Map Google na iOS w wersji 5.0 systemy iOS 10 i 32-bitowa architektura ARMv7 nie są już obsługiwane.

Pakiet SDK Miejsc na iOS

Wraz z opublikowaniem pakietu SDK Miejsc na iOS 5.0 pakiet GMSCoordinateBounds został wycofany i zastąpiony przez pakiet GMSPlacesViewportInfo.

Warstwa Fusion Tables (funkcja eksperymentalna) (3 grudnia 2018 r. – 3 grudnia 2019 r.)

Warstwa Fusion Tables w interfejsie Maps JavaScript API została wyłączona 3 grudnia 2019 r. i nie jest już dostępna od wersji 3.38 (3.37 to ostatnia wersja obsługująca tabele Fusion Tables). Więcej informacji


Pakiety SDK Miejsc na Androida i iOS (29 stycznia – 29 lipca 2019 r.)

29 stycznia 2019 r. uaktualnione pakiety SDK Miejsc na Androida i iOS zastąpiły dotychczasowe wersje tych pakietów. Obecne wersje pakietu Places SDK dla iOS, Places SDK na Androida oraz selektora miejsc zostały wycofane 29 stycznia 2019 r. i wyłączyliśmy 29 lipca 2019 r.


Dodawanie i usuwanie miejsc (30 czerwca 2017 r. – 30 czerwca 2018 r.)

30 czerwca 2018 roku funkcje dodawania i usuwania miejsc zostały wyłączone i nie są już dostępne.


Nieobsługiwane zapytania dotyczące wyszukiwania miejsc w interfejsie Places API i bibliotece Miejsc, Maps JavaScript API (31 marca 2022 r. – 31 marca 2023 r.)

31 marca 2022 r. wycofaliśmy nieobsługiwane zapytania dotyczące wyszukiwania miejsc w przypadku wyszukiwania tekstowego, wyszukiwania w pobliżu i funkcji Znajdź miejsce w interfejsach Places API i bibliotece Places. Interfejs Maps JavaScript API zostanie wycofany 31 marca 2022 r.. Od 31 marca 2023 r. będziesz otrzymywać INVALID_REQUEST odpowiedzi na błędy.

Interfejsów Places API i Places Library oraz Maps JavaScript API obsługuje 3 metody wyszukiwania miejsc: wyszukiwanie tekstowe, wyszukiwanie w pobliżu i znajdowanie miejsca. Każda metoda akceptuje żądania z obsługiwanymi kombinacjami parametrów i odrzuca większość żądań z kombinacjami parametrów, które nie są obsługiwane.

Kilka kombinacji nieobsługiwanych parametrów nie zostało do tej pory prawidłowo odrzuconych:

  • Żądania wyszukiwania tekstowego z pustym lub brakującym parametrem query i bez obsługiwanego parametru type.
  • Żądania wyszukiwania tekstu z query=*.
  • Zapytania o wyszukiwanie w pobliżu od: keyword=*.
  • Zapytania o wyszukiwanie w pobliżu od: name=*.
  • Znajdź prośby o dodanie miejsca od: input=*.

Te nieobsługiwane żądania o wyszukiwaniu miejsc muszą zostać zastąpione jednym z następujących:

  • Żądania wyszukiwania w pobliżu bez parametru keyword (lub name) mogą służyć do znajdowania pobliskich placówek. Zalecamy też użycie parametru type z jednym obsługiwanym typem (patrz Tabela 1. Typy miejsc). Zapewnia to najbliższe dopasowanie do obecnego zachowania żądań wyszukiwania tekstowego z pustym lub brakującym parametrem query.

  • Do znajdowania najbliższych adresów można używać żądań Geocoding API z parametrem latlng. Zapewnia to działanie najbliższe aktualnemu działaniu:

    • Żądania wyszukiwania tekstu z query=*.
    • Zapytania o wyszukiwanie w pobliżu od: keyword=*.
    • Zapytania o wyszukiwanie w pobliżu od: name=*.
    • Znajdź prośby o dodanie miejsca od: input=*.

Załącznik 1: podsumowanie wycofanych zamienników pakietu Places SDK dla iOS

W tabeli poniżej znajdziesz metody zastępowania używane w przypadku poszczególnych wycofanych metod lub właściwości.

Wycofana metoda/usługa Użyj zamiast tego
setAutocompleteBoundsUsingNorthEastCorner:SouthWestCorner
(w GMSAutocompleteViewController)
locationRestriction i locationBias
setAutocompleteBoundsUsingNorthEastCorner:SouthWestCorner
(w GMSAutocompleteResultsViewController)
locationRestriction i locationBias
setAutocompleteBoundsUsingNorthEastCorner:SouthWestCorner
(w GMSAutocompleteTableDataSource)
locationRestriction i locationBias
initWithBounds:filter
(w GMSAutocompleteFetcher)
initWithFilter:
autocompleteBounds i autocompleteBoundsMode
(w GMSAutocompleteViewController)
GMSAutocompleteViewController.autocompleteFilter za pomocą locationBias lub locationRestriction.
findAutocompletePredictionsFromQuery:bounds:boundsMode:filter:SessionToken:callback, autocompleteQuery:bounds:filter:callback i autocompleteQuery:bounds:boundsMode:filter:callback
(w: GMSPlacesClient)
findAutocompletePredictionsFromQuery:filter:sessionToken:callback z locationBias lub locationRestriction.

Minimalna wersja pakietu Places SDK na iOS z zastąpionymi właściwościami to v3.8.0.