Mapy termiczne

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:

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

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 parametru X rosną z zachodu na wschód i z Y 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:

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

Więcej informacji na temat nakładania kafelków na domyślną mapę znajdziesz w artykule Typy nakładanych map.