Menampilkan data historis cuaca per jam hingga 24 jam di lokasi tertentu, mulai dari jam terakhir.
Permintaan HTTP
GET https://weather.googleapis.com/v1/history/hours:lookup
URL menggunakan sintaksis gRPC Transcoding.
Parameter kueri
Parameter | |
---|---|
location |
Wajib. Lokasi untuk mendapatkan data historis per jam. |
units |
Opsional. Sistem satuan yang akan digunakan untuk kondisi cuaca yang ditampilkan. Jika tidak diberikan, kondisi cuaca yang ditampilkan akan menggunakan sistem metrik (default = METRIC). |
page |
Opsional. Jumlah maksimum data historis per jam yang akan ditampilkan per halaman - nilai dari 1 hingga 24 (inklusif). Nilai defaultnya adalah nilai maksimum yang diizinkan, yaitu 24. |
page |
Opsional. Token halaman yang diterima dari permintaan sebelumnya. Ini digunakan untuk mengambil halaman berikutnya. |
hours |
Opsional. Membatasi jumlah total jam yang akan diambil mulai dari jam terakhir - dari 1 hingga 24 (inklusif). Nilai defaultnya adalah nilai maksimum yang diizinkan, yaitu 24. |
language |
Opsional. Memungkinkan klien memilih bahasa untuk respons. Jika data tidak dapat diberikan untuk bahasa tersebut, API akan menggunakan kecocokan terdekat. Nilai yang diizinkan bergantung pada standar IETF BCP-47. Nilai defaultnya adalah "en". |
Isi permintaan
Isi permintaan harus kosong.
Isi respons
Respons untuk RPC hours.lookup.
Jika berhasil, isi respons memuat data dengan struktur berikut:
Representasi JSON |
---|
{ "historyHours": [ { object ( |
Kolom | |
---|---|
history |
Data historis per jam, sesuai dengan jumlah jam dan ukuran halaman yang ditentukan dalam permintaan. |
time |
Zona waktu di lokasi yang diminta. |
next |
Token untuk mengambil halaman berikutnya. |
Cakupan otorisasi
Memerlukan cakupan OAuth berikut:
https://www.googleapis.com/auth/cloud-platform
HistoryHour
Merepresentasikan data histori per jam di lokasi tertentu.
Representasi JSON |
---|
{ "interval": { object ( |
Kolom | |
---|---|
interval |
Interval satu jam (dalam waktu UTC) yang berlaku untuk data historis ini (stempel waktu dibulatkan ke bawah ke jam terdekat). |
display |
Tanggal dan waktu lokal dalam zona waktu lokasi (waktu sipil) tempat data per jam ini dihitung. Kolom ini dapat digunakan untuk tujuan tampilan di klien. Catatan: tanggal ini akan terdiri dari tahun, bulan, hari, jam, dan offset dari UTC. |
weather |
Histori kondisi cuaca. |
temperature |
Histori suhu. |
feels |
Ukuran bagaimana suhu terasa di lokasi yang diminta. |
dew |
Suhu titik embun historis. |
heat |
Suhu indeks panas historis. |
wind |
Histologis angin dingin, suhu udara yang terpapar di kulit. |
wet |
Suhu bohlam basah historis, suhu terendah yang dapat dicapai dengan menguapkan air. |
precipitation |
Probabilitas presipitasi historis dan jumlah presipitasi yang terakumulasi selama satu jam terakhir. |
air |
Kondisi tekanan udara historis. |
wind |
Histori kondisi angin. |
visibility |
Visibilitas historis. |
ice |
Ketebalan es historis. |
is |
Benar jika jam ini berada di antara waktu matahari terbit (inklusif) dan matahari terbenam (eksklusif) lokal. Jika tidak, waktunya adalah malam hari (antara matahari terbenam dan matahari terbit berikutnya). Catatan: jam ini akan dianggap sebagai siang hari atau malam hari jika intervalnya berpotongan dengan waktu matahari terbit dan terbenam lokal (misalnya: jika intervalnya adalah dari pukul 05.00 hingga 06.00 dan matahari terbit pukul 05.59, maka isDaytime akan bernilai benar). |
relative |
Persentase historis kelembapan relatif (nilai dari 0 hingga 100). |
uv |
Indeks ultraviolet (UV) historis. |
thunderstorm |
Kemungkinan petir historis (nilai dari 0 hingga 100). |
cloud |
Persentase historis langit yang tertutup awan (nilai dari 0 hingga 100). |