Method: forecast.days.lookup

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

Yêu cầu HTTP

GET https://weather.googleapis.com/v1/forecast/days: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 ngày.
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ố bản ghi dự báo hằng ngày tối đa cần trả về trên mỗi trang – một giá trị từ 1 đến 10 (bao gồm cả 1 và 10). Giá trị mặc định là 5.
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.
days

integer

Không bắt buộc. Giới hạn tổng số ngày để tìm nạp kể từ ngày hiện tại – một giá trị từ 1 đến 10 (bao gồm cả). Giá trị mặc định là giá trị tối đa được phép là 10.
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 days.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 
{
  "forecastDays": [
    {
      object (ForecastDay)
    }
  ],
  "timeZone": {
    object (TimeZone)
  },
  "nextPageToken": string
}
Trường
forecastDays[]

object (ForecastDay)

Các bản ghi dự báo hằng ngày, theo số ngày 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

ForecastDay

Biểu thị bản ghi dự báo hằng ngày tại một vị trí nhất định.

Biểu diễn dưới dạng JSON 
{
  "interval": {
    object (Interval)
  },
  "displayDate": {
    object (Date)
  },
  "daytimeForecast": {
    object (ForecastDayPart)
  },
  "nighttimeForecast": {
    object (ForecastDayPart)
  },
  "maxTemperature": {
    object (Temperature)
  },
  "minTemperature": {
    object (Temperature)
  },
  "feelsLikeMaxTemperature": {
    object (Temperature)
  },
  "feelsLikeMinTemperature": {
    object (Temperature)
  },
  "maxHeatIndex": {
    object (Temperature)
  },
  "sunEvents": {
    object (SunEvents)
  },
  "moonEvents": {
    object (MoonEvents)
  },
  "iceThickness": {
    object (IceThickness)
  }
}
Trường
interval

object (Interval)

Khoảng thời gian theo giờ UTC khi ngày được dự báo này bắt đầu (bao gồm) và kết thúc (không bao gồm). Lưu ý: một ngày bắt đầu từ 7 giờ sáng và kết thúc vào 7 giờ sáng ngày hôm sau, theo giờ địa phương. Ví dụ: Nếu múi giờ địa phương là UTC-7, thì khoảng thời gian sẽ bắt đầu vào thời điểm 14:00:00.000Z và kết thúc vào cùng giờ vào ngày tiếp theo.
displayDate

object (Date)

Ngày theo 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 ngày 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.
daytimeForecast

object (ForecastDayPart)

Tình trạng thời tiết dự báo trong ngày (từ 7 giờ sáng đến 7 giờ tối theo giờ địa phương).
nighttimeForecast

object (ForecastDayPart)

Tình trạng thời tiết dự báo cho thời gian ban đêm (từ 7 giờ tối đến 7 giờ sáng ngày hôm sau, theo giờ địa phương).
maxTemperature

object (Temperature)

Nhiệt độ tối đa (cao) trong suốt cả ngày.
minTemperature

object (Temperature)

Nhiệt độ tối thiểu (thấp) trong suốt cả ngày.
feelsLikeMaxTemperature

object (Temperature)

Nhiệt độ cảm nhận tối đa (cao) trong suốt cả ngày.
feelsLikeMinTemperature

object (Temperature)

Nhiệt độ cảm nhận tối thiểu (thấp) trong suốt cả ngày.
maxHeatIndex

object (Temperature)

Nhiệt độ chỉ số nóng bức tối đa trong ngày.
sunEvents

object (SunEvents)

Các sự kiện liên quan đến mặt trời (ví dụ: bình minh, hoàng hôn).
moonEvents

object (MoonEvents)

Các sự kiện liên quan đến mặt trăng (ví dụ: trăng mọc, trăng lặn).
iceThickness

object (IceThickness)

Lượng băng tích luỹ trong cả ngày.

Ngày

