Mapas de calor

O endpoint heatmapTiles fornece 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 aparecer sobre uma mapa do Google Maps. 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 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. O tamanho da grade de blocos é determinado pelo escalonamento das coordenadas X e Y exponencialmente 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 de bloco devem 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 com coordenadas de 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 cotas. Para mais informações, consulte Gerar uma chave.

Exemplo de solicitação de mapa de calor

A imagem acima mostra um mapa de calor de US_AQI com nível de zoom 2 e 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 a sobreposição de blocos na parte de cima do mapa padrão, consulte Tipos de mapa de sobreposição.