Évaluer la qualité de l'air pour Places à l'aide de l'API Air Quality

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 verrons 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 intégrer les données de l'API Air Quality dans les 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 offre les avantages suivants:

  • Temps réel * et données historiques : données récentes et précises représentant l'état actuel, ainsi que des données temporelles sur une période de 30 jours, avec une résolution horaire. (* Une photo instantanée de la qualité de l'air extérieur par heure)
  • Données mondiales et locales : couvrent des zones entières de plus de 100 pays, mais sont très localisées (jusqu'à 500 millions). Les données de l'API Air Quality fournissent des signaux clés qui permettent aux utilisateurs de comparer les lieux et de prendre des décisions concernant le lieu le plus approprié.

La qualité de l'air peut être radicalement différente, même à proximité d'un lieu

Exemple de tutoriel

Afficher les données sur la qualité de l'air dès le début de l'expérience

Il existe deux façons principales d'afficher les données de l'API Air Quality:

Afficher les données de l'API Air Quality sur les repères de position

  • Sélectionnez votre index géographique: IQA universel ou local (jusqu'à 70 indices de la qualité de l'air différents sont disponibles). L'indice de la qualité de l'air (IQA) est l'échelle sur laquelle un pays donné, comme l'EPA des États-Unis, classe différents niveaux de qualité de l'air en fonction de méthodes de calcul, de sources de données et d'objectifs spécifiques.
  • Commencez à visualiser la valeur principale et le code couleur de l'API Air Quality directement dans l'interface de recherche de lieux.

l'affichage par défaut peut n'inclure que le code couleur.


Affichez plus d'informations sur l'API Air Quality lors de la sélection des repères:

  • Signification de l'IQA universel / de l'IQA 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 pour les conditions de qualité de l'air actuelles.
  • Vous pouvez ajuster le niveau d'information affiché par défaut en fonction de vos besoins. Gardez à l'esprit que les points de données pour un lieu sont souvent utiles par rapport à d'autres.

Exemple d'affichage de la section "Qualité de l'air"

Réponse à 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'index 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 ceux où la qualité de l'air est bonne.

Réponse à la qualité de l'air

...
"color":{
  "red": 0.9490196,
  "green": 0.98039216,
  "blue": 0.019607844
}
...
Convertir en RVB 
  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 tuiles colorées d'une carte de densité sont un excellent moyen:

  • pour fournir une vue d'ensemble de l'ensemble du domaine.
  • pour révéler rapidement des nuances dans cette zone.

Utilisez l'API Maps JavaScript avec ImateMapType pour afficher les tuiles individuelles nécessaires pour couvrir la totalité de la fenêtre d'affichage de votre carte Google. Les tuiles de la carte de densité sont actualisées lorsque l'utilisateur interagit avec la carte en effectuant un panoramique, en effectuant un zoom ou en changeant de position.

N'oubliez pas que la valeur autorisée pour le niveau de zoom ne peut pas dépasser 16.
Le calque de cartes de densité de l'API Air Quality peut disparaître lors d'une recherche hyperlocalisée.

Vous pouvez sélectionner des types de carte de densité dans un nombre limité d'indices de qualité de l'air:

  • UAQI_RED_GREEN : palette rouge-vert de l'indice universel de la qualité de l'air.
  • UAQI_INDIGO_PERSIAN : palette indigo-persane de l'indice de qualité de l'air universel.
  • PM25_INDIGO_PERSIAN : palette indigo-persane PM2,5.
  • GBR_DEFRA : palette de couleurs de l'indice de la qualité de l'air quotidienne (Royaume-Uni).
  • DEU_UBA : palette de couleurs de l'indice de la qualité de l'air locale en Allemagne.
  • CAN_EC : palette de couleurs de l'indice de qualité de l'air du Canada.
  • Palette de couleurs de l'indice de la qualité de l'air (France) de FRA_ATMO.
  • US_AQI : palette de couleurs de l'indice de la qualité de l'air aux États-Unis.

    • Assurez-vous d'indiquer la gamme de couleurs pour que les utilisateurs comprennent la valeur et le classement des couleurs:

    • Échelle de gradient UAQI (0-100) : Médiocre / 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 le point clé sur l'échelle UAQI (0-100) : médiocre / excellent

    Nombre de requêtes et coût associé

    • API Maps JavaScript: une carte au chargement de l'expérience.
    • API Air Quality :
      • 1 requête par lieu (toutes lors du chargement de la carte ou uniquement lors de la sélection de l'utilisateur)
      • Calque 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 correspond à une unité SKU.
    • API Nearby Search (New): une requête tous les 20 lieux affichés. Facturation différente en fonction des données de lieu incluses dans 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 choisissent 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 tenant compte de la quantité d'informations qui s'affichent simultanément et de la façon dont elles sont rendues visibles.

    Actions suivantes

    Documentation complémentaire suggérée:

    Contributeurs

    Cet article est mis à jour par Google. Ce commentaire a été écrit initialement par les contributeurs suivants.
    Auteur principal:

    Thomas Anglaret | Solutions Engineer