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 las tarjetas de mapas de calor
La superposición de mosaicos es una cuadrícula ensamblada a partir de una colección de mosaicos, cada una de las coordenadas asignadas (X
,Y
).
El mosaico con coordenadas (0,0) siempre está en la esquina noroeste del mapa. Los valores X
aumentan de oeste a este, mientras que los valores de Y
aumentan de norte a sur.
El elemento zoom level
determina el tamaño y el tamaño del contenido de un mapa que se muestra en la vista de mapa. El tamaño de la cuadrícula de mosaicos se determina escalando las coordenadas X
y Y
de forma exponencial en función del nivel de zoom.
gridSizeX = XzoomLevel gridSizeY = YzoomLevel
Por ejemplo, con un nivel de zoom de 2, el mapa del mundo se representa mediante una matriz de 4 x 4 para 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:
Para obtener más información, consulta Coordenadas de mapas y de mosaicos.
Acerca del extremo del mapa de calor
Un mosaico de mapa de calor se representa con un array de bytes que contiene los datos del mosaico como una imagen PNG. Para solicitar mosaicos de mapas de calor de calidad del aire actuales usando el extremo heatmapTiles
, envía una solicitud GET 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 el tamaño del contenido de un mapa en la vista de mapa. Los valores permitidos son de 0 a 16; el valor 0 muestra todo el mundo en una sola tarjeta.X
,Y
: Coordenadas de la tarjeta que se recuperarán, en relación con la esquina noroeste (0,0). Los valores deX
aumentan de oeste a este, y los valores deY
aumentan 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 coordenadas 10,10, la API mostrará un error.
YOUR_API_KEY
: Es la clave de API de tu aplicación. Esa clave identifica tu aplicación a los fines de la administración de la cuota. Si deseas 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
El mosaico se ve de la siguiente manera:
Si deseas obtener más información sobre cómo superponer mosaicos en el mapa predeterminado, consulta Cómo superponer tipos de mapas.