ヒートマップ

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

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

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

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

gridSizeX = XzoomLevel
gridSizeY = YzoomLevel

たとえば、ズームレベル 2 では、世界地図は 4 x 4 のマトリックスを使用して表され、合計 16 枚のタイルになります。ズームによって、座標に許可される最大値も決まります。

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

4 × 4 のグリッドで表示される世界全体のヒートマップ。

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

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

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

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

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

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

  • Z - 地図ビューに表示される地図のコンテンツの大きさを決定するズームレベル。指定できる値は 0 ~ 16 です。0 にすると、世界全体が 1 つのタイルに表示されます。

  • XY - 取得するタイルの座標(北西の角(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

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

座標 0,1 のヒートマップ タイル。

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