Method: history.hours.lookup

Trả về dữ liệu thời tiết hằng giờ trong quá khứ trong tối đa 24 giờ tại một vị trí nhất định, bắt đầu từ giờ gần nhất.

Yêu cầu HTTP

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

URL sử dụng cú pháp Chuyển mã gRPC.

Tham số truy vấn

Thông số
location

object (LatLng)

Bắt buộc. Vị trí để lấy dữ liệu hằng giờ trong quá khứ.
unitsSystem

enum (UnitsSystem)

Không bắt buộc. Hệ thống đơn vị để sử dụng cho các điều kiện thời tiết được trả về. Nếu bạn không cung cấp, thì các điều kiện thời tiết được trả về sẽ theo hệ mét (mặc định = METRIC).
pageSize

integer

Không bắt buộc. Số lượng bản ghi nhật ký theo giờ tối đa cần trả về trên mỗi trang – một giá trị từ 1 đến 24 (bao gồm cả 24). Giá trị mặc định là giá trị tối đa được phép là 24.
pageToken

string

Không bắt buộc. Mã thông báo trang nhận được từ một yêu cầu trước đó. Phương thức này dùng để truy xuất trang tiếp theo.
hours

integer

Không bắt buộc. Giới hạn tổng số giờ để tìm nạp kể từ giờ gần nhất – từ 1 đến 24 (bao gồm cả 24). Giá trị mặc định là giá trị tối đa được phép là 24.
languageCode

string

Không bắt buộc. Cho phép ứng dụng khách chọn ngôn ngữ cho phản hồi. Nếu không thể cung cấp dữ liệu cho ngôn ngữ đó, API sẽ sử dụng ngôn ngữ phù hợp nhất. Các giá trị được phép dựa trên tiêu chuẩn IETF BCP-47. Giá trị mặc định là "en".

Nội dung yêu cầu

Nội dung yêu cầu phải trống.

Nội dung phản hồi

Phản hồi cho RPC hours.lookup.

Nếu thành công, phần nội dung phản hồi sẽ chứa dữ liệu có cấu trúc sau:

Biểu diễn dưới dạng JSON 
{
  "historyHours": [
    {
      object (HistoryHour)
    }
  ],
  "timeZone": {
    object (TimeZone)
  },
  "nextPageToken": string
}
Trường
historyHours[]

object (HistoryHour)

Bản ghi nhật ký hằng giờ, theo số giờ và kích thước trang được chỉ định trong yêu cầu.
timeZone

object (TimeZone)

Múi giờ tại vị trí được yêu cầu.
nextPageToken

string

Mã thông báo để truy xuất trang tiếp theo.

Phạm vi uỷ quyền

Yêu cầu phạm vi OAuth sau:

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

HistoryHour

Đại diện cho bản ghi nhật ký hằng giờ tại một vị trí nhất định.

Biểu diễn dưới dạng 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
}
Trường
interval

object (Interval)

Khoảng thời gian một giờ (theo giờ UTC) mà dữ liệu trong quá khứ này có hiệu lực (dấu thời gian được làm tròn xuống giờ gần nhất).
displayDateTime

object (DateTime)

Ngày và giờ theo múi giờ của vị trí (giờ dân sự) mà bản ghi hằng giờ này được tính toán. Trường này có thể được dùng cho mục đích hiển thị trên ứng dụng. Lưu ý: ngày này sẽ bao gồm năm, tháng, ngày, giờ và độ lệch so với giờ UTC.
weatherCondition

object (WeatherCondition)

Tình trạng thời tiết trong quá khứ.
temperature

object (Temperature)

Nhiệt độ trong quá khứ.
feelsLikeTemperature

object (Temperature)

Chỉ số đo cảm nhận về nhiệt độ tại vị trí được yêu cầu.
dewPoint

object (Temperature)

Nhiệt độ điểm sương trong quá khứ.
heatIndex

object (Temperature)

Nhiệt độ theo chỉ số nóng bức trong quá khứ.
windChill

object (Temperature)

Độ lạnh do gió gây ra trong quá khứ, nhiệt độ không khí tiếp xúc với da.
wetBulbTemperature

object (Temperature)

Nhiệt độ bầu ướt trong quá khứ, nhiệt độ thấp nhất có thể đạt được bằng cách bay hơi nước.
precipitation

object (Precipitation)

Xác suất mưa trong quá khứ và lượng mưa tích luỹ trong 1 giờ qua.
airPressure

object (AirPressure)

Điều kiện áp suất không khí trong quá khứ.
wind

object (Wind)

Tình trạng gió trong quá khứ.
visibility

object (Visibility)

Mức độ hiển thị trước đây.
iceThickness

object (IceThickness)

Độ dày băng trong quá khứ.
isDaytime

boolean

Đúng nếu giờ này nằm trong khoảng thời gian mặt trời mọc (bao gồm) và mặt trời lặn (không bao gồm) tại địa phương. Nếu không, đó là ban đêm (giữa lúc mặt trời lặn và lúc mặt trời mọc tiếp theo). Lưu ý: giờ này sẽ được coi là ban ngày hoặc ban đêm nếu khoảng thời gian này tương ứng với thời gian mặt trời mọc và lặn tại địa phương (ví dụ: nếu khoảng thời gian là từ 5 giờ đến 6 giờ sáng và mặt trời mọc lúc 5:59 sáng, thì isDaytime sẽ là true).
relativeHumidity

integer

Tỷ lệ phần trăm độ ẩm tương đối trong quá khứ (giá trị từ 0 đến 100).
uvIndex

integer

Chỉ số tia cực tím (UV) trong quá khứ.
thunderstormProbability

integer

Xác suất có giông bão trong quá khứ (giá trị từ 0 đến 100).
cloudCover

integer

Tỷ lệ phần trăm theo dữ liệu trong quá khứ của bầu trời bị che phủ bởi mây (giá trị từ 0 đến 100).