Menampilkan prakiraan per jam hingga 240 jam di lokasi tertentu, mulai dari jam saat ini.
Permintaan HTTP
GET https://weather.googleapis.com/v1/forecast/hours:lookup
URL menggunakan sintaksis gRPC Transcoding.
Parameter kueri
Parameter | |
---|---|
location |
Wajib. Lokasi untuk mendapatkan prakiraan 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 perkiraan 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 saat ini - nilai dari 1 hingga 240 (inklusif). Nilai defaultnya adalah nilai maksimum yang diizinkan, yaitu 240. |
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 |
---|
{ "forecastHours": [ { object ( |
Kolom | |
---|---|
forecast |
Data perkiraan 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
ForecastHour
Merepresentasikan data perkiraan per jam di lokasi tertentu.
Representasi JSON |
---|
{ "interval": { object ( |
Kolom | |
---|---|
interval |
Interval satu jam (dalam waktu UTC) yang berlaku untuk data perkiraan ini (stempel waktu dibulatkan ke bawah ke jam terdekat). |
display |
Tanggal dan waktu lokal dalam zona waktu lokasi (waktu sipil) yang digunakan untuk menghitung perkiraan per jam ini. Kolom ini dapat digunakan untuk tujuan tampilan di klien. Catatan: tanggal ini akan terdiri dari tahun, bulan, hari, jam, dan offset dari UTC. |
weather |
Kondisi cuaca yang diprediksi. |
temperature |
Perkiraan suhu. |
feels |
Ukuran bagaimana suhu akan terasa di lokasi yang diminta. |
dew |
Suhu titik embun yang diprediksi. |
heat |
Suhu indeks panas yang diprediksi. |
wind |
Perkiraan angin dingin, suhu udara yang terpapar di kulit. |
wet |
Perkiraan suhu bola basah, suhu terendah yang dapat dicapai dengan menguapkan air. |
precipitation |
Perkiraan probabilitas presipitasi dan jumlah presipitasi yang terakumulasi selama satu jam terakhir. |
air |
Kondisi tekanan udara yang diprediksi. |
wind |
Prakiraan kondisi angin. |
visibility |
Perkiraan visibilitas. |
ice |
Perkiraan ketebalan es. |
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 |
Perkiraan persentase kelembapan relatif (nilai dari 0 hingga 100). |
uv |
Prakiraan indeks ultraviolet (UV). |
thunderstorm |
Perkiraan probabilitas petir (nilai dari 0 hingga 100). |
cloud |
Perkiraan persentase langit yang tertutup awan (nilai dari 0 hingga 100). |