Mapy termiczne

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

Nakładka z kafelków to siatka utworzona 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 lewym górnym 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 mają być treści mapy 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 przedstawiana za pomocą macierzy 4 x 4, czyli łącznie 16 kafelków.

Poniższy obraz przedstawia mapę termiczną TREE_UPI całego świata podzieloną na kafelki, do których można uzyskać dostęp przy poziomie powiększenia 2.

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

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

Aktualne kafelki mapy termicznej pyłków możesz pobrać za pomocą punktu końcowego heatmapTiles , wysyłając żądanie GET HTTP na adres:

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

Informacje o punkcie końcowym mapy termicznej

Aby żądanie zostało zrealizowane, musisz podać wszystkie parametry wymienione poniżej:

  • KEY: klucz interfejsu API Twojej aplikacji. Ten klucz identyfikuje Twoją aplikację na potrzeby zarządzania limitem. Dowiedz się, jak uzyskać klucz.
  • TYPE: typ mapy termicznej, którą chcesz zwrócić. Zobacz dozwolone wartości.
  • Z: poziom powiększenia, który określa, jak duże lub małe mają być treści mapy w widoku mapy. Dozwolone wartości to 0–16. Wartość 0 powoduje wyświetlenie całego świata na jednym kafelku.
  • X,Y: współrzędne mapy względem lewego górnego rogu (0,0). Wartości X rosną z zachodu na wschód, a wartości Y – 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ład żądania 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żywamy 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 jest wyświetlany 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 kafelków na mapę domyślną znajdziesz w artykule Nakładanie typów map.