Mendapatkan perkiraan per menit (Eksperimental)

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:
  • UNITS_SYSTEM_UNSPECIFIED
  • IMPERIAL
  • METRIC

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

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:
  • DOMINANT_PRECIPITATION_TYPE_UNSPECIFIED
  • NONE
  • RAIN
  • SNOW
  • HAIL
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:
  • PRECIPITATION_INTENSITY_UNSPECIFIED
  • NO_INTENSITY
  • MID_LIGHT
  • LIGHT
  • MID_MODERATE
  • MODERATE
  • MID_HEAVY
  • HEAVY

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