Mapas de calor

O endpoint heatmapTiles fornece mapas de calor relacionados ao pólen usando a sobreposição de blocos. Uma sobreposição de blocos é uma coleção de blocos de imagens que pode ser exibida sobre o Google Maps. Cada bloco de imagem tem 256 x 256 pixels.

A sobreposição de blocos é uma grade montada a partir de uma coleção de blocos, cada um atribuído a coordenadas (X,Y). O bloco com as coordenadas (0,0) está sempre no canto noroeste do mapa. Os valores de X aumentam de oeste para leste, enquanto os valores de Y aumentam de norte para sul.

O zoom level determina o tamanho do conteúdo de um mapa em uma visualização de mapa. O tamanho da grade de blocos é determinado pelo escalonamento das coordenadas X e Y de forma exponencial pelo nível de zoom.

gridSizeX = XzoomLevel
gridSizeY = YzoomLevel

Por exemplo, em um nível de zoom 2, o mapa-múndi é representado usando uma matriz de 4 x 4, para um total de 16 blocos.

A imagem a seguir mostra um mapa de calor TREE_UPI de todo o mundo, dividido em blocos que podem ser acessados em um nível de zoom 2.

Um mapa de calor do mundo todo como uma grade de 4 x 4.

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: a chave de API do seu aplicativo. Essa chave identifica seu aplicativo para fins de gerenciamento de cota. Saiba como receber uma chave.
  • TYPE: o tipo de mapa de calor a ser retornado. Consulte valores permitidos.
  • Z: nível de zoom que determina o tamanho do conteúdo de um mapa na visualização. Os valores permitidos são de 0 a 16, em que um valor de 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 de X aumentam de oeste para leste, e os valores de Y 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 vai retornar um erro.

Exemplo de solicitação de mapa de calor

A imagem acima mostra um mapa de calor TREE_UPI com um nível de zoom de 2, além das 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:

Exemplo de bloco de mapa de calor usando o mapa TREE_UPI.

Para mais informações sobre como sobrepor blocos no mapa padrão, consulte Tipos de mapa de sobreposição.