Method: currentConditions.lookup

Titik akhir Kondisi Saat Ini menyediakan informasi kualitas udara per jam di lebih dari 100 negara, hingga resolusi 500 x 500 meter. Mencakup lebih dari 70 indeks lokal serta indeks dan kategori kualitas udara global.

Permintaan HTTP

POST https://airquality.googleapis.com/v1/currentConditions:lookup

URL menggunakan sintaksis gRPC Transcoding.

Isi permintaan

Isi permintaan memuat data dengan struktur berikut:

Representasi JSON 
{
  "location": {
    object (LatLng)
  },
  "extraComputations": [
    enum (ExtraComputation)
  ],
  "uaqiColorPalette": enum (ColorPalette),
  "customLocalAqis": [
    {
      object (CustomLocalAqi)
    }
  ],
  "universalAqi": boolean,
  "languageCode": string
}
Kolom
location

object (LatLng)

Wajib. Bujur dan lintang tempat API mencari data kondisi kualitas udara saat ini.
extraComputations[]

enum (ExtraComputation)

Opsional. Fitur tambahan yang dapat diaktifkan secara opsional. Menentukan komputasi tambahan akan menghasilkan elemen dan kolom yang relevan untuk ditampilkan dalam respons.
uaqiColorPalette

enum (ColorPalette)

Opsional. Menentukan palet warna yang digunakan untuk data yang diberikan oleh 'Universal Air Quality Index' (UAQI). Palet warna ini relevan hanya untuk UAQI, AQI lainnya memiliki palet warna yang telah ditentukan sebelumnya yang tidak dapat dikontrol.
customLocalAqis[]

object (CustomLocalAqi)

Opsional. Menyatakan hubungan 'negara/wilayah ke AQI'. Memasangkan negara/wilayah dengan AQI yang diinginkan sehingga data kualitas udara yang diperlukan untuk negara/wilayah tersebut akan ditampilkan sesuai dengan AQI yang dipilih. Parameter ini dapat digunakan untuk menentukan AQI non-default untuk negara tertentu, misalnya, untuk mendapatkan indeks EPA AS untuk Kanada, bukan indeks default untuk Kanada.
universalAqi

boolean

Opsional. Jika ditetapkan ke true, AQI Universal akan disertakan dalam kolom 'indeks' respons. Nilai default adalah true.
languageCode

string

Opsional. Memungkinkan klien memilih bahasa respons. Jika data tidak dapat diberikan untuk bahasa tersebut, API akan menggunakan kecocokan terdekat. Nilai yang diizinkan bergantung pada standar IETF. Nilai defaultnya adalah en.

Isi respons

Jika berhasil, isi respons memuat data dengan struktur berikut:

Representasi JSON 
{
  "dateTime": string,
  "regionCode": string,
  "indexes": [
    {
      object (AirQualityIndex)
    }
  ],
  "pollutants": [
    {
      object (Pollutant)
    }
  ],
  "healthRecommendations": {
    object (HealthRecommendations)
  }
}
Kolom
dateTime

string (Timestamp format)

Stempel waktu yang dibulatkan ke bawah dalam format RFC3339 UTC "Zulu", dengan resolusi nanodetik dan maksimal sembilan digit pecahan. Misalnya: "2014-10-02T15:00:00Z".
regionCode

string

Kode ISO_3166-1 alpha-2 untuk negara/wilayah yang sesuai dengan lokasi yang diberikan dalam permintaan. Kolom ini dapat dihapus dari respons jika lokasi yang diberikan dalam permintaan berada di wilayah yang disengketakan.
indexes[]

object (AirQualityIndex)

Berdasarkan parameter permintaan, daftar ini akan mencakup (hingga) dua indeks kualitas udara:

  • AQI Universal. Akan ditampilkan jika boolean universalAqi disetel ke true.
  • AQI Lokal. Akan dikembalikan jika komputasi tambahan LOCAL_AQI ditentukan.
pollutants[]

object (Pollutant)

Daftar polutan yang memengaruhi lokasi yang ditentukan dalam permintaan. Catatan: Kolom ini hanya akan ditampilkan untuk permintaan yang menentukan satu atau beberapa komputasi tambahan berikut: POLLUTANT_ADDITIONAL_INFO, DOMINANT_POLLUTANT_CONCENTRATION, POLLUTANT_CONCENTRATION.
healthRecommendations

object (HealthRecommendations)

Saran kesehatan dan tindakan yang disarankan terkait kondisi kualitas udara yang dilaporkan. Rekomendasi disesuaikan secara berbeda untuk populasi berisiko, kelompok yang lebih sensitif terhadap polutan, dan populasi umum.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut ini:

  • https://www.googleapis.com/auth/cloud-platform

Untuk informasi selengkapnya, lihat Ringkasan OAuth 2.0.