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 wymiary 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ć aktualne kafelki mapy ciepła jakości powietrza, użyj punktu końcowego heatmapTiles, wysyłając żądanie HTTP GET do:

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ą od zachodu na wschód, a wartości Y – od 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.

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