Obsługa wersji

Wybór kanału tygodniowego

W przypadku większości aplikacji zalecamy korzystanie z kanału tygodniowego. Jest to najnowsza i aktualna wersja zawierająca najnowsze poprawki błędów i ulepszenia w zakresie 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 ma wersję 3.54. Ta wersja jest aktualizowana co tydzień o nowe funkcje, poprawki błędów i ulepszenia wydajności.

W połowie listopada zaktualizujemy cotygodniowy kanał do wersji 3.55. Nowa wersja może wtedy usunąć wycofane funkcje lub wprowadzić niezgodności wsteczne.

Wybór kanału kwartalnego

Niektóre aplikacje mogą liczyć na mniejsze, ale większe aktualizacje, ponieważ zapewniają większą przewidywalność. Aplikacje te powinny używać kanału kwartalnego. Skorzystaj z tego rozwiązania, jeśli chcesz, by poprawki błędów i ulepszenia wydajności pojawiły się w oczekiwanym czasie (patrz kwartalne aktualizacje). Aby określić kanał kwartalny, wczytaj 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.53. 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 listopada kanał kwartalny zostanie zaktualizowany do wersji 3.54. Nowa wersja będzie wtedy zawierać nowe funkcje, usuwać wycofane funkcje lub wprowadzać niezgodności wsteczne z poprzednich 3 miesięcy.

Wybór kanału wersji beta

Kanał wersji beta pozwala wypróbować nowe funkcje i zmiany. Funkcje w wersji beta zostały ukończone, ale mogą w nich występować pewne problemy (do ich zgłaszania i przekazywania opinii użyj narzędzia do śledzenia problemów). Kanał beta nie jest objęty żadnymi gwarancją ani zasadami wycofywania, dlatego niektóre zmiany mogą być niezgodne ze starszymi wersjami.

Ten kanał jest oparty na kanale weekly i jest aktualizowany raz w tygodniu.

Kanał wersji beta 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=beta
        &key=YOUR_API_KEY&callback=initMap">
</script>

Wybór kanału alfa

Przetestuj kanał alfa, aby wypróbować nowe eksperymentalne funkcje i zmiany. Aby zgłosić problemy i przesłać opinię, skorzystaj z narzędzia do śledzenia błędów. Kanał alfa nie jest objęty żadną gwarancją jakości usług ani zasadami wycofywania, dlatego niektóre zmiany mogą być niezgodne z wcześniejszymi wersjami. Służy ona wyłącznie do celów programistycznych i nie należy jej używać w środowisku produkcyjnym.

Ten kanał jest oparty na kanale beta i jest aktualizowany raz w tygodniu.

Kanał alfa możesz określić, wczytując 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

Numer wersji podawaj tylko wtedy, gdy regularnie testujesz i aktualizujesz aplikację. Wynika to z faktu, że wersje numerowane są z czasem usuwane w miarę tworzenia nowych wersji co kwartał. Numer wersji możesz określić, wczytując interfejs Maps JavaScript API za pomocą tego tagu skryptu:

<script async
    src="https://maps.googleapis.com/maps/api/js?v=3.53
        &key=YOUR_API_KEY&callback=initMap">
</script>

Obecnie możesz określić v=3.54, v=3.53, v=3.52 lub v=3.51.

• Wersja 3.54 zawiera cotygodniowe aktualizacje z nowymi funkcjami, poprawkami i ulepszeniami wydajności.
• Wersja 3.53 nie otrzymuje aktualizacji cotygodniowych.
• Wersja 3.52 nie otrzymuje aktualizacji cotygodniowych.
• Wersja 3.51 nie otrzymuje aktualizacji cotygodniowych.
• Możemy od czasu do czasu wprowadzać poprawki błędów zabezpieczeń do dowolnej wersji.
• Gdy utworzysz nową wersję, możemy wprowadzić niezgodne wstecznie zmiany.

W połowie listopada będzie można określać właściwości v=3.55, v=3.54, v=3.53 lub v=3.52.

• Wersja 3.55 będzie otrzymywać cotygodniowe aktualizacje z nowymi funkcjami, poprawkami i ulepszeniami wydajności.
• Wersja 3.54 nie będzie już otrzymywać cotygodniowych aktualizacji.
• Wersja 3.53 nie będzie już otrzymywać cotygodniowych aktualizacji.
• Wersja 3.52 nie będzie już otrzymywać cotygodniowych aktualizacji.
• Możemy od czasu do czasu wprowadzać poprawki błędów zabezpieczeń do dowolnej wersji.
• Wersja 3.51 nie będzie już dostępna. Każda próba wczytania tej wersji zostanie zignorowana, a Ty otrzymasz swój kanał domyślny.

Poniższe diagramy pokazują, które wersje będą dostępne na każdym kanale w przyszłym roku.

Aktualizacja wpłynęła na moją aplikację

Aktualizacja kanałów wersji może wpłynąć na Twoją aplikację. Może się tak zdarzyć, gdy aplikacja korzysta z nieudokumentowanych lub wycofanych funkcji albo z powodu błędu lub usterki, które wprowadziliśmy.

Jako tymczasowe obejście problemu możesz ponownie skonfigurować aplikację, aby korzystała ze starszej wersji.

1. Otwórz konsolę w narzędziach dla programistów w przeglądarce i sprawdź wartość google.maps.version.
2. Zaktualizuj tag skryptu, który wczytuje interfejs API, i poproś o starszy numer wersji.
   Jeśli np. google.maps.version to „3.54.2”, w skrypcie skryptu użyj v=3.53.
   To tymczasowe rozwiązanie będzie działać tylko przez ograniczony czas.

Gdy wprowadzimy tymczasowe obejście, będziesz mieć czas (zwykle od 3 do 6 miesięcy) na zaktualizowanie aplikacji, aby nie korzystała już z nieudokumentowanych lub wycofanych funkcji i uwzględniała błędy.

Następnie wróć do oryginalnego tagu skryptu, aby wczytać interfejs API.

Możesz też utworzyć zgłoszenie do zespołu pomocy lub zgłosić problem.

Aktualizacje kwartalne

Zespół interfejsu Maps JavaScript API co kwartał udostępnia nową wersję. Odbywa się to w połowie lutego, połowy maja, połowy i połowie listopada. Najbliższa aktualizacja będzie połowa listopada. Nowy kanał tygodniowy będzie miał wersję 3.55, po czym zaktualizujemy pozostałe kanały.