Obsługa wersji

Wybór kanału tygodniowego

W przypadku większości aplikacji zalecamy korzystanie z kanału tygodniowego. 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.58. Ta wersja jest aktualizowana co tydzień o nowe funkcje, poprawki błędów i ulepszenia działania.

W połowie listopada kanał tygodniowy zostanie zaktualizowany do wersji 3.59. W tym czasie nowa wersja może usunąć przestarzałe funkcje lub wprowadzić niekompatybilność wsteczną.

Wybieranie kanału kwartalnego

Niektóre aplikacje mogą korzystać z mniejszej liczby większych aktualizacji, ponieważ zapewnia to większą przewidywalność. W przypadku tych aplikacji należy korzystać z kanału kwartalnego. Stosuj to podejście, jeśli chcesz, aby poprawki błędów i ulepszenia wydajności były dostępne w oczekiwanym terminie (patrz comiesięczne aktualizacje). 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.57. 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ć w tej wersji poprawki błędów związanych z zabezpieczeniami.

W połowie listopada kwartalny kanał zostanie zaktualizowany do wersji 3.58. Wtedy nowa wersja będzie zawierać nowe funkcje, usuwać wycofane funkcje lub wprowadzać niezgodności wsteczne w porównaniu z poprzednimi 3 miesiącami.

Wybieranie wersji beta

Korzystaj z kanału wersji beta, aby wypróbować nowe funkcje i zmiany w wersji beta. Funkcje w wersji beta są w pełni funkcjonalne, ale mogą mieć jeszcze nierozwiązane problemy (użyj śledzika problemów, aby zgłosić problemy i przekazać opinię). Kanały beta nie są objęte gwarancją jakości usług ani żadnymi zasadami wycofywania, a niektóre zmiany mogą nie być zgodne ze starszymi wersjami.

Ten kanał jest oparty na kanale weekly i jest aktualizowany 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ąc z kanału alfa, możesz wypróbować nowe eksperymentalne funkcje i zmiany. Aby zgłaszać problemy i przesyłać opinie, użyj śledzika problemów. Kanału alfa nie obejmuje żadna gwarancja jakości usług ani żadna zasada wycofywania, a niektóre zmiany mogą nie być zgodne wstecznie z wcześniejszymi wersjami. Służy ona tylko do celów programistycznych i nie powinna być używana w wersji produkcyjnej.

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>
  (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

Określ wersję za pomocą numeru tylko wtedy, gdy regularnie testujesz i aktualizujesz aplikację. Dzieje się tak, ponieważ wersje numerowane 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.57,
  });
  </script>

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

• Wersja 3.58 otrzymuje cotygodniowe aktualizacje z nowymi funkcjami, poprawkami błędów i ulepszeniami 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 związanych z zabezpieczeniami do dowolnej wersji.
• Podczas tworzenia nowej wersji możemy wprowadzić zmiany, które nie będą zgodne z poprzednimi wersjami.

Po połowie listopada będzie można wybrać v=3.59, v=3.58, v=3.57 lub v=3.56.

• Wersja 3.59 będzie co tydzień otrzymywać aktualizacje z nowymi funkcjami, poprawkami błędów i ulepszeniami 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 związanych z zabezpieczeniami do dowolnej wersji.
• Wersja 3.55 nie będzie już dostępna. Wszelkie próby załadowania tej wersji zostaną zignorowane, a zamiast niej wyświetli się kanał domyślny.

Na diagramie poniżej widać, które wersje będą dostępne w poszczególnych kanałach w przyszłym 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 powodu błędu lub wprowadzonej przez nas poprawki.

Jako tymczasowe rozwiązanie możesz skonfigurować aplikację tak, aby używała starszej wersji.

1. Otwórz konsolę w narzędziach dla programistów w przeglądarce i sprawdź wartość zmiennej google.maps.version.
2. Zaktualizuj tag skryptu, który wczytuje interfejs API, i wyślij żądanie z numerem starszej wersji.
   Jeśli na przykład google.maps.version to „3.58.2”, w tagu skryptu użyj wartości v=3.57.
   To tymczasowe obejście będzie działać tylko przez ograniczony czas.

Gdy wprowadzimy tymczasowe obejście, będziesz mieć czas (zazwyczaj 3–6 miesięcy), aby zaktualizować aplikację, aby nie używała już funkcji bez dokumentacji lub wycofanych funkcji, oraz aby naprawić błędy lub wprowadzić poprawki.

Następnie wróć do pierwotnego tagu skryptu, aby załadować interfejs API.

Możesz też utworzyć zgłoszenie lub zgłosić problem.

Kwartalne e-maile z aktualnościami

Raz na kwartał zespół Maps JavaScript API udostępnia nową wersję. Dotyczy to połowy lutego, maja, sierpnia i listopada. Następna aktualizacja zostanie przeprowadzona w połowie listopada. Nowy kanał tygodniowy będzie zawierać wersję 3.59. Wtedy też zostaną zaktualizowane inne kanały.