heatmapTiles
i wyświetla mapy termiczne związane z jakością powietrza za pomocą nakładki z kafelkami. Kafelek
nakładka to kolekcja kafelków obrazów w formacie PNG, które można wyświetlić na
Mapy 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 płytek,
wszystkich przypisanych współrzędnych (X
,Y
).
Kafelek ze współrzędnymi (0,0) jest zawsze w północno-zachodnim rogu
pozycję na mapie. Wartości X
rosną z zachodu na wschód,
a Y
rośnie 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 tych elementów: X
i Y
koordynuje wykładniczo zgodnie z poziomem powiększenia.
gridSizeX = XzoomLevel gridSizeY = YzoomLevel
Na przykład w powiększeniu 2 mapa świata jest przedstawiana w formacie 10 x 10 cm macierz, co łącznie daje 16 kafelków. Powiększenie określa też wartość maksymalną, dla współrzędnych.
Poniższy obraz przedstawia mapę termiczną US_AQI
z powiększeniem 2,
wraz ze współrzędnymi każdego kafelka:
Zobacz współrzędne mapy i fragmenty mapy aby dowiedzieć się więcej.
Punkt końcowy mapy termicznej
Kafelek mapy termicznej jest reprezentowany przez tablicę bajtów z danymi kafelka w postaci pliku PNG
. Wysyłasz prośbę o obecne kafelki mapy termicznej jakości powietrza za pomocą
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. Zobacz dozwolone .Z
– poziom powiększenia, który określa, jak duża lub mała jest zawartość mapy pojawią się w widoku mapy. Dozwolone są wartości z zakresu 0–16, gdzie 0 jest wyświetlane cały świat w jednym kafelku.X
,Y
– współrzędne kafelka do pobrania względem północy. zachodni róg (0,0). Wartości parametruX
rosną z zachodu na wschód i zY
wartości 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 poprosisz o wyświetlenie kafelka na stronie współrzędne 10,10, interfejs API zwraca błąd.
YOUR_API_KEY
– klucz interfejsu API Twojej aplikacji. Ten klucz identyfikuje do zarządzania limitami. Więcej informacji znajdziesz w sekcji klucz.
Przykładowe żądanie mapy termicznej
Na powyższej ilustracji widać mapę termiczną US_AQI
z powiększeniem 2,
wraz ze współrzędnymi każdego kafelka. W poniższym przykładzie użyto parametru
heatmapTiles
, aby zażądać kafelka o współrzędnych 0,1 z
mapa termiczna:
https://airquality.googleapis.com/v1/mapTypes/US_AQI/heatmapTiles/2/0/1?key=YOUR_API_KEY
Kafelek wygląda tak:
Więcej informacji na temat nakładania kafelków na domyślną mapę znajdziesz w artykule Typy nakładanych map.