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:
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 parametruX
rosną z zachodu na wschód, a wartościY
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:
Więcej informacji o nakładaniu kafelków na mapę domyślną znajdziesz w artykule Typy nakładek map.