Kesadaran kualitas udara untuk Tempat yang menggunakan Air Quality API

Dalam dokumen ini, Anda akan mempelajari cara menggunakan Air Quality API untuk membangun pengalaman penelusuran tempat yang kaya. Kami akan menunjukkan bagaimana kualitas udara bisa menjadi sinyal bernilai bagi pengguna dari awal hingga akhir funnel, dan bagaimana data Air Quality API dapat disematkan ke dalam 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:

  • Data real time * dan data historis - data baru dan akurat yang mewakili status saat ini serta data masa lalu dalam periode 30 hari dalam resolusi per jam. (* ringkasan kualitas udara luar ruangan per jam)
  • Data global dan lokal - yang 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 di tempat yang paling tepat.

Kualitas udara bisa sangat berbeda bahkan untuk lokasi dekat

Panduan Contoh

Tampilkan data kualitas udara di awal pengalaman

Ada dua cara utama untuk menampilkan data Air Quality API:

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 tingkat kualitas udara yang berbeda, berdasarkan metode penghitungan, sumber data, dan tujuan yang ditetapkan yang berbeda.
  • Mulai visualisasikan nilai Air Quality API dan kode warna utama langsung dari pengalaman penelusuran tempat.

tampilan default hanya dapat menyertakan kode warna.


Tampilkan informasi Air Quality API selengkapnya tentang pemilihan pin:

  • Arti AQI / AQI Lokal Universal.
  • 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. Perlu diingat bahwa titik data untuk lokasi sering kali berguna dibandingkan dengan lokasi lain.

Contoh tampilan bagian kualitas udara

Respons 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 membuat kueri data Kualitas Udara hanya berdasarkan 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)

Menampilkan lapisan peta panas Air Quality API pada peta

Ubin berwarna peta panas adalah cara yang bagus:

  • untuk memberikan gambaran umum secara luas.
  • untuk menampilkan nuansa di area tersebut dengan cepat.

Gunakan Maps JavaScript API dengan ImateMapType untuk menampilkan setiap ubin yang diperlukan untuk menutupi seluruh area tampilan peta Google Anda. Petak peta panas akan diperbarui saat pengguna berinteraksi dengan peta dengan menggeser, melakukan zoom, atau mengubah lokasi.

Perhatikan bahwa nilai tingkat zoom yang diizinkan maksimal 16.
Lapisan ubin peta panas Air Quality API mungkin hilang dalam penelusuran hiperlokal.

Anda dapat memilih Jenis peta panas dalam kumpulan Indeks Kualitas Udara terbatas:

  • UAQI_RED_GREEN - Palet merah-hijau Indeks Kualitas Udara Universal.
  • UAQI_INDIGO_PERSIAN - Palet indigo-persian Indeks Kualitas Udara Universal.
  • PM25_INDIGO_PERSIAN - indeks PM2.5 palet nila-persian.
  • GBR_DEFRA - Palet warna Indeks Kualitas Udara Harian (UK).
  • DEU_UBA - Palet warna Indeks Kualitas Udara Lokal Jerman.
  • CAN_EC - Palet warna Indeks Kesehatan Kualitas Udara Kanada.
  • FRA_ATMO - Palet warna Indeks Kualitas Udara Perancis.
  • Palet warna US_AQI - Indeks Kualitas Udara Amerika Serikat.

  • 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 merepresentasikan poin penting dalam skala UAQI (0-100): Buruk / Sangat Baik

    Jumlah kueri dan biaya yang terkait

    • Maps JavaScript API: 1 peta pada saat pemuatan pengalaman.
    • Air Quality API:
      • 1 kueri untuk setiap tempat (semua pada pemuatan peta atau hanya pada pilihan pengguna).
      • Lapisan ubin peta panas: setiap gambar ubin berukuran 256*256 piksel dan untuk menutupi peta standar yang ditampilkan di perangkat seluler atau web, Anda memerlukan 12-14 ubin. Setiap kartu yang diambil dihitung sebagai 1 unit SKU.
    • Nearby Search (Baru) API: 1 kueri setiap 20 tempat 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 seawal mungkin dalam pengalaman penelusuran dengan memperhatikan jumlah informasi yang ditampilkan sekaligus dan bagaimana data tersebut ditampilkan.

    Tindakan Berikutnya

    Bacaan Lebih Lanjut yang Disarankan:

    Kontributor

    Google mengelola artikel ini. Kontributor berikut awalnya yang menulisnya.
    Penulis utama:

    Thomas Anglaret | Engineer Solusi