En este documento, analizarás cómo 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 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 adaptarse a varias experiencias de búsqueda, como cuando los usuarios buscan un lugar para visitar. La API de Air Quality ofrece lo siguiente:
- Datos**en tiempo real** * y **históricos** : Datos actualizados y precisos que representan el estado actual, así como datos anteriores dentro de un período de 30 días con una resolución por hora (* una instantánea por hora de la calidad del aire exterior)
- Datos globales y locales : Abarcan áreas completas en más de 100 países, pero están altamente localizados (hasta 500 m). 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 muy diferente incluso en ubicaciones cercanas.
Explicación de ejemplo
Muestra los datos de la calidad del aire al principio de la experiencia
Existen dos formas principales de mostrar los datos de la API de Air Quality:
Condiciones actuales o por hora: Obtén valores individuales para mostrar en cada ubicación.
(ve a la sección: Muestra los datos de la API de 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 tu mapa. Los índices de capas específicas de cada país están disponibles.
(ve a la sección: Muestra la capa de mapa de calor 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 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 por la cual un país determinado, por ejemplo, la EPA de EE.UU., categoriza 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 principal y el código de color de la API de Air Quality directamente desde la experiencia de búsqueda de lugares.
La visualización predeterminada podría incluir solo el código de color.
Muestra más información de la API de Air Quality cuando se selecciona un pin:
- Significado del ICA universal o local
- Niveles de contaminantes, que son una medida de partículas y gases en el aire: Contaminante dominante, concentración, fuentes y efectos.
- Recomendaciones de salud, que son acciones recomendadas para 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 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": …
}
}
- Como alternativa, puedes consultar los datos de la 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, es decir, si buscas parques en tu área, solo se mostrarán los parques con buena calidad del aire.
Respuesta de 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)
Muestra la capa de mapa de calor de la API de Air Quality en un mapa
Los mosaicos de mapas de calor de colores son una excelente manera de hacer lo siguiente:
- Proporcionar una descripción general de un área grande
- Mostrar rápidamente los matices dentro de esa área
Usa la API de Maps JavaScript con ImateMapType para mostrar los mosaicos individuales necesarios para cubrir toda la ventana gráfica de tu mapa de Google. Los mosaicos de mapas de calor se actualizarán a medida que el usuario interactúe con el mapa desplazándose, aplicando zoom o cambiando de ubicación.
Ten en cuenta que el valor del nivel de zoom permitido es de hasta 16.
Es posible que la capa de mosaicos de mapas de calor de la API de Air Quality desaparezca en la 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 color:
- Escala de gradiente UAQI (0-100):
Mala / 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 UAQI (0-100):
Mala / Excelente
Cantidad de consultas y costo asociado
- API de Maps JavaScript: 1 mapa en la carga de la experiencia
- API de Air Quality:
- 1 consulta por lugar (todo en la carga del mapa o solo en la selección del usuario)
- Capa de mosaicos de mapas de calor: Cada imagen de mosaico es de 256 x 256 px y, para cubrir un mapa estándar presentado en un dispositivo móvil o en la Web, necesitas de 12 a 14 mosaicos. Cada mosaico extraído se cuenta como 1 unidad de SKU.
- API de Nearby Search (nueva): 1 consulta por cada 20 lugares mostrados Facturación diferente según los datos de Places que forman parte de la respuesta de la consulta
Conclusión
Mostramos 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, con cuidado de la cantidad de información que se muestra a la vez y cómo se hace visible.
Próximas acciones
Lecturas adicionales sugeridas:
- Mejora el descubrimiento local con la API de Nearby Search (nueva)
- Consulta tus datos en tiempo real con el diseño basado en datos
Colaboradores
Google mantiene este artículo. Los siguientes colaboradores lo escribieron originalmente.
Autor principal:
Thomas Anglaret | Ingeniero de soluciones