Mapy termiczne

Punkt końcowy heatmapTiles udostępnia mapy termiczne związane z jakością powietrza w formie nakładki z kafelkami. Nakładka z kafelkami to zbiór kafelków obrazów w formacie PNG, które można wyświetlić na Mapach Google. Każdy kafelek obrazu ma wymiary 256 x 256 pikseli.

Informacje o kafelkach mapy termicznej

Nakładka z kafelkami to siatka złożona z kafelków, z których każdy ma przypisane współrzędne (X i Y). Kafelek ze współrzędnymi (0,0) znajduje się zawsze 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 jak mała zawartość mapy wyświetla się w widoku mapy. Rozmiar siatki kafelków jest określany przez wykładnicze skalowanie współrzędnych X i Y zgodnie z poziomem powiększenia.

gridSizeX = XzoomLevel
gridSizeY = YzoomLevel

Na przykład przy powiększeniu równym 2 mapa świata jest przedstawiana za pomocą matrycy 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 poziomem powiększenia 2 wraz ze współrzędnymi 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 fragmentu mapy.

Informacje o punkcie końcowym mapy termicznej

Kafelek mapy termicznej jest reprezentowany przez macierz bajtów zawierającą dane kafelka jako obraz PNG. Bieżące żądania fragmentów mapy termicznej jakości powietrza możesz wysyłać, korzystając z 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 wymagane są wszystkie parametry żądania:

  • TYPE – mapa termiczna typu zwracana. Zobacz Dozwolone wartości.

  • Z – poziom powiększenia określający, jak duża lub mała zawartość mapy ma się wyświetlać w widoku mapy. Dozwolone są wartości z zakresu 0–16, gdzie wartość 0 wyświetla cały świat w 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 – 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 kafelka 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 o uzyskiwaniu klucza.

Przykładowe żądanie mapy termicznej

Powyższy obraz przedstawia mapę termiczną US_AQI z poziomem powiększenia 2 wraz ze współrzędnymi każdego kafelka. Ten przykład używa punktu końcowego heatmapTiles do żądania 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

Kafelek jest wyświetlany jako:

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

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