Obsługa wersji

Wybieranie kanału tygodniowego

W przypadku większości aplikacji zalecamy kanał tygodniowy. To jest . Możesz określić kanał tygodniowy, wczytując Maps JavaScript API za pomocą tego kodu tag 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.58. Ta wersja jest co tydzień aktualizowana o nowe funkcje, poprawki błędów i ulepszenia wydajności.

W połowie listopada zaktualizujemy kanał cotygodniowy do wersji 3.59. Od tego dnia nowa wersja może usunąć wycofane funkcje lub wprowadzić niezgodności wsteczne.

Wybieranie kanału kwartalnego

Niektóre aplikacje mogą skorzystać z mniejszej liczby aktualizacji, ale za to większych. i przewidywalność. Aplikacje te powinny korzystać z kanału kwartalnego. Użyj tej metody jeśli chcesz, aby poprawki błędów i ulepszenia w działaniu były udostępniane w odpowiednim czasie. (patrz aktualizacje kwartalne). Możesz określić kanał kwartalny, wczytując interfejs Maps JavaScript API za pomocą poniższego kodu tag skryptu:

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

Obecnie kanał kwartalny to 3.57. W trakcie kwartału ta wersja nie otrzymuje nowych funkcji, poprawek błędów ani poprawy wydajności. Co jakiś czas możemy wprowadzać do tej wersji poprawki błędów.

W połowie listopada zaktualizujemy kanał kwartalny do wersji 3.58. Nowa wersja będzie zawierać nowe funkcje, usuwać wycofane funkcje, lub wprowadzenie wstecznych niezgodności z poprzednich 3 miesięcy.

Wybieranie kanału wersji beta

Korzystaj z wersji beta, by testować nowe funkcje i zmiany w wersji beta. Funkcje w wersji beta są w pełni gotowe, ale mogą wystąpić problemy (proszę Narzędzie do śledzenia problemów w celu zgłaszania problemów i przekazania opinii). Kanał beta nie jest objęty żadnymi Gwarancja jakości usług lub zasady wycofywania, a niektóre zmiany mogą być niezgodne wstecznie. we wcześniejszych wersjach.

Ten kanał powstał na podstawie kanału weekly i jest aktualizowany raz w tygodniu.

Możesz określić kanał beta, wczytając Maps JavaScript API za pomocą tego skryptu :

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

Wybieranie kanału alfa

Korzystaj z kanału alfa, aby testować nowe eksperymentalne funkcje i zmiany. Użyj Narzędzie do śledzenia problemów aby zgłaszać problemy i przekazywać opinie. Kanał alfa nie jest objęty gwarancją jakości usług ani nie jest wycofywany. , a niektóre zmiany mogą być niezgodne wstecznie z wcześniejszymi wersjami. Jest przeznaczona tylko dla programistów i nie powinna być używana w środowisku produkcyjnym.

Ten kanał powstał na podstawie kanału beta i jest aktualizowany raz w tygodniu.

Możesz określić kanał alfa, wczytając Maps JavaScript API za pomocą poniższego skryptu :

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

Wybór numeru wersji

Określ wersję za pomocą numeru tylko wtedy, gdy regularnie testujesz i aktualizujesz aplikację. Dzieje się tak, ponieważ wersje numerowane są ostatecznie usuwane wraz z tworzeniem nowych wersji w każdym kwartale. Numer wersji możesz określić, wczytując interfejs Maps JavaScript API z następującym tagiem skryptu:

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

Obecnie możesz określić v=3.58, v=3.57, v=3.56 lub v=3.55

• Wersja 3.58 jest cotygodniowo aktualizowana o nowe funkcje, poprawki błędów i poprawy wydajności.
• Wersja 3.57 nie otrzymuje cotygodniowych aktualizacji.
• Wersja 3.56 nie otrzymuje cotygodniowych aktualizacji.
• Wersja 3.55 nie otrzymuje cotygodniowych aktualizacji.
• Możemy co jakiś czas wprowadzać poprawki błędów w zabezpieczeniach w dowolnej wersji.
• Podczas tworzenia nowej wersji możemy wprowadzić zmiany niezgodne wstecznie.

Od połowy listopada będzie można określić v=3.59, v=3.58, v=3.57 lub v=3.56

• Wersja 3.59 będzie co tydzień otrzymywać aktualizacje o nowych funkcjach, poprawkach poprawy wydajności.
• Wersja 3.58 nie będzie już otrzymywać cotygodniowych aktualizacji.
• Wersja 3.57 nie będzie już otrzymywać cotygodniowych aktualizacji.
• Wersja 3.56 nie będzie już otrzymywać cotygodniowych aktualizacji.
• Możemy co jakiś czas wprowadzać poprawki błędów w zabezpieczeniach w dowolnej wersji.
• Wersja 3.55 nie będzie już dostępna. Każda próba wczytania tej wersji będzie ignorowany i otrzymasz kanał domyślny.

Poniższy diagram przedstawia, które wersje będą dostępne w każdym kanale w ciągu następnego roku.

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

Uaktualnienie kanałów wersji może mieć wpływ na Twoją aplikację. Może się tak zdarzyć, ponieważ aplikacja korzysta z nieudokumentowanych lub wycofanych funkcji bądź z powodu błędu lub błędu poprawkę, którą wprowadziliśmy.

Aby tymczasowo obejść problem, możesz ponownie skonfigurować aplikację do używania starszej wersji.

1. Otwórz konsolę w narzędziach dla programistów w przeglądarce i sprawdź, jakie korzyści google.maps.version
2. zaktualizować tag skryptu, który wczytuje interfejs API; poprosić o starszy numer wersji.
   Jeśli np. google.maps.version to „3.58.2”, użyj v=3.57 w tagu skryptu.
   To tymczasowe obejście będzie działać tylko przez ograniczony czas.

Po wdrożeniu tymczasowego rozwiązania masz czas (zazwyczaj 3–6 miesięcy), zaktualizować aplikację, aby nie używała już nieudokumentowanych lub wycofanych funkcji, ani kont, przeznaczonego na poprawki błędów i poprawki błędów.

Następnie przywróć pierwotny tag skryptu, aby wczytać interfejs API.

Możesz też utworzyć zgłoszenia do zespołu pomocy lub zgłoś problem.

Kwartalne e-maile z aktualnościami

Raz na kwartał zespół Maps JavaScript API publikuje nową wersję. W połowie lutego, połowa maja, połowa sierpnia i listopada. Następna aktualizacja nastąpi w połowie listopada. Nowy kanał cotygodniowy będzie zawierał wersję 3.59, Inne kanały zostaną zaktualizowane.