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
エンドポイントを使用して 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
タイルは次のように表示されます。
デフォルトの地図の上にタイルをオーバーレイする方法について詳しくは、オーバーレイのマップタイプをご覧ください。