Heatmaps

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

Das Kachel-Overlay ist ein Raster, das aus einer Sammlung von Kacheln besteht, denen jeweils zugewiesene Koordinaten (X, Y) zugewiesen sind. Die Kachel mit den Koordinaten (0,0) befindet sich immer in der nordwestlichen Ecke der Karte. Die X-Werte erhöhen sich von Westen nach Osten, die Y-Werte von Nord nach Süd.

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

gridSizeX = XzoomLevel
gridSizeY = YzoomLevel

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

Die folgende Abbildung zeigt eine TREE_UPI-Heatmap der gesamten Welt, unterteilt in Kacheln, auf die mit 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 über den Endpunkt heatmapTiles anfordern. Dazu senden Sie eine HTTP-GET-Anfrage an:

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

Informationen zum Heatmap-Endpunkt

Für eine erfolgreiche Anfrage sind alle unten aufgeführten Parameter erforderlich:

  • KEY: Der API-Schlüssel Ihrer Anwendung. Dieser Schlüssel identifiziert Ihre Anwendung zum Zweck der Kontingentverwaltung. Hier erfahren Sie, wie Sie einen Schlüssel abrufen.
  • TYPE: Der Typ der Heatmap, die zurückgegeben werden soll. Weitere Informationen finden Sie unter Zulässige Werte.
  • Z: Zoomstufe, mit der festgelegt wird, wie groß oder klein der Inhalt einer Karte in einer Kartenansicht angezeigt wird. Zulässige Werte sind 0–16, wobei ein Wert von 0 die gesamte Welt in einer einzelnen Kachel anzeigt.
  • X,Y: Die Kachelkoordinaten relativ zur nordöstlichen Ecke (0,0). Die X-Werte nehmen von Westen nach Osten und Y-Werte von Nord nach Süd zu. Die Koordinaten müssen für die angegebene Zoomstufe gültig sein. Wenn Sie beispielsweise die Zoomstufe auf 2 festlegen und eine Kachel an 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 Zoomstufe 2 sowie die Koordinaten jeder Kachel. Im folgenden Beispiel wird der Endpunkt heatmapTiles verwendet, um die Kachel an 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 als Overlay auf einer Karte angezeigt werden kann:

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

Weitere Informationen zum Überlagern von Kacheln über der Standardkarte finden Sie unter Overlay-Kartentypen.