Heatmaps

Der Endpunkt heatmapTiles bietet pollenbezogene Heatmaps über ein Kachel-Overlay. 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 Pixeln.

Das Kachel-Overlay ist ein Raster, das aus einer Sammlung von Kacheln besteht, die jeweils (X,Y)-Koordinaten 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 ansteigen.

Mit dem zoom level wird festgelegt, wie groß oder klein die Inhalte einer Karte in einer Kartenansicht angezeigt werden. Die Größe des Kachelrasters wird durch eine exponentielle Skalierung der X- und Y-Koordinaten anhand der Zoomstufe bestimmt.

gridSizeX = XzoomLevel
gridSizeY = YzoomLevel

Bei einer Zoomstufe von 2 wird die Weltkarte beispielsweise mit einer 4 × 4-Matrix dargestellt, was insgesamt 16 Kacheln ergibt.

Das folgende Bild zeigt eine TREE_UPI-Hitzekarte der gesamten Welt, die in Kacheln unterteilt ist, auf die bei einer Zoomstufe von 2 zugegriffen werden kann.

Eine Heatmap der gesamten Welt als 4 × 4-Raster.

Weitere Informationen finden Sie unter Karten- und Kachelkoordinaten.

Aktuelle Pollen-Heatmap-Kacheln können Sie über den Endpunkt heatmapTiles anfordern, indem Sie eine HTTP-GET-Anfrage an folgende Adresse senden:

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

Heatmap-Endpunkt

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

  • KEY: Der API-Schlüssel Ihrer Anwendung. Mit diesem Schlüssel wird Ihre Anwendung für die Kontingentverwaltung identifiziert. Weitere Informationen zum Abrufen eines Schlüssels
  • TYPE: Der Typ der zurückzugebenden Heatmap. Weitere Informationen finden Sie unter Zulässige Werte.
  • Z: Zoomebene, die bestimmt, wie groß oder klein die Inhalte einer Karte in einer Kartenansicht angezeigt werden. Zulässige Werte sind 0–16. Bei einem Wert von 0 wird die gesamte Welt in einer einzigen Kachel angezeigt.
  • X,Y: Die Kachelkoordinaten relativ zur nordöstlichen Ecke (0,0). Die X-Werte nehmen von Westen nach Osten und die Y-Werte von Norden nach Süden 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 einer Zoomstufe von 2 sowie die Koordinaten der einzelnen Kacheln. Im folgenden Beispiel wird der heatmapTiles-Endpunkt 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 Karte „TREE_UPI“

Weitere Informationen zum Einfügen von Kacheln in die Standardkarte finden Sie unter Kartentypen für Overlays.