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 画像で含むバイト配列で表されます。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 つのタイルに表示されます。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
タイルは次のように表示されます。
デフォルトの地図にタイルを重ね合わせる方法については、オーバーレイの地図タイプをご覧ください。