Method: history.hours.lookup

Menampilkan data historis cuaca per jam hingga 24 jam di lokasi tertentu, mulai dari jam terakhir.

Permintaan HTTP

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

URL menggunakan sintaksis gRPC Transcoding.

Parameter kueri

Parameter
location

object (LatLng)

Wajib. Lokasi untuk mendapatkan data historis 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 historis 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 terakhir - dari 1 hingga 24 (inklusif). Nilai defaultnya adalah nilai maksimum yang diizinkan, yaitu 24.

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
{
  "historyHours": [
    {
      object (HistoryHour)
    }
  ],
  "timeZone": {
    object (TimeZone)
  },
  "nextPageToken": string
}
Kolom
historyHours[]

object (HistoryHour)

Data historis 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

HistoryHour

Merepresentasikan data histori 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 historis ini (stempel waktu dibulatkan ke bawah ke jam terdekat).

displayDateTime

object (DateTime)

Tanggal dan waktu lokal dalam zona waktu lokasi (waktu sipil) tempat data per jam ini dihitung. 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)

Histori kondisi cuaca.

temperature

object (Temperature)

Histori suhu.

feelsLikeTemperature

object (Temperature)

Ukuran bagaimana suhu terasa di lokasi yang diminta.

dewPoint

object (Temperature)

Suhu titik embun historis.

heatIndex

object (Temperature)

Suhu indeks panas historis.

windChill

object (Temperature)

Histologis angin dingin, suhu udara yang terpapar di kulit.

wetBulbTemperature

object (Temperature)

Suhu bohlam basah historis, suhu terendah yang dapat dicapai dengan menguapkan air.

precipitation

object (Precipitation)

Probabilitas presipitasi historis dan jumlah presipitasi yang terakumulasi selama satu jam terakhir.

airPressure

object (AirPressure)

Kondisi tekanan udara historis.

wind

object (Wind)

Histori kondisi angin.

visibility

object (Visibility)

Visibilitas historis.

iceThickness

object (IceThickness)

Ketebalan es historis.

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

Persentase historis kelembapan relatif (nilai dari 0 hingga 100).

uvIndex

integer

Indeks ultraviolet (UV) historis.

thunderstormProbability

integer

Kemungkinan petir historis (nilai dari 0 hingga 100).

cloudCover

integer

Persentase historis langit yang tertutup awan (nilai dari 0 hingga 100).