Đại diện cho toàn bộ hoặc một phần ngày theo lịch, chẳng hạn như ngày sinh nhật. Thời gian trong ngày và múi giờ được chỉ định ở nơi khác hoặc không quan trọng. Ngày này có liên quan đến Lịch Gregorian. Giá trị này có thể biểu thị một trong những giá trị sau:

  • Một ngày đầy đủ, với các giá trị năm, tháng và ngày khác 0.
  • Tháng và ngày, với năm bằng 0 (ví dụ: ngày kỷ niệm).
  • Chỉ riêng giá trị năm, với giá trị tháng và ngày bằng 0.
  • Năm và tháng, với ngày bằng 0 (ví dụ: ngày hết hạn thẻ tín dụng).

Các loại có liên quan:

Biểu diễn dưới dạng JSON 
{
  "year": integer,
  "month": integer,
  "day": integer
}
Trường
year

integer

Năm của ngày. Giá trị phải từ 1 đến 9999 hoặc bằng 0 để chỉ định ngày không có năm.
month

integer

Tháng trong năm. Giá trị phải từ 1 đến 12 hoặc bằng 0 để chỉ định một năm không có tháng và ngày.
day

integer

Ngày trong tháng. Giá trị phải từ 1 đến 31 và có giá trị trong năm và tháng, hoặc bằng 0 để chỉ định giá trị năm, hoặc một năm và tháng, trong đó ngày là không quan trọng.

ForecastDayPart

Đại diện cho một bản ghi dự báo cho một phần trong ngày.

Biểu diễn dưới dạng JSON 
{
  "interval": {
    object (Interval)
  },
  "weatherCondition": {
    object (WeatherCondition)
  },
  "precipitation": {
    object (Precipitation)
  },
  "wind": {
    object (Wind)
  },
  "relativeHumidity": integer,
  "uvIndex": integer,
  "thunderstormProbability": integer,
  "cloudCover": integer
}
Trường
interval

object (Interval)

Ngày và giờ theo giờ UTC khi phần ngày này bắt đầu (bao gồm) và kết thúc (không bao gồm). Lưu ý: một phần của ngày bắt đầu lúc 7 giờ sáng và kết thúc lúc 7 giờ tối cùng ngày, theo giờ địa phương. Ví dụ: Nếu múi giờ địa phương là UTC-7, thì khoảng thời gian ban ngày sẽ bắt đầu vào lúc 14:00:00.000Z và kết thúc vào lúc 02:00:00.000Z ngày hôm sau, còn khoảng thời gian ban đêm sẽ bắt đầu vào lúc 02:00:00.000Z ngày hôm sau và kết thúc vào lúc 14:00:00.000Z cùng ngày.
weatherCondition

object (WeatherCondition)

Tình trạng thời tiết được dự báo.
precipitation

object (Precipitation)

Lượng mưa dự báo.
wind

object (Wind)

Hướng gió trung bình, tốc độ gió tối đa và gió giật.
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) tối đa được dự báo.
thunderstormProbability

integer

Xác suất có giông bão trung bình.
cloudCover

integer

Tỷ lệ phần trăm mây che phủ trung bình.

SunEvents

Biểu thị các sự kiện liên quan đến mặt trời (ví dụ: mặt trời mọc, mặt trời lặn).

Biểu diễn dưới dạng JSON 
{
  "sunriseTime": string,
  "sunsetTime": string
}
Trường
sunriseTime

string (Timestamp format)

Thời điểm mặt trời mọc.

LƯU Ý: Trong một số trường hợp đặc biệt (ví dụ: phía bắc vòng Bắc Cực), có thể không có thời gian mặt trời mọc trong một ngày. Trong những trường hợp này, trường này sẽ không được đặt.

Sử dụng RFC 3339, trong đó đầu ra được tạo sẽ luôn được chuẩn hoá theo Z và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các độ dời khác ngoài "Z" cũng được chấp nhận. Ví dụ: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" hoặc "2014-10-02T15:01:23+05:30".
sunsetTime

string (Timestamp format)

Thời điểm mặt trời lặn.

LƯU Ý: Trong một số trường hợp đặc biệt (ví dụ: phía bắc vòng Bắc Cực), có thể không có thời gian mặt trời lặn trong một ngày. Trong những trường hợp này, trường này sẽ không được đặt.

