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, có độ 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 cho khung 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à kết thúc của mỗi phân đoạn dự báo
  • Loại, khả năng, lượng và cường độ mưa dự kiến trong mỗi 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ụ ở 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ề thông tin ghi công. Khách hàng phải cung cấp cho Google thông tin ghi nhận tác giả 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 Quy định hạn chế. Khách hàng không được 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ể lưu tạm Nội dung Google Maps hiện hành từ Weather API trong 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)

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 dành riêng cho dịch vụ Google Maps Platform.

Nội dung trên Google Maps 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 trên Google Maps đã lưu vào bộ nhớ đệm

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 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. Bao gồm các giá trị sau:
  • 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 truyền pageToken dưới dạng tham số đầu vào trong yêu cầu tiếp theo. Không bắt buộc

Giới thiệu về phản hồi dự báo theo phút

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

Trường Mô tả
overallPredictionTimeframe Khung thời gian tổng thể cho các cụm từ gợi ý.
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 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 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 mưa dự kiế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 có mưa được dự đoán trong khoảng thời gian đó. Giá trị là tỷ lệ phần trăm từ 0 đến 100.
segments.qpf Dự báo lượng mưa định lượng.
segments.qpf.quantity Lượng mưa dự kiến trong phân đoạn đó.
segments.qpf.unit Đơn vị dùng để đo lượng mưa tích tụ (ví dụ: MILLIMETERS, INCHES).
segments.snowfallAmount Lượng tuyết dự kiến trong phân đoạn đó.
segments.snowfallAmount.quantity Lượng tuyết dự kiến (tương đương với nước lỏng) trong phân đ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 (PrecipitationIntensity). Các giá trị bao gồm:
  • PRECIPITATION_INTENSITY_UNSPECIFIED
  • NO_INTENSITY
  • MID_LIGHT
  • LIGHT
  • MID_MODERATE
  • MODERATE
  • MID_HEAVY
  • HEAVY

Lưu ý: Đảm bảo rằng ứng dụng của bạn có thể xử lý các giá trị không xác định.

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ó trang tiếp theo.

Ví dụ về thông tin 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"
    },
    ...
  ]
}