Dans ce document, vous allez découvrir comment utiliser l'API Air Quality pour créer des expériences de recherche de lieux enrichies. Nous allons vous montrer comment la qualité de l'air peut être un signal de valeur pour les utilisateurs du début à la fin de l'entonnoir, et comment les données de l'API Air Quality peuvent être intégrées aux expériences existantes.
Cas d'utilisation et valeur ajoutée
Les signaux de l'API Air Quality peuvent s'adapter à diverses expériences de recherche, par exemple lorsque les utilisateurs recherchent un lieu à visiter. L'API Air Quality propose:
- Données en temps réel * et historiques : données récentes et précises qui représentent l'état actuel, ainsi que des données historiques sur une période de 30 jours avec une résolution horaire. (* Instantané horaire de la qualité de l'air extérieur)
- Données globales et locales : les données de l'API Air Quality couvrent des zones entières dans plus de 100 pays, mais sont très localisées (jusqu'à 500 m). Elles fournissent des signaux clés aux utilisateurs pour comparer et choisir l'endroit le plus approprié.
La qualité de l'air peut varier considérablement, même pour des lieux proches.
Exemple de tutoriel
Afficher les données sur la qualité de l'air au début de l'expérience
Il existe deux principales façons d'afficher les données de l'API Air Quality:
Conditions actuelles / par heure: obtenez des valeurs individuelles à afficher pour chaque zone géographique.
(consultez la section Afficher les données de l'API Air Quality sur les repères géographiques)Tuiles de carte de densité: superposez une couche colorée représentant les conditions actuelles de qualité de l'air extérieur sur votre carte. Des index de calques spécifiques par pays sont disponibles.
(consultez la section Afficher la couche de carte thermique de l'API Air Quality sur une carte)
Afficher les données de l'API Air Quality sur les repères géographiques
- Choisissez l'indice de votre zone géographique: IQA universel ou IQA local (jusqu'à 70 indices de la qualité de l'air (IQA) différents sont disponibles). L'indice de la qualité de l'air (IQA) est l'échelle utilisée par un pays donné, par exemple l'EPA des États-Unis, pour classer les différents niveaux de qualité de l'air en fonction de différentes méthodes de calcul, de sources de données et d'objectifs désignés.
- Commencez à visualiser la valeur principale de l'API Air Quality et le code couleur directement depuis l'expérience de recherche de lieux.
L'affichage par défaut peut inclure uniquement le code de couleur.
Affichez plus d'informations sur l'API Air Quality lors de la sélection d'un repère:
- Signification de l'IQA universel / local
- Niveaux de polluants, qui mesurent les particules et les gaz dans l'air: polluant dominant, concentration, sources et effets.
- Recommandations de santé : actions recommandées en fonction de la qualité de l'air actuelle.
- Vous pouvez ajuster le niveau d'informations affiché par défaut en fonction de vos besoins. N'oubliez pas que les points de données d'un emplacement sont souvent utiles par rapport à d'autres emplacements.
Exemple d'affichage de la section sur la qualité de l'air
{
"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": …
}
}
- Vous pouvez également interroger les données sur la qualité de l'air uniquement en cas d'interaction avec un lieu.
- Vous pouvez utiliser l'indice de l'API Air Quality pour filtrer les lieux à proximité. Par exemple, si vous recherchez des parcs dans votre région, vous n'afficherez que les parcs dont la qualité de l'air est bonne.
Réponse sur la qualité de l'air
... "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)
Afficher le calque de carte de densité de l'API Air Quality sur une carte
Les cartes de densité colorées sont un excellent moyen de:
- pour fournir un aperçu d'une grande zone.
- pour afficher rapidement les nuances dans cette zone.
Utilisez l'API Maps JavaScript avec ImateMapType pour afficher les tuiles individuelles nécessaires pour couvrir l'intégralité du viewport de votre carte Google. Les cartes de densité s'actualisent lorsque l'utilisateur interagit avec la carte en effectuant un panoramique, un zoom ou un changement de position.
N'oubliez pas que la valeur du niveau de zoom est limitée à 16.
La carte de chaleur de l'API Air Quality peut disparaître lors d'une recherche hyperlocale.
Vous pouvez sélectionner des types de cartes de densité parmi un nombre limité d'indices de qualité de l'air:
Assurez-vous d'indiquer l'échelle de couleurs pour que les utilisateurs puissent comprendre la valeur et son classement par couleur:
- Échelle de dégradé de l'IQA de l'UA (0-100) : mauvais / excellent
Extrait de code CSS de la palette de couleurs:
.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 */ ); }
- des couleurs unies pour représenter les points clés de l'échelle UAQI (0-100) : mauvais / excellent
Nombre de requêtes et coût associé
- API Maps JavaScript: une carte lors du chargement de l'expérience.
- API Air Quality :
- Une requête par lieu (toutes à la fois lors du chargement de la carte ou uniquement lors de la sélection par l'utilisateur).
- Calque de tuiles de carte de densité: chaque image de tuile mesure 256 x 256 pixels. Pour couvrir une carte standard présentée sur un appareil mobile ou sur le Web, vous avez besoin de 12 à 14 tuiles. Chaque tuile extraite est comptabilisée comme une unité de SKU.
- API Nearby Search (nouvelle version): une requête pour 20 lieux affichés. Facturation différente en fonction des données de lieu qui font partie de la réponse à la requête.
Conclusion
Nous avons montré que l'API Air Quality peut être un point de données important pour les utilisateurs lorsqu'ils décident d'un lieu à visiter. Par conséquent, les données sur la qualité de l'air doivent être visibles le plus tôt possible dans l'expérience de recherche, en veillant à la quantité d'informations affichées en même temps et à la façon dont elles sont rendues visibles.
Étapes suivantes
Autres ressources suggérées:
- Améliorer la découverte locale avec l'API Nearby Search (nouvelle version)
- Afficher vos données en temps réel avec les styles basés sur les données
Contributeurs
Cet article est géré par Google. Les contributeurs suivants l'ont initialement rédigé.
Auteur principal:
Thomas Anglaret | Ingénieur solutions