POST AI agent ready /v1/weather/current

API Cuaca - Kondisi Saat Ini berdasarkan Kota atau Koordinat

Mengembalikan data cuaca terkini untuk lokasi yang ditentukan berdasarkan nama kota atau garis lintang/bujur. Responsnya mencakup suhu (seperti yang dirasakan), kelembapan, curah hujan, kecepatan dan arah angin, tutupan awan, kode cuaca numerik, dan deskripsi yang dapat dibaca manusia.

Endpoint

Code examples

curl -X POST https://api.botoi.com/v1/weather/current \
  -H "Content-Type: application/json" \
  -d '{"city":"London","lat":51.5074,"lng":-0.1278}'

When to use this API

Konten dinamis berdasarkan cuaca lokal

Personalisasikan spanduk beranda atau rekomendasi produk berdasarkan cuaca lokal pengunjung. Situs retail dapat mempromosikan payung saat hujan atau tabir surya saat langit cerah, sehingga meningkatkan rasio konversi dengan relevansi kontekstual.

Logistik dan perencanaan rute pengiriman

Periksa kondisi cuaca di sepanjang rute pengiriman sebelum memberangkatkan pengemudi. Tandai rute dengan angin kencang atau curah hujan lebat sehingga petugas operator dapat mengubah rute atau menunda pengiriman untuk melindungi barang dan keselamatan pengemudi.

IoT dan otomatisasi rumah pintar

Jajak pendapat data cuaca terkini untuk memicu tindakan rumah pintar. Tutup tirai bermotor saat tutupan awan turun di bawah 20%, aktifkan alat penyiram hanya saat curah hujan nol, atau sesuaikan titik setel termostat berdasarkan suhu yang diinginkan.

Frequently asked questions

Haruskah saya menggunakan nama kota atau koordinat?

Keduanya berhasil. Nama kota nyaman untuk masukan yang dilihat pengguna. Koordinat lebih tepat dan menghindari ambiguitas ketika beberapa kota memiliki nama yang sama (misalnya, "Springfield" ada di lebih dari 30 negara bagian AS).

Satuan suhu apa yang dikembalikan?

Suhu dikembalikan dalam Celsius secara default. Bidang unit dalam respons mengonfirmasi hal ini. Konversikan ke sisi klien Fahrenheit dengan rumus F = C * 9/5 + 32.

Seberapa sering data cuaca diperbarui?

Data cuaca diperbarui setiap 15 menit dari sumber hulu. Untuk sebagian besar aplikasi, menyimpan respons dalam cache selama 10-15 menit di pihak Anda aman dan mengurangi panggilan API.

Apa yang diwakili oleh kolom kode_cuaca?

Weather_code adalah kode interpretasi cuaca WMO numerik. Nilai umum: 0 = langit cerah, 1-3 = berawan sebagian, 45/48 = kabut, 51-67 = gerimis/hujan, 71-77 = salju, 80-82 = hujan lebat, 95+ = badai petir. Bidang deskripsi menyediakan label yang dapat dibaca manusia.

Apa yang terjadi jika kota atau koordinat tidak diberikan?

Titik akhir menampilkan kesalahan yang meminta Anda memberikan nama kota atau pasangan lintang/bujur. Setidaknya satu parameter lokasi diperlukan.

Get your API key

Free tier includes 5 requests per minute with no credit card required. Upgrade for higher limits.