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 ser mostrados 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 com base em uma coleção de blocos, cada um com coordenadas (X,Y) atribuídas. 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 exponencial das coordenadas X e Y pelo nível de zoom.

gridSizeX = XzoomLevel
gridSizeY = YzoomLevel

Por exemplo, no nível de zoom 2, o mapa-múndi é representado usando uma matriz de 4 x 4, totalizando 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 de US_AQI com um nível de zoom de 2, além das coordenadas de cada bloco:

Um mapa de calor do mundo inteiro como uma grade de 4 por 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 os blocos do 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 em uma solicitação:

  • TYPE: o tipo de mapa de calor a ser retornado. Consulte allowed values.

  • Z: nível de zoom que determina o tamanho do conteúdo de um mapa em uma visualização. 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 a ser recuperado, relativas ao canto noroeste (0,0). Os valores de X aumentam de oeste para leste, e os valores de Y aumentam de norte para sul.

    As coordenadas de 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 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 assim:

Um bloco de mapa de calor nas coordenadas 0,1.

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