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 com base em uma coleção de blocos,
a cada coordenadas atribuídas (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 de 2, o mapa-múndi é representado por uma matriz 4 x 4, totalizando 16 blocos. O zoom também determina qual é o valor máximo permitido para as coordenadas.
A imagem abaixo mostra um mapa de calor de US_AQI
com nível de zoom 2 e as coordenadas de cada bloco:
Consulte Coordenadas de mapa e bloco para mais detalhes.
Sobre o endpoint do mapa de calor
Um bloco do mapa de calor é representado por uma matriz de bytes contendo os dados do bloco como uma imagem PNG. Para solicitar os blocos do mapa de calor atuais da qualidade do ar, use 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. Veja os 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 a ser extraída em relação ao canto noroeste (0,0). Os valores deX
estão aumentando de oeste para leste e os valores deY
estão aumentando 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
: chave de API do 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:
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.