- Permintaan HTTP
- Parameter kueri
- Isi permintaan
- Isi respons
- Cakupan otorisasi
- CurrentConditionsHistory
Menampilkan kondisi cuaca saat ini di lokasi tertentu.
Permintaan HTTP
GET https://weather.googleapis.com/v1/currentConditions:lookup
URL menggunakan sintaksis gRPC Transcoding.
Parameter kueri
Parameter | |
---|---|
location |
Wajib. Lokasi untuk mendapatkan kondisi cuaca saat ini. |
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). |
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 currentConditions.lookup - mewakili kondisi cuaca saat ini di lokasi yang diminta.
Jika berhasil, isi respons memuat data dengan struktur berikut:
Representasi JSON |
---|
{ "currentTime": string, "timeZone": { object ( |
Kolom | |
---|---|
current |
Waktu saat ini (UTC) yang terkait dengan data yang ditampilkan. Menggunakan RFC 3339, dengan output yang dihasilkan akan selalu dinormalisasi Z dan menggunakan digit pecahan 0, 3, 6, atau 9. Offset selain "Z" juga diterima. Contoh: |
time |
Zona waktu di lokasi yang diminta. |
weather |
Kondisi cuaca saat ini. |
temperature |
Suhu saat ini. |
feels |
Ukuran suhu yang saat ini terasa di lokasi yang diminta. |
dew |
Suhu titik embun saat ini. |
heat |
Suhu indeks panas saat ini. |
wind |
Suhu dingin saat ini, suhu udara yang terpapar di kulit. |
precipitation |
Probabilitas presipitasi saat ini dan jumlah presipitasi yang terakumulasi selama satu jam terakhir. |
air |
Kondisi tekanan udara saat ini. |
wind |
Kondisi angin saat ini. |
visibility |
Visibilitas saat ini. |
current |
Perubahan kondisi saat ini selama 24 jam terakhir. |
is |
Benar jika waktu saat ini di lokasi yang diminta 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). |
relative |
Persentase kelembapan udara relatif saat ini (nilai dari 0 hingga 100). |
uv |
Indeks ultraviolet (UV) saat ini. |
thunderstorm |
Probabilitas petir saat ini (nilai dari 0 hingga 100). |
cloud |
Persentase langit saat ini yang tertutup awan (nilai dari 0 hingga 100). |
Cakupan otorisasi
Memerlukan cakupan OAuth berikut:
https://www.googleapis.com/auth/cloud-platform
CurrentConditionsHistory
Menampilkan serangkaian perubahan dalam kondisi saat ini selama 24 jam terakhir.
Representasi JSON |
---|
{ "temperatureChange": { object ( |
Kolom | |
---|---|
temperature |
Suhu saat ini dikurangi suhu 24 jam yang lalu. |
max |
Suhu maksimum (tinggi) dalam 24 jam terakhir. |
min |
Suhu minimum (rendah) dalam 24 jam terakhir. |
qpf |
Jumlah presipitasi (hujan atau salju), yang diukur sebagai setara air cair, yang telah terakumulasi selama 24 jam terakhir. Catatan: QPF adalah singkatan dari Quantitative Precipitation Forecast (lihat definisi QuantitativePrecipitationForecast untuk mengetahui detail selengkapnya). |