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 lượng mưa theo từng phút với độ phân giải cao (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 đây trong khoảng thời gian 6 giờ:

  • Thời gian bắt đầu và kết thúc của khoảng 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à kết thúc của từng phân đoạn dự báo
  • Loại, khả năng, số lượng và cường độ dự đoán của lượng mưa trong từng phân đ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ụ trước khi phát hành rộng rãi) trong Điều khoản riêng dành cho dịch vụ của Nền tảng Google Maps, 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 ghi công cho Google theo Tài liệu nếu Khách hàng sử dụng Nội dung của 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 của 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 của Google Maps áp dụng từ Weather API trong Khoảng thời gian lưu vào bộ nhớ đệm áp dụng, 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)

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

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

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

Để yêu cầu thông tin dự báo theo từng 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

Bao gồm toạ độ vĩ độ và kinh độ của vị trí trong các tham số yêu cầu.

Các tham số trong 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ạ độ vĩ độ của vị trí được yêu cầu. Bắt buộc
location.longitude Toạ độ 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 không có hệ thống đơn vị nào được chỉ định, 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 chuyể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ác phản hồi dự báo theo từng phút

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

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

Ví dụ về thông tin dự báo theo từng phút

Ví dụ sau đây yêu cầu thông tin dự báo theo từng 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 khoảng 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"
    },
    ...
  ]
}