Xem thông tin dự báo theo phút (Thử nghiệm)

Điểm cuối forecast:minutes cung cấp thông tin dự báo mưa có độ phân giải cao theo từng phút (còn gọi là dự báo hiện tại) cho một vị trí nhất định.

API này trả về thông tin sau trong khoảng thời gian 6 giờ:

  • Thời gian bắt đầu và kết thúc của khung thời gian dự đoán
  • Múi giờ của vị trí được yêu cầu
  • Thời gian bắt đầu và thời gian kết thúc của từng phân đoạn dự báo
  • Loại, khả năng xảy ra, lượng và cường độ mưa dự đoán trong mỗi đoạn

Điều khoản

Các điều khoản này được ban hành theo Mục 6 (Điều khoản dành cho sản phẩm/dịch vụ ở giai đoạn trước khi phát hành rộng rãi) trong Điều khoản dành riêng cho dịch vụ của Google Maps Platform, theo thoả thuận giữa Google và bạn.

1.1 Yêu cầu về việc ghi công. Khách hàng phải cung cấp thông tin ghi nhận quyền tác giả cho Google theo Tài liệu nếu Khách hàng sử dụng Nội dung trên Google Maps từ Weather API.

1.2 Các hạn chế. Khách hàng không thể sử dụng Nội dung trên Google Maps được truy xuất từ Weather API để tạo lại một dịch vụ hoặc sản phẩm của Google (ví dụ: sử dụng dữ liệu được truy xuất từ Weather API trong một ứng dụng thời tiết hoặc mô hình thời tiết có mục đích chính là cung cấp thông tin thời tiết).

1.3 Lưu vào bộ nhớ đệm. Khách hàng có thể tạm thời lưu vào bộ nhớ đệm Nội dung Google Maps hiện hành từ Weather API trong Khoảng thời gian lưu vào bộ nhớ đệm hiện hành, như mô tả trong Bảng 1.3.1 (Quyền lưu vào bộ nhớ đệm).

Bảng 1.3.1 (Quyền lưu vào bộ nhớ đệm)

Những quyền này bổ sung cho các quyền được mô tả trong Bảng 17.2.1 của Điều khoản dành riêng cho dịch vụ của Google Maps Platform.

Nội dung trên Google Maps Khoảng thời gian lưu vào bộ nhớ đệm
Giá trị dự báo theo phút Một giờ, sau đó Khách hàng phải xoá Nội dung được lưu vào bộ nhớ đệm của Google Maps

Giới thiệu về yêu cầu dự báo theo phút

Để yêu cầu thông tin dự báo theo phút, hãy gửi yêu cầu GET HTTP đến:

https://weather.googleapis.com/v1/forecast/minutes:lookup?key=API_KEY&location.latitude=LATITUDE&location.longitude=LONGITUDE

Thêm toạ độ vĩ độ và kinh độ của vị trí vào các thông số yêu cầu.

Tham số yêu cầu

Điểm cuối forecast.minutes chấp nhận các tham số yêu cầu sau:

Tham số Mô tả Bắt buộc hoặc không bắt buộc
location.latitude Toạ độ theo vĩ độ của vị trí được yêu cầu. Bắt buộc
location.longitude Toạ độ theo kinh độ của vị trí được yêu cầu. Bắt buộc
unitsSystem Hệ thống đơn vị được yêu cầu. Các giá trị bao gồm:
  • UNITS_SYSTEM_UNSPECIFIED
  • IMPERIAL
  • METRIC

Nếu bạn không chỉ định hệ thống đơn vị, thì phản hồi sẽ mặc định là METRIC.

 Không bắt buộc
pageSize Chỉ định số lượng kết quả tối đa cần trả về. Không bắt buộc
pageToken Mã thông báo trang nhận được từ một yêu cầu trước đó. Để truy xuất trang dữ liệu tiếp theo, hãy truyền pageToken làm tham số đầu vào trong yêu cầu tiếp theo. Không bắt buộc

Giới thiệu về câu trả lời dự báo theo phút

Weather API trả về các trường sau trong phần nội dung phản hồi:

