Consapevolezza dell'aria per i luoghi che utilizzano l'API Air Quality

In questo documento, scoprirai come utilizzare l'API Air Quality per creare esperienze di ricerca di luoghi coinvolgenti. Mostreremo in che modo la qualità dell'aria può essere un indicatore di valore per gli utenti dall'inizio fino alla fine della canalizzazione e come i dati dell'API Air Quality possono essere incorporati nelle esperienze esistenti.

Casi d'uso e valore aggiunto

Gli indicatori dell'API Air Quality possono adattarsi a varie esperienze di ricerca, ad esempio quando gli utenti cercano un luogo da visitare. L'API Air Quality offre:

  • In tempo reale * e dati storici: dati aggiornati e precisi che rappresentano lo stato attuale e dati indietro nel tempo in un periodo di 30 giorni con risoluzione oraria. (* un'istantanea oraria della qualità dell'aria all'esterno)
  • Dati globali e locali: coprono intere aree in oltre 100 paesi, ma sono anche altamente localizzati (fino a 500 m) I dati dell'API Air Quality forniscono indicatori chiave che consentono agli utenti di confrontare e prendere decisioni sul luogo più appropriato.

La qualità dell'aria può essere drasticamente diversa anche in luoghi vicini

Esempio di procedura dettagliata

Mostra i dati sulla qualità dell'aria all'inizio dell'esperienza

Esistono due modi principali per mostrare i dati dell'API Air Quality:

Visualizza i dati dell'API Air Quality sui segnaposto dei luoghi

  • Scegli l'indice di località: un IQA universale o un IQA locale (sono disponibili fino a 70 Indici di qualità dell'aria (IQA) diversi). L'indice di qualità dell'aria (IQA) è la scala in base alla quale un determinato paese, ad esempio l'EPA degli Stati Uniti, classifica diversi livelli di qualità dell'aria in base a diversi metodi di calcolo, fonti di dati e finalità designate.
  • Inizia a visualizzare il valore e il codice colore principali dell'API Air Quality direttamente dall'esperienza di ricerca di luoghi.

la visualizzazione predefinita potrebbe includere solo il codice colore.


Visualizza ulteriori informazioni sull'API Air Quality sulla selezione dei pin:

  • Significato dell'IQA universale / IQA locale.
  • Livelli di inquinanti, ovvero una misurazione delle particelle e dei gas nell'aria: inquinante dominante, concentrazione, fonti ed effetti.
  • Consigli sulla salute, che sono azioni consigliate per le attuali condizioni di qualità dell'aria.
  • Puoi modificare il livello di informazioni visualizzate per impostazione predefinita in base alle tue esigenze. Tieni presente che i punti dati di una località sono spesso utili rispetto ad altre località.

Esempio di visualizzazione della sezione Qualità dell'aria

Risposta alla qualità dell'aria

{
    "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": …
    }
}
  • In alternativa, puoi eseguire query sui dati relativi alla qualità dell'aria solo in seguito all'interazione con una località.

  • Puoi utilizzare l'indice dell'API Air Quality per filtrare i luoghi nelle vicinanze, ad esempio se stai cercando parchi nella tua zona, vedrai solo parchi con una buona qualità dell'aria.

Risposta alla qualità dell'aria

...
"color":{
  "red": 0.9490196,
  "green": 0.98039216,
  "blue": 0.019607844
}
...
Converti in 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)

Visualizza il livello della mappa termica dell'API Air Quality su una mappa

I riquadri colorati della mappa termica sono un ottimo modo:

  • per fornire una panoramica ampia dell'area.
  • per mostrare rapidamente le sfumature nell'area.

Utilizza l'API Maps JavaScript con ImateMapType per visualizzare i singoli riquadri necessari per coprire l'intera area visibile della tua mappa Google. I riquadri della mappa termica si aggiornano man mano che l'utente interagisce con la mappa eseguendo panoramica, zoom o modifica della posizione.

Tieni presente che il valore del livello di zoom consentito è fino a 16.
Il livello del riquadro della mappa termica dell'API Air Quality potrebbe scomparire dalla ricerca iperlocale.

Puoi selezionare i Tipi di mappa termica in un insieme limitato di indici di qualità dell'aria:

  • UAQI_RED_GREEN - Tavolozza rosso-verde dell'indice universale di qualità dell'aria.
  • UAQI_INDIGO_PERSIAN - Tavolozza dell'indice universale di qualità dell'aria indaco-persiano.
  • PM25_INDIGO_PERSIAN - Tavolozza con indice PM2.5 indaco-persiano.
  • GBR_DEFRA - Tavolozza dei colori per l'indice di qualità dell'aria giornaliera (UK).
  • DEU_UBA - Tavolozza dei colori dell'indice di qualità dell'aria locale tedesco.
  • CAN_EC - Tavolozza dei colori dell'indice canadese di qualità dell'aria.
  • FRA_ATMO - Tavolozza dei colori dell'indice di qualità dell'aria in Francia.
  • US_AQI - Tavolozza dei colori dell'indice di qualità dell'aria negli Stati Uniti.

    • Assicurati di indicare la scala dei colori per consentire agli utenti di comprendere il valore e il ranking dei colori:

    • UAQI scala del gradiente (0-100): Scadente / Eccellente

    Snippet di codice CSS della tavolozza dei colori: 

    .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 */
   );
}

    • colori a tinta unita per rappresentare il punto chiave nella scala UAQI (0-100): Scadente / Eccellente

    Numero di query e costo associati

    • API Maps JavaScript: 1 mappa al caricamento dell'esperienza.
    • API Air Quality:
      • 1 query per ogni luogo (tutto al caricamento della mappa o solo in seguito alla selezione dell'utente).
      • Livello del riquadro della mappa termica: ogni immagine del riquadro è 256*256 px e per coprire una mappa standard presentata su un dispositivo mobile o web sono necessari 12-14 riquadri. Ogni riquadro estratto viene conteggiato come 1 unità SKU.
    • API Nearby Search (nuova): 1 query ogni 20 luoghi visualizzati. Fatturazione diversa in base ai dati del luogo che fanno parte della risposta alla query.

    Conclusione

    Abbiamo dimostrato che l'API Air Quality può essere un punto dati importante per consentire agli utenti di decidere un luogo da visitare. Di conseguenza, i dati sulla qualità dell'aria dovrebbero essere visibili il prima possibile nell'esperienza di ricerca, prestando attenzione alla quantità di informazioni visualizzate contemporaneamente e a come vengono rese visibili.

    Azioni successive

    Ulteriori letture suggerite:

    Collaboratori

    Google gestisce questo articolo. I seguenti collaboratori lo hanno scritto in origine.
    Autore principale:

    Thomas Anglaret | Solutions Engineer