Obsługa wersji

Zespół Maps JavaScript API regularnie aktualizuje interfejs API, dodając nowe funkcje, poprawki błędów i ulepszenia w zakresie wydajności. Na tej stronie opisujemy wersje interfejsu API, których możesz używać w swoich aplikacjach.

Kanały wersji i numery wersji

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

  • Kanał tygodniowy jest określony przez v=weekly.
    Ten kanał jest aktualizowany raz w tygodniu i jest najbardziej aktualny.
  • Kanał kwartalny jest określony wartością v=quarterly.
    Ten kanał jest aktualizowany raz na kwartał i jest najbardziej przewidywalny.
  • Kanał wersji beta jest określony za pomocą funkcji v=beta.
    Ten kanał pochodzi z kanału weekly. Jest aktualizowany raz w tygodniu. Obejmuje dodatkowe zmiany związane z wczesnymi testami i opiniami.
  • Kanał alfa jest określony za pomocą funkcji v=alpha.
    Ten kanał pochodzi z kanału beta. Jest aktualizowany raz w tygodniu. Obejmuje ona eksperymenty służące do przekazywania opinii klientów na temat prototypów. Służy ona wyłącznie do celów programistycznych i nie powinna być używana w środowisku produkcyjnym.
  • Numer wersji jest określony jako v=n.nn.
    Możesz wybrać v=3.56, v=3.55, v=3.54 lub v=3.53.
    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 przejdziesz z abonamentu premium i nie określisz kanału lub wersji, domyślnie otrzymasz kanał kwartalny. Jeśli podasz nieprawidłową wersję, otrzymasz kanał domyślny.

Wybór kanału tygodniowego

W przypadku większości aplikacji zalecamy korzystanie z kanałów tygodniowych. To jest najnowsza wersja z najnowszymi poprawkami błędów i ulepszeniami w zakresie wydajności. Aby określić kanał tygodniowy, wczytaj interfejs 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 wersja 3.56. Ta wersja jest co tydzień aktualizowana o nowe funkcje, poprawki błędów i ulepszenia w zakresie wydajności.

W połowie maja kanał tygodniowy zostanie zaktualizowany do wersji 3.57. Może ona usunąć wtedy wycofane funkcje lub wprowadzić brak zgodności wstecznej.

Wybór kanału kwartalnego

Niektóre aplikacje mogą korzystać z mniejszej liczby aktualizacji, lecz większych aktualizacji, ponieważ dają one większą przewidywalność. Aplikacje te powinny korzystać z kanału kwartalnego. Skorzystaj z tej metody, jeśli chcesz, by poprawki błędów i ulepszenia wydajności pojawiały się w oczekiwanym czasie (patrz Aktualizacje kwartalne). Aby określić kanał kwartalny, możesz wczytywać interfejs Maps JavaScript API przy użyciu 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 to wersja 3.55. Przez cały kwartał ta wersja nie otrzymuje nowych funkcji, poprawek błędów ani ulepszeń dotyczących wydajności. Co jakiś czas możemy wprowadzać do tej wersji poprawki błędów związanych z bezpieczeństwem.

W połowie maja kanał kwartalny zostanie zaktualizowany do wersji 3.56. Po tym terminie nowa wersja będzie zawierać nowe funkcje, usunąć wycofane funkcje lub wprowadzić wcześniejsze niezgodności z poprzednimi 3 miesiącami.

Wybieranie wersji beta

Używaj wersji beta, aby testować nowe funkcje i zmiany w wersji beta. Funkcje w wersji beta są już gotowe, ale mogą w nich występować pewne problemy. Aby je zgłosić i przekazać opinię, skorzystaj z narzędzia do śledzenia błędó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.

Ten kanał pochodzi z kanału weekly. Jest aktualizowany raz w tygodniu.

Aby określić kanał wersji beta, możesz wczytać interfejs Maps JavaScript API przy użyciu tego tagu skryptu:

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

