Mendapatkan perkiraan per menit (Eksperimental)

Endpoint forecast:minutes memberikan prakiraan presipitasi beresolusi tinggi, per menit (juga dikenal sebagai nowcasting) untuk lokasi tertentu.

API menampilkan informasi berikut untuk jangka waktu 6 jam:

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

Persyaratan

Persyaratan ini dikeluarkan berdasarkan Pasal 6 (Persyaratan Penawaran Pra-GA) dari Google Maps Platform Service Specific Terms, sebagaimana disepakati 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 Batasan. 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 di aplikasi cuaca atau model cuaca yang tujuan utamanya adalah untuk memberikan informasi cuaca).

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

Tabel 1.3.1 (Izin Penyimpanan dalam Cache)

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 prakiraan per menit Satu jam, setelah itu Pelanggan harus menghapus Konten Google Maps yang disimpan dalam cache

Tentang permintaan prakiraan per menit

Untuk meminta prakiraan 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 unit 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 prakiraan per menit

Weather API menampilkan kolom berikut di 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 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 Kemungkinan presipitasi yang diprediksi selama segmen tersebut. Nilai dalam persentase berkisar antara 0 hingga 100.
segments.qpf Prakiraan presipitasi kuantitatif.
segments.qpf.quantity Jumlah presipitasi yang diprediksi selama segmen tersebut.
segments.qpf.unit Unit yang digunakan untuk mengukur jumlah presipitasi yang terakumulasi (misalnya, MILLIMETERS, INCHES).
segments.snowfallAmount Jumlah salju yang diprediksi selama segmen tersebut.
segments.snowfallAmount.quantity Jumlah salju yang diprediksi (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 prakiraan per menit

Contoh berikut meminta informasi prakiraan 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"
    },
    ...
  ]
}