Method: forecast.hours.lookup

Trả về thông tin dự báo theo giờ trong tối đa 240 giờ tại một vị trí nhất định, bắt đầu từ giờ hiện tại.

Yêu cầu HTTP

GET https://weather.googleapis.com/v1/forecast/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í để nhận thông tin dự báo hằng giờ.
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 tối đa các bản ghi dự báo theo giờ 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 số giờ cần tìm nạp kể từ giờ hiện tại – một giá trị từ 1 đến 240 (bao gồm cả 240). Giá trị mặc định là giá trị tối đa được phép là 240.
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 
{
  "forecastHours": [
    {
      object (ForecastHour)
    }
  ],
  "timeZone": {
    object (TimeZone)
  },
  "nextPageToken": string
}
Trường
forecastHours[]

object (ForecastHour)

Bản ghi dự báo 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

ForecastHour

Biểu thị một bản ghi dự báo 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 dự báo 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à dự báo theo 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 dự báo.
temperature

object (Temperature)

Nhiệt độ dự báo.
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 dự báo.
heatIndex

object (Temperature)

Nhiệt độ chỉ số nóng bức dự báo.
windChill

object (Temperature)

Nhiệt độ cảm nhận dự báo, nhiệt độ không khí tiếp xúc với da.
wetBulbTemperature

object (Temperature)

Nhiệt độ bầu ướt dự báo, 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 dự báo và lượng mưa tích luỹ trong giờ qua.
airPressure

object (AirPressure)

Tình trạng áp suất khí quyển dự báo.
wind

object (Wind)

Tình trạng gió dự báo.
visibility

object (Visibility)

Khả năng hiển thị dự kiến.
iceThickness

object (IceThickness)

Độ dày của băng theo dự báo.
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 tại đị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 dự đoán về độ ẩm tương đối (giá trị từ 0 đến 100).
uvIndex

integer

Chỉ số tia cực tím (UV) dự báo.
thunderstormProbability

integer

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

integer

Tỷ lệ phần trăm dự đoán của bầu trời bị mây che phủ (giá trị từ 0 đến 100).