Wybieranie kanału alfa

Używaj kanału alfa do testowania nowych eksperymentalnych funkcji i zmian. Aby zgłaszać problemy i przesyłać opinie, użyj narzędzia do śledzenia problemów. Kanał alfa 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. Służy ona wyłącznie do celów programistycznych i nie powinna być używana w środowisku produkcyjnym.

Ten kanał pochodzi z kanału beta. 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

Określ wersję za pomocą numeru tylko wtedy, gdy regularnie testujesz i aktualizujesz swoją aplikację. Dzieje się tak, ponieważ wersje numerowane są z czasem usuwane, gdy co kwartał pojawiają się nowe wersje. Aby określić numer wersji, możesz wczytać interfejs Maps JavaScript API za pomocą tego tagu skryptu:

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

Obecnie możesz określić v=3.56, v=3.55, v=3.54 lub v=3.53.

  • Wersja 3.56 otrzymuje cotygodniowe aktualizacje z nowymi funkcjami, poprawkami błędów i ulepszeniami w zakresie wydajności.
  • Wersja 3.55 nie jest dostarczana co tydzień.
  • Wersja 3.54 nie jest dostarczana co tydzień.
  • Wersja 3.53 nie jest dostarczana co tydzień.
  • Co jakiś czas możemy wprowadzać w dowolnej wersji poprawki błędów związanych z bezpieczeństwem.
  • Podczas tworzenia nowej wersji możemy wprowadzić niezgodne wstecznie zmiany.

Po połowie maja będzie można określić v=3.57, v=3.56, v=3.55 i v=3.54.

  • Wersja 3.57 będzie co tydzień otrzymywać aktualizacje z nowymi funkcjami, poprawkami błędów i ulepszeniami w zakresie wydajności.
  • Wersja 3.56 nie będzie już otrzymywać cotygodniowych aktualizacji.
  • Wersja 3.55 nie będzie już otrzymywać cotygodniowych aktualizacji.
  • Wersja 3.54 nie będzie już otrzymywać cotygodniowych aktualizacji.
  • Co jakiś czas możemy wprowadzać w dowolnej wersji poprawki błędów związanych z bezpieczeństwem.
  • Wersja 3.53 nie będzie już dostępna. Każda próba wczytania tej wersji zostanie zignorowana, a zamiast niego otrzymasz domyślny kanał.

Poniższy schemat pokazuje, które wersje będą dostępne na poszczególnych kanałach w przyszłym roku.

v3.53v3.54v3.54v3.55v3.55v3.55v3.56v3.56v3.56v3.56v3.57v3.57v3.57v3.58v3.58v3.59

Aktualizacja wpłynęła na moje zgłoszenie

Aktualizacja kanałów wersji może mieć wpływ na Twoją aplikację. Może to być spowodowane tym, że aplikacja opiera się na nieudokumentowanych lub wycofanych funkcjach albo z powodu błędu lub poprawek, które wprowadziliśmy.

Aby tymczasowo obejść ten problem, możesz ponownie skonfigurować aplikację, 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.56.2”, użyj w tagu skryptu v=3.55.
    To tymczasowe obejście będzie działać tylko przez ograniczony czas.

Po wprowadzeniu tymczasowego obejścia będziesz mieć czas (zwykle 3–6 miesięcy) na zaktualizowanie aplikacji. Dzięki temu aplikacja przestanie korzystać z nieudokumentowanych lub wycofanych funkcji oraz będzie zawierać błędy lub poprawki.

Aby wczytać interfejs API, przywróć pierwotny tag skryptu.

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

Kwartalne e-maile z aktualnościami

Raz na kwartał zespół Maps JavaScript API wydaje nową wersję. Może się to odbywać w połowie lutego, w połowie maja, w połowie sierpnia i w połowie listopada. Kolejna aktualizacja odbędzie się w połowie maja. Nowy tygodniowy kanał będzie dostarczał wersję 3.57 i wtedy pozostałe kanały zostaną zaktualizowane.

