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:
Condizioni attuali / orarie: ottieni valori individuali da visualizzare per ogni località.
(vai alla sezione: Visualizzare i dati dell'API Air Quality sui segnaposto)Riquadri della mappa termica: sovrapponi un livello colorato che rappresenta le condizioni attuali della qualità dell'aria esterna sulla mappa. Sono disponibili indici di livelli specifici per paese.
(vai alla sezione: Visualizzare il livello della mappa termica dell'API Air Quality su una mappa)
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
{ "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 } ...
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:
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:
- Migliorare la scoperta locale con l'API Nearby Search (nuova)
- Visualizzare i dati in tempo reale con gli stili basati sui dati
Collaboratori
Google gestisce questo articolo. I seguenti collaboratori lo hanno scritto originariamente.
Autore principale:
Thomas Anglaret | Solutions Engineer