Heatmaps

Der Endpunkt heatmapTiles stellt Pollen-Heatmaps über Kachel-Overlays bereit. Ein Kachel-Overlay ist eine Sammlung von Bildkacheln, die über Google Maps angezeigt werden können. Jede Bildkachel hat eine Größe von 256 × 256 Pixel.

Das Kachel-Overlay ist ein Raster, das aus einer Sammlung von Kacheln besteht, denen jeweils Koordinaten (X, Y) zugewiesen sind. Die Kachel mit den Koordinaten (0,0) befindet sich immer in der nordwestlichen Ecke der Karte. Die X-Werte nehmen von Westen nach Osten zu, während die Y-Werte von Norden nach Süden zunehmen.

Mit zoom level wird festgelegt, wie groß oder klein der Inhalt einer Karte in einer Kartenansicht angezeigt wird. Die Größe des Kachelrasters wird durch exponentielles Skalieren der Koordinaten X und Y anhand der Zoomstufe bestimmt.

gridSizeX = XzoomLevel
gridSizeY = YzoomLevel

Bei einer Zoomstufe von 2 wird die Weltkarte beispielsweise durch eine 4 × 4-Matrix mit insgesamt 16 Kacheln dargestellt.

Die folgende Abbildung zeigt eine TREE_UPI-Heatmap der gesamten Welt, die in Kacheln unterteilt ist und auf die bei Zoomstufe 2 zugegriffen werden kann.

Eine Heatmap der gesamten Welt als 4 × 4-Raster

Weitere Informationen finden Sie unter Karten- und Kachelkoordinaten.

Sie können aktuelle Pollen-Heatmap-Kacheln mithilfe des Endpunkts heatmapTiles anfordern. Senden Sie dazu eine HTTP-GET-Anfrage an:

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

Informationen zum Heatmap-Endpunkt

Alle unten aufgeführten Parameter sind für eine erfolgreiche Anfrage erforderlich:

  • KEY: der API-Schlüssel Ihrer Anwendung. Dieser Schlüssel identifiziert Ihre Anwendung für die Kontingentverwaltung. Weitere Informationen zum Abrufen eines Schlüssels
  • TYPE: Der Typ der Heatmap, die zurückgegeben werden soll. Siehe Zulässige Werte.
  • Z: Zoomstufe, mit der bestimmt wird, wie groß oder klein der Inhalt einer Karte in einer Kartenansicht angezeigt wird. Zulässige Werte sind 0–16, wobei der Wert 0 die gesamte Welt in einer einzigen Kachel darstellt.
  • X,Y: die Kachelkoordinaten im Verhältnis zur nordöstlichen Ecke (0,0). X-Werte erhöhen sich von Westen nach Osten und Y-Werte von Norden nach Süden. Die Koordinaten müssen für die angegebene Zoomstufe gültig sein. Wenn Sie beispielsweise die Zoomstufe auf 2 festlegen und eine Kachel bei den Koordinaten (10, 10) anfordern, gibt die API einen Fehler zurück.

Beispiel für eine Heatmap-Anfrage

Das Bild oben zeigt eine TREE_UPI-Heatmap mit einer Zoomstufe von 2 sowie die Koordinaten der einzelnen Kacheln. Im folgenden Beispiel wird der Endpunkt heatmapTiles verwendet, um die Kachel bei den Koordinaten (2,1) anzufordern:

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

Die Kachel wird als Bild angezeigt, das auf einer Karte eingeblendet werden kann:

Beispiel für eine Heatmap-Kachel mit der TREE_UPI-Karte.

Weitere Informationen dazu, wie Kacheln über die Standardkarte gelegt werden, finden Sie unter Overlay-Kartentypen.