Heatmaps

Die heatmapTiles Endpunkt bietet Heatmaps zur Luftqualität über ein Kachel-Overlay. Eine Kachel Das Overlay ist eine Sammlung von PNG-Bildkacheln, die auf einem Google Maps 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, jede zugewiesene Koordinaten (X,Y). 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 einem Kartenansicht. Die Größe des Kachelrasters wird durch Skalierung von X und Y bestimmt. -Koordinaten exponentiell durch die Zoomstufe.

gridSizeX = XzoomLevel
gridSizeY = YzoomLevel

Bei einer Zoomstufe von 2 wird die Weltkarte beispielsweise durch eine -Matrix, sodass insgesamt 16 Kacheln vorhanden sind. Der Zoom bestimmt auch, was der Maximalwert ist 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

Siehe Karten- und Kachelkoordinaten .

Informationen zum Heatmap-Endpunkt

Eine Heatmap-Kachel wird durch ein Byte-Array dargestellt, das die Kacheldaten im PNG-Format enthält. Bild. Sie fordern Heatmap-Kacheln zur aktuellen Luftqualität mithilfe der heatmapTiles Endpunkt, indem du eine HTTP-GET-Anfrage an folgende Adresse sendest:

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 Zugelassene Werte.

  • Z – Zoomstufe, mit der bestimmt wird, wie groß oder klein der Inhalt einer Karte ist werden in der Kartenansicht angezeigt. Zulässige Werte sind 0–16, wobei ein Wert von 0 angezeigt wird die ganze Welt in einer einzigen Kachel.

  • X,Y: Koordinaten der abzurufenden Kachel relativ zum Norden westliche Ecke (0,0) zeigen. X-Werte nehmen von Westen nach Osten und Y zu von Norden nach Süden zunehmen.

    Kachelkoordinaten müssen für die angegebene Zoomstufe gültig sein. Beispiel: Sie setzen die Zoomstufe auf 2 und fordern eine Kachel bei Koordinaten 10,10, gibt das API einen Fehler zurück.

  • YOUR_API_KEY: der API-Schlüssel Ihrer Anwendung. Dieser Schlüssel identifiziert Ihre für die Kontingentverwaltung. Weitere Informationen finden Sie unter get Schlüssel

Beispiel für eine Heatmap-Anfrage

Das Bild oben zeigt eine US_AQI-Heatmap mit der Zoomstufe 2, sowie die Koordinaten der einzelnen Kacheln. Im folgenden Beispiel wird die Methode heatmapTiles, um die Kachel an den Koordinaten 0,1 vom Heatmap:

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

Die Kachel wird wie folgt angezeigt:

Eine Heatmap-Kachel bei den Koordinaten 0,1.

Weitere Informationen zum Einblenden von Kacheln über der Standardkarte finden Sie unter Overlay-Kartentypen: