天気図を取得する（試験運用版）

mapTypes エンドポイントは、降水量予測など、さまざまな気象現象を表すラスターマップ タイルを提供します。これらの地図タイルは、標準の Google マップに重ねて表示できます。

利用規約

これらの規約は、Google とお客様が合意した Google Maps Platform サービス固有の規約のセクション 6（一般提供前サービス規約）に基づいて発行されます。

1.1 帰属表示の要件。お客様が Weather API の Google マップ コンテンツを使用する場合、お客様はドキュメントに従って Google に帰属表示を提供する必要があります。

1.2 制限。お客様は、Weather API から取得した Google Maps コンテンツを使用して、Google のサービスまたはプロダクトを再作成することはできません（たとえば、Weather API から取得したデータを、天気情報の提供を主な目的とする天気アプリまたは天気モデルで使用することはできません）。

1.3 キャッシュ保存。お客様は、表 1.3.1（キャッシュ保存の許可）に記載されているとおり、該当するキャッシュ保存期間中、Weather API から該当する Google マップ コンテンツを一時的にキャッシュに保存できます。

表 1.3.1（キャッシュ保存の権限）

これらの権限は、Google Maps Platform サービス固有の規約の表 17.2.1 に記載されている権限に追加されるものです。

Google マップのコンテンツ キャッシュ期間
天気地図タイル 1 時間。その後、お客様はキャッシュされた Google Maps コンテンツを削除する必要があります。

天気図リクエストについて

天気図をリクエストするには、次の URL に HTTP GET リクエストを送信します。

https://weather.googleapis.com/v1/mapTypes/{map_type}/mapTiles/{zoom}/{x}/{y}

地図タイプ

Weather API は、さまざまな天気地図タイプをサポートしています。これらのタイプは、さまざまな基盤となる天気モデルと地理的エリアに対応しています。

  • US_PRECIPITATION_CURRENT: 米国の高解像度降水量ナウキャスト。
  • EU_PRECIPITATION_CURRENT: 欧州の高解像度降水量ナウキャスト。

以下のカバレッジマップは、天気地図タイルを利用できる地域を示しています。

天気地図タイルの対象範囲

タイル座標系

この API は、標準のウェブ メルカトル タイル座標系を使用します。地図とタイル座標の詳細については、ロードマップ タイルと地図とタイル座標をご覧ください。

このシステムでは以下を行います。

  • zoom: ズームレベル（0 ～ 16）。ズームレベル 0 では、全世界が 1 つのタイル（20 x 20 = 1 タイル）で表示されます。ズームレベル z では、世界が 2z x 2z のタイルからなるグリッドに分割されます。
  • x: タイルの X 座標（列）。0（最西端）から 2zoom - 1（最東端）の範囲です。
  • y: タイルの Y 座標（行）。0（最北）から 2ズーム - 1（最南）の範囲です。

天気地図を表示する

Google Maps JavaScript API を使用してウェブ アプリケーションにこれらのタイルを表示するには、カスタム google.maps.ImageMapType を作成します。

const weatherMapType = new google.maps.ImageMapType({
  getTileUrl: function(coord, zoom) {
    const mapType = "US_PRECIPITATION_CURRENT";
    return `https://weather.googleapis.com/v1/mapTypes/${mapType}/mapTiles/${zoom}/${coord.x}/${coord.y}`;
  },
  tileSize: new google.maps.Size(256, 256),
  maxZoom: 16,
  minZoom: 0,
  name: "Weather"
});

// Overlay on existing map
map.overlayMapTypes.insertAt(0, weatherMapType);

天気地図リクエストの例

次の例では、ニューオーリンズの米国の降水量天気図タイルをリクエストしています。

curl -o tile.png -X GET "https://weather.googleapis.com/v1/mapTypes/US_PRECIPITATION_CURRENT/mapTiles/12/1025/1688?key=API_KEY"

レスポンスはバイナリです。JSON ラッパーは、?alt=json などの特定のシリアル化設定でのみ表示されます。