Mapas de calor

El extremo heatmapTiles proporciona mapas de calor relacionados con la calidad del aire a través de una superposición de mosaicos. Una superposición de mosaicos es una colección de mosaicos de imágenes PNG que se pueden mostrar sobre un mapa de Google Maps. Cada mosaico de imagen es de 256 x 256 píxeles.

Acerca de las tarjetas de mapa de calor

La superposición de mosaicos es una cuadrícula ensamblada a partir de una colección de mosaicos, a cada uno de los cuales se le asignan coordenadas (X,Y). El mosaico con coordenadas (0,0) siempre se encuentra en la esquina noroeste del mapa. Los valores de X aumentan de oeste a este, mientras que los valores de Y aumentan de norte a sur.

El zoom level determina qué tan grande o pequeño aparece el contenido de un mapa en una vista del mapa. El tamaño de la cuadrícula de mosaicos se determina escalando las coordenadas X y Y de forma exponencial según el nivel de zoom.

gridSizeX = XzoomLevel
gridSizeY = YzoomLevel

Por ejemplo, en un nivel de zoom de 2, el mapa mundial se representa con una matriz de 4 x 4, lo que da un total de 16 mosaicos. El zoom también determina cuál es el valor máximo permitido para las coordenadas.

En la siguiente imagen, se muestra un mapa de calor de US_AQI con un nivel de zoom de 2, junto con las coordenadas de cada segmento:

Un mapa de calor de todo el mundo como una cuadrícula de 4 x 4.

Consulta Coordenadas de mapas y de mosaicos para obtener más detalles.

Acerca del extremo del mapa de calor

Una segmentación del mapa de calor se representa con un array de bytes que contiene los datos de la segmentación como una imagen PNG. Para solicitar las tarjetas del mapa de calor de la calidad del aire actual, envía una solicitud GET de HTTP al extremo heatmapTiles:

https://airquality.googleapis.com/v1/mapTypes/TYPE/heatmapTiles/Z/X/Y?key=YOUR_API_KEY

Todos los parámetros de la solicitud son obligatorios:

  • TYPE: Es el tipo de mapa de calor que se mostrará. Consulta los valores permitidos.

  • Z: Es el nivel de zoom que determina qué tan grande o pequeño aparece el contenido de un mapa en una vista del mapa. Los valores permitidos son del 0 al 16, donde el valor 0 muestra el mundo entero en un solo mosaico.

  • X,Y: Son las coordenadas de la segmentación que se recuperará, relativas a la esquina noroeste (0,0). Los valores de X aumentan de oeste a este, y los de Y, de norte a sur.

    Las coordenadas de mosaico deben ser válidas para el nivel de zoom especificado. Por ejemplo, si estableces el nivel de zoom en 2 y solicitas una segmentación en las coordenadas 10,10, la API devolverá un error.

  • YOUR_API_KEY: Es la clave de API de tu aplicación. Esta clave identifica tu aplicación a los efectos de la administración de cuotas. Para obtener más información, consulta cómo obtener una clave.

Ejemplo de solicitud de mapa de calor

La imagen anterior muestra un mapa de calor de US_AQI con un nivel de zoom de 2, junto con las coordenadas de cada segmento. En el siguiente ejemplo, se usa el extremo heatmapTiles para solicitar la segmentación en las coordenadas 0,1 del mapa de calor:

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

El mosaico aparece de la siguiente manera:

Un mosaico de mapa de calor en las coordenadas 0,1.

Para obtener más información sobre cómo superponer mosaicos sobre el mapa predeterminado, consulta Superposición de tipos de mapas.