Mapy termiczne

Punkt końcowy heatmapTiles udostępnia mapy termiczne związane z pyłkami w postaci nakładek na kafelki. Nakładka z fragmentami mapy to zbiór fragmentów obrazów, które można wyświetlać na wierzchu Map Google. Każdy fragment obrazu ma wymiary 256 x 256 pikseli.

Nakładka z kafelkami to siatka złożona z kolekcji kafelków, z których każdy ma przypisane współrzędne (X,Y). Kafelek o współrzędnych (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że lub małe będą treści na mapie 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 poziomie powiększenia 2 mapa świata jest reprezentowana za pomocą macierzy 4 x 4, czyli łącznie 16 kafelków.

Obraz poniżej przedstawia mapę cieplną 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 formie siatki 4 x 4.

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

Możesz poprosić o aktualne kafelki mapy cieplnej z informacjami o pyłkach za pomocą punktu końcowego heatmapTiles przez wysłanie żądania HTTP GET na adres:

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

Informacje o punkcie końcowym mapy termicznej

Wszystkie wymienione poniżej parametry są wymagane do prawidłowego wysłania żądania:

  • KEY: klucz interfejsu API Twojej aplikacji. Ten klucz identyfikuje aplikację na potrzeby zarządzania limitami. Dowiedz się, jak uzyskać klucz.
  • TYPE: typ mapy popularności do zwrócenia. Zobacz dozwolone wartości.
  • Z: poziom powiększenia, który określa, jak duże lub małe będą treści mapy w widoku mapy. Dozwolone wartości to 0–16, przy czym wartość 0 wyświetla cały świat na jednym kafelku.
  • X,Y: współrzędne kafelka względem północno-wschodniego rogu (0,0). X wartości rosną z zachodu na wschód, a Y wartości rosną z północy na południe. Współrzędne muszą być prawidłowe dla określonego poziomu powiększenia. Jeśli na przykład ustawisz poziom powiększenia na 2 i poprosisz o kafelek 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ędnymi każdego kafelka. W tym przykładzie użyto punktu końcowego heatmapTiles, aby poprosić o kafelek o współrzędnych (2,1):

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

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

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

Więcej informacji o nakładaniu fragmentów na domyślną mapę znajdziesz w artykule Typy map nakładanych.