Mendapatkan perkiraan per menit (Eksperimental)

Endpoint forecast:minutes memberikan perkiraan presipitasi per menit dengan resolusi tinggi (juga dikenal sebagai nowcasting) untuk lokasi tertentu.

API menampilkan informasi berikut untuk jangka waktu 6 jam:

  • Waktu mulai dan berakhir jangka waktu prediksi
  • Zona waktu lokasi yang diminta
  • Waktu mulai dan waktu berakhir setiap segmen perkiraan
  • Jenis, kemungkinan, kuantitas, dan intensitas presipitasi yang diprediksi selama setiap segmen

Persyaratan

Persyaratan ini dikeluarkan berdasarkan Pasal 6 (Persyaratan Penawaran Pra-GA) 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 dapat menggunakan Konten Google Maps yang diambil dari Weather API untuk membuat ulang layanan atau produk Google (misalnya, menggunakan data yang diambil dari Weather API dalam aplikasi cuaca atau model cuaca yang tujuan utamanya adalah menyediakan informasi cuaca).

1.3 Penyimpanan dalam cache. Pelanggan dapat menyimpan sementara dalam cache Konten Google Maps yang berlaku dari Weather API untuk Periode Penyimpanan dalam Cache yang berlaku, sebagaimana dijelaskan dalam Tabel 1.3.1 (Izin Penyimpanan dalam Cache).

Tabel 1.3.1 (Meng-cache Izin)

Izin ini merupakan tambahan dari izin yang dijelaskan dalam Tabel 17.2.1 Persyaratan Khusus Layanan Google Maps Platform.

Konten Google Maps Periode Penyimpanan dalam Cache
Nilai perkiraan per menit Satu jam, setelah itu Pelanggan harus menghapus Konten Google Maps yang di-cache

Tentang permintaan perkiraan per menit

Untuk meminta perkiraan per 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 satuan yang diminta. Nilai mencakup:
  • UNITS_SYSTEM_UNSPECIFIED
  • IMPERIAL
  • METRIC

Jika tidak ada sistem unit yang ditentukan, respons akan ditetapkan secara default ke METRIC.

 Opsional
pageSize Menentukan jumlah maksimum hasil 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 per menit

Weather API menampilkan kolom berikut dalam isi respons:

Kolom Deskripsi
overallPredictionTimeframe Rentang 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 ditandai 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:
  • DOMINANT_PRECIPITATION_TYPE_UNSPECIFIED
  • NONE
  • RAIN
  • SNOW
  • HAIL
segments.probability Peluang presipitasi yang diprediksi selama segmen tersebut. Nilai dalam persentase yang berkisar dari 0 hingga 100.
segments.qpf Prakiraan presipitasi kuantitatif.
segments.qpf.quantity Prediksi jumlah presipitasi selama segmen tersebut.
segments.qpf.unit Unit yang digunakan untuk mengukur jumlah presipitasi yang terakumulasi (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 Unit yang digunakan untuk mengukur jumlah salju yang terakumulasi (misalnya, MILLIMETERS, INCHES).
segments.intensity Intensitas presipitasi segmen. Nilai mencakup:
  • PRECIPITATION_INTENSITY_UNSPECIFIED
  • NO_INTENSITY
  • LIGHT
  • MODERATE
  • HEAVY
nextPageToken Token yang dapat dikirim sebagai pageToken untuk mengambil halaman berikutnya. Jika kolom ini dihilangkan, tidak akan ada halaman berikutnya.

Contoh perkiraan per menit

Contoh berikut meminta informasi perkiraan cuaca per 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 jangka waktu prediksi keseluruhan:

  {
  "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"
    },
    ...
  ]
}