Obsługa wersji

Wybór kanału tygodniowego

W przypadku większości aplikacji zalecamy korzystanie z kanału tygodniowego. Jest to najnowsza wersja, która zawiera najnowsze poprawki błędów i ulepszenia wydajności. Kanał tygodniowy możesz określić, wczytując interfejs Maps JavaScript API za pomocą tego tagu skryptu:

  <script>
    (g=>{var h,a,k,p="The Google Maps JavaScript API",c="google",l="importLibrary",q="__ib__",m=document,b=window;b=b[c]||(b[c]={});var d=b.maps||(b.maps={}),r=new Set,e=new URLSearchParams,u=()=>h||(h=new Promise(async(f,n)=>{await (a=m.createElement("script"));e.set("libraries",[...r]+"");for(k in g)e.set(k.replace(/[A-Z]/g,t=>"_"+t[0].toLowerCase()),g[k]);e.set("callback",c+".maps."+q);a.src=`https://maps.${c}apis.com/maps/api/js?`+e;d[q]=f;a.onerror=()=>h=n(Error(p+" could not load."));a.nonce=m.querySelector("script[nonce]")?.nonce||"";m.head.append(a)}));d[l]?console.warn(p+" only loads once. Ignoring:",g):d[l]=(f,...n)=>r.add(f)&&u().then(()=>d[l](f,...n))})({
      key: "YOUR_API_KEY",
      v: "weekly",
    });
  </script>
  

Obecnie kanał tygodniowy ma wersję 3.62. Ta wersja jest aktualizowana co tydzień i zawiera nowe funkcje, poprawki błędów oraz ulepszenia wydajności.

W połowie listopada wersja tygodniowa zostanie zaktualizowana do wersji 3.63. W tym czasie nowa wersja może usunąć wycofane funkcje lub wprowadzić zmiany, które nie są wstecznie kompatybilne.

Wybieranie kanału kwartalnego

W przypadku niektórych aplikacji korzystniejsze może być rzadsze, ale większe aktualizowanie, ponieważ zapewnia to większą przewidywalność. W takich przypadkach należy używać kanału kwartalnego. Użyj tego podejścia, jeśli chcesz, aby poprawki błędów i ulepszenia wydajności były wprowadzane w oczekiwanym czasie (patrz aktualizacje kwartalne). Kanał kwartalny możesz określić, wczytując interfejs Maps JavaScript API za pomocą tego tagu skryptu:

  <script>
  (g=>{var h,a,k,p="The Google Maps JavaScript API",c="google",l="importLibrary",q="__ib__",m=document,b=window;b=b[c]||(b[c]={});var d=b.maps||(b.maps={}),r=new Set,e=new URLSearchParams,u=()=>h||(h=new Promise(async(f,n)=>{await (a=m.createElement("script"));e.set("libraries",[...r]+"");for(k in g)e.set(k.replace(/[A-Z]/g,t=>"_"+t[0].toLowerCase()),g[k]);e.set("callback",c+".maps."+q);a.src=`https://maps.${c}apis.com/maps/api/js?`+e;d[q]=f;a.onerror=()=>h=n(Error(p+" could not load."));a.nonce=m.querySelector("script[nonce]")?.nonce||"";m.head.append(a)}));d[l]?console.warn(p+" only loads once. Ignoring:",g):d[l]=(f,...n)=>r.add(f)&&u().then(()=>d[l](f,...n))})({
    key: "YOUR_API_KEY",
    v: "quarterly",
  });
  </script>

Obecnie kanał kwartalny ma wersję 3.61. W tym kwartale ta wersja nie będzie otrzymywać nowych funkcji, poprawek błędów ani ulepszeń działania. Co jakiś czas możemy wprowadzać do tej wersji poprawki błędów związanych z bezpieczeństwem.

W połowie listopada kanał kwartalny zostanie zaktualizowany do wersji 3.62. W tym czasie nowa wersja będzie zawierać nowe funkcje, usuwać wycofane funkcje lub wprowadzać niezgodności wsteczne z poprzednich 3 miesięcy.

