Method: forecast.hours.lookup

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

Permintaan HTTP

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

URL ini menggunakan sintaksis gRPC Transcoding.

Parameter kueri

Parameter
location

object (LatLng)

Wajib. Lokasi untuk mendapatkan prakiraan cuaca 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 rekaman 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. 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). Defaultnya adalah nilai maksimum yang diizinkan, yaitu 240.
languageCode

string

Opsional. Memungkinkan klien memilih bahasa untuk respons. Jika data tidak dapat disediakan untuk bahasa tersebut, API akan menggunakan kecocokan terdekat. Nilai yang diizinkan mengandalkan 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)

Rekaman 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 prakiraan 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 valid untuk data perkiraan ini (stempel waktu dibulatkan ke bawah ke jam terdekat).
displayDateTime

object (DateTime)

Tanggal dan waktu setempat 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 selisih dari UTC.
weatherCondition

object (WeatherCondition)

Kondisi cuaca yang diperkirakan.
temperature

object (Temperature)

Prakiraan suhu.
feelsLikeTemperature

object (Temperature)

Ukuran bagaimana suhu akan terasa di lokasi yang diminta.
dewPoint

object (Temperature)

Prakiraan suhu titik embun.
heatIndex

object (Temperature)

Suhu indeks panas yang diperkirakan.
windChill

object (Temperature)

Perkiraan angin dingin, suhu udara yang terpapar pada kulit.
wetBulbTemperature

object (Temperature)

Prakiraan suhu bohlam basah, suhu terendah yang dapat dicapai dengan menguapkan air.
precipitation

object (Precipitation)

Prakiraan probabilitas presipitasi dan jumlah presipitasi yang terakumulasi selama satu jam terakhir.
airPressure

object (AirPressure)

Kondisi tekanan udara yang diperkirakan.
wind

object (Wind)

Prakiraan kondisi angin.
visibility

object (Visibility)

Visibilitas yang diperkirakan.
iceThickness

object (IceThickness)

Perkiraan ketebalan es.
isDaytime

boolean

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

integer

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

integer

Indeks ultraviolet (UV) yang diperkirakan.
thunderstormProbability

integer

Prakiraan probabilitas badai petir (nilai dari 0 hingga 100).
cloudCover

integer

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