Mendapatkan perkiraan per menit (Eksperimental)

Endpoint forecast:minutes menyediakan 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 waktu berakhir jangka waktu prediksi
  • Zona waktu lokasi yang diminta
  • Waktu mulai dan 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) 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 untuk memberikan informasi cuaca).

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

Tabel 1.3.1 (Meng-cache Izin)

Izin ini merupakan tambahan dari izin yang dijelaskan dalam Tabel 17.2.1 dalam 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 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 perkiraan per 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:
  • 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 Satuan yang digunakan untuk mengukur jumlah presipitasi yang terakumulasi (misalnya, MILLIMETERS, INCHES).
segments.snowfallAmount Prediksi jumlah salju selama segmen tersebut.
segments.snowfallAmount.quantity Jumlah salju yang diprediksi (sebagai setara air cair) selama segmen tersebut.
segments.snowfallAmount.unit Satuan 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 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 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"
    },
    ...
  ]
}