O endpoint heatmapTiles mostra mapas de calor relacionados ao pólen por meio da sobreposição de blocos. Uma sobreposição de blocos é uma coleção de blocos de imagem que podem ser exibidos na parte de cima do Google Maps. Cada bloco de imagem tem 256 x 256 pixels.
A sobreposição de blocos é uma grade montada com base em uma coleção de blocos, cada uma com coordenadas
(X
,Y
). O bloco com as coordenadas (0,0) está sempre no canto noroeste do mapa. Os valores X
aumentam de oeste para leste, enquanto os valores Y
aumentam de norte para sul.
O zoom level
determina se o conteúdo de um mapa aparece em uma visualização de mapa. O tamanho da grade de blocos é determinado dimensionando as coordenadas X
e Y
exponencialmente pelo nível de zoom.
gridSizeX = XzoomLevel gridSizeY = YzoomLevel
Por exemplo, com um nível de zoom de 2, o mapa-múndi é representado por uma matriz 4 x 4, totalizando 16 blocos.
A imagem a seguir mostra um mapa de calor de TREE_UPI
do mundo inteiro, dividido em blocos que podem ser acessados com um nível de zoom de 2.
Consulte Coordenadas de mapa e bloco para mais detalhes.
É possível solicitar blocos de mapa de calor de pólen atuais usando o endpoint heatmapTiles enviando uma solicitação HTTP GET para:
https://pollen.googleapis.com/v1/mapTypes/TYPE/heatmapTiles/Z/X/Y?key=YOUR_API_KEY
Sobre o endpoint do mapa de calor
Todos os parâmetros listados abaixo são necessários para uma solicitação bem-sucedida:
KEY
: chave de API do aplicativo. Ela identifica o aplicativo para fins de gerenciamento de cotas. Saiba como gerar uma chave.TYPE
: o tipo de mapa de calor a ser retornado. Veja os valores permitidos.Z
: nível de zoom que determina se o conteúdo de um mapa aparece em uma visualização de mapa. Os valores permitidos são de 0 a 16, em que o valor 0 mostra o mundo inteiro em um único bloco.X
,Y
: as coordenadas do bloco em relação ao canto nordeste (0,0). Os valores deX
aumentam de oeste para leste, e os valores deY
aumentam de norte para sul. As coordenadas precisam ser válidas para o nível de zoom especificado. Por exemplo, se você definir o nível de zoom como 2 e solicitar um bloco nas coordenadas (10,10), a API retornará um erro.
Exemplo de solicitação de mapa de calor
A imagem acima mostra um mapa de calor TREE_UPI
com nível de zoom de 2 e as coordenadas de cada bloco. O exemplo a seguir usa o endpoint heatmapTiles
para solicitar o bloco nas coordenadas (2,1):
https://pollen.googleapis.com/v1/mapTypes/TREE_UPI/heatmapTiles/2/2/1?key=YOUR_API_KEY
O bloco aparece como uma imagem que pode ser sobreposta em um mapa:
Para saber mais sobre a sobreposição de blocos sobre o mapa padrão, consulte Tipos de mapa de sobreposição.