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ị đ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 hằng ngày 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 đó. Tham số này được dùng để truy xuất trang tiếp theo.
days

integer

Không bắt buộc. Giới hạn số ngày cần tìm nạp kể từ ngày hiện tại – một giá trị từ 1 đến 10 (bao gồm cả 1 và 10). 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 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 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)

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ị một 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)
  }
}
Trường
interval

object (Interval)

Khoảng thời gian theo giờ UTC khi ngày 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 gian 14:00:00.000Z và kết thúc vào cùng giờ ngày hôm sau.
displayDate

object (Date)

Ngày đị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 cho ban ngày (từ 7 giờ sáng đến 7 giờ tối theo giờ địa phương).
nighttimeForecast

object (ForecastDayPart)

Điều kiện thời tiết dự báo cho thời gian ban đêm trong ngày (từ 19:00 đến 7:00 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ụ: thời điểm mặt trăng mọc, thời điểm mặt trăng lặn).

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 Dương lịch. Nội dung này có thể đại diện cho một trong những nội dung 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 giá trị 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 giá trị 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 từ 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 một 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 khoảng thời gian trong ngày.

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

object (Interval)

Ngày và giờ theo giờ UTC khi phần này trong ngà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 từ 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 thời gian 14:00:00.000Z và kết thúc vào 02:00:00.000Z ngày hôm sau, còn khoảng thời gian ban đêm sẽ bắt đầu vào 02:00:00.000Z ngày hôm sau và kết thúc vào 14:00:00.000Z cùng ngày.
weatherCondition

object (WeatherCondition)

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

object (Precipitation)

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

object (Wind)

Hướng gió trung bình, tốc độ tối đa và gió giật.
iceThickness

object (IceThickness)

Tổng lượng băng trong một phần của ngày.
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ố cực tím (UV) dự báo tối đa.
thunderstormProbability

integer

Xác suất trung bình có bão kèm theo sấm sét.
cloudCover

integer

Tỷ lệ 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ụ: bình minh, hoàng hô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.

Hãy dùng RFC 3339, trong đó dữ liệu đầu ra được tạo sẽ luôn được chuẩn hoá theo múi giờ và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các khoảng lệch 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.

Hãy dùng RFC 3339, trong đó dữ liệu đầu ra được tạo sẽ luôn được chuẩn hoá theo múi giờ và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các khoảng lệch 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ụ: mặt trăng mọc, mặt 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 phần trên của mặt trăng xuất hiện 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 mặt 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 những 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.

Hãy dùng RFC 3339, trong đó dữ liệu đầu ra được tạo sẽ luôn được chuẩn hoá theo múi giờ và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các khoảng lệch 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 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 mặt trăng lặn. Trong những trường hợp khác, danh sách này 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 những 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.

Hãy dùng RFC 3339, trong đó dữ liệu đầu ra được tạo sẽ luôn được chuẩn hoá theo múi giờ và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các khoảng lệch 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)

Chu kỳ của mặt trăng (còn gọi là pha mặt trăng).

MoonPhase

Đánh dấu chu kỳ mặt trăng (còn gọi là pha mặt trăng).

Enum
MOON_PHASE_UNSPECIFIED Chu kỳ mặt 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% ở bên phải tại Bắc bán cầu 🌒 và ở bên trái tại Nam bán cầu 🌘.
FIRST_QUARTER Mặt trăng được chiếu sáng 50,1% ở bên phải tại bán cầu bắc 🌓 và ở bên trái tại bán cầu nam 🌗.
WAXING_GIBBOUS Mặt trăng được chiếu sáng từ 50% đến 100% ở bên phải tại bán cầu bắc 🌔 và ở bên trái tạ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 tại bán cầu bắc 🌖 và ở phía bên phải tạ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 tại bán cầu bắc 🌗 và ở phía bên phải tại bán cầu nam 🌓.
WANING_CRESCENT Mặt trăng được chiếu sáng từ 0% đến 50% ở bên trái tại bán cầu bắc 🌘 và ở bên phải tại bán cầu nam 🌒.