Mapy termiczne

Punkt końcowy heatmapTiles udostępnia mapy termiczne jakości powietrza za pomocą nakładki z kafelkami. Nakładka na kafelki to kolekcja kafelków obrazów w formacie PNG, które można wyświetlać na Mapach Google. Każdy kafelek z obrazem ma rozmiar 256 x 256 pikseli.

Informacje o kafelkach mapy termicznej

Nakładka z kafelkami to siatka złożona z kolekcji kafelków, do których przypisane są współrzędne (X,Y). Kafelek ze współrzędnymi (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ża lub mała zawartość mapy pojawia się 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 powiększeniu 2 mapa świata jest przedstawiona za pomocą macierzy 4 x 4, co daje w sumie 16 kafelków. Powiększenie określa też maksymalną wartość współrzędnych.

Poniższy obraz przedstawia mapę termiczną US_AQI z powiększeniem na poziomie 2 oraz współrzędne każdego kafelka:

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

Więcej informacji znajdziesz w sekcji Współrzędne mapy i kafelki.

Punkt końcowy mapy termicznej

Kafelek mapy termicznej jest reprezentowany przez tablicę bajtów, która zawiera dane kafelka w postaci obrazu PNG. Żądanie kafelków mapy termicznej bieżącej jakości powietrza wysyła za pomocą 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

Żądanie musi zawierać wszystkie parametry:

  • TYPE – mapa termiczna do zwrócenia. Sprawdź dozwolone wartości.

  • Z – poziom powiększenia, który określa, jak duża lub mała zawartość mapy pojawia się w widoku mapy. Dozwolone są wartości z zakresu 0–16, gdzie wartość 0 oznacza cały świat na jednym kafelku.

  • X,Y – współrzędne kafelka do pobrania względem północnego zachodniego rogu (0,0). Wartości parametru 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 np. ustawisz poziom powiększenia na 2 i żądasz wyświetlenia kafelka przy współrzędnych 10,10, interfejs API zwróci błąd.

  • YOUR_API_KEY – klucz interfejsu API Twojej aplikacji. Ten klucz identyfikuje aplikację na potrzeby zarządzania limitami. Więcej informacji znajdziesz w artykule na temat pobierania klucza.

Przykładowe żądanie mapy termicznej

Powyższy obraz przedstawia mapę termiczną US_AQI z powiększeniem na poziomie 2 oraz współrzędne każdego kafelka. Ten przykład korzysta z punktu końcowego heatmapTiles, aby zażądać kafelka w współrzędnych 0,1 z mapy termicznej:

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

Kafelek wygląda tak:

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

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