ヒートマップ

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

タイル オーバーレイはタイルのコレクションから構築されたグリッドで、 (X,Y) 座標。座標 (0,0) のタイルは常に 移動します。X の値は西から東に向かって増加し、 Y の値は北から南に向かって増加します。

zoom level は、地図上に表示される地図コンテンツのサイズを決定します。 使用できます。タイルグリッドのサイズは、XY のスケーリングによって決まります ズームレベルに応じて指数関数的に変化します。

gridSizeX = XzoomLevel
gridSizeY = YzoomLevel

たとえば、ズームレベル 2 では、世界地図は 4 x 4 のズームレベルで表されます。 合計 16 タイルです。

次の画像は、全世界の TREE_UPI ヒートマップをセクション分けしたものです。 ズームレベル 2 でアクセスできるタイルに変換されます。

4 x 4 グリッドでの世界全体のヒートマップ。

地図とタイルをご覧ください。 座標 追加することもできます

heatmapTiles HTTP GET リクエストを次の宛先に送信します。

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

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

リクエストが成功するには、以下のパラメータがすべて必要です。

  • KEY: アプリケーションの API キー。このキーで、アプリケーションを識別するための クォータ管理を目的としています。詳しくは、 キーです。
  • TYPE: 返されるヒートマップのタイプ。許可されていることを 使用できます。
  • Z: 地図のコンテンツのサイズを決定するズームレベル マップビューに表示されます。使用できる値は 0 ~ 16 で、値 0 は表示されます。 世界全体を単一のタイルで表示できます。
  • XY: 北東の角(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

タイルは、地図に重ねることができる画像として表示されます。

TREE_UPI マップを使用したヒートマップ タイルの例。

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