Heatmaps

Der heatmapTiles stellt pollenbezogene Heatmaps über ein Kachel-Overlay 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 die Koordinaten (X,Y) zugewiesen sind. Die Kachel mit den Koordinaten (0,0) befindet sich immer in der nordwestlichen Ecke der Karte. Die X-Werte steigen von West nach Ost und die Y-Werte von Nord nach Süd.

Die zoom level bestimmt, wie groß oder klein die Inhalte einer Karte in einer Kartenansicht angezeigt werden. Die Größe des Kachelrasters wird durch exponentielles Skalieren der X- und Y-Koordinaten nach der Zoomstufe bestimmt.

gridSizeX = XzoomLevel
gridSizeY = YzoomLevel

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

Die folgende Abbildung zeigt eine TREE_UPI-Heatmap der gesamten Welt, unterteilt in Kacheln, 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 Kachel koordinaten.

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

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

Endpunkt für Heatmaps

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. Informationen zum Abrufen eines Schlüssels.
  • TYPE: Der Typ der zurückzugebenden Heatmap. Siehe zulässige Werte.
  • Z: Die Zoomstufe, die bestimmt, wie groß oder klein die Inhalte einer Karte in einer Kartenansicht angezeigt werden. Zulässige Werte sind 0 bis 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 steigen von West nach Ost und die Y-Werte von Nord nach Süd. Die Koordinaten müssen für die angegebene Zoomstufe gültig sein. Wenn Sie beispielsweise die Zoomstufe auf 2 festlegen und eine Kachel mit den Koordinaten (10,10) anfordern, gibt die API einen Fehler zurück.

Beispiel für eine Heatmap-Anfrage

Die Abbildung 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 mit 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 überlagert werden kann:

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

Weitere Informationen zum Überlagern von Kacheln auf der Standardkarte finden Sie unter Karten-Overlays.