Heatmaps

Der Endpunkt heatmapTiles stellt über ein Kachel-Overlay Heatmaps mit Bezug zur Luftqualität bereit. Ein Kachel-Overlay ist eine Sammlung von PNG-Bildkacheln, die über Google Maps angezeigt werden können. Jede Bildkachel hat eine Größe von 256 x 256 Pixel.

Heatmap-Kacheln

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 erhöhen sich von Westen nach Osten, 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. Der Zoom bestimmt auch den Maximalwert für die Koordinaten.

Die folgende Abbildung zeigt eine US_AQI-Heatmap mit der Zoomstufe 2 zusammen mit den Koordinaten der einzelnen Kacheln:

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

Weitere Informationen finden Sie unter Karten- und Kachelkoordinaten.

Informationen zum Heatmap-Endpunkt

Eine Heatmap-Kachel wird durch ein Byte-Array dargestellt, das die Kacheldaten als PNG-Bild enthält. Wenn Sie Heatmap-Kacheln für die aktuelle Luftqualität über den Endpunkt heatmapTiles anfordern, senden Sie eine HTTP-GET-Anfrage an:

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

Alle Anfrageparameter sind in einer Anfrage erforderlich:

  • 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 Koordinaten der abzurufenden Kachel, relativ zur nordwestlichen Ecke (0,0). Die X-Werte steigen von Westen nach Osten und Y-Werte von Nord nach Süd.

    Kachelkoordinaten 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.

  • YOUR_API_KEY: Der API-Schlüssel Ihrer Anwendung. Dieser Schlüssel identifiziert Ihre Anwendung zum Zweck der Kontingentverwaltung. Weitere Informationen findest du unter Schlüssel abrufen.

Beispiel für eine Heatmap-Anfrage

Das Bild oben zeigt eine US_AQI-Heatmap mit Zoomstufe 2 und den Koordinaten der einzelnen Kacheln. Im folgenden Beispiel wird der Endpunkt heatmapTiles verwendet, um die Kachel bei den Koordinaten 0,1 aus der Heatmap anzufordern:

https://airquality.googleapis.com/v1/mapTypes/US_AQI/heatmapTiles/2/0/1?key=YOUR_API_KEY

Die Kachel wird angezeigt als:

Eine Heatmap-Kachel an den Koordinaten 0,1.

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