ヒートマップ

heatmapTiles エンドポイントは、タイル オーバーレイを通じて大気質関連のヒートマップを提供します。タイル オーバーレイは、Google マップ上に重ねて表示できる PNG 画像タイルのコレクションです。各画像タイルは 256 x 256 ピクセルです。

ヒートマップ タイルについて

タイル オーバーレイは、タイルのコレクションから組み立てられたグリッドで、各タイルには（X、Y）座標が割り当てられています。座標（0,0）のタイルは常にマップの北西隅にあります。X の値は西から東に増分し、Y の値は北から南に増分します。

zoom level は、地図ビューに表示される地図のコンテンツの大きさを決定します。タイルグリッドのサイズは、X 座標と Y 座標をズームレベルで指数関数的にスケーリングすることによって決まります。

gridSizeX = XzoomLevel
gridSizeY = YzoomLevel

たとえば、ズームレベル 2 では、世界地図は 4 x 4 の行列で表され、合計 16 個のタイルになります。ズームは、座標に許容される最大値も決定します。

次の図は、ズームレベルが 2 の US_AQI ヒートマップと、各タイルの座標を示しています。

詳しくは、地図とタイル座標をご覧ください。

ヒートマップ エンドポイントについて

ヒートマップ タイルは、タイルデータを PNG 画像として含むバイト配列で表されます。現在の空気質ヒートマップ タイルをリクエストするには、HTTP GET リクエストを次の URL に送信して heatmapTiles エンドポイントを使用します。

https://airquality.googleapis.com/v1/mapTypes/TYPE/heatmapTiles/Z/X/Y?key=YOUR_API_KEY

リクエストでは、すべてのリクエスト パラメータが必須です。

• TYPE - 返すヒートマップのタイプ。許容値をご覧ください。

• Z - 地図ビューで地図のコンテンツがどのくらいの大きさで表示されるかを決定するズームレベル。使用できる値は 0 ～ 16 です。値が 0 の場合は、全世界が 1 つのタイルで表示されます。

• X、Y - 北西の角（0,0）を基準とした、取得するタイルの座標。X 値は西から東に増分し、Y 値は北から南に増分します。

  タイル座標は、指定されたズームレベルで有効である必要があります。たとえば、ズームレベルを 2 に設定し、座標 10,10 のタイルをリクエストすると、API はエラーを返します。

• YOUR_API_KEY - アプリケーションの API キー。このキーは、割り当て管理の目的でアプリケーションを識別します。詳細については、鍵を取得するをご覧ください。

ヒートマップ リクエストの例

上の画像は、ズームレベル 2 の US_AQI ヒートマップと、各タイルの座標を示しています。次の例では、heatmapTiles エンドポイントを使用して、ヒートマップから座標 0,1 のタイルをリクエストしています。

https://airquality.googleapis.com/v1/mapTypes/US_AQI/heatmapTiles/2/0/1?key=YOUR_API_KEY

タイルは次のように表示されます。

デフォルトの地図の上にタイルをオーバーレイする方法については、地図タイプのオーバーレイをご覧ください。