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 dei luoghi complete. Vedremo 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 inseriti in varie esperienze di ricerca, ad esempio quando gli utenti cercano una località da visitare. L'API Air Quality offre:

  • In tempo reale * e dati storici: dati aggiornati e precisi che rappresentano lo stato attuale e i dati passati in un periodo 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). Forniscono indicatori chiave per consentire agli utenti di confrontare e prendere decisioni sul luogo più appropriato.

La qualità dell'aria può variare notevolmente anche per località vicine

Procedura dettagliata di esempio

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 della posizione

  • Scegli il tuo indice delle 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 con cui un determinato paese, ad esempio l'EPA degli Stati Uniti, 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 ricerca dei luoghi.

la visualizzazione predefinita potrebbe includere solo il codice colore.


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

  • Significato di IQA universale / IQA locale.
  • Livelli di inquinanti, che misurano le particelle e i gas presenti nell'aria: inquinante predominante, concentrazione, sorgenti ed effetti.
  • Consigli per la salute, ovvero azioni consigliate per le attuali condizioni di qualità dell'aria.
  • Puoi regolare il livello di informazioni visualizzato per impostazione predefinita in base alle tue esigenze. Tieni presente che i punti dati per 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 sulla qualità dell'aria solo in caso di interazione con un luogo.

  • 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 i 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)

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

Le schede colorate della mappa termica sono un ottimo modo per:

  • per fornire una panoramica dell'area ampia.
  • 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'intero viewport della tua mappa Google. I riquadri della mappa termica si aggiornano man mano che l'utente interagisce con la mappa eseguendo una panoramica, eseguendo lo zoom o cambiando la posizione.

Tieni presente che il valore del livello di zoom consentito può essere fino a 16.
Il livello della mappa di calore dell'API Air Quality potrebbe scomparire nella ricerca iperclocale.

Puoi selezionare i tipi di mappe termiche in un insieme limitato di indici di qualità dell'aria:

  • UAQI_RED_GREEN: tavolozza rossa-verde dell'IQA universale.
  • UAQI_INDIGO_PERSIAN - Universal Air Quality Index indigo-persian palette.
  • PM25_INDIGO_PERSIAN - tavolozza indaco-persiana 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 canadese della 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 degli Stati Uniti.

    • Assicurati di indicare la scala di colori per consentire agli utenti di comprendere il valore e la relativa classificazione in base al colore:

    • scala di gradiente IQA di Pechino (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

    Conteggio delle 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 alla selezione dell'utente).
      • Livello delle schede della mappa di calore: ogni immagine della scheda è di 256 x 256 pixel 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 Ricerca nelle vicinanze (nuova): 1 query ogni 20 luoghi visualizzati. Fatturazione diversa in base ai dati dei luoghi che fanno parte della risposta alla query.

    Conclusione

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

    Azioni successive

    Letture consigliate:

    Collaboratori

    Questo articolo è gestito da Google. È stato originariamente scritto dai seguenti collaboratori.
    Autore principale:

    Thomas Anglaret | Solutions Engineer