Wybieranie wersji beta

Użyj wersji beta, aby wypróbować nowe funkcje i zmiany. Funkcje w wersji beta są w pełni funkcjonalne, ale mogą mieć pewne nierozwiązane problemy (aby zgłosić problemy i przekazać opinię, użyj narzędzia do śledzenia problemów). Kanał 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.

Ta wersja jest oparta na wersji weekly i jest aktualizowana raz w tygodniu.

Kanał beta możesz określić, wczytując interfejs Maps JavaScript API za pomocą tego tagu skryptu:

  <script>
  (g=>{var h,a,k,p="The Google Maps JavaScript API",c="google",l="importLibrary",q="__ib__",m=document,b=window;b=b[c]||(b[c]={});var d=b.maps||(b.maps={}),r=new Set,e=new URLSearchParams,u=()=>h||(h=new Promise(async(f,n)=>{await (a=m.createElement("script"));e.set("libraries",[...r]+"");for(k in g)e.set(k.replace(/[A-Z]/g,t=>"_"+t[0].toLowerCase()),g[k]);e.set("callback",c+".maps."+q);a.src=`https://maps.${c}apis.com/maps/api/js?`+e;d[q]=f;a.onerror=()=>h=n(Error(p+" could not load."));a.nonce=m.querySelector("script[nonce]")?.nonce||"";m.head.append(a)}));d[l]?console.warn(p+" only loads once. Ignoring:",g):d[l]=(f,...n)=>r.add(f)&&u().then(()=>d[l](f,...n))})({
    key: "YOUR_API_KEY",
    v: "beta",
  });
  </script>

Wybieranie kanału alfa

Korzystaj z kanału alfa, aby wypróbować nowe eksperymentalne funkcje i zmiany. Aby zgłaszać problemy i przesyłać opinie, używaj Issue Trackera. 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 on wyłącznie do celów programistycznych i nie należy go używać w środowisku produkcyjnym.

Ta wersja jest oparta na wersji beta i jest aktualizowana raz w tygodniu.

Kanał alfa możesz określić, wczytując interfejs Maps JavaScript API za pomocą tego tagu skryptu:

  <script>
  (g=>{var h,a,k,p="The Google Maps JavaScript API",c="google",l="importLibrary",q="__ib__",m=document,b=window;b=b[c]||(b[c]={});var d=b.maps||(b.maps={}),r=new Set,e=new URLSearchParams,u=()=>h||(h=new Promise(async(f,n)=>{await (a=m.createElement("script"));e.set("libraries",[...r]+"");for(k in g)e.set(k.replace(/[A-Z]/g,t=>"_"+t[0].toLowerCase()),g[k]);e.set("callback",c+".maps."+q);a.src=`https://maps.${c}apis.com/maps/api/js?`+e;d[q]=f;a.onerror=()=>h=n(Error(p+" could not load."));a.nonce=m.querySelector("script[nonce]")?.nonce||"";m.head.append(a)}));d[l]?console.warn(p+" only loads once. Ignoring:",g):d[l]=(f,...n)=>r.add(f)&&u().then(()=>d[l](f,...n))})({
    key: "YOUR_API_KEY",
    v: "alpha",
  });
  </script>

Wybieranie numeru wersji

