En este documento, aprenderás a usar la API de Air Quality para crear experiencias enriquecidas de búsqueda de lugares. Mostraremos cómo la calidad del aire puede ser un indicador de valor para los usuarios desde el inicio hasta el final del embudo y cómo se pueden incorporar los datos de la API de Air Quality en las experiencias existentes.
Casos de uso y valor agregado
Los indicadores de la API de Air Quality pueden ajustarse a varias experiencias de búsqueda, como cuando los usuarios buscan una ubicación para visitar. La API de Air Quality ofrece lo siguiente:
- En tiempo real * y datos históricos: Son datos actualizados y precisos que representan el estado actual, así como datos retrospectivos en un período de 30 días en una resolución por hora. (* un resumen por hora de la calidad del aire exterior)
- Datos globales y locales: que abarcan áreas enteras en más de 100 países, pero están altamente localizadas (hasta 500 millones), los datos de la API de Air Quality proporcionan indicadores clave para que los usuarios comparen y tomen decisiones sobre el lugar más adecuado.
La calidad del aire puede ser drásticamente diferente, incluso en ubicaciones cercanas
Explicación de ejemplo
Mostrar datos de calidad del aire al principio de la experiencia
Hay dos formas principales de mostrar los datos de la API de Air Quality:
Condiciones actuales / por hora: Permite obtener valores individuales para mostrar en cada ubicación.
(Ir a la sección Datos de la API de Display Air Quality en los pines de ubicación)Mosaicos de mapas de calor: Superpón una capa de color que represente las condiciones actuales de la calidad del aire exterior sobre el mapa. Los índices de capas específicos de cada país están disponibles.
(Ir a la sección Capa del mapa de calor de la API de Display Air Quality en un mapa)
Muestra los datos de la API de Air Quality en los pines de ubicación
- Elige tu índice de ubicación: ICA universal o ICA local (hay hasta 70 índices de calidad del aire (ICA) diferentes disponibles. Un índice de calidad del aire (ICA) es la escala en la que un país determinado, por ejemplo, la EPA de EE.UU., clasifica los diferentes niveles de calidad del aire según diferentes métodos de cálculo, fuentes de datos y propósitos designados.
- Comienza a visualizar el valor y el código de color de la API principal de Air Quality directamente desde la experiencia de búsqueda de lugares.
la pantalla predeterminada puede incluir solo el código de color.
Muestra más información de la API de Air Quality en la selección de pines:
- Significado de ICA universal / ICA local.
- Niveles de contaminantes, que miden las partículas y los gases del aire: contaminante dominante, concentración, fuentes y efectos.
- Recomendaciones de salud, que son acciones recomendadas para las condiciones actuales de calidad del aire.
- Puedes ajustar el nivel de información que se muestra de forma predeterminada para satisfacer tus necesidades. Ten en cuenta que los puntos de datos de una ubicación a menudo son útiles en comparación con otras ubicaciones.
Ejemplo de visualización de la sección de calidad del aire
{
"dateTime": "2023-08-09T10:00:00Z",
"regionCode": "fr",
"indexes": [
{
"code": "uaqi",
"displayName": "Universal AQI",
"aqi": 76,
"aqiDisplay": "76",
"color": {
"red": 0.4117647,
"green": 0.77254903,
"blue": 0.20392157
},
"category": "Good air quality",
"dominantPollutant": "pm10"
},
…
],
"pollutants": [
{
"code": "co",
"displayName": "CO",
"fullName": "Carbon monoxide",
"concentration": {
"value": 95.18,
"units": "PARTS_PER_BILLION"
}...
},
…
],
"healthRecommendations": -{
"generalPopulation": "With this level of air quality, you have no limitations. Enjoy the outdoors!",
"elderly": "If you start to feel respiratory discomfort such as coughing or breathing difficulties, consider red ...",
"lungDiseasePopulation": …
}
}
- De forma alternativa, puedes consultar los datos de la calidad del aire solo al interactuar con una ubicación.
- Puedes utilizar el índice de la API de Air Quality para filtrar lugares cercanos, por ejemplo, si buscas parques en tu área, solo se mostrarán los parques con buena calidad del aire.
Respuesta sobre la calidad del aire
...
"color":{
"red": 0.9490196,
"green": 0.98039216,
"blue": 0.019607844
}
...
Convertir a RGB
var red = parseInt(colorResponse.red*255)|| 1; var green = parseInt(colorResponse.green*255)|| 1; var blue = parseInt(colorResponse.blue*255)|| 1; // --> output rgb(241,250,5)
Muestra la capa del mapa de calor de la API de Air Quality en un mapa
Los mosaicos de colores de mapas de calor son una excelente manera de lo siguiente:
- para ofrecer una visión general del área amplia.
- para mostrar rápidamente los matices dentro de esa área.
Usa la API de Maps JavaScript con el ImateMapType para mostrar los mosaicos individuales necesarios para abarcar todo el viewport de tu mapa de Google. Los mosaicos de mapas de calor se actualizarán a medida que los usuarios interactúen con el mapa, ya que se desplazan lateralmente por él, hacen zoom o cambian la ubicación.
Ten en cuenta que el valor permitido del nivel de zoom es de hasta 16.
La capa del mosaico del mapa de calor de la API de Air Quality puede desaparecer durante la búsqueda hiperlocal.
Puedes seleccionar Tipos de mapas de calor en un conjunto limitado de índices de calidad del aire:
Asegúrate de indicar la escala de colores para que los usuarios entiendan el valor y su clasificación de colores:
- UAQI con escala de gradientes (0-100):
Deficiente / Excelente
Fragmento de código CSS de la paleta de colores:
.gradient-scale {
background: linear-gradient(to right,
rgb(99, 20, 161) 0%, /* purple */
rgb(149, 0, 25) 20%, /* red */
rgb(248, 47, 21) 40%, /* orange */
rgb(255, 248, 35) 60%, /* yellow */
rgb(34,163,120) 80%, /* steelblue */
rgb(255,255,255) 100% /* white */
);
}
- colores sólidos para representar puntos clave en la escala UAQI (0-100):
Deficiente / Excelente
Recuento de consultas y costo asociado
- API de Maps JavaScript: 1 mapa cuando se carga la experiencia.
- API de Air Quality:
- 1 consulta por cada lugar (todos en la carga del mapa o solo según la selección del usuario)
- Capa de mosaicos de mapa de calor: cada imagen de mosaico es de 256*256 px y, para cubrir un mapa estándar que se presenta en un dispositivo móvil o en la Web, se necesitan entre 12 y 14 mosaicos. Cada tarjeta que se extrae se cuenta como 1 unidad de SKU.
- API de Nearby Search (nuevo): Se muestra 1 búsqueda cada 20 lugares. Facturación diferente según los datos de Place que forman parte de la respuesta de la consulta.
Conclusión
Demostramos que la API de Air Quality puede ser un dato importante para que los usuarios decidan qué lugar visitar. Por lo tanto, los datos de la calidad del aire deben ser visibles lo antes posible en la experiencia de búsqueda, teniendo en cuenta la cantidad de información que se muestra al mismo tiempo y cómo se hace visible.
Acciones siguientes
Lecturas adicionales sugeridas:
- Cómo mejorar el descubrimiento local con la API de Nearby Search (nuevo)
- Consulta tus datos en tiempo real con el diseño basado en datos
Colaboradores
Google conserva este artículo. Los siguientes colaboradores la escribieron originalmente.
Autor principal:
Thomas Anglaret | Ingeniero de soluciones