Trường Mô tả
overallPredictionTimeframe Khung thời gian tổng thể cho thông tin dự đoán.
overallPredictionTimeframe.startTime Thời gian bắt đầu của khung thời gian dự đoán. Điều này phản ánh điểm tham chiếu ban đầu.
overallPredictionTimeframe.endTime Thời gian kết thúc của khung thời gian dự đoán. Thời gian này được đặt sau thời gian bắt đầu 6 giờ.
timeZone Múi giờ của vị trí được yêu cầu.
segments Các phân đoạn dự đoán ở cấp độ phút, được biểu thị bằng timeFrame.
segments.timeFrame Khung thời gian liên quan đến phân khúc.
segments.timeFrame.startTime Thời gian bắt đầu của phân đoạn.
segments.timeFrame.endTime Thời gian kết thúc của phân đoạn.
segments.type Loại hình lượng mưa dự đoán trong phân đoạn đó. Bao gồm các giá trị sau:
  • DOMINANT_PRECIPITATION_TYPE_UNSPECIFIED
  • NONE
  • RAIN
  • SNOW
  • HAIL
segments.probability Khả năng mưa dự kiến trong khoảng thời gian đó. Giá trị được tính bằng tỷ lệ phần trăm trong khoảng từ 0 đến 100.
segments.qpf Thông tin dự báo lượng mưa.
segments.qpf.quantity Lượng mưa dự kiến trong khoảng thời gian đó.
segments.qpf.unit Đơn vị dùng để đo lượng mưa tích luỹ (ví dụ: MILLIMETERS, INCHES).
segments.snowfallAmount Lượng tuyết dự kiến trong đoạn đường đó.
segments.snowfallAmount.quantity Lượng tuyết dự đoán (tương đương với nước lỏng) trong đoạn đó.
segments.snowfallAmount.unit Đơn vị dùng để đo lượng tuyết tích tụ (ví dụ: MILLIMETERS, INCHES).
segments.intensity Cường độ mưa của phân đoạn. Bao gồm các giá trị sau:
  • PRECIPITATION_INTENSITY_UNSPECIFIED
  • NO_INTENSITY
  • LIGHT
  • MODERATE
  • HEAVY
nextPageToken Một mã thông báo có thể được gửi dưới dạng pageToken để truy xuất trang tiếp theo. Nếu bạn bỏ qua trường này, thì sẽ không có trang tiếp theo.

Ví dụ về dự báo theo phút

Ví dụ sau đây yêu cầu thông tin dự báo theo phút cho một vị trí ở Tây Virginia:

curl -H "Content-Type: application/json" -X GET "https://weather.googleapis.com/v1/forecast/minutes:lookup?key=API_KEY&location.latitude=37.60451&location.longitude=-80.59044&unitsSystem=METRIC&pageSize=5"

Trong phản hồi, đối tượng segments cho biết từng phân đoạn của khung thời gian dự đoán tổng thể:

  {
  "overallPredictionTimeframe": {
    "startTime": "2026-05-11T12:10:00Z",
    "endTime": "2026-05-11T18:12:00Z"
  },
  "timeZone": {
    "id": "America/New_York"
  },
  "segments": [
    {
      "timeFrame": {
        "startTime": "2026-05-11T12:20:00Z",
        "endTime": "2026-05-11T12:22:00Z"
      },
      "type": "RAIN",
      "probability": 21,
      "qpf": {
        "quantity": 0.1333,
        "unit": "MILLIMETERS"
      },
      "snowfallAmount": {
        "quantity": 0.0,
        "unit": "MILLIMETERS"
      },
      "intensity": "MODERATE"
    },
    {
      "timeFrame": {
        "startTime": "2026-05-11T12:22:00Z",
        "endTime": "2026-05-11T12:24:00Z"
      },
      "type": "RAIN",
      "probability": 21,
      "qpf": {
        "quantity": 0.1333,
        "unit": "MILLIMETERS"
      },
      "snowfallAmount": {
        "quantity": 0.0,
        "unit": "MILLIMETERS"
      },
      "intensity": "MODERATE"
    },
    ...
  ]
}