heatmapTiles エンドポイントは、タイル オーバーレイを使用して花粉関連のヒートマップを提供します。タイル オーバーレイは、Google マップ上に表示できる画像タイルのコレクションです。各画像タイルのサイズは 256 x 256 ピクセルです。
タイル オーバーレイは、タイルの集合から組み立てられたグリッドで、それぞれに(X
、Y
)座標が割り当てられます。座標(0,0)のタイルは常に地図の北西の隅にあります。X
値は西から東に増加し、Y
値は北から南に増加します。
zoom level
は、地図表示内に表示される地図のコンテンツの大きさを決定します。タイルグリッドのサイズは、X
座標と Y
座標をズームレベルに応じて指数関数的にスケーリングすることによって決定されます。
gridSizeX = XzoomLevel gridSizeY = YzoomLevel
たとえば、ズームレベル 2 では、世界地図は 4 x 4 のマトリックスを使用して表示され、合計 16 個のタイルになります。
次の画像は、全世界の TREE_UPI
ヒートマップを、ズームレベル 2 でアクセスできるタイルに分割したものです。
詳しくは、地図とタイルの座標をご覧ください。
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
タイルは、地図に重ねて表示できる画像として表示されます。
デフォルトの地図にタイルを重ね合わせる方法については、オーバーレイの地図タイプをご覧ください。