Zespół Maps JavaScript API regularnie aktualizuje ten interfejs o nowe funkcje, poprawki błędów i ulepszenia wydajności. Na tej stronie opisaliśmy wersje interfejsu API dostępne do użycia w Twoich aplikacjach.
Kanały wersji i numery wersji
W aplikacji możesz określić kanały wersji lub numery wersji:
- Kanał tygodniowy jest określony za pomocą
v=weekly
.
Ten kanał jest aktualizowany raz w tygodniu i jest aktualny. - Kanał kwartalny jest określony za pomocą
v=quarterly
.
Ten kanał jest aktualizowany raz na kwartał i jest najbardziej przewidywalny. - Kanał beta jest określony za pomocą
v=beta
.
Ten kanał opiera się na kanaleweekly
i jest aktualizowany raz w tygodniu. Obejmuje ona dodatkowe zmiany wczesnego testowania i opinii. - Kanał alfa jest określony za pomocą
v=alpha
.
Ten kanał opiera się na kanalebeta
i jest aktualizowany raz w tygodniu. Obejmuje ona eksperymenty dotyczące opinii klientów na temat prototypów. Służy jedynie do programowania i nie należy jej używać w środowisku produkcyjnym. - Numer wersji jest określony za pomocą
v=n.nn
.
Możesz wybraćv=3.52
,v=3.51
,v=3.50
lubv=3.49
.
Numery wersji są aktualizowane raz na kwartał (patrz kwartalne aktualizacje).
Jeśli nie określisz kanału lub wersji, domyślnie będziesz otrzymywać kanał tygodniowy. Jeśli przeprowadzisz migrację z abonamentu premium i nie określisz kanału ani wersji, domyślnie otrzymasz kanał kwartalny. Jeśli określisz nieprawidłową wersję, otrzymasz kanał domyślny.
Wybór kanału tygodniowego
W przypadku większości aplikacji zalecamy cotygodniowy kanał. Jest to najnowsza i aktualna wersja zawierająca najnowsze poprawki błędów i ulepszenia wydajności. Aby określić kanał tygodniowy, wczytaj Maps JavaScript API za pomocą tego tagu skryptu:
<script async
src="https://maps.googleapis.com/maps/api/js?v=weekly
&key=YOUR_API_KEY&callback=initMap">
</script>
Obecnie kanał tygodniowy to 3.52. Ta wersja jest aktualizowana co tydzień o nowe funkcje, poprawki błędów i lepsze działanie aplikacji.
W połowie kwietnia zaktualizujemy cotygodniowy kanał do wersji 3.53. W takiej sytuacji nowa wersja może usunąć wycofane funkcje lub wprowadzić niezgodności wsteczne.
Wybór kanału kwartalnego
Niektóre aplikacje mogą osiągać lepsze wyniki przy mniejszej liczbie aktualizacji, ale ze względu na jej większą przewidywalność. Aplikacje powinny korzystać z kanału kwartalnego. Użyj tej metody, jeśli chcesz otrzymywać poprawki błędów i zwiększać wydajność w oczekiwanym czasie (patrz aktualizacje kwartalne). Aby określić kanał kwartalny, możesz wczytać interfejs Maps JavaScript API za pomocą tego tagu skryptu:
<script async
src="https://maps.googleapis.com/maps/api/js?v=quarterly
&key=YOUR_API_KEY&callback=initMap">
</script>
Obecnie kanał kwartalny ma wersję 3.51. W tym kwartale nie pojawią się nowe funkcje, poprawki błędów ani lepsze działanie aplikacji. Możemy co jakiś czas wprowadzać w tej wersji poprawki błędów zabezpieczeń.
W połowie kwietnia zaktualizujemy kwartalną wersję kanału do wersji 3.52. Nowa wersja będzie wtedy zawierać nowe funkcje, usuwać funkcje wycofane lub wprowadzać niezgodności wsteczne z ostatnich 3 miesięcy.
Wybór kanału wersji beta
Użyj wersji beta, aby wypróbować nowe funkcje i zmiany w wersji beta. Funkcje beta są już gotowe, ale mogą występować nierozwiązane problemy (aby zgłosić problemy i przesłać opinię, użyj narzędzia do śledzenia problemów). Kanał w wersji beta nie jest objęty żadną gwarancją jakości usług ani zasadami wycofywania, a niektóre zmiany mogą nie być zgodne wstecznie z wcześniejszymi wersjami.
Opiera się on na kanale weekly
i jest aktualizowany raz w tygodniu.
Aby określić kanał w wersji beta, wczytaj interfejs Maps JavaScript API za pomocą tego tagu skryptu:
<script async
src="https://maps.googleapis.com/maps/api/js?v=beta
&key=YOUR_API_KEY&callback=initMap">
</script>
Wybór kanału alfa
Użyj kanału alfa, aby wypróbować nowe eksperymentalne funkcje i zmiany. Aby zgłosić problemy i przesłać opinię, użyj narzędzia do śledzenia problemów. Kanał alfa nie jest objęty gwarancją jakości usług ani nie uwzględnia żadnych zasad wycofywania, a niektóre zmiany mogą nie być zgodne wstecznie z wcześniejszymi wersjami. Służy jedynie do programowania i nie należy jej używać w środowisku produkcyjnym.
Opiera się on na kanale beta
i jest aktualizowany raz w tygodniu.
Aby określić kanał alfa, możesz wczytać interfejs Maps JavaScript API za pomocą tego tagu skryptu:
<script async
src="https://maps.googleapis.com/maps/api/js?v=alpha
&key=YOUR_API_KEY&callback=initMap">
</script>
Wybieranie numeru wersji
Wersję wersji określ przez numer, tylko jeśli regularnie testujesz i aktualizujesz aplikację. Wynika to z tego, że wersje numerowane są z czasem usuwane w miarę tworzenia nowych wersji. Numer wersji możesz określić, ładując interfejs Maps JavaScript API za pomocą tego tagu skryptu:
<script async
src="https://maps.googleapis.com/maps/api/js?v=3.51
&key=YOUR_API_KEY&callback=initMap">
</script>
Obecnie możesz określić v=3.52
, v=3.51
, v=3.50
lub v=3.49
.
- Wersja 3.52 otrzymuje cotygodniowe aktualizacje z nowymi funkcjami, poprawkami błędów i ulepszeniami wydajności.
- Wersja 3.51 nie otrzymuje cotygodniowych aktualizacji.
- Wersja 3.50 nie otrzymuje aktualizacji tygodniowych.
- Wersja 3.49 nie otrzymuje cotygodniowych aktualizacji.
- Możemy co jakiś czas wprowadzać poprawki błędów zabezpieczeń w dowolnej wersji.
- Podczas tworzenia nowej wersji możemy wprowadzić niezgodne wstecznie zmiany.
Od połowy kwietnia będzie można określać wartości v=3.53
, v=3.52
, v=3.51
lub v=3.50
.
- Wersja 3.53 będzie otrzymywać cotygodniowe aktualizacje z nowymi funkcjami, poprawkami błędów i ulepszeniami wydajności.
- Wersja 3.52 nie będzie już otrzymywać cotygodniowych aktualizacji.
- Wersja 3.51 nie będzie już otrzymywać aktualizacji tygodniowych.
- Wersja 3.50 nie będzie już otrzymywać aktualizacji tygodniowych.
- Możemy co jakiś czas wprowadzać poprawki błędów zabezpieczeń w dowolnej wersji.
- Wersja 3.49 nie będzie już dostępna. Każda próba wczytania tej wersji zostanie zignorowana i zamiast niej otrzymasz kanał domyślny.
Poniższy diagram przedstawia wersje, które będą dostępne na każdym kanale w ciągu kolejnego roku.
Pytania i odpowiedzi na temat błędów.Aktualizacja wpłynęła na moją aplikację
Aktualizacja kanałów wersji może mieć wpływ na Twoją aplikację. Może się tak zdarzyć, gdy aplikacja korzysta z nieudokumentowanych lub wycofanych funkcji albo z powodu wprowadzonego błędu.
Aby tymczasowo obejść problem, możesz skonfigurować aplikację tak, aby używała starszej wersji.
- Otwórz konsolę w narzędziach dla programistów w przeglądarce i sprawdź wartość
google.maps.version
. - Zaktualizuj tag skryptu, który wczytuje interfejs API, i poproś o numer starszej wersji.
Jeśli np.google.maps.version
to „3.52.2”, w skrypcie skryptu użyjv=3.51
.
To tymczasowe obejście będzie działać tylko przez ograniczony czas.
Gdy tymczasowe rozwiązanie tymczasowe zostanie wdrożone, będziesz mieć czas (zazwyczaj od 3 do 6 miesięcy), aby zaktualizować swoją aplikację. Nie będzie ona już wtedy korzystać z nieudokumentowanych ani wycofywanych funkcji, a także będzie uwzględniać błędy lub poprawki.
Następnie wróć do oryginalnego tagu skryptu, aby wczytać interfejs API.
Możesz też utworzyć zgłoszenie do pomocy lub zgłosić problem.
Aktualizacje kwartalne
Raz na kwartał zespół Maps JavaScript API udostępnia nową wersję. Dzieje się tak w połowie lutego, połowie maja, w sierpniu i w połowie listopada. Następna aktualizacja będzie miała miejsce w połowie kwietnia. Nowa wersja cotygodniowa będzie miała wersję 3.53, która zostanie zaktualizowana w tym czasie.
Cotygodniowa aktualizacja kanałów
Kanał tygodniowy prowadzi obecnie do wersji 3.52.
W połowie kwietnia zaktualizujemy cotygodniowy kanał z wersji 3.52 do wersji 3.53. Na tym etapie nowa wersja będzie zawierać nowe funkcje, usunąć wycofane funkcje lub wprowadzić niezgodności wsteczne. Może być konieczne przetestowanie tych zmian po zaktualizowaniu kanału.
W ciągu kwartału nowa wersja będzie co tydzień aktualizowana o nowe funkcje, poprawki i ulepszenia w zakresie wydajności. Nie zostaną one wycofane i nie spowodują niezgodności wstecznej.
Kwartalna aktualizacja kanału
Kwartalny kanał wskazuje obecnie wersję 3.51.
W połowie kwietnia kwartalny kanał zostanie zaktualizowany z wersji 3.51 do wersji 3.52. Po aktualizacji ta wersja będzie zawierać nowe funkcje, usunąć wycofane funkcje lub wprowadzić niezgodności wsteczne z ostatnich 3 miesięcy. Może być konieczne przetestowanie tych zmian po zaktualizowaniu kanału.
W tym kwartale nie będziemy dodawać nowych funkcji, poprawek błędów ani ulepszeń wydajności. Nie zostaną one wycofane i nie spowodują niezgodności wstecznej.
Aktualizacje wersji
W połowie kwietnia numery wersji są przenoszone, aby umożliwić opublikowanie nowej wersji.
Wersja 3.53
W połowie kwietnia zostanie wydana nowa wersja 3.53. Po wydaniu ta wersja będzie zawierać nowe funkcje, usunąć wycofane funkcje lub wprowadzić niezgodności wsteczne w porównaniu z wersją 3.52. W przypadku zmiany numeru wersji należy przetestować aplikację.
W tym kwartale nowa wersja będzie aktualizowana o nowe funkcje, poprawki i ulepszenia w zakresie wydajności. Nie zostaną one wycofane i nie spowodują niezgodności wstecznej.
Wersja 3.52
Ta wersja zawiera nowe funkcje, usuwa wycofane funkcje lub wprowadza niezgodności wsteczne w porównaniu z wersją 3.51. W przypadku zmiany numeru wersji należy przetestować aplikację.
W połowie kwietnia ta wersja nie będzie już aktualizowana o nowe funkcje, poprawki błędów ani ulepszenia wydajności. Nie zostaną one wycofane i nie spowodują niezgodności wstecznej.
Wersja 3.51
Ta wersja zawiera nowe funkcje, usuwa wycofane funkcje lub wprowadza niezgodności wsteczne w porównaniu z wersją 3.50. W przypadku zmiany numeru wersji należy przetestować aplikację.
Ta wersja nie będzie już aktualizowana o nowe funkcje, poprawki błędów ani ulepszenia wydajności. Nie spowoduje to usunięcia funkcji, które zostały wycofane po tej wersji i nie wprowadzą nowych niezgodności wstecznych.
Wersja 3.50
Ta wersja zawiera nowe funkcje, usuwa wycofane funkcje lub wprowadza niezgodności wsteczne w porównaniu z wersją 3.49. W przypadku zmiany numeru wersji należy przetestować aplikację.
Ta wersja nie będzie już aktualizowana o nowe funkcje, poprawki błędów ani ulepszenia wydajności. Nie spowoduje to usunięcia funkcji, które zostały wycofane po tej wersji i nie wprowadzą nowych niezgodności wstecznych.
Wersja 3.49
Ta wersja zostanie usunięta w połowie kwietnia i nie będzie już można jej używać. Każda próba wczytania tej wersji zostanie zignorowana i zamiast niej otrzymasz kanał domyślny.
Obsługa wersji
W każdym kwartale są dostępne 4 wersje. Wszystkie te 4 wersje są obsługiwane.
Kontrole wersji
Do debugowania użyj właściwości google.maps.version
, aby uzyskać w swojej aplikacji bieżącą wersję interfejsu API JavaScript Map Google.
Poniższy przykładowy kod zapisuje wersję interfejsu API w konsoli przeglądarki.
Więcej informacji o konsoli przeglądarki znajdziesz w przewodniku dotyczącym
sprawdzania błędów w przeglądarce.
<!DOCTYPE html>
<html>
<head>
<title>Display Google Maps API Version</title>
</head>
<body>
<script>
function initMap() {
// Add your map here.
console.log('Google Maps API version: ' + google.maps.version);
}
</script>
<script src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&callback=initMap"
defer></script>
</body>
</html>
Dokumentacja wersji interfejsu API
Przewodnik dla deweloperów zawsze opisuje wersję tygodniową.
Ponadto dla każdej wersji istnieje osobne odwołanie:
- Dokumentacja interfejsu API w wersji 3.52 (kanał tygodniowy)
- Dokumentacja interfejsu API w wersji 3.51 (kanał kwartalny)
- Dokumentacja API w wersji 3.50
- Dokumentacja API w wersji 3.49
- Wersje od 3.0 do 3.48 zostały usunięte.