バージョニング

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

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

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

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

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

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

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

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

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

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

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

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

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

次のスクリプトタグで Maps JavaScript API を読み込むと、ベータ版チャンネルを指定できます。

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

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

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

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

次のスクリプトタグで Maps JavaScript API を読み込むと、アルファ版チャンネルを指定できます。

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

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

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

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

現在は、v=3.52、v=3.51、v=3.50、または v=3.49 を指定できます。

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

4 月中旬以降は、v=3.53、v=3.52、v=3.51、または v=3.50 を指定できます。

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

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

更新によってアプリケーションに影響が生じた場合

リリース チャンネルを更新すると、アプリケーションに影響する可能性があります。これは、アプリケーションが文書化されていない機能や非推奨の機能に依存していることか、バグやバグ修正が導入されたことが原因になっている可能性があります。

一時的な回避策として、古いバージョンを使用するようにアプリケーションを再構成できます。

1. ブラウザのデベロッパー ツールでコンソールを開き、google.maps.version の値を確認します。
2. API を読み込むスクリプトタグを更新し、古いバージョン番号をリクエストします。
   たとえば、google.maps.version が「3.52.2」の場合は、スクリプトタグで v=3.51 を使用します。
   この一時的な回避策は期間限定で有効です。

一時的な回避策を適用したら、一定期間内（通常は 3～6 か月）にアプリを更新し、文書化されていない機能やサポート終了の機能を削除したり、バグやバグの修正に対応したりしてください。

API を読み込むには、元のスクリプトタグに戻す必要があります。

サポートケースを作成したり、問題を報告したりすることもできます。

四半期ごとの更新

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