Dalam dokumen ini, Anda akan melihat cara menggunakan Air Quality API untuk membangun pengalaman penelusuran tempat yang lengkap. Kami akan menunjukkan bagaimana kualitas udara dapat menjadi sinyal nilai bagi pengguna dari awal hingga akhir funnel, serta bagaimana data Air Quality API dapat disematkan ke pengalaman yang sudah ada.
Kasus Penggunaan dan nilai tambah
Sinyal Air Quality API dapat masuk ke dalam berbagai pengalaman penelusuran seperti saat pengguna mencari lokasi untuk dikunjungi. Air Quality API menawarkan:
- Real-time * dan data historis - data baru dan akurat yang mewakili keadaan saat ini serta data mundur dalam periode 30 hari dengan resolusi per jam. (* ringkasan kualitas udara luar ruangan per jam)
- Data global dan lokal - mencakup seluruh area di 100+ negara tetapi sangat dilokalkan (hingga 500 juta) data Air Quality API memberikan sinyal penting bagi pengguna untuk membandingkan dan membuat keputusan tentang tempat yang paling tepat.
Kualitas udara bisa sangat berbeda bahkan di lokasi dekat
Panduan Contoh
Tampilkan data kualitas udara di awal pengalaman
Ada dua cara utama untuk menampilkan data Air Quality API:
Kondisi saat ini / per jam: dapatkan nilai individual untuk ditampilkan terhadap setiap lokasi.
(buka bagian: Menampilkan data Air Quality API pada pin lokasi)Ubin peta panas: menempatkan lapisan berwarna yang mewakili kondisi kualitas udara luar ruangan saat ini di atas peta Anda. Tersedia indeks lapisan khusus negara.
(buka bagian: Lapisan peta panas Display Air Quality API di peta)
Menampilkan data Air Quality API di pin lokasi
- Pilih indeks lokasi Anda: AQI Universal atau AQI Lokal (tersedia hingga 70 Indeks Kualitas Udara (AQI) yang berbeda). Indeks kualitas udara (AQI) adalah skala yang digunakan negara tertentu, misalnya, EPA AS, mengategorikan berbagai tingkat kualitas udara, berdasarkan metode penghitungan, sumber data, dan tujuan yang ditetapkan yang berbeda.
- Mulai visualisasikan nilai utama Air Quality API dan kode warna langsung dari pengalaman penelusuran tempat.
layar default hanya dapat menyertakan kode warna.
Menampilkan informasi Air Quality API selengkapnya tentang pemilihan pin:
- Arti AQI Universal / AQI Lokal.
- Tingkat polutan, yang merupakan ukuran partikel dan gas di udara: Polutan dominan, Konsentrasi, Sumber & Efek.
- Rekomendasi kesehatan, yang merupakan tindakan yang disarankan untuk kondisi kualitas udara saat ini.
- Anda dapat menyesuaikan tingkat informasi yang ditampilkan secara default untuk memenuhi kebutuhan Anda. Perhatikan bahwa titik data untuk lokasi sering kali berguna dibandingkan dengan lokasi lain.
Contoh tampilan bagian kualitas udara
{ "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": … } }
- Atau, Anda dapat mengkueri data Kualitas Udara hanya terkait interaksi dengan lokasi.
- Anda dapat menggunakan indeks Air Quality API untuk memfilter tempat-tempat terdekat, yaitu: jika Anda mencari taman di area Anda, Anda hanya akan menampilkan taman dengan kualitas udara yang baik.
Respons Kualitas Udara
... "color":{ "red": 0.9490196, "green": 0.98039216, "blue": 0.019607844 } ...Konversikan ke 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)
Display lapisan peta panas Air Quality API pada peta
Ubin berwarna peta panas adalah cara yang bagus:
- untuk memberikan gambaran area yang luas.
- untuk menampilkan nuansa dalam area tersebut dengan cepat.
Gunakan Maps JavaScript API dengan ImateMapType untuk menampilkan setiap ubin yang diperlukan untuk menutupi seluruh area pandang peta Google Anda. Ubin peta panas akan dimuat ulang saat pengguna berinteraksi dengan peta dengan menggeser, memperbesar/memperkecil, atau mengubah lokasi.
Perlu diingat bahwa nilai tingkat zoom yang diizinkan maksimal 16.
Lapisan ubin peta panas Air Quality API mungkin hilang saat penelusuran hiperlokal.
Anda dapat memilih Jenis peta Panas dalam kumpulan Indeks Kualitas Udara terbatas:
Pastikan Anda menunjukkan skala warna bagi pengguna untuk memahami nilai dan peringkat warnanya:
- skala gradien UAQI (0-100): Buruk / Sangat Baik
Cuplikan kode CSS palet warna:
.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 */ ); }
- warna solid untuk mewakili poin penting dalam skala UAQI (0-100): Buruk / Sangat Baik
Jumlah kueri dan biaya yang terkait
- Maps JavaScript API: 1 peta saat pengalaman dimuat.
- Air Quality API:
- 1 kueri setiap tempat (semuanya pada pemuatan peta atau hanya pada pilihan pengguna).
- Lapisan ubin peta panas: setiap gambar ubin berukuran 256*256px dan untuk mencakup peta standar yang disajikan di perangkat seluler atau web, Anda memerlukan 12-14 ubin. Setiap ubin yang ditarik dihitung sebagai 1 unit SKU.
- Nearby Search (Baru) API: 1 kueri setiap 20 tempat yang ditampilkan. Penagihan yang berbeda menurut data Tempat yang merupakan bagian dari respons kueri.
Kesimpulan
Kami menunjukkan bahwa Air Quality API dapat menjadi titik data penting bagi pengguna untuk memutuskan tempat yang akan dikunjungi. Oleh karena itu, data Kualitas Udara harus terlihat secepat mungkin dalam pengalaman penelusuran dengan memperhatikan jumlah informasi yang ditampilkan sekaligus dan cara informasi tersebut ditampilkan.
Tindakan Berikutnya
Disarankan Bacaan Lebih Lanjut:
- Meningkatkan penemuan lokal dengan Nearby Search API (Baru)
- Melihat data secara real time dengan Gaya visual berbasis data
Kontributor
Google mengelola artikel ini. Awalnya, kontributor berikut ini ditulis.
Penulis utama:
Thomas Anglaret | Engineer Solusi