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). Płytka 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 w widoku mapy. 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.

Ten obraz przedstawia mapę termiczną US_AQI z poziomem powiększenia 2, wraz ze współrzędnymi każdej płytki:

Mapa termiczna całego świata w siatce 4 x 4.

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

Punkt końcowy mapy termicznej

Płytka mapy termicznej 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 ciepła 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 (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 żądania kafelka 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ę fragmentów mapy na mapę domyślną znajdziesz w artykule Typy nakładek mapy.