Menampilkan histori kualitas udara untuk lokasi tertentu selama rentang waktu tertentu.
Permintaan HTTP
POST https://airquality.googleapis.com/v1/history:lookup
URL menggunakan sintaksis gRPC Transcoding.
Isi permintaan
Isi permintaan memuat data dengan struktur berikut:
Representasi JSON |
---|
{ "pageSize": integer, "pageToken": string, "location": { object ( |
Kolom | |
---|---|
pageSize |
Opsional. Jumlah maksimum data info per jam yang akan ditampilkan per halaman. Defaultnya adalah 72 dan nilai maksimumnya adalah 168 (data 7 hari). |
pageToken |
Opsional. Token halaman yang diterima dari panggilan histori sebelumnya. Ini digunakan untuk mengambil halaman berikutnya. Perhatikan bahwa saat memberikan nilai untuk parameter ini, semua parameter lain yang diberikan harus cocok dengan panggilan yang memberikan token halaman (panggilan sebelumnya). |
location |
Wajib diisi. Lintang dan bujur tempat API mencari data histori kualitas udara. |
extraComputations[] |
Opsional. Fitur tambahan yang dapat diaktifkan secara opsional. Menentukan komputasi tambahan akan menghasilkan elemen dan kolom yang relevan ditampilkan dalam respons. |
uaqiColorPalette |
Opsional. Menentukan palet warna yang digunakan untuk data yang disediakan oleh 'Universal Air Quality Index' (UAQI). Palet warna ini relevan hanya untuk UAQI, AQI lain memiliki palet warna yang telah ditentukan yang tidak dapat dikontrol. |
customLocalAqis[] |
Opsional. Menunjukkan 'negara/wilayah ke AQI' hubungan. Menyambungkan 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. |
dateTime |
Stempel waktu untuk menampilkan data historis. Stempel waktu dibulatkan ke jam persis sebelumnya. Catatan: ini akan menampilkan data per jam hanya untuk stempel waktu yang diminta (yaitu satu elemen info per jam). Misalnya, permintaan yang dikirim dengan parameter dateTime yang ditetapkan ke 2023-01-03T11:05:49Z akan dibulatkan ke 2023-01-03T11:00:00Z. Stempel waktu dalam RFC3339 UTC "Zulu" , dengan resolusi nanodetik dan hingga sembilan digit pecahan. Contoh: "2014-10-02T15:01:23Z" dan "2014-10-02T15:01:23.045123456Z". Catatan: |
hours |
Angka dari 1 hingga 720 yang menunjukkan rentang jam untuk permintaan. Misalnya: Nilai 48 akan menghasilkan data dari 48 jam terakhir. |
period |
Menunjukkan periode Catatan: |
universalAqi |
Opsional. Jika disetel ke benar (true), AQI Universal akan disertakan dalam 'indeks' kolom respons. Nilai default adalah true. |
languageCode |
Opsional. Memungkinkan klien memilih bahasa untuk respons. Jika data tidak dapat diberikan untuk bahasa tersebut, API akan menggunakan pencocokan 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 |
---|
{
"hoursInfo": [
{
object ( |
Kolom | |
---|---|
hoursInfo[] |
Opsional. Berisi informasi kualitas udara untuk setiap jam dalam rentang yang diminta. Misalnya, jika permintaan adalah histori selama 48 jam, akan ada 48 elemen info per jam. |
regionCode |
Opsional. Kode ISO_3166-1 alpha-2 negara/wilayah yang sesuai dengan lokasi yang diberikan dalam permintaan. Kolom ini mungkin dihilangkan dari respons jika lokasi yang diberikan dalam permintaan berada di wilayah yang disengketakan. |
nextPageToken |
Opsional. Token untuk mengambil halaman berikutnya. |
Cakupan otorisasi
Memerlukan cakupan OAuth berikut:
https://www.googleapis.com/auth/cloud-platform
Untuk informasi selengkapnya, lihat Ringkasan OAuth 2.0.
HourInfo
Berisi informasi kualitas udara untuk setiap jam dalam rentang yang diminta. Misalnya, jika permintaan adalah histori selama 48 jam, akan ada 48 elemen info per jam.
Representasi JSON |
---|
{ "dateTime": string, "indexes": [ { object ( |
Kolom | |
---|---|
dateTime |
Stempel waktu yang dibulatkan ke bawah yang menunjukkan waktu data mengacu dalam RFC3339 UTC "Zulu" , dengan resolusi nanodetik dan hingga sembilan digit pecahan. Misalnya: "2014-10-02T15:00:00Z". |
indexes[] |
Berdasarkan parameter permintaan, daftar ini akan mencakup (hingga) dua indeks kualitas udara:
|
pollutants[] |
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 |
Saran kesehatan dan tindakan yang disarankan terkait kondisi kualitas udara yang dilaporkan. Rekomendasi disesuaikan secara berbeda untuk populasi yang berisiko, kelompok dengan sensitivitas lebih tinggi terhadap polutan, dan populasi umum. |