Method: forecast.hours.lookup

Menampilkan prakiraan per jam hingga 240 jam di lokasi tertentu, mulai dari jam saat ini.

Permintaan HTTP

GET https://weather.googleapis.com/v1/forecast/hours:lookup

URL menggunakan sintaksis gRPC Transcoding.

Parameter kueri

Parameter
location

object (LatLng)

Wajib. Lokasi untuk mendapatkan prakiraan per jam.

unitsSystem

enum (UnitsSystem)

Opsional. Sistem satuan yang akan digunakan untuk kondisi cuaca yang ditampilkan. Jika tidak diberikan, kondisi cuaca yang ditampilkan akan menggunakan sistem metrik (default = METRIC).

pageSize

integer

Opsional. Jumlah maksimum data perkiraan per jam yang akan ditampilkan per halaman - nilai dari 1 hingga 24 (inklusif). Nilai defaultnya adalah nilai maksimum yang diizinkan, yaitu 24.

pageToken

string

Opsional. Token halaman yang diterima dari permintaan sebelumnya. Ini digunakan untuk mengambil halaman berikutnya.

hours

integer

Opsional. Membatasi jumlah total jam yang akan diambil mulai dari jam saat ini - nilai dari 1 hingga 240 (inklusif). Nilai defaultnya adalah nilai maksimum yang diizinkan, yaitu 240.

languageCode

string

Opsional. Memungkinkan klien memilih bahasa untuk respons. Jika data tidak dapat diberikan untuk bahasa tersebut, API akan menggunakan kecocokan terdekat. Nilai yang diizinkan bergantung pada standar IETF BCP-47. Nilai defaultnya adalah "en".

Isi permintaan

Isi permintaan harus kosong.

Isi respons

Respons untuk RPC hours.lookup.

Jika berhasil, isi respons memuat data dengan struktur berikut:

Representasi JSON
{
  "forecastHours": [
    {
      object (ForecastHour)
    }
  ],
  "timeZone": {
    object (TimeZone)
  },
  "nextPageToken": string
}
Kolom
forecastHours[]

object (ForecastHour)

Data perkiraan per jam, sesuai dengan jumlah jam dan ukuran halaman yang ditentukan dalam permintaan.

timeZone

object (TimeZone)

Zona waktu di lokasi yang diminta.

nextPageToken

string

Token untuk mengambil halaman berikutnya.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

  • https://www.googleapis.com/auth/cloud-platform

ForecastHour

Merepresentasikan data perkiraan per jam di lokasi tertentu.

Representasi JSON
{
  "interval": {
    object (Interval)
  },
  "displayDateTime": {
    object (DateTime)
  },
  "weatherCondition": {
    object (WeatherCondition)
  },
  "temperature": {
    object (Temperature)
  },
  "feelsLikeTemperature": {
    object (Temperature)
  },
  "dewPoint": {
    object (Temperature)
  },
  "heatIndex": {
    object (Temperature)
  },
  "windChill": {
    object (Temperature)
  },
  "wetBulbTemperature": {
    object (Temperature)
  },
  "precipitation": {
    object (Precipitation)
  },
  "airPressure": {
    object (AirPressure)
  },
  "wind": {
    object (Wind)
  },
  "visibility": {
    object (Visibility)
  },
  "iceThickness": {
    object (IceThickness)
  },
  "isDaytime": boolean,
  "relativeHumidity": integer,
  "uvIndex": integer,
  "thunderstormProbability": integer,
  "cloudCover": integer
}
Kolom
interval

object (Interval)

Interval satu jam (dalam waktu UTC) yang berlaku untuk data perkiraan ini (stempel waktu dibulatkan ke bawah ke jam terdekat).

displayDateTime

object (DateTime)

Tanggal dan waktu lokal dalam zona waktu lokasi (waktu sipil) yang digunakan untuk menghitung perkiraan per jam ini. Kolom ini dapat digunakan untuk tujuan tampilan di klien. Catatan: tanggal ini akan terdiri dari tahun, bulan, hari, jam, dan offset dari UTC.

weatherCondition

object (WeatherCondition)

Kondisi cuaca yang diprediksi.

temperature

object (Temperature)

Perkiraan suhu.

feelsLikeTemperature

object (Temperature)

Ukuran bagaimana suhu akan terasa di lokasi yang diminta.

dewPoint

object (Temperature)

Suhu titik embun yang diprediksi.

heatIndex

object (Temperature)

Suhu indeks panas yang diprediksi.

windChill

object (Temperature)

Perkiraan angin dingin, suhu udara yang terpapar di kulit.

wetBulbTemperature

object (Temperature)

Perkiraan suhu bola basah, suhu terendah yang dapat dicapai dengan menguapkan air.

precipitation

object (Precipitation)

Perkiraan probabilitas presipitasi dan jumlah presipitasi yang terakumulasi selama satu jam terakhir.

airPressure

object (AirPressure)

Kondisi tekanan udara yang diprediksi.

wind

object (Wind)

Prakiraan kondisi angin.

visibility

object (Visibility)

Perkiraan visibilitas.

iceThickness

object (IceThickness)

Perkiraan ketebalan es.

isDaytime

boolean

Benar jika jam ini berada di antara waktu matahari terbit (inklusif) dan matahari terbenam (eksklusif) lokal. Jika tidak, waktunya adalah malam hari (antara matahari terbenam dan matahari terbit berikutnya). Catatan: jam ini akan dianggap sebagai siang hari atau malam hari jika intervalnya berpotongan dengan waktu matahari terbit dan terbenam lokal (misalnya: jika intervalnya adalah dari pukul 05.00 hingga 06.00 dan matahari terbit pukul 05.59, maka isDaytime akan bernilai benar).

relativeHumidity

integer

Perkiraan persentase kelembapan relatif (nilai dari 0 hingga 100).

uvIndex

integer

Prakiraan indeks ultraviolet (UV).

thunderstormProbability

integer

Perkiraan probabilitas petir (nilai dari 0 hingga 100).

cloudCover

integer

Perkiraan persentase langit yang tertutup awan (nilai dari 0 hingga 100).