Der Endpunkt heatmapTiles
stellt Heatmaps zur Luftqualität über ein Kachel-Overlay 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 mit jeweils zugewiesenen Koordinaten (X
,Y
) besteht.
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, 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. Mit dem Zoom wird auch der Maximalwert für die Koordinaten bestimmt.
Die folgende Abbildung zeigt eine US_AQI
-Heatmap mit einer Zoomstufe von 2 und den Koordinaten der einzelnen Kacheln:
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. Sie fordern die Kacheln der aktuellen Luftqualität über den Endpunkt heatmapTiles
an, indem Sie eine HTTP-GET-Anfrage an folgende Adresse senden:
https://airquality.googleapis.com/v1/mapTypes/TYPE/heatmapTiles/Z/X/Y?key=YOUR_API_KEY
Alle Anfrageparameter sind in einer Anfrage erforderlich:
TYPE
– Der Heatmap-Typ, der zurückgegeben werden soll. Siehe Zulässige Werte.Z
: Die 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 Koordinaten der abzurufenden Kachel, relativ zur nordwestlichen Ecke (0,0). DieX
-Werte nehmen von Westen nach Osten und dieY
-Werte von Norden nach Süden zu.Kachelkoordinaten 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.
YOUR_API_KEY
: der API-Schlüssel Ihrer Anwendung. Dieser Schlüssel identifiziert Ihre Anwendung für die Kontingentverwaltung. Weitere Informationen finden Sie unter Schlüssel anfordern.
Beispiel für eine Heatmap-Anfrage
Das Bild oben zeigt eine US_AQI
-Heatmap mit einer Zoomstufe von 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 wie folgt angezeigt:
Weitere Informationen dazu, wie Kacheln über die Standardkarte gelegt werden, finden Sie unter Overlay-Kartentypen.