Sử dụng RFC 3339, trong đó đầu ra được tạo sẽ luôn được chuẩn hoá theo Z và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các độ dời khác ngoài "Z" cũng được chấp nhận. Ví dụ: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" hoặc "2014-10-02T15:01:23+05:30".

MoonEvents

Biểu thị các sự kiện liên quan đến mặt trăng (ví dụ: trăng mọc, trăng lặn).

Biểu diễn dưới dạng JSON 
{
  "moonriseTimes": [
    string
  ],
  "moonsetTimes": [
    string
  ],
  "moonPhase": enum (MoonPhase)
}
Trường
moonriseTimes[]

string (Timestamp format)

Thời điểm khi phần trên của mặt trăng xuất hiện phía trên đường chân trời (xem https://en.wikipedia.org/wiki/Moonrise_and_moonset).

LƯU Ý: Trong hầu hết các trường hợp, mỗi ngày sẽ có một thời điểm trăng mọc. Trong các trường hợp khác, danh sách có thể trống (ví dụ: khi mặt trăng mọc sau nửa đêm ngày tiếp theo). Tuy nhiên, trong một số trường hợp đặc biệt (ví dụ: ở các vùng cực), danh sách này có thể chứa nhiều giá trị. Trong những trường hợp này, các giá trị được sắp xếp theo thứ tự tăng dần.

Sử dụng RFC 3339, trong đó đầu ra được tạo sẽ luôn được chuẩn hoá theo Z và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các độ dời khác ngoài "Z" cũng được chấp nhận. Ví dụ: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" hoặc "2014-10-02T15:01:23+05:30".
moonsetTimes[]

string (Timestamp format)

Thời điểm khi phần trên của mặt trăng khuất dưới đường chân trời (xem https://en.wikipedia.org/wiki/Moonrise_and_moonset).

LƯU Ý: Trong hầu hết các trường hợp, mỗi ngày sẽ có một thời điểm trăng lặn. Trong các trường hợp khác, danh sách có thể trống (ví dụ: khi mặt trăng lặn sau nửa đêm ngày tiếp theo). Tuy nhiên, trong một số trường hợp đặc biệt (ví dụ: ở các vùng cực), danh sách này có thể chứa nhiều giá trị. Trong những trường hợp này, các giá trị được sắp xếp theo thứ tự tăng dần.

Sử dụng RFC 3339, trong đó đầu ra được tạo sẽ luôn được chuẩn hoá theo Z và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các độ dời khác ngoài "Z" cũng được chấp nhận. Ví dụ: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" hoặc "2014-10-02T15:01:23+05:30".
moonPhase

enum (MoonPhase)

Tuần trăng (còn gọi là tuần âm lịch).

MoonPhase

Đánh dấu tuần trăng (còn gọi là tuần trăng).

Enum
MOON_PHASE_UNSPECIFIED Tuần trăng không xác định.
NEW_MOON Mặt trăng không được mặt trời chiếu sáng.
WAXING_CRESCENT Mặt trăng được chiếu sáng từ 0% đến 50% ở phía bên phải ở Bắc bán cầu 🌒 và ở phía bên trái ở Nam bán cầu 🌘.
FIRST_QUARTER Mặt trăng được chiếu sáng 50,1% ở bên phải ở Bắc bán cầu 🌓 và ở bên trái ở Nam bán cầu 🌗.
WAXING_GIBBOUS Mặt trăng được chiếu sáng từ 50% đến 100% ở bên phải ở bán cầu bắc 🌔 và ở bên trái ở bán cầu nam 🌖.
FULL_MOON Mặt trăng được chiếu sáng hoàn toàn.
WANING_GIBBOUS Mặt trăng được chiếu sáng từ 50% đến 100% ở phía bên trái ở bán cầu bắc 🌖 và ở phía bên phải ở bán cầu nam 🌔.
LAST_QUARTER Mặt trăng được chiếu sáng 50,1% ở phía bên trái ở bán cầu bắc 🌗 và ở phía bên phải ở bán cầu nam 🌓.
WANING_CRESCENT Mặt trăng được chiếu sáng từ 0% đến 50% ở phía bên trái ở bán cầu bắc 🌘 và ở phía bên phải ở bán cầu nam 🌒.