Punkt końcowy heatmapTiles zapewnia mapy termiczne związane z pyłkami za pomocą nakładki z kafelkami. Nakładka z kafelkami to zbiór obrazów, które można wyświetlać na Mapach Google. Każdy kafelek obrazu ma wymiary 256 x 256 pikseli.
Nakładka z kafelkami to siatka złożona z kafelków, z których każdy ma przypisane współrzędne (X
,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.
Poniższy obraz przedstawia mapę termiczną TREE_UPI
całego świata podzieloną na fragmenty, które są dostępne przy powiększeniu 2.
Więcej informacji znajdziesz w sekcji Współrzędne mapy i kafelka.
Możesz zażądać bieżących fragmentów mapy termicznej pyłków za pomocą punktu końcowego mapa termiczna, wysyłając żądanie HTTP GET do:
https://pollen.googleapis.com/v1/mapTypes/TYPE/heatmapTiles/Z/X/Y?key=YOUR_API_KEY
Informacje o punkcie końcowym mapy termicznej
Do zrealizowania żądania wymagane są wszystkie parametry wymienione poniżej:
KEY
: klucz interfejsu API Twojej aplikacji. Identyfikuje on aplikację na potrzeby zarządzania limitami. Dowiedz się, jak uzyskać klucz.TYPE
: typ mapy termicznej do zwrócenia. 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 są przesunięte względem północno-wschodniego narożnika (0,0).X
wartości rosną z zachodu na wschód, a wartościY
– z północy na południe. Współrzędne 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.
Przykładowe żądanie mapy termicznej
Powyższy obraz przedstawia mapę termiczną TREE_UPI
z poziomem powiększenia 2 i współrzędne każdego kafelka. Ten przykład używa punktu końcowego heatmapTiles
do żądania kafelka w miejscach o współrzędnych (2,1):
https://pollen.googleapis.com/v1/mapTypes/TREE_UPI/heatmapTiles/2/2/1?key=YOUR_API_KEY
Kafelek jest widoczny jako obraz, który można nałożyć na mapę:
Więcej informacji o nakładaniu kafelków na domyślną mapę znajdziesz w artykule Typy nakładek map.