Qualità dell'aria per i luoghi

In questo documento, scoprirai come utilizzare l'API Air Quality per creare esperienze di ricerca di luoghi complete. Mostreremo come la qualità dell'aria può essere un indicatore di valore per gli utenti dall'inizio 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 essere integrati in varie esperienze di ricerca, ad esempio quando gli utenti cercano un luogo da visitare. L'API Air Quality offre:

  • Dati storici e in tempo reale*: dati aggiornati e accurati che rappresentano lo stato attuale e i dati storici in un intervallo di 30 giorni con una risoluzione oraria. (* un'istantanea oraria della qualità dell'aria esterna)
  • Dati globali e locali: i dati dell'API Air Quality coprono intere aree in oltre 100 paesi, ma sono altamente localizzati (fino a 500 m) e forniscono indicatori chiave per consentire agli utenti di confrontare e prendere decisioni sul luogo più appropriato.

La qualità dell'aria può essere drasticamente diversa anche per località vicine

Procedura dettagliata di esempio

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 delle località

  • Scegli l'indice della tua località: IQA universale o IQA locale (sono disponibili fino a 70 diversi indici di qualità dell'aria (IQA)). Un indice di qualità dell'aria (IQA) è la scala con cui un determinato paese, ad esempio l'EPA statunitense, classifica i diversi livelli di qualità dell'aria, in base a diversi metodi di calcolo, origini dati e scopi designati.
  • Inizia a visualizzare il valore principale dell'API Air Quality e il codice colore direttamente dall'esperienza di Place Search.

la visualizzazione predefinita potrebbe includere solo il codice colore.


Visualizza ulteriori informazioni sull'API Air Quality quando selezioni un segnaposto:

  • Significato di IQA universale/IQA locale.
  • Livelli di agenti inquinanti, che misurano le particelle e i gas presenti nell'aria: agente inquinante predominante, concentrazione, cause ed effetti.
  • Consigli per la salute, ovvero comportamenti consigliati per le condizioni attuali della qualità dell'aria.
  • Puoi regolare 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 se confrontati con quelli di altre località.

Esempio di visualizzazione della sezione Qualità dell'aria

Risposta sulla 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 sulla qualità dell'aria solo quando interagisci con una località.

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

Risposta sulla 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:

  • per fornire una panoramica di un'ampia area.
  • per mostrare rapidamente le sfumature all'interno di quell'area.

Utilizza l'API Maps JavaScript con ImateMapType per visualizzare i singoli riquadri necessari per coprire l'intera area visibile della mappa Google. I riquadri della mappa termica verranno aggiornati man mano che l'utente interagisce con la mappa eseguendo panoramiche, zoom o modificando la posizione.

Tieni presente che il valore consentito per il livello di zoom è fino a 16.
Il livello dei riquadri della mappa termica dell'API Air Quality potrebbe scomparire nella ricerca iperlocale.

Puoi selezionare i tipi di mappa Heatmap all'interno di un insieme limitato di indici di qualità dell'aria:

  • UAQI_RED_GREEN: tavolozza rosso-verde dell'indice di qualità dell'aria universale.
  • UAQI_INDIGO_PERSIAN: tavolozza indaco-persiano dell'indice di qualità dell'aria universale.
  • PM25_INDIGO_PERSIAN: tavolozza indaco-persiano dell'indice PM2.5.
  • GBR_DEFRA: tavolozza dei colori dell'indice giornaliero di qualità dell'aria (Regno Unito).
  • DEU_UBA: tavolozza dei colori dell'indice di qualità dell'aria locale tedesco.
  • CAN_EC: tavolozza dei colori dell'indice di salute correlato alla qualità dell'aria canadese.
  • FRA_ATMO: tavolozza dei colori dell'indice di qualità dell'aria in Francia.
  • US_AQI: tavolozza dei colori dell'indice di qualità dell'aria degli Stati Uniti.

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

    • Scala del gradiente IQAU (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 i punti chiave della scala UAQI (0-100): Scarso/Eccellente

    Numero di query e costo associato

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

    Conclusione

    Abbiamo dimostrato che l'API Air Quality può essere un punto dati importante per gli utenti per decidere un luogo da visitare. Pertanto, 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 al modo in cui vengono rese visibili.

    Azioni successive

    Letture consigliate per approfondire:

    Collaboratori

    Google gestisce questo articolo. I seguenti collaboratori l'hanno scritta originariamente.
    Autore principale:

    Thomas Anglaret | Solutions Engineer