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 un conjunto de mosaicos de imágenes PNG que se pueden mostrar en la parte superior de un mapa de Google Maps. Cada mosaico de imagen es de (256 x 256 píxeles).

Información acerca de los mosaicos de mapas de calor

La superposición de mosaicos es una cuadrícula que se ensambla a partir de una colección de mosaicos, cada una con coordenadas (X y 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 objeto zoom level determina el tamaño del contenido de un mapa en la vista de mapa. Para determinar el tamaño de la cuadrícula de mosaicos, ajusta las coordenadas X y Y de forma exponencial según el nivel de zoom.

gridSizeX = XzoomLevel
gridSizeY = YzoomLevel

Por ejemplo, con un nivel de zoom de 2, el mapa mundial se representa con una matriz de 4 x 4, es decir, un total de 16 mosaicos. El zoom también determina 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 mosaico:

Mapa de calor de todo el mundo en una cuadrícula de 4 por 4

Consulta el artículo Coordenadas de mapas y de mosaicos para obtener más detalles.

Acerca del extremo del mapa de calor

Un mosaico de mapa de calor se representa con un array de bytes que contiene los datos de un mosaico como una imagen PNG. Para solicitar mosaicos de mapas de calor de la calidad del aire actuales con el extremo heatmapTiles, envía una solicitud GET HTTP a lo siguiente:

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

Todos los parámetros de solicitud son obligatorios en una solicitud:

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

  • Z: Es el nivel de zoom que determina el tamaño del contenido de un mapa en la vista de mapa. Los valores permitidos son del 0 al 16, y el valor 0 muestra todo el mundo en una sola tarjeta.

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

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

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

Ejemplo de solicitud de mapa de calor

En la imagen anterior, se muestra un mapa de calor de US_AQI con un nivel de zoom de 2, junto con las coordenadas de cada mosaico. En el siguiente ejemplo, se usa el extremo heatmapTiles para solicitar el mosaico 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

La tarjeta se muestra de la siguiente manera:

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

Para obtener más información sobre la superposición de mosaicos sobre el mapa predeterminado, consulta el artículo Tipos de mapas de superposición.