Tổng quan về API Thời tiết

Weather API cho phép bạn yêu cầu dữ liệu thời tiết theo thời gian thực, theo từng khu vực cụ thể cho các vị trí trên khắp thế giới để cung cấp thông tin cho trang tổng quan thời tiết trực tiếp, ứng dụng cập nhật thời tiết, lớp phủ thời tiết trên tuyến đường và trình theo dõi sức khoẻ hoặc hoạt động dựa trên thời tiết. Thông tin thời tiết bao gồm nhiệt độ hiện tại, lượng mưa, độ ẩm tương đối, tốc độ gió, chỉ số UV và nhiều thông tin khác.

Đối với một vị trí ở vĩ độ và kinh độ nhất định, API sẽ cung cấp các điểm cuối (https://weather.googleapis.com/v1/...) cho dữ liệu trong bảng sau.

Xem nhanh các điểm cuối REST

Điểm cuối của API URL Mô tả Tham số được ghi lại
Tình trạng hiện tại https://weather.googleapis.com/v1/currentConditions:lookup Điều kiện thời tiết trực tiếp location.latitude, location.longitude
Dự báo hằng giờ https://weather.googleapis.com/v1/forecast/hours:lookup Dự báo tình hình thời tiết trong tối đa 240 giờ location.latitude, location.longitude
Dự báo hằng ngày https://weather.googleapis.com/v1/forecast/days:lookup Dự báo tình trạng thời tiết trong tối đa 10 ngày location.latitude, location.longitude
Nhật ký theo giờ https://weather.googleapis.com/v1/history/hours:lookup Lưu vào bộ nhớ đệm dữ liệu về tình trạng trong quá khứ (tối đa 24 giờ) location.latitude, location.longitude
Cảnh báo thời tiết khắc nghiệt https://weather.googleapis.com/v1/publicAlerts:lookup Cảnh báo thời tiết khắc nghiệt key, location.latitude, location.longitude

Các trường hợp sử dụng phổ biến

Các tính năng của Weather API

Dữ liệu của Weather API bao gồm:

  • Điều kiện thời tiết và biểu tượng: Nội dung mô tả và biểu tượng tương ứng cho biết điều kiện thời tiết hiện tại (ví dụ: "Nhiều mây" hoặc "Mưa tuyết rải rác") bằng weatherCondition.
  • Nhiệt độ: Nhiệt độ hiện tại (temperature), nhiệt độ tối thiểu và tối đa (minTemperature và maxTemperature trong thông tin dự báo hằng ngày hoặc trong currentConditionsHistory), và nhiệt độ biểu kiến ("nhiệt độ cảm nhận") (feelsLikeTemperature).
  • Lượng mưa: Tổng lượng mưa và loại mưa (tuyết, mưa, băng, hỗn hợp).
  • Gió: Nhiệt độ gió lạnh (windChill), hướng gió (wind.direction), tốc độ gió (wind.speed) và gió giật (wind.gust).
  • Độ dày của băng: Độ dày của băng.
  • Độ ẩm: Điểm sương (dewPoint), chỉ số nhiệt (heatIndex), nhiệt độ bầu ướt (wetBulbTemperature) và độ ẩm tương đối (relativeHumidity).
  • Chỉ số UV: Chỉ số tia cực tím (UV) (uvIndex).
  • Xác suất có giông bão: Phần trăm khả năng xảy ra giông bão.
  • Tầm nhìn: Khoảng cách mà bạn có thể nhìn thấy rõ một vật thể.
  • Áp suất không khí: Áp suất không khí trung bình ở mực nước biển.
  • Sự kiện mặt trời và mặt trăng: Thời gian mặt trời mọc, mặt trời lặn, mặt trăng mọc và mặt trăng lặn.
  • Độ che phủ của mây: Tỷ lệ phần trăm bầu trời bị mây che phủ.

Cách sử dụng Weather API

1 Thiết lập Bắt đầu bằng cách Thiết lập dự án Google Cloud và hoàn tất các hướng dẫn sau đây.
2 Xem tình hình hiện tại Xem phần Lấy điều kiện hiện tại.
3 Xem thông tin dự báo hằng giờ Xem phần Xem thông tin dự báo hằng giờ.
4 Nhận thông tin dự báo hằng ngày Xem phần Nhận thông tin dự báo hằng ngày.
5 Xem nhật ký hằng giờ Xem phần Xem nhật ký theo giờ.
6 Nhận cảnh báo thời tiết Xem phần Nhận thông báo về thời tiết.

Đối với chỉ số chất lượng không khí (AQI) và các chất ô nhiễm dạng hạt (PM2.5, PM10), hãy sử dụng Air Quality API (https://airquality.googleapis.com/v1/currentConditions:lookup). Weather API không trả về các giá trị này.

Các API môi trường có liên quan khác bao gồm:

  • Lượng phấn hoa: Pollen API (https://pollen.googleapis.com/v1/forecast:lookup)
  • Bức xạ mặt trời và tiềm năng tạo năng lượng mặt trời trên mái nhà: Solar API (https://solar.googleapis.com/v1/buildingInsights:findClosest)

Bước tiếp theo