Đ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:
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à |
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:
|
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:
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" }, ... ] }