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ị đo 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, điều kiện thời tiết được trả về sẽ ở hệ thống đo lường (mặc định = METRIC).
pageSize

integer

Không bắt buộc. Số lượng bản ghi lịch sử 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ả 1 và 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 đó. Tham số này được 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ờ cần tìm nạp, bắt đầu từ giờ gần đây 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 chọn ngôn ngữ cho câu trả lờ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)

Các bản ghi lịch sử theo 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 một bản ghi nhật ký theo 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 đến giờ gần nhất).
displayDateTime

object (DateTime)

Ngày và giờ địa phương theo múi giờ của vị trí (giờ dân sự) mà bản ghi hằng giờ này được tính. 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)

Đo lường cảm giác 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 độ chỉ số nóng bức trong quá khứ.
windChill

object (Temperature)

Chỉ số nhiệt độ cảm nhận, nhiệt độ không khí tiếp xúc với da trong quá khứ.
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 làm bay hơi nước.
precipitation

object (Precipitation)

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

object (AirPressure)

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

object (Wind)

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

object (Visibility)

Khả năng xem trước đây.
iceThickness

object (IceThickness)

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

boolean

True nếu giờ này nằm trong khoảng thời gian từ lúc bình minh (bao gồm) đến lúc hoàng hôn (không bao gồm) tại địa phương. Nếu không, đó là ban đêm (giữa thời điểm mặt trời lặn và thời điểm 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 giao với thời gian mặt trời mọc và lặn tương ứng theo giờ địa phương (ví dụ: nếu khoảng thời gian là từ 5 giờ sáng đến 6 giờ sáng và mặt trời mọc lúc 5 giờ 59 phút 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 bầu trời bị mây che phủ trong quá khứ (giá trị từ 0 đến 100).