Mapas de calor

O endpoint heatmapTiles oferece mapas de calor relacionados à qualidade do ar usando uma sobreposição de blocos. Uma sobreposição de blocos é uma coleção de blocos de imagens PNG que podem ser exibidos sobre um mapa do Google. Cada bloco de imagem tem 256 x 256 pixels.

Sobre os blocos de mapa de calor

A sobreposição de blocos é uma grade montada a partir de uma coleção de blocos, cada uma atribuída 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 4 x 4, para um total de 16 blocos. O zoom também determina qual é o valor máximo permitido para as coordenadas.

A imagem a seguir mostra um mapa de calor US_AQI com um nível de zoom de 2, junto com as coordenadas de cada bloco:

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

Consulte Coordenadas de mapa e bloco para mais detalhes.

Sobre o endpoint do mapa de calor

Um bloco de mapa de calor é representado por uma matriz de bytes que contém os dados do bloco como uma imagem PNG. Você solicita blocos de mapa de calor da qualidade do ar atual usando o endpoint heatmapTiles enviando uma solicitação HTTP GET para:

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

Todos os parâmetros de solicitação são obrigatórios:

  • 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 do mapa. 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 a ser recuperado, em relação ao canto noroeste (0,0). Os valores de X aumentam de oeste para leste, e os de Y aumentam de norte para sul.

    As coordenadas do bloco 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.

  • YOUR_API_KEY: a chave de API do seu aplicativo. Essa chave identifica seu aplicativo para fins de gerenciamento de cota. Para mais informações, consulte receber uma chave.

Exemplo de solicitação de mapa de calor

A imagem acima mostra um mapa de calor US_AQI com um nível de zoom de 2, junto com as coordenadas de cada bloco. O exemplo a seguir usa o endpoint heatmapTiles para solicitar o Bloco nas coordenadas 0,1 do mapa de calor:

https://airquality.googleapis.com/v1/mapTypes/US_AQI/heatmapTiles/2/0/1?key=YOUR_API_KEY

O bloco aparece como:

Bloco de mapa de calor nas coordenadas 0,1.

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