Method: history.hours.lookup

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

Permintaan HTTP

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

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

object (HistoryHour)

Catatan 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

Mewakili catatan 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 valid untuk data historis 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 data 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 historis.
temperature

object (Temperature)

Suhu historis.
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)

Angin dingin historis, suhu udara yang terpapar pada 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)

Kondisi angin historis.
visibility

object (Visibility)

Visibilitas historis.
iceThickness

object (IceThickness)

Ketebalan es historis.
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

Persen kelembapan relatif historis (nilai dari 0 hingga 100).
uvIndex

integer

Indeks ultraviolet (UV) historis.
thunderstormProbability

integer

Kemungkinan badai petir historis (nilai dari 0 hingga 100).
cloudCover

integer

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