Endpoint forecast:minutes menyediakan perkiraan presipitasi resolusi tinggi dari menit ke menit (juga dikenal sebagai nowcasting) untuk lokasi tertentu.
API menampilkan informasi berikut untuk jangka waktu 6 jam:
- Waktu mulai dan waktu berakhir jangka waktu prediksi
- Zona waktu lokasi yang diminta
- Waktu mulai dan berakhir setiap segmen perkiraan
- Jenis, kemungkinan, jumlah, dan intensitas presipitasi yang diprediksi selama setiap segmen
Persyaratan
Persyaratan ini diterbitkan berdasarkan Pasal 6 (Persyaratan Penawaran Pra-GA) dari Persyaratan Khusus Layanan Google Maps Platform, sebagaimana disetujui oleh Google dan Anda.
1.1 Persyaratan Atribusi. Pelanggan harus memberikan atribusi kepada Google sesuai dengan Dokumentasi jika Pelanggan menggunakan Konten Google Maps dari Weather API.
1.2 Pembatasan. Pelanggan tidak boleh menggunakan Konten Google Maps yang diambil dari Weather API untuk membuat ulang layanan atau produk Google (misalnya, menggunakan data yang diambil dari Weather API di aplikasi cuaca atau model cuaca yang tujuan utamanya adalah memberikan informasi cuaca).
1.3 Caching. Pelanggan dapat meng-cache sementara Konten Google Maps yang berlaku dari Weather API selama Periode Cache yang berlaku, seperti yang dijelaskan dalam Tabel 1.3.1 (Izin Cache).
Tabel 1.3.1 (Izin Cache)
Izin ini merupakan tambahan dari yang dijelaskan dalam Tabel 17.2.1 Persyaratan Khusus Layanan Google Maps Platform.
| Konten Google Maps | Periode Penyimpanan dalam Cache |
|---|---|
| Nilai perkiraan menit | Satu jam, setelah itu Pelanggan harus menghapus Konten Google Maps yang di-cache |
Tentang permintaan perkiraan menit
Untuk meminta perkiraan menit, kirim permintaan HTTP GET ke:
https://weather.googleapis.com/v1/forecast/minutes:lookup?key=API_KEY&location.latitude=LATITUDE&location.longitude=LONGITUDE
Sertakan koordinat lintang dan bujur lokasi dalam parameter permintaan Anda.
Parameter permintaan
Endpoint forecast.minutes menerima parameter permintaan berikut:
| Parameter | Deskripsi | Wajib diisi atau opsional |
|---|---|---|
location.latitude |
Koordinat lintang lokasi yang diminta. | Wajib |
location.longitude |
Koordinat bujur lokasi yang diminta. | Wajib |
unitsSystem |
Sistem unit yang diminta. Nilai mencakup:
Jika tidak ada sistem unit yang ditentukan, respons akan ditetapkan secara default ke |
Opsional |
pageSize |
Menentukan jumlah hasil maksimum yang akan ditampilkan. | Opsional |
pageToken |
Token halaman yang diterima dari permintaan sebelumnya. Untuk mengambil halaman data berikutnya, teruskan pageToken sebagai parameter input dalam permintaan berikutnya. |
Opsional |
Tentang respons perkiraan menit
Weather API menampilkan kolom berikut dalam isi respons:
| Kolom | Deskripsi |
|---|---|
overallPredictionTimeframe |
Jangka waktu keseluruhan untuk prediksi. |
overallPredictionTimeframe.startTime |
Waktu mulai jangka waktu prediksi. Hal ini mencerminkan titik referensi awal. |
overallPredictionTimeframe.endTime |
Waktu berakhir jangka waktu prediksi. Waktu ini ditetapkan enam jam setelah waktu mulai. |
timeZone |
Zona waktu lokasi yang diminta. |
segments |
Segmen prediksi tingkat menit, yang dilambangkan dengan timeFrame. |
segments.timeFrame |
Jangka waktu yang relevan dengan segmen. |
segments.timeFrame.startTime |
Waktu mulai segmen. |
segments.timeFrame.endTime |
Waktu berakhir segmen. |
segments.type |
Jenis presipitasi yang diprediksi selama segmen tersebut. Nilai mencakup:
|
segments.probability |
Perkiraan peluang presipitasi selama segmen tersebut. Nilai dalam persentase berkisar antara 0 hingga 100. |
segments.qpf |
Prakiraan presipitasi kuantitatif. |
segments.qpf.quantity |
Perkiraan jumlah presipitasi selama segmen tersebut. |
segments.qpf.unit |
Satuan yang digunakan untuk mengukur jumlah akumulasi presipitasi (misalnya, MILLIMETERS, INCHES). |
segments.snowfallAmount |
Prediksi jumlah salju selama segmen tersebut. |
segments.snowfallAmount.quantity |
Perkiraan jumlah salju (sebagai setara air cair) selama segmen tersebut. |
segments.snowfallAmount.unit |
Satuan yang digunakan untuk mengukur jumlah akumulasi salju (misalnya, MILLIMETERS, INCHES). |
segments.intensity |
Intensitas presipitasi segmen (PrecipitationIntensity). Nilainya mencakup:
Catatan: Pastikan klien Anda dapat menangani nilai yang tidak diketahui. |
nextPageToken |
Token yang dapat dikirim sebagai pageToken untuk mengambil halaman berikutnya. Jika kolom ini dihilangkan, tidak akan ada halaman berikutnya. |
Contoh perkiraan menit
Contoh berikut meminta informasi prakiraan menit untuk lokasi di West Virginia:
curl -H "Content-Type: application/json" -X GET "https://weather.googleapis.com/v1/forecast/minutes:lookup?key=API_KEY&location.latitude=37.60451&location.longitude=-80.59044&unitsSystem=METRIC&pageSize=5"
Dalam respons, objek segments menunjukkan setiap segmen dari keseluruhan jangka waktu prediksi:
{ "overallPredictionTimeframe": { "startTime": "2026-05-11T12:10:00Z", "endTime": "2026-05-11T18:12:00Z" }, "timeZone": { "id": "America/New_York" }, "segments": [ { "timeFrame": { "startTime": "2026-05-11T12:20:00Z", "endTime": "2026-05-11T12:22:00Z" }, "type": "RAIN", "probability": 21, "qpf": { "quantity": 0.1333, "unit": "MILLIMETERS" }, "snowfallAmount": { "quantity": 0.0, "unit": "MILLIMETERS" }, "intensity": "MODERATE" }, { "timeFrame": { "startTime": "2026-05-11T12:22:00Z", "endTime": "2026-05-11T12:24:00Z" }, "type": "RAIN", "probability": 21, "qpf": { "quantity": 0.1333, "unit": "MILLIMETERS" }, "snowfallAmount": { "quantity": 0.0, "unit": "MILLIMETERS" }, "intensity": "MODERATE" }, ... ] }