Wersję należy określać za pomocą numeru tylko wtedy, gdy regularnie testujesz i aktualizujesz aplikację. Dzieje się tak, ponieważ numerowane wersje są ostatecznie usuwane, gdy co kwartał tworzone są nowe wersje. Numer wersji możesz określić, wczytując interfejs Maps JavaScript API za pomocą tego tagu skryptu:

  <script>
  (g=>{var h,a,k,p="The Google Maps JavaScript API",c="google",l="importLibrary",q="__ib__",m=document,b=window;b=b[c]||(b[c]={});var d=b.maps||(b.maps={}),r=new Set,e=new URLSearchParams,u=()=>h||(h=new Promise(async(f,n)=>{await (a=m.createElement("script"));e.set("libraries",[...r]+"");for(k in g)e.set(k.replace(/[A-Z]/g,t=>"_"+t[0].toLowerCase()),g[k]);e.set("callback",c+".maps."+q);a.src=`https://maps.${c}apis.com/maps/api/js?`+e;d[q]=f;a.onerror=()=>h=n(Error(p+" could not load."));a.nonce=m.querySelector("script[nonce]")?.nonce||"";m.head.append(a)}));d[l]?console.warn(p+" only loads once. Ignoring:",g):d[l]=(f,...n)=>r.add(f)&&u().then(()=>d[l](f,...n))})({
    key: "YOUR_API_KEY",
    v: 3.61,
  });
  </script>

Obecnie możesz określić v=3.62, v=3.61, v=3.60 lub v=3.59.

• Wersja 3.62 jest aktualizowana co tydzień i zawiera nowe funkcje, poprawki błędów oraz ulepszenia zwiększające wydajność.
• Wersja 3.61 nie otrzymuje cotygodniowych aktualizacji.
• Wersja 3.60 nie otrzymuje cotygodniowych aktualizacji.
• Wersja 3.59 nie otrzymuje cotygodniowych aktualizacji.
• Możemy co jakiś czas wprowadzać poprawki błędów związanych z bezpieczeństwem w dowolnej wersji.
• Podczas tworzenia nowej wersji możemy wprowadzać zmiany, które nie są wstecznie kompatybilne.

Po połowie listopada będzie można określić v=3.63, v=3.62, v=3.61 lub v=3.60.

• Wersja 3.63 będzie otrzymywać cotygodniowe aktualizacje z nowymi funkcjami, poprawkami błędów i ulepszeniami wydajności.
• Wersja 3.62 nie będzie już otrzymywać cotygodniowych aktualizacji.
• Wersja 3.61 nie będzie już otrzymywać cotygodniowych aktualizacji.
• Wersja 3.60 nie będzie już otrzymywać cotygodniowych aktualizacji.
• Możemy co jakiś czas wprowadzać poprawki błędów związanych z bezpieczeństwem w dowolnej wersji.
• Wersja 3.59 nie będzie już dostępna. Każda próba wczytania tej wersji zostanie zignorowana, a zamiast niej otrzymasz kanał domyślny.

Poniższy diagram pokazuje, które wersje będą dostępne w poszczególnych kanałach w ciągu najbliższego roku.

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

Gdy zaktualizujemy kanały wersji, może to wpłynąć na Twoją aplikację. Może to być spowodowane tym, że aplikacja korzysta z nieudokumentowanych lub wycofanych funkcji albo z wprowadzonego przez nas błędu lub poprawki błędu.

Tymczasowo możesz ponownie skonfigurować aplikację, aby używać starszej wersji.

1. Otwórz konsolę w narzędziach programisty przeglądarki i sprawdź wartość google.maps.version.
2. Zaktualizuj tag skryptu, który wczytuje interfejs API, i poproś o starszy numer wersji.
   Jeśli na przykład google.maps.version to „3.62.2”, użyj w tagu skryptu v=3.61.
   To tymczasowe obejście będzie działać tylko przez ograniczony czas.

Po wprowadzeniu tymczasowego rozwiązania będziesz mieć czas (zwykle od 3 do 6 miesięcy) na zaktualizowanie aplikacji, aby nie korzystała już z nieudokumentowanych lub wycofanych funkcji, a także na uwzględnienie błędów lub poprawek.

Następnie przywróć pierwotny tag skryptu, aby załadować interfejs API.

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

Kwartalne e-maile z aktualnościami

Zespół interfejsu Maps JavaScript API wydaje nową wersję raz na kwartał. Dzieje się to w połowie lutego, maja, sierpnia i listopada. Kolejna aktualizacja nastąpi w połowie listopada. Nowy kanał tygodniowy będzie udostępniać wersję 3.63. W tym czasie zaktualizujemy pozostałe kanały.