Obsługa wersji

Zespół interfejsu API JavaScript Map regularnie aktualizuje interfejs API o nowe funkcje, poprawki i ulepszenia w zakresie wydajności. Na tej stronie opisaliśmy wersje interfejsu API, których można używać w aplikacjach.

Kanały wersji i numery wersji

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

  • Kanał tygodniowy jest określany za pomocą v=weekly.
    Kanał jest aktualizowany raz w tygodniu.
  • Kanał kwartalny jest określany jako v=quarterly.
    Kanał jest aktualizowany raz na kwartał i jest najbardziej przewidywalny.
  • Kanał beta jest określany za pomocą v=beta.
    Kanał jest oparty na kanale weekly i jest aktualizowany raz w tygodniu. Obejmuje dodatkowe zmiany na wczesnych testach i opinie.
  • Kanał alfa jest określany za pomocą v=alpha.
    Kanał jest oparty na kanale beta i jest aktualizowany raz w tygodniu. Uwzględnia eksperymenty dotyczące opinii klientów na temat prototypów. Służy ona wyłącznie do celów programistycznych i nie należy jej używać w środowisku produkcyjnym.
  • Numer wersji wskazuje v=n.nn.
    Możesz wybrać v=3.53, v=3.52, v=3.51 lub v=3.50.
    Numery wersji są aktualizowane raz na kwartał (patrz kwartalne aktualizacje).

Jeśli nie określisz kanału lub wersji, domyślnie otrzymasz kanał tygodniowy. Jeśli przeprowadzisz migrację z abonamentu premium i nie określisz kanału lub 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 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.53. Ta wersja jest aktualizowana co tydzień o nowe funkcje, poprawki błędów i ulepszenia wydajności.

W połowie lipca zaktualizujemy cotygodniowy kanał do wersji 3.54. 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.52. 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 lipca kanał kwartalny zostanie zaktualizowany do wersji 3.53. 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.52
        &key=YOUR_API_KEY&callback=initMap">
</script>

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

  • Wersja 3.53 jest otrzymywać cotygodniowe aktualizacje z nowymi funkcjami, poprawkami i poprawą wydajności.
  • Wersja 3.52 nie otrzymuje aktualizacji cotygodniowych.
  • Wersja 3.51 nie otrzymuje aktualizacji cotygodniowych.
  • Wersja 3.50 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.

Od połowy lipca będzie można określić właściwości v=3.54, v=3.53, v=3.52 lub v=3.51.

  • Wersja 3.54 będzie otrzymywać cotygodniowe aktualizacje z nowymi funkcjami, poprawkami i ulepszeniami wydajności.
  • Wersja 3.53 nie będzie już otrzymywać cotygodniowych aktualizacji.
  • Wersja 3.52 nie będzie już otrzymywać cotygodniowych aktualizacji.
  • Wersja 3.51 nie będzie już otrzymywać cotygodniowych aktualizacji.
  • Możemy od czasu do czasu wprowadzać poprawki błędów zabezpieczeń do dowolnej wersji.
  • Wersja 3.50 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.

Trzeba też pamiętać, że

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.53.2”, w skrypcie skryptu użyj v=3.52.
    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. Następna aktualizacja będzie połowa lipca. Nowy kanał tygodniowy będzie miał wersję 3.54, w której będziemy aktualizować pozostałe kanały.

Cotygodniowa aktualizacja kanału

Kanał tygodniowy wskazuje obecnie wersję 3.53.

W połowie lipca zaktualizujemy cotygodniowy kanał do wersji 3.53. W tej chwili nowa wersja będzie zawierać nowe funkcje, usunąć wycofane funkcje lub wprowadzić niezgodności wsteczne. Przetestuj zmiany 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 spowoduje to usunięcia wycofanych funkcji ani nie zapewni zgodności wstecznej.

Kwartalna aktualizacja kanałów

Kanał kwartalny wskazuje obecnie wersję 3.52.

W połowie lipca kanał kwartalny zostanie zaktualizowany z wersji 3.52 do wersji 3.53. Po aktualizacji ta wersja będzie zawierać nowe funkcje, usunąć wycofane funkcje lub wprowadzić niezgodności wsteczne z poprzednich 3 miesięcy. Przetestuj zmiany po zaktualizowaniu kanału.

W ciągu kwartału nie będziemy dodawać do niej nowych funkcji, poprawek błędów ani ulepszeń działania aplikacji. Nie spowoduje to usunięcia wycofanych funkcji ani nie zapewni zgodności wstecznej.

Aktualizacje wersji

W połowie lipca numery wersji są przenoszone, aby umożliwić udostępnienie nowej wersji.

Wersja 3.54

Nowa wersja 3.54 zostanie udostępniona w połowie lipca. Po wydaniu tej wersji będzie ona zawierać nowe funkcje, usuwać wycofane funkcje lub wprowadzać niezgodności wsteczne w porównaniu z wersją 3.53. Przełączaj się między numerami wersji aplikacji, aby ją przetestować.

W kwartale nowa wersja będzie aktualizowana co tydzień o nowe funkcje, poprawki i ulepszenia w zakresie wydajności. Nie spowoduje to usunięcia wycofanych funkcji ani nie zapewni zgodności wstecznej.

Wersja 3.53

Ta wersja zawiera nowe funkcje, usuwa wycofane funkcje lub wprowadza niezgodności w porównaniu z wersją 3.52. Przełączaj się między numerami wersji aplikacji, aby ją przetestować.

Od połowy lipca ta wersja nie będzie już aktualizowana o nowe funkcje, poprawki błędów ani lepsze działanie aplikacji. Nie spowoduje to usunięcia wycofanych funkcji ani nie zapewni zgodności wstecznej.

Wersja 3.52

Ta wersja zawiera nowe funkcje, usuwa wycofane funkcje lub wprowadza niezgodności w porównaniu z wersją 3.51. Przełączaj się między numerami wersji aplikacji, aby ją przetestować.

Ta wersja nie będzie już zawierać nowych funkcji, poprawek błędów ani ulepszeń działania. Nie spowoduje to usunięcia funkcji, które zostały wycofane po tej wersji, ani nowych niezgodności wstecznych.

Wersja 3.51

Ta wersja zawiera nowe funkcje, usuwa wycofane funkcje lub wprowadza niezgodności w porównaniu z wersją 3.50. Przełączaj się między numerami wersji aplikacji, aby ją przetestować.

Ta wersja nie będzie już zawierać nowych funkcji, poprawek błędów ani ulepszeń działania. Nie spowoduje to usunięcia funkcji, które zostały wycofane po tej wersji, ani nowych niezgodności wstecznych.

Wersja 3.50

Ta wersja zostanie usunięta i nie będzie można już z niej korzystać. Każda próba wczytania tej wersji zostanie zignorowana, a Ty otrzymasz swój kanał domyślny.

Obsługa wersji

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

Sprawdzanie wersji

Do debugowania użyj właściwości google.maps.version, aby uzyskać aktualną wersję interfejsu Maps JavaScript API w swojej aplikacji. Poniższy przykładowy kod zapisuje wersję interfejsu API w konsoli przeglądarki. Więcej informacji 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 programistów zawsze opisuje wersję tygodniową.

Każda wersja ma osobne odwołanie: