Obsługa wersji

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.

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.

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 numer starszej wersji.
   Jeśli np. google.maps.version to „3.52.2”, w skrypcie skryptu użyj v=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.