Obsługa wersji

Zespół Maps JavaScript API regularnie aktualizuje interfejs API, dodając do niego nowe funkcje, poprawki błędów i ulepszenia w zakresie wydajności. Na tej stronie dowiesz się: tych wersji interfejsu API, które można wykorzystać w aplikacjach.

Kanały wersji i numery wersji

W aplikacji możesz określić kanały wersji lub numery wersji:

  • Kanał cotygodniowy jest określany za pomocą v=weekly.
    Ten kanał jest aktualizowany raz w tygodniu i jest najbardziej aktualny.
  • Kanał kwartalny jest określony za pomocą parametru v=quarterly.
    Ten kanał jest aktualizowany raz na kwartał i jest najbardziej przewidywalny.
  • Kanał beta jest określony za pomocą parametru v=beta.
    Ten kanał powstał na podstawie kanału weekly i jest aktualizowany raz w tygodniu. Zawiera też dodatkowe zmiany dotyczące wstępnych testów i opinii.
  • Kanał alfa jest określony za pomocą parametru v=alpha.
    Ten kanał powstał na podstawie kanału beta i jest aktualizowany raz w tygodniu. Obejmuje eksperymenty z opiniami klientów na temat prototypów. Jest przeznaczona tylko dla programistów i nie powinna być używana w środowisku produkcyjnym.
  • Numer wersji jest podawany za pomocą znaku v=n.nn.
    Masz do wyboru v=3.58, v=3.57, v=3.56 lub v=3.55.
    Numery wersji są aktualizowane raz na kwartał (patrz Aktualizacje kwartalne).

Jeśli nie określisz kanału lub wersji, otrzymasz kanał tygodniowy. domyślnie. Jeśli nie udało Ci się przejść z abonamentu premium wyraźnie wskażesz kanał lub wersję, domyślnie otrzymasz kanał kwartalny. Jeśli Jeśli określisz nieprawidłową wersję, otrzymasz kanał domyślny.

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.

v=weekly v=kwartalnie v=3.nn v=3.nn-1 sierpień 2024 r. listopad 2024 r. Luty 2025 r. Maj 2025 r. v3.55 v3.56 v3.56 v3.57 v3.57 v3.57 v3.58 v3.58 v3.58 v3.58 v3.59 v3.59 v3.59 v3.60 v3.60 v3.61

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.

Cotygodniowe aktualizacje kanału

Kanał tygodniowy odnosi się obecnie do wersji 3.58.

W połowie listopada zaktualizujemy cotygodniowy kanał z wersji 3.58 do wersji 3.59. Nowa wersja będzie zawierać nowe funkcje, usuwać wycofane funkcje, lub wprowadzenie niekompatybilności wstecznej. Konieczne może być przetestowanie tych zmian po zaktualizowaniu kanału.

W ciągu kwartału do nowej wersji będziemy dodawać co tydzień nowe funkcje, poprawki błędów i ulepszenia wydajności. Nie spowoduje to usunięcia wycofanych funkcji ani nie spowoduje niezgodności wstecznej.

Kwartalne informacje na temat kanału

Kanał kwartalny wskazuje obecnie wersję 3.57.

W połowie listopada kanał kwartalny zostanie zaktualizowany do wersji 3.57 do wersji 3.58. Po aktualizacji ta wersja będzie zawierać nowe funkcje, usuwać wycofane funkcje, lub wprowadzenie wstecznej niezgodności z poprzednich 3 miesięcy. Konieczne może być przetestowanie tych zmian po zaktualizowaniu kanału.

Przez cały kwartał nie będzie można dodawać do tej wersji nowych funkcji, lub poprawa wydajności. Nie spowoduje to usunięcia wycofanych funkcji ani nie spowoduje niezgodności wstecznej.

Aktualizacje wersji

W połowie listopada numery wersji zostaną przeniesione, aby dostosować nowej wersji.

Wersja 3.59

Nowa wersja 3.59 zostanie udostępniona w połowie listopada. Po opublikowaniu ta wersja będzie zawierać nowe funkcje, usuwać wycofane funkcje, lub wprowadzenie wstecznej niezgodności w porównaniu z wersją 3.58. Przy przechodzeniu między numerami wersji należy przetestować aplikację.

W trakcie kwartału do nowej wersji będziemy dodawać co tydzień nowe funkcje, poprawki błędów poprawy wydajności. Nie spowoduje to usunięcia wycofanych funkcji ani nie spowoduje niezgodności wstecznej.

Wersja 3.58

Ta wersja zawiera nowe funkcje, usuwa wycofane funkcje lub wprowadza kompatybilności wstecznej w porównaniu do wersji 3.57. Przy przechodzeniu między numerami wersji należy przetestować aplikację.

W połowie listopada nie będziemy w niej aktualizować nowych funkcji. poprawki błędów lub usprawnienia działania aplikacji. Nie spowoduje to usunięcia wycofanych funkcji ani nie spowoduje niezgodności wstecznej.

Wersja 3.57

Ta wersja zawiera nowe funkcje, usuwa wycofane funkcje lub wprowadza kompatybilności wstecznej w porównaniu z wersją 3.56. Przy przechodzeniu między numerami 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 wycofanych po tej wersji ani wprowadzenia nowych wstecznej niezgodności.

Wersja 3.56

Ta wersja zawiera nowe funkcje, usuwa wycofane funkcje lub wprowadza kompatybilności wstecznej w porównaniu do wersji 3.55. Przy przechodzeniu między numerami 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 wycofanych po tej wersji ani wprowadzenia nowych wstecznej niezgodności.

Wersja 3.55

W połowie listopada ta wersja zostanie usunięta i nie będzie już można jej używać. Każda próba wczytania tej wersji zostanie zignorowana, a Ty otrzymasz kanał domyślny .

Obsługa wersji

W każdym kwartale dostępne są 4 wersje. Obsługiwane są wszystkie te 4 wersje.

Sprawdzanie wersji

Na potrzeby debugowania użyj właściwości google.maps.version, aby uzyskać aktualnej wersji Maps JavaScript API w Twojej aplikacji. Ten przykładowy kod zapisuje wersję interfejsu API w konsoli przeglądarki. (Więcej informacji o konsoli przeglądarki znajdziesz w przewodniku sprawdzanie 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 programistów zawsze opisuje wersję tygodniową.

Oprócz tego dla każdej wersji istnieje osobne odniesienie: