バージョニング

週ごとのチャンネルを選択する

ほとんどのアプリケーションでは、週ごとのチャンネルをおすすめします。最も更新頻度が多く、最も新しいバージョンが適用されるため、最新のバグ修正やパフォーマンスの改善が施されます。次のスクリプトタグで Maps JavaScript API を読み込むと、週ごとのチャンネルを指定できます。

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

週ごとのチャンネルの現在のバージョンは 3.58 です。このバージョンでは、新機能の追加、バグの修正、パフォーマンスの改善を含む更新を毎週実施しています。

11 月中旬に、週ごとのチャンネルがバージョン 3.59 に更新されます。このバージョンへの更新時に、サポート対象外となった機能の削除、下位互換性のない変更が行われる場合があります。

四半期ごとのチャンネルを選択する

アプリケーションによっては、影響を予測しやすくなるため、更新頻度が少なくてもメリットを得られる場合があります。そうしたアプリケーションでは、四半期ごとのチャンネルを使用してください。バグの修正やパフォーマンスの改善を、予定した時期に適用したい場合は、この方法を使用します（四半期ごとの更新を参照）。次のスクリプトタグで Maps JavaScript API を読み込むと、四半期ごとのチャンネルを指定できます。

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

四半期ごとのチャンネルの現在のバージョンは 3.57 です。この四半期中、Google がこのバージョンで、新機能の追加、バグの修正、パフォーマンスの改善を実施することはありません。セキュリティ関連のバグ修正は、随時適用される可能性があります。

11 月中旬に、四半期ごとのチャンネルがバージョン 3.58 に更新されます。このバージョンへの更新時に、新機能の追加、サポート対象外となった機能の削除、過去 3 か月間のバージョンとの下位互換性がない変更が行われる場合があります。

ベータ版チャンネルを選択する

ベータ版チャンネルを使用すると、ベータ版の新機能や変更点を試すことができます。ベータ版機能は不完全ではありませんが、未解決の問題が含まれている可能性があります（Issue Tracker を使用して問題を報告し、フィードバックをお送りください）。ベータ版チャンネルは SLA や非推奨ポリシーの対象ではありません。一部の変更は、以前のリリースとの下位互換性がない場合があります。

このチャンネルは weekly チャンネルに基づいており、週に 1 回更新されます。

ベータ版チャンネルを指定するには、次のスクリプトタグを使用して Maps JavaScript API を読み込みます。

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

アルファ版チャンネルを選択する

アルファ版チャンネルを使用して、新しい試験運用版の機能と変更内容をお試しください。Issue Tracker を使用して、問題を報告し、フィードバックをお送りください。アルファ版チャンネルは SLA や非推奨ポリシーの対象ではありません。一部の変更は、以前のリリースとの下位互換性がない場合があります。これは開発専用です。本番環境では使用しないでください。

このチャンネルは beta チャンネルに基づいており、週に 1 回更新されます。

アルファ版チャンネルを指定するには、次のスクリプトタグを使用して Maps JavaScript API を読み込みます。

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

バージョン番号を選択する

アプリケーションを定期的にテストして更新する場合にのみ、バージョン番号を指定します。これは、番号付きのバージョンは、四半期ごとに新しいバージョンが作成され、やがて削除されるためです。バージョン番号を指定するには、次のスクリプトタグを使用して Maps JavaScript API を読み込みます。

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

現在は、v=3.58、v=3.57、v=3.56、または v=3.55 を指定できます。

• バージョン 3.58 では、新機能の追加、バグの修正、パフォーマンスの改善を含む更新を毎週実施しています。
• バージョン 3.57 では、毎週の更新は実施されていません。
• バージョン 3.56 では、毎週の更新は実施されていません。
• バージョン 3.55 では、毎週の更新は実施されていません。
• セキュリティ関連のバグ修正は、どのバージョンにも随時適用される可能性があります。
• 新しいバージョンを作成する際に、下位互換性のない変更が行われる場合があります。

11 月中旬以降は、v=3.59、v=3.58、v=3.57、または v=3.56 を指定できます。

• バージョン 3.59 では、新機能の追加、バグの修正、パフォーマンスの改善を含む更新を毎週実施しています。
• バージョン 3.58 では、毎週の更新が実施されなくなります。
• バージョン 3.57 では、毎週の更新が実施されなくなります。
• バージョン 3.56 では、毎週の更新が実施されなくなります。
• セキュリティ関連のバグ修正は、どのバージョンにも随時適用される可能性があります。
• バージョン 3.55 は使用できなくなります。このバージョンを読み込もうとしても無視され、代わりにデフォルト チャンネルが適用されます。

下の図には、今後 1 年間に各チャンネルで利用できるバージョンがまとめられています。

四半期ごとの更新

四半期に 1 回、Maps JavaScript API チームが新しいバージョンをリリースします。リリースは、2 月中旬、5 月中旬、8 月中旬、11 月中旬に行われます。次回のリリースは 11 月中旬です。新しい週ごとのチャンネルで提供されるバージョンは 3.59 となります。そこで他のチャンネルも更新されます。