Mapy termiczne

Punkt końcowy heatmapTiles udostępnia mapy ciepła związane z jakością powietrza za pomocą nakładki na kafelki. Nakładka z kafelków to zbiór kafelków z obrazami w formacie PNG, które można wyświetlać na mapie w Mapach Google. Każdy kafelek obrazu ma rozmiar 256 × 256 pikseli.

Elementy mapy termicznej

Nakładka z kafelkami to siatka utworzona z kolekcji kafelków, z których każdy ma przypisane współrzędne (X,Y). Element o współrzędnych (0,0) znajduje się zawsze w północno-zachodnim rogu mapy. Wartości X rosną z zachodu na wschód, a wartości Y rosną z północy na południe.

Wartość zoom level określa, jak duże lub małe są elementy mapy widoczne na mapie. Rozmiar siatki płytek jest określany przez skalowanie współrzędnych X i Y w sposób wykładniczy według poziomu powiększenia.

gridSizeX = XzoomLevel
gridSizeY = YzoomLevel

Na przykład przy poziomie powiększenia 2 mapa świata jest reprezentowana za pomocą macierzy 4 x 4, co daje w sumie 16 płytek. Powiększenie określa też maksymalną wartość dozwoloną dla współrzędnych.

Na tym obrazie widać mapę termiczną US_AQI z poziomem powiększenia 2 oraz współrzędne każdej płytki:

Mapa termiczna całego świata w postaci siatki 4 x 4.

Więcej informacji znajdziesz w artykule Współrzędne mapy i płytki.

Punkt końcowy mapy termicznej

Płytka mapy cieplnej jest reprezentowana przez tablicę bajtów zawierającą dane płytki jako obraz PNG. Aby uzyskać informacje o obecnej jakości powietrza, wyślij żądanie HTTP GET do punktu końcowego heatmapTiles, korzystając z interfejsu:

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

W żądaniu muszą się znaleźć wszystkie parametry żądania:

  • TYPE – typ mapy termicznej do zwrócenia. Zobacz dozwolone wartości.

  • Z – poziom powiększenia, który określa, jak duże lub małe elementy mapy są widoczne na mapie. Dozwolone wartości to 0–16, przy czym wartość 0 wyświetla cały świat na jednej karcie.

  • X,Y – współrzędne kafelka do pobrania w uwzględnieniu narożnika północno-zachodniego (0,0). Wartości X rosną z zachodu na wschód, a wartości Y – z północy na południe.

    Współrzędne płytki muszą być prawidłowe dla wybranego poziomu powiększenia. Jeśli na przykład ustawisz poziom powiększenia na 2, a żądanie będzie dotyczyć elementu o współrzędnych 10,10, interfejs API zwróci błąd.

  • YOUR_API_KEY – klucz interfejsu API Twojej aplikacji. Ten klucz identyfikuje Twoją aplikację na potrzeby zarządzania limitem. Więcej informacji znajdziesz w artykule get a key (ang.).

Przykładowe żądanie mapy termicznej

Obraz powyżej przedstawia mapę termiczną US_AQI z poziomem powiększenia 2 oraz współrzędne każdej płytki. W tym przykładzie punkt końcowy heatmapTiles służy do wysyłania prośby o płytkę o współrzędnych 0,1 z mapy ciepła:

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

Element wygląda tak:

Płytka mapy termicznej w współrzędnych 0,1.

Więcej informacji o nakładaniu się kafelków na mapie domyślnej znajdziesz w artykule Typy nakładek mapy.