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 sobre un mapa de Google. Cada mosaico de imagen es de 256 × 256 píxeles.
Información acerca de las tarjetas de mapa de calor
La superposición de mosaicos es una cuadrícula ensamblada a partir de un conjunto de mosaicos, cada uno de los cuales tiene asignadas 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 de 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 del mundo se representa con una matriz de 4 x 4, para 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 tarjeta:
Consulta Coordenadas de mapas y mosaicos para obtener más detalles.
Información acerca del extremo del mapa de calor
Una tarjeta de mapa de calor se representa con un array de bytes que contiene los datos de la tarjeta como una imagen PNG. Para solicitar las tarjetas de mapa de calor de la calidad del aire actual con el extremo heatmapTiles, envía una solicitud GET de HTTP a la siguiente dirección:
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 qué tan grande o pequeño aparece el contenido de un mapa en una vista de mapa. Los valores permitidos son del 0 al 16, en los que un valor de 0 muestra el mundo entero en una sola tarjeta.X,Y: Son las coordenadas de la tarjeta que se recuperará en relación con la esquina noroeste (0,0). Los valores deXaumentan de oeste a este y los deYaumentan de norte a sur.Las coordenadas de mosaicos deben ser válidas para el nivel de zoom especificado. Por ejemplo, si estableces el nivel de zoom en 2 y solicitas una tarjeta en las coordenadas 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 para la administración de cuotas. 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 la tarjeta 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 aparece de la siguiente manera:
Para obtener más información sobre cómo superponer mosaicos sobre el mapa predeterminado, consulta Tipos de mapas superpuestos.