Method: forecast.hours.lookup

Trả về thông tin dự báo hằng 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ị để 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 dự báo hằng 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ờ 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 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 
{
  "forecastHours": [
    {
      object (ForecastHour)
    }
  ],
  "timeZone": {
    object (TimeZone)
  },
  "nextPageToken": string
}
Trường
forecastHours[]

object (ForecastHour)

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

ForecastHour

Đại diện cho một bản ghi dự báo 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 dự báo này có hiệu lực (dấu thời gian được làm tròn đế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à thông tin dự báo 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 hình thời tiết được dự báo.
temperature

object (Temperature)

Nhiệt độ dự báo.
feelsLikeTemperature

object (Temperature)

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

object (Temperature)

Nhiệt độ điểm sương được dự báo.
heatIndex

object (Temperature)

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

object (Temperature)

Độ lạnh do gió gây ra được dự báo, nhiệt độ không khí tiếp xúc với da.
wetBulbTemperature

object (Temperature)

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

object (AirPressure)

Điều kiện áp suất không khí được dự báo.
wind

object (Wind)

Tình trạng gió được dự báo.
visibility

object (Visibility)

Khả năng hiển thị được dự đoán.
iceThickness

object (IceThickness)

Độ dày băng dự kiến.
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 được dự đoán (giá trị từ 0 đến 100).
uvIndex

integer

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

integer

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

integer

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