Mapas de calor

A heatmapTiles fornece mapas de calor relacionados à qualidade do ar com uma sobreposição de blocos. Um bloco é uma coleção de blocos de imagem PNG que podem ser exibidos sobre uma 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 uma das 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 um visualização de mapa. O tamanho da grade de blocos é determinado pelo dimensionamento de X e Y. coordenadas 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 chave 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 de US_AQI com nível de zoom 2. junto com as coordenadas de cada bloco:

Um mapa de calor do mundo inteiro no formato de grade 4 por 4.

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 um PNG imagem. Você solicita blocos de mapa de calor atuais da qualidade do ar usando o heatmapTiles endpoint 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. Ver permitidos de imagem.

  • Z: nível de zoom que determina o tamanho do conteúdo de um mapa. aparecer em uma visualização de mapa. Os valores permitidos são de 0 a 16, em que um valor de 0 é exibido o mundo inteiro em um único bloco.

  • X,Y: as coordenadas do bloco a ser recuperada em relação ao norte. canto oeste (0,0). Os valores de X estão aumentando de oeste para leste e Y 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 em coordenadas de 10,10, a API retornará um erro.

  • YOUR_API_KEY: chave de API do aplicativo. Essa chave identifica aplicativo para fins de gerenciamento de cotas. Para mais informações, consulte get 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. junto com as coordenadas de cada bloco. O exemplo a seguir usa o endpoint heatmapTiles para solicitar o bloco nas coordenadas 0,1 da mapa de calor:

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

O bloco aparece como:

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

Para mais informações sobre a sobreposição de blocos na parte superior do mapa padrão, consulte Sobrepor tipos de mapa.