Cotygodniowa aktualizacja kanału

Obecnie jest to wersja 3.56.

W połowie maja kanał tygodniowy zostanie zaktualizowany z wersji 3.56 do wersji 3.57. Na tym etapie nowa wersja będzie zawierać nowe funkcje, usunąć wycofane funkcje lub wprowadzić wcześniejsze niezgodności. Może być konieczne przetestowanie tych zmian po zaktualizowaniu kanału.

W trakcie kwartału nowa wersja będzie co tydzień aktualizowana o nowe funkcje, poprawki błędów i ulepszenia w zakresie wydajności. Nie spowoduje to usunięcia wycofanych funkcji ani wprowadzenia wstecznych niezgodności.

Kwartalna aktualizacja kanału

Kanał kwartalny jest obecnie dostępny w wersji 3.55.

W połowie maja kanał kwartalny zostanie zaktualizowany z wersji 3.55 do wersji 3.56. Po aktualizacji ta wersja będzie zawierać nowe funkcje, usunąć funkcje wycofane lub wprowadzić wcześniejsze niezgodności z poprzednimi 3 miesiącami. Może być konieczne przetestowanie tych zmian po zaktualizowaniu kanału.

Przez cały kwartał ta wersja nie będzie zawierać nowych funkcji, poprawek błędów ani ulepszeń dotyczących wydajności. Nie spowoduje to usunięcia wycofanych funkcji ani wprowadzenia wstecznych niezgodności.

Aktualizacje wersji

W połowie maja numery wersji są przenoszone, aby dostosować je do wydania nowej wersji.

Wersja 3.57

Nowa wersja 3.57 zostanie opublikowana w połowie maja. Po opublikowaniu będzie zawierać nowe funkcje, usunąć wycofane funkcje lub wprowadzać niezgodne wstecznie wersje względem wersji 3.56. Gdy zmieniasz numer wersji na inną, musisz przetestować swoją aplikację.

W trakcie kwartału nowa wersja będzie co tydzień aktualizowana o nowe funkcje, poprawki błędów i ulepszenia w zakresie wydajności. Nie spowoduje to usunięcia wycofanych funkcji ani wprowadzenia wstecznych niezgodności.

Wersja 3.56

Ta wersja zawiera nowe funkcje, usuwa wycofane funkcje lub zawiera wsteczne różnice w porównaniu do wersji 3.55. Gdy zmieniasz numer wersji na inną, musisz przetestować swoją aplikację.

Od połowy maja ta wersja nie będzie już aktualizowana o nowe funkcje, poprawki błędów i ulepszenia wydajności. Nie spowoduje to usunięcia wycofanych funkcji ani wprowadzenia wstecznych niezgodności.

Wersja 3.55

Ta wersja zawiera nowe funkcje, zawiera wycofane funkcje lub zawiera wsteczne różnice w porównaniu do wersji 3.54. Gdy zmieniasz numer wersji na inną, musisz przetestować swoją 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 niezgodności wstecznych.

Wersja 3.54

Ta wersja zawiera nowe funkcje, usuwa wycofane funkcje lub zawiera wsteczne różnice w porównaniu do wersji 3.53. Gdy zmieniasz numer wersji na inną, musisz przetestować swoją 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 niezgodności wstecznych.

Wersja 3.53

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

Obsługa wersji

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

Sprawdzanie wersji

Do debugowania użyj właściwości google.maps.version, aby uzyskać w aplikacji aktualną wersję interfejsu Maps JavaScript API. Ten przykładowy kod zapisuje wersję interfejsu API w konsoli przeglądarki. Więcej informacji o konsoli przeglądarki znajdziesz w przewodniku 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ę cotygodniową.

Każda wersja posiada też oddzielne odniesienie: