Ringkasan Weather API

Weather API memungkinkan Anda meminta data cuaca hiperlokal real-time untuk lokasi di seluruh dunia guna mendukung dasbor cuaca live, aplikasi pembaruan cuaca, overlay cuaca rute, dan pelacak kesehatan atau aktivitas berbasis cuaca. Informasi cuaca mencakup suhu saat ini, presipitasi, kelembapan relatif, kecepatan angin, indeks UV, dan lainnya.

Untuk lokasi pada lintang dan bujur tertentu, API menyediakan endpoint (https://weather.googleapis.com/v1/...) untuk data dalam tabel berikut.

Sekilas tentang endpoint REST

Endpoint API URL Deskripsi Parameter yang didokumentasikan
Kondisi saat ini https://weather.googleapis.com/v1/currentConditions:lookup Kondisi cuaca live location.latitude, location.longitude
Prakiraan cuaca per jam https://weather.googleapis.com/v1/forecast/hours:lookup Prakiraan kondisi hingga 240 jam ke depan location.latitude, location.longitude
Prakiraan harian https://weather.googleapis.com/v1/forecast/days:lookup Prakiraan kondisi hingga 10 hari ke depan location.latitude, location.longitude
Histori per jam https://weather.googleapis.com/v1/history/hours:lookup Kondisi sebelumnya yang di-cache hingga 24 jam location.latitude, location.longitude
Pemberitahuan cuaca buruk https://weather.googleapis.com/v1/publicAlerts:lookup Pemberitahuan cuaca buruk key, location.latitude, location.longitude

Kasus penggunaan umum

Fitur Weather API

Data Weather API mencakup hal berikut:

  • Kondisi dan ikon cuaca: Deskripsi dan ikon yang sesuai yang menunjukkan kondisi cuaca saat ini (misalnya, "Berawan" atau "Hujan salju tersebar") di weatherCondition.
  • Suhu: Suhu saat ini (temperature), suhu minimum dan maksimum (minTemperature dan maxTemperature pada perkiraan harian, atau di dalam currentConditionsHistory), dan suhu semu ("terasa seperti") (feelsLikeTemperature).
  • Presipitasi: Total presipitasi dan jenis presipitasi (salju, hujan, es, campuran).
  • Angin: Suhu angin (windChill), arah angin (wind.direction), kecepatan angin (wind.speed), dan embusan angin (wind.gust).
  • Ketebalan es: Ketebalan es.
  • Kelembapan: Titik embun (dewPoint), indeks panas (heatIndex), suhu bola basah (wetBulbTemperature), dan kelembapan relatif (relativeHumidity).
  • Indeks UV: Indeks ultraviolet (UV) (uvIndex).
  • Kemungkinan badai petir: Persentase kemungkinan terjadinya badai petir.
  • Jarak pandang: Jarak di mana suatu objek terlihat jelas.
  • Tekanan udara: Tekanan udara rata-rata di permukaan laut.
  • Peristiwa matahari dan bulan: Waktu matahari terbit, matahari terbenam, bulan terbit, dan bulan terbenam.
  • Tutupan awan: Persentase langit yang tertutup awan.

Cara menggunakan Weather API

1 Melakukan penyiapan Mulai dengan Menyiapkan project Google Cloud dan selesaikan petunjuk yang mengikutinya.
2 Mendapatkan kondisi saat ini Lihat Mendapatkan kondisi saat ini.
3 Mendapatkan prakiraan cuaca per jam Lihat Mendapatkan prakiraan cuaca per jam.
4 Mendapatkan perkiraan harian Lihat Mendapatkan perkiraan harian.
5 Mendapatkan histori per jam Lihat Mendapatkan histori per jam.
6 Mendapatkan peringatan cuaca Lihat Mendapatkan peringatan cuaca.

Untuk indeks kualitas udara (AQI) dan polutan partikulat (PM2.5, PM10), gunakan Air Quality API (https://airquality.googleapis.com/v1/currentConditions:lookup). Weather API tidak menampilkan nilai ini.

API lingkungan terkait lainnya mencakup:

  • Jumlah serbuk sari: Pollen API (https://pollen.googleapis.com/v1/forecast:lookup)
  • Penyinaran matahari dan potensi atap: Solar API (https://solar.googleapis.com/v1/buildingInsights:findClosest)

Langkah berikutnya