En este documento, aprenderás a usar la API de Air Quality para crear experiencias de búsqueda de lugares enriquecidas. Mostraremos cómo la calidad del aire puede ser un indicador de valor para los usuarios desde el principio hasta el final del embudo y cómo los datos de la API de Air Quality se pueden incorporar en experiencias existentes.
Casos de uso y valor agregado
Los indicadores de la API de Air Quality pueden adaptarse a varias experiencias de búsqueda, como cuando los usuarios buscan una ubicación para visitar. La API de Air Quality ofrece lo siguiente:
- Datos en tiempo real * y datos históricos: datos actualizados y precisos que representan el estado actual, así como datos históricos dentro de un período de 30 días con una resolución por hora. (* Resumen por hora de la calidad del aire exterior)
- Datos globales y locales: Los datos de la API de Air Quality cubren áreas completas en más de 100 países, pero son altamente localizados (hasta 500 m). Proporcionan indicadores clave para que los usuarios comparen y tomen decisiones sobre el lugar más adecuado.
La calidad del aire puede ser muy diferente incluso en ubicaciones cercanas.
Explicación de ejemplo
Muestra datos sobre la calidad del aire al comienzo de la experiencia
Existen dos maneras principales de mostrar los datos de la API de Air Quality:
Condiciones actuales / por hora: Obtén valores individuales para mostrar en cada ubicación.
(ve a la sección Mostrar datos de la API de Air Quality en los pines de ubicación)Mosaicos de mapa de calor: Superponen una capa de color que representa las condiciones actuales de la calidad del aire al aire libre sobre el mapa. Hay índices de capas específicas por país disponibles.
(ve a la sección: Cómo mostrar la capa de mapa térmico de la API de Air Quality en un mapa)
Muestra los datos de la API de Air Quality en los pines de ubicación
- Elige el índice de tu 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 con la que un país determinado, por ejemplo, la Agencia de Protección Ambiental (EPA) de EE.UU., clasifica los diferentes niveles de calidad del aire, según diferentes métodos de cálculo, fuentes de datos y fines designados.
- Comienza a visualizar el valor principal de la API de Air Quality y el código de color directamente desde la experiencia de búsqueda de lugares.
el gráfico predeterminado solo puede incluir el código de color.
Muestra más información de la API de Air Quality cuando se selecciona un pin:
- Significado de ICA universal / ICA local
- Niveles de contaminantes, que son una medida de las partículas y los gases en el aire: contaminante dominante, concentración, fuentes y efectos.
- Recomendaciones relacionadas con la salud, que son acciones recomendadas en función de las condiciones actuales de la 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 datos de una ubicación suelen ser útiles en comparación con otras.
Ejemplo de la 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": …
}
}
- Como alternativa, puedes consultar los datos de calidad del aire solo cuando interactúas con una ubicación.
- Puedes usar el índice de la API de Air Quality para filtrar lugares cercanos, p. ej., si buscas parques en tu área, solo se mostrarán los parques con buena calidad del aire.
Respuesta a la calidad del aire
... "color":{ "red": 0.9490196, "green": 0.98039216, "blue": 0.019607844 } ...
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)
Cómo mostrar la capa del mapa de calor de la API de Air Quality en un mapa
Las tarjetas de colores del mapa de calor son una excelente manera de hacer lo siguiente:
- para proporcionar una descripción general de un área extensa.
- para mostrar rápidamente los matices dentro de esa área.
Usa la API de Maps JavaScript con ImateMapType para mostrar las tarjetas individuales necesarias para cubrir toda la vista del mapa de Google. Las tarjetas del mapa de calor se actualizarán a medida que el usuario interactúe con el mapa desplazando, acercando o cambiando la ubicación.
Ten en cuenta que el valor permitido del nivel de zoom es de hasta 16.
La capa de mosaicos del mapa de calor de la API de Air Quality puede desaparecer en una búsqueda hiperlocal.
Puedes seleccionar Tipos de mapas de calor dentro de un conjunto limitado de índices de calidad del aire:
Asegúrate de indicar la escala de colores para que los usuarios comprendan el valor y su clasificación de colores:
- escala de gradiente UAQI (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 el punto clave en la escala de UAQI (0-100):
Deficiente / Excelente
Cantidad de consultas y costo asociado
- API de Maps JavaScript: 1 mapa cuando se carga la experiencia
- API de Air Quality:
- 1 consulta para cada lugar (todas en la carga del mapa o solo en 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 presentado en un dispositivo móvil o la Web, necesitas entre 12 y 14 mosaicos. Cada tarjeta extraída se cuenta como 1 unidad de SKU.
- API de Nearby Search (nueva): Se muestran 1 consulta 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 dónde visitar. Por lo tanto, los datos de calidad del aire deben ser visibles lo antes posible en la experiencia de búsqueda, con cuidado de la cantidad de información que se muestra a la vez y cómo se hace visible.
Acciones siguientes
Lecturas adicionales sugeridas:
- Mejora el descubrimiento local con la API de Nearby Search (nuevo)
- Cómo ver tus datos en tiempo real con el diseño basado en datos
Colaboradores
Google mantiene este artículo. Los siguientes colaboradores la escribieron originalmente.
Autor principal:
Thomas Anglaret | Ingeniero de soluciones