ヒートマップ

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

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

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

gridSizeX = XzoomLevel
gridSizeY = YzoomLevel

たとえば、ズームレベル 2 では、世界地図は 4 x 4 のマトリックスで表され、合計 16 枚のタイルになります。

次の画像は、ズームレベル 2 でアクセスできるタイルに分割された、世界全体の TREE_UPI ヒートマップを示しています。

詳細については、地図とタイル座標をご覧ください。

現在の花粉飛散ヒートマップ タイルをリクエストするには、 heatmapTiles エンドポイントを使用して、次の URL に HTTP GET リクエストを送信します。

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

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

リクエストを正常に完了するには、以下のすべてのパラメータが必要です。

• KEY: アプリケーションの API キー。このキーは、割り当て管理の目的でアプリケーションを識別します。鍵を取得する方法をご確認ください。
• TYPE: 返されるヒートマップのタイプ。許可される値をご覧ください。
• Z: 地図ビューに表示される地図のコンテンツの大きさを決定するズームレベル。指定できる値は 0 ～ 16 です。値が 0 の場合、世界全体が 1 つのタイルで表示されます。
• X、Y: 北東の角（0,0）を基準としたタイル座標。X 値は西から東に増加し、Y 値は北から南に増加します。座標は、指定したズームレベルで有効なものである必要があります。たとえば、ズームレベルを 2 に設定し、座標（10,10）でタイルをリクエストすると、API はエラーを返します。

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

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

https://pollen.googleapis.com/v1/mapTypes/TREE_UPI/heatmapTiles/2/2/1?key=YOUR_API_KEY

タイルは、地図にオーバーレイできる画像として表示されます。

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