Mapy termiczne

Punkt końcowy heatmapTiles udostępnia mapy termiczne dotyczące pyłków za pomocą nakładki na kafelki. Nakładka z kafelkami to zbiór kafelków z obrazami, które można wyświetlać na mapie Google. Każda kafelka obrazu ma rozmiar 256 x 256 pikseli.

Nakładka z kafelkami to siatka utworzona z kolekcji kafelków, z których każdy ma przypisane współrzędne (X,Y). Płytka o współrzędnych (0,0) znajduje się zawsze w północno-zachodnim rogu mapy. Wartości X rosną z zachodu na wschód, a wartości Y rosną z północy na południe.

Wartość zoom level określa, jak duże lub małe są elementy mapy widoczne na mapie. Rozmiar siatki płytek jest określany przez skalowanie współrzędnych X i Y w sposób wykładniczy według poziomu powiększenia.

gridSizeX = XzoomLevel
gridSizeY = YzoomLevel

Na przykład przy poziomie powiększenia 2 mapa świata jest reprezentowana za pomocą macierzy 4 x 4, co daje w sumie 16 płytek.

Na poniższym obrazie widać mapę ciepła TREE_UPI całego świata podzieloną na kafelki, do których można uzyskać dostęp na poziomie powiększenia 2.

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

Więcej informacji znajdziesz w sekcji Współrzędne mapy i płytek.

Aby uzyskać obecne płytki mapy ciepła pyłków, użyj punktu końcowego heatmapTiles, wysyłając żądanie HTTP GET do:

https://pollen.googleapis.com/v1/mapTypes/TYPE/heatmapTiles/Z/X/Y?key=YOUR_API_KEY

Punkt końcowy mapy termicznej

Aby żądanie zostało zrealizowane, wszystkie wymienione poniżej parametry są wymagane:

  • KEY: klucz interfejsu API Twojej aplikacji. Ten klucz identyfikuje Twoją aplikację na potrzeby zarządzania limitem. Dowiedz się, jak uzyskać klucz.
  • TYPE: typ mapy ciepła do zwrócenia. Zobacz dozwolone wartości.
  • Z: poziom powiększenia określający, jak duże lub małe elementy mapy mają się wyświetlać na mapie. Dozwolone wartości to 0–16, przy czym wartość 0 wyświetla cały świat na jednej karcie.
  • X,Y: współrzędne płytki względem narożnika północno-wschodniego (0,0). Wartości X rosną z zachodu na wschód, a wartości Y rosną z północy na południe. Współrzędne muszą być prawidłowe dla wybranego poziomu powiększenia. Jeśli na przykład ustawisz poziom powiększenia na 2 i poprosisz o płytkę o współrzędnych (10,10), interfejs API zwróci błąd.

Przykładowe żądanie mapy termicznej

Obraz powyżej przedstawia mapę termiczną TREE_UPI z poziomem powiększenia 2 oraz współrzędne każdej płytki. W tym przykładzie użyto punktu końcowego heatmapTiles do zażądania płytki o współrzędnych (2,1):

https://pollen.googleapis.com/v1/mapTypes/TREE_UPI/heatmapTiles/2/2/1?key=YOUR_API_KEY

Kafelek jest wyświetlany jako obraz, który można nałożyć na mapę:

Przykład kafelka mapy cieplnej z użyciem mapy TREE_UPI.

Więcej informacji o nakładaniu się płytek na mapie domyślnej znajdziesz w artykule Typy map nakładek.