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 でアクセスできるタイルに分割されています。
詳しくは、地図とタイル座標をご覧ください。
HTTP GET リクエストを次の URL に送信することで、現在の花粉ヒートマップ タイルを heatmapTiles エンドポイントを使用してリクエストできます。
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
タイルは、地図に重ね合わせることができる画像として表示されます。
デフォルトの地図の上にタイルをオーバーレイする方法については、地図タイプのオーバーレイをご覧ください。