Tổng quan về API Chất lượng không khí
Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang
Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
Air Quality API cho phép bạn yêu cầu dữ liệu về chất lượng không khí cho một vị trí cụ thể, bao gồm hơn 70 chỉ số chất lượng không khí (AQI), chất gây ô nhiễm và khuyến nghị về sức khoẻ. Mô hình này bao phủ hơn 100 quốc gia với độ phân giải 500 x 500 mét.
Lý do nên sử dụng Air Quality API
API này cung cấp các điểm cuối cho phép bạn truy vấn:
- Tình trạng hiện tại: Thông tin theo giờ về chất lượng không khí theo thời gian thực.
- Nhật ký hằng giờ: Nhật ký chất lượng không khí của một địa điểm cụ thể, trong một phạm vi thời gian nhất định, tối đa 30 ngày.
- Bản đồ nhiệt: Các ô được mã hoá bằng màu sắc của nhiều chỉ số và chất ô nhiễm.
- Dự báo hằng giờ: Tình trạng chất lượng không khí trong tương lai cho một địa điểm cụ thể, tối đa 96 giờ (4 ngày).
Các tính năng của Air Quality API
- Chỉ số và danh mục chất lượng không khí theo thời gian thực: Air Quality API liên tục tính toán giá trị của nhiều chỉ số chất lượng không khí với độ phân giải 500 x 500 mét.
- Đề xuất về sức khoẻ: Hàng trăm đề xuất về sức khoẻ dựa trên nghiên cứu dành cho cộng đồng nói chung và các nhóm nhạy cảm, bao gồm: trẻ em, người cao tuổi, phụ nữ mang thai, vận động viên và người mắc bệnh hen suyễn hoặc bệnh tim.
- Thông tin chi tiết về chất gây ô nhiễm: Thông tin chuyên sâu về các chất gây ô nhiễm, nêu bật chất gây ô nhiễm chính, nồng độ, nguồn và tác động.
- Nhật ký theo giờ: Nhật ký chất lượng không khí của một vị trí cụ thể trong một phạm vi thời gian nhất định. Mỗi phản hồi có thể bao gồm chỉ số chất lượng không khí theo giờ, dữ liệu về chất gây ô nhiễm và các khuyến nghị về sức khoẻ trong tối đa 720 giờ (30 ngày).
- Bản đồ nhiệt: Bản đồ nhiệt là một tập hợp các ô hình ảnh chỉ số chất lượng không khí và chất gây ô nhiễm có thể hiển thị ở trên cùng của Google Maps.
Nếu địa chỉ thanh toán của bạn ở Khu vực kinh tế Châu Âu (EEA), bạn có thể hiển thị bản đồ nhiệt trên mọi bản đồ.
Tìm hiểu thêm.
- Dự báo theo giờ: Tình trạng chất lượng không khí trong tương lai tại một địa điểm cụ thể, trong một khoảng thời gian nhất định hoặc vào một giờ cụ thể trong tương lai, tối đa 96 giờ (4 ngày). Mỗi phản hồi có thể bao gồm chỉ số dự báo chất lượng không khí theo giờ, dữ liệu về chất gây ô nhiễm và các đề xuất hữu ích.
Cách hoạt động của Air Quality API
Air Quality API có các phương thức sau:
currentConditions: Điểm cuối currentConditions cung cấp thông tin về chất lượng không khí theo giờ hiện tại.
history: Điểm cuối history cung cấp thông tin về chất lượng không khí theo giờ trong quá khứ cho một vị trí cụ thể, trong một phạm vi thời gian nhất định, tối đa là 30 ngày.
heatmapTiles: Điểm cuối heatmapTiles cung cấp bản đồ nhiệt liên quan đến chất lượng không khí thông qua một lớp phủ ô.
forecast: Điểm cuối forecast cung cấp thông tin về chất lượng không khí trong tương lai theo giờ cho một vị trí cụ thể, trong một khoảng thời gian nhất định, tối đa là 96 giờ (4 ngày).
Phạm vi cung cấp Air Quality API theo quốc gia và khu vực
Hãy xem Các quốc gia được hỗ trợ và AQI có sẵn của Air Quality API để biết thông tin mới nhất về phạm vi cung cấp theo từng quốc gia, trong đó có thông tin về chất lượng không khí (AQI) và thông tin về chất lượng không khí tại địa phương (LAQI).
Cách sử dụng Air Quality API
Bước tiếp theo
Trừ phi có lưu ý khác, nội dung của trang này được cấp phép theo Giấy phép ghi nhận tác giả 4.0 của Creative Commons và các mẫu mã lập trình được cấp phép theo Giấy phép Apache 2.0. Để biết thông tin chi tiết, vui lòng tham khảo Chính sách trang web của Google Developers. Java là nhãn hiệu đã đăng ký của Oracle và/hoặc các đơn vị liên kết với Oracle.
Cập nhật lần gần đây nhất: 2025-08-31 UTC.
[null,null,["Cập nhật lần gần đây nhất: 2025-08-31 UTC."],[[["\u003cp\u003eThe Air Quality API provides access to real-time, historical, and forecasted air quality data for over 100 countries with a resolution of 500 x 500 meters.\u003c/p\u003e\n"],["\u003cp\u003eYou can retrieve current conditions, hourly history (up to 30 days), heatmaps, and hourly forecasts (up to 96 hours) using the API.\u003c/p\u003e\n"],["\u003cp\u003eThe API includes various air quality indexes, health recommendations, pollutant details, and heatmap tile overlays.\u003c/p\u003e\n"],["\u003cp\u003eCoverage details and available air quality indexes vary by country and region, so refer to the provided resources for specific information.\u003c/p\u003e\n"],["\u003cp\u003eTo use the Air Quality API, you need to set up a Google Cloud project and then utilize the provided endpoints and documentation to retrieve air quality data.\u003c/p\u003e\n"]]],["The Air Quality API provides real-time and historical air quality data, forecasts, and heatmaps for over 100 countries with 500x500 meter resolution. Key actions include querying current conditions, accessing up to 30 days of hourly history, viewing color-coded heatmap tiles, and obtaining up to 96-hour hourly forecasts. The API delivers information on 70+ AQIs, pollutants, and health recommendations for various groups, leveraging methods such as `currentConditions`, `history`, `heatmapTiles`, and `forecast`.\n"],null,["The Air Quality API lets you request air quality data for a specific location,\nincluding over 70 air quality indexes (AQIs), pollutants, and health\nrecommendations. It covers over 100 countries with a resolution of 500 x 500\nmeters.\n\nWhy use the Air Quality API\n\nThe API provides endpoints that let you query:\n\n- **Current Conditions:** Real-time hourly air quality information.\n- **Hourly History:** Air quality history for a specific location, for a given time range, up to a maximum of 30 days.\n- **Heatmaps:** Color coded tiles of various indexes and pollutants.\n- **Hourly Forecast:** Future air quality conditions for a specific location, up to 96 hours (4 days).\n\nFeatures of the Air Quality API\n\n- **Real-time air quality indexes and categories:** The Air Quality API continuously calculates the value of various air quality indexes with 500 x 500 meters resolution.\n- **Health recommendations:** Hundreds of research-backed health recommendations for the general public and sensitivity groups including: children, elderly, pregnant women, athletes and those with asthma or heart conditions.\n- **Pollutant details:** In-depth information about different pollutants, highlighting the dominant pollutant, concentrations, sources and effects.\n- **Hourly history:** Air quality history for a specific location for a given time range. Each response potentially includes hourly air quality indexes, pollutant data, and health recommendations for a maximum of 720 hours (30 days).\n- **Heatmaps:** Heatmaps are a collection of AQ indexes and pollutants image tiles that can be displayed on top of a Google Map. If your billing address is in the European Economic Area (EEA), you may display heatmaps on top of any map. [Learn more](/maps/comms/eea/faq#tos-updates).\n- **Hourly forecast:** Future air quality conditions for a specific location, and for a given time range or for a particular hour in the future, up to 96 hours (4 days). Each response potentially includes hourly air quality forecast indexes, pollutant data and actionable recommendations.\n\nHow the Air Quality API works\n\nThe Air Quality API has the following methods:\n\n- **currentConditions** : The\n [`currentConditions`](/maps/documentation/air-quality/reference/rest/v1/currentConditions/lookup) endpoint\n provides current hourly air quality information.\n\n- **history** : The\n [`history`](/maps/documentation/air-quality/reference/rest/v1/history/lookup) endpoint provides\n historical hourly air quality information for a specific location, for a\n given time range, up to a maximum of 30 days.\n\n- **heatmapTiles** : The [`heatmapTiles`](/maps/documentation/air-quality/reference/rest/v1/mapTypes.heatmapTiles/lookupHeatmapTile)\n endpoint provides air quality related heatmaps through a tile overlay.\n\n- **forecast** : The [`forecast`](/maps/documentation/air-quality/reference/rest/v1/forecast/lookup)\n endpoint provides hourly future air quality information for a specific\n location, for a given time range, up to a maximum of 96 hours (4 days).\n\nAir Quality API country and region coverage\n\nSee [Air Quality API supported countries and available AQIs](/maps/documentation/air-quality/coverage) for the\nlatest coverage details, on a country-by-country basis, for which air quality\ninformation (AQI) and local air quality information (LAQI) is available.\n\nHow to use the Air Quality API\n\n|---|-------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------|\n| 1 | **Get set up** | Start with [Set up your Google Cloud project](/maps/documentation/air-quality/cloud-setup) and complete the instructions that follow. |\n| 2 | **Get current hourly air quality information** | See [Current conditions](/maps/documentation/air-quality/current-conditions). |\n| 3 | **Get hourly air-quality history** | See [History](/maps/documentation/air-quality/history). |\n| 4 | **Get air quality related heatmaps through a tile overlay** | See [Heatmaps](/maps/documentation/air-quality/heatmaps). |\n| 5 | **Get hourly air quality forecast information** | See [Forecast](/maps/documentation/air-quality/forecast). |\n\nWhat's next\n\n- [Set up your Google Cloud project](/maps/documentation/air-quality/cloud-setup)\n- [Get current conditions](/maps/documentation/air-quality/current-conditions)\n- [Get hourly history](/maps/documentation/air-quality/history)\n- [Get heatmaps](/maps/documentation/air-quality/heatmaps)\n- [Get hourly forecast](/maps/documentation/air-quality/forecast)"]]
