Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
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 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:
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:
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Não contém as informações de que eu preciso","missingTheInformationINeed","thumb-down"],["Muito complicado / etapas demais","tooComplicatedTooManySteps","thumb-down"],["Desatualizado","outOfDate","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Problema com as amostras / o código","samplesCodeIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2025-08-31 UTC."],[[["\u003cp\u003eThe \u003ccode\u003eheatmapTiles\u003c/code\u003e endpoint delivers air quality heatmaps as a tile overlay, which is a collection of PNG images displayed on top of a Google Map.\u003c/p\u003e\n"],["\u003cp\u003eEach tile within the overlay has specific (X, Y) coordinates, with (0,0) at the northwest corner and increasing values eastward (X) and southward (Y), determined by the zoom level.\u003c/p\u003e\n"],["\u003cp\u003eThe zoom level (0-16) controls the map's scale and the tile grid size, with higher zoom levels showing more detailed areas.\u003c/p\u003e\n"],["\u003cp\u003eTo request a heatmap tile, you need to provide the heatmap type, zoom level (Z), tile coordinates (X, Y), and your API key in the request URL.\u003c/p\u003e\n"],["\u003cp\u003eYou can overlay these heatmap tiles on top of the default map using methods described in the provided documentation for a comprehensive air quality visualization.\u003c/p\u003e\n"]]],[],null,["The\n[`heatmapTiles`](/maps/documentation/air-quality/reference/rest/v1/mapTypes.heatmapTiles/lookupHeatmapTile)\nendpoint provides air quality related heatmaps through a tile overlay. A tile\noverlay is a collection of PNG image tiles that can be displayed on top of a\nGoogle Maps. Each image tile is (256 x 256 pixels).\n\nAbout heatmap tiles\n\nThe tile overlay is a grid assembled from a collection of tiles,\neach assigned (`X`,`Y`) coordinates.\nThe tile with coordinates (0,0) is always at the northwest corner\nof the map. The `X` values increase from west to east,\nwhile the `Y` values increase from north to south.\n\nThe `zoom level` determines how large or small the contents of a map appear in a\nmap view. The tile grid size is determined by scaling the `X` and `Y`\ncoordinates exponentially by the zoom level. \n\n```text\ngridSizeX = XzoomLevel\ngridSizeY = YzoomLevel\n```\n\nFor example, at a zoom level of 2, the world map is represented using a 4 x 4\nmatrix, for a total of 16 tiles. The zoom also determines what is the max value\nallowed for the coordinates.\n\nThe following image shows a `US_AQI` heatmap with a zoom level of 2,\nalong with the coordinates of each tile:\n\nSee [Map and Tile coordinates](/maps/documentation/javascript/coordinates)\nfor additional details.\n\nAbout the heatmap endpoint\n\nA heatmap tile is represented by a bytes array containing the tile data as a PNG\nimage. You request current air quality heatmap tiles using the\n[`heatmapTiles`](/maps/documentation/air-quality/reference/rest/v1/mapTypes.heatmapTiles/lookupHeatmapTile)\nendpoint by sending an HTTP GET request to: \n\n```html\nhttps://airquality.googleapis.com/v1/mapTypes/TYPE/heatmapTiles/Z/X/Y?key=YOUR_API_KEY\n```\n\nAll request parameters are required in a request:\n\n- `TYPE` - The type heatmap to return. See [allowed\n values](/maps/documentation/air-quality/reference/rest/v1/mapTypes.heatmapTiles/lookupHeatmapTile#maptype).\n\n- `Z` - Zoom level that determines how large or small the contents of a map\n appear in a map view. Allowed values are 0-16, where a value of 0 displays\n the entire world in a single tile.\n\n- `X`,`Y` - The coordinates of the tile to retrieve, relative to the north\n west corner (0,0). `X` values are increasing from west to east and `Y`\n values are increasing from north to south.\n\n Tile coordinates have to be valid for the specified zoom level.\n For example, if you set the zoom level to 2, and request a tile at\n coordinates of 10,10, the API returns an error.\n- `YOUR_API_KEY` - Your application's API key. This key identifies your\n application for purposes of quota management. For more information, see [get\n a key](/maps/documentation/air-quality/get-api-key).\n\nExample heatmap request\n\nThe image above shows a `US_AQI` heatmap with a zoom level of 2,\nalong with the coordinates of each tile. The following example uses the\n`heatmapTiles` endpoint to request the tile at coordinates 0,1 from the\nheatmap: \n\n```html\nhttps://airquality.googleapis.com/v1/mapTypes/US_AQI/heatmapTiles/2/0/1?key=YOUR_API_KEY\n```\n\nThe tile appears as:\n\nFor more information on overlaying tiles on top of the default map, see\n[Overlay Map Types](/maps/documentation/javascript/examples/maptype-overlay)."]]
