Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

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

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

利用規約

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

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

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

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

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

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

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

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

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

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

地図タイプ

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

US_PRECIPITATION_CURRENT: 米国の高解像度降水ナウキャスト。
EU_PRECIPITATION_CURRENT: 高解像度のヨーロッパの降水量のナウキャスト。

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

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

タイル座標系

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

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

zoom: ズームレベル（0 ～ 16）。ズームレベル 0 では、全世界が 1 つのタイル（2⁰ x 2⁰ = 1 タイル）で表されます。ズームレベル z では、世界が 2^z x 2^z タイルのグリッドに分割されます。
x: タイルの X 座標（列）。0（最西端）から 2^ズーム - 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 などの特定のシリアル化設定でのみ表示されます。