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

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

  • Dati in tempo reale * e storici: 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 all'esterno)
  • Dati globali e locali: coprono intere aree in oltre 100 paesi, ma sono altamente localizzati (fino a 500 metri). I dati dell'API Air Quality forniscono agli utenti indicatori chiave per confrontare e prendere decisioni sul luogo più appropriato.

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

Esempio di procedura dettagliata

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

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

Visualizzare i dati dell'API Air Quality sui segnaposto

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

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 inquinanti, che sono una misura di particelle e gas nell'aria: agente inquinante predominante, concentrazione, fonti ed effetti.
  • Consigli per la salute, ovvero azioni consigliate 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 per una località sono spesso utili se confrontati con quelli di 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 sulla qualità dell'aria solo in caso di interazione 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 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)

Visualizzare 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'area di grandi dimensioni.
  • 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 tua mappa Google. I riquadri della mappa termica vengono aggiornati man mano che l'utente interagisce con la mappa spostandosi, eseguendo lo zoom o cambiando posizione.

Tieni presente che i valori consentiti per il livello di zoom sono fino a 16.
Il livello di riquadro della mappa termica dell'API Air Quality potrebbe scomparire nella ricerca iperlocale.

Puoi selezionare tipi di mappe termiche all'interno di 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 - Universal Air Quality Index indigo-persian palette.
  • PM25_INDIGO_PERSIAN - PM2.5 index indigo-persian palette.
  • 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 in modo che gli utenti possano comprendere il valore e la relativa classificazione dei colori:

    • scala del gradiente UAQI (0-100): Scarsa / 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 pieni per rappresentare il punto chiave nella scala UAQI (0-100): Scarsa / Eccellente

    Conteggio delle query e costi associati

    • API Maps JavaScript: 1 mappa al caricamento dell'esperienza.
    • API Air Quality:
      • 1 query per ogni luogo (tutti al caricamento della mappa o solo alla selezione dell'utente).
      • Livello di riquadri della mappa termica: ogni immagine del riquadro è 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 un'unità SKU.
    • API Nearby Search (New): 1 query ogni 20 luoghi visualizzati. Fatturazione diversa in base ai dati sui luoghi 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 devono essere visibili il prima possibile nell'esperienza di ricerca, prestando attenzione alla quantità di informazioni visualizzate contemporaneamente e alla modalità di visualizzazione.

    Azioni successive

    Letture consigliate:

    Collaboratori

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

    Thomas Anglaret | Solutions Engineer