Mapy termiczne

Punkt końcowy heatmapTiles udostępnia mapy cieplne związane z jakością powietrza w postaci nakładki na kafelki. Nakładka z fragmentami mapy to zbiór fragmentów obrazów PNG, które można wyświetlać na wierzchu Map Google. Każdy fragment obrazu ma wymiary 256 x 256 pikseli.

Informacje o kafelkach mapy termicznej

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

zoom level określa, jak duże lub małe będą treści na mapie w widoku mapy. Rozmiar siatki kafelków jest określany przez skalowanie współrzędnych X i Y wykładniczo 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, czyli łącznie 16 kafelków. Powiększenie określa też maksymalną wartość dopuszczalną dla współrzędnych.

Obraz poniżej przedstawia mapę termiczną US_AQI z poziomem powiększenia 2 oraz współrzędnymi każdego kafelka:

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

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

Informacje o punkcie końcowym mapy termicznej

Kafelek mapy termicznej jest reprezentowany przez tablicę bajtów zawierającą dane kafelka w postaci obrazu PNG. Aby poprosić o aktualne kafelki mapy cieplnej jakości powietrza, użyj punktu końcowego heatmapTiles. W tym celu wyślij żądanie HTTP GET na adres:

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

W żądaniu wymagane są wszystkie parametry:

  • 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 będą treści mapy w widoku mapy. Dozwolone wartości to 0–16, przy czym wartość 0 wyświetla cały świat na jednym kafelku.

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

    Współrzędne kafelka muszą być prawidłowe dla określonego poziomu powiększenia. Jeśli na przykład ustawisz poziom powiększenia na 2 i poprosisz o kafelek 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 limitami. Więcej informacji znajdziesz w artykule uzyskiwanie klucza.

Przykładowe żądanie mapy termicznej

Obraz powyżej przedstawia US_AQImapę termiczną z poziomem powiększenia 2 oraz współrzędnymi każdego kafelka. W tym przykładzie użyto punktu końcowego heatmapTiles do wysłania żądania dotyczącego kafelka o współrzędnych 0,1 z mapy termicznej:

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

Element będzie wyglądać tak:

Kafelek mapy termicznej o współrzędnych 0,1.

Więcej informacji o nakładaniu fragmentów na domyślną mapę znajdziesz w artykule Typy map nakładkowych.