Italy Air Quality API

Real-time air quality and 48-hour forecasts for all Italian cities. Returns AQI, PM2.5, PM10, NO2, O3 and SO2. Data from ARPA regional stations + Copernicus CAMS.

覆盖意大利所有城市的实时空气质量数据与48小时预报。返回空气质量指数（AQI, Air Quality Index）、PM2.5、PM10、NO2、O3及SO2。数据源自意大利区域环境保护局（ARPA）的区域监测站点与哥白尼大气监测服务（Copernicus CAMS）。

原始信息汇总

Italy Air Quality API 数据集概述

数据集基本信息

• 数据集名称: Italy Air Quality API
• 类别: Weather
• 提供者: Emilio
• 订阅者数量: 1
• 访问地址: https://rapidapi.com/emiliomerenda10/api/italy-air-quality-api

数据内容与覆盖范围

• 数据描述: 提供意大利主要城市的实时空气质量数据和48小时预报。
• 数据来源:
  • ARPA区域地面站（测量实际空气的物理传感器）。
  • Copernicus CAMS欧洲模型（欧盟官方空气质量警报使用的同一模型）。
  • 对于伦巴第大区的城市，优先使用ARPA传感器数据。对于所有其他城市，或在没有监测站覆盖的情况下，API会自动回退到CAMS模型数据。
• 覆盖范围: 约100个意大利城市，覆盖所有大区。
• 数据获取: 无需API密钥即可调用获取数据。

提供的数据指标

• 欧洲标准的空气质量指数（AQI，范围0–500）及对应的通俗类别描述。
• PM2.5、PM10、NO2、O3、SO2的浓度值，并包含世界卫生组织（WHO）的安全限值。
• 主要污染物（即当天驱动AQI指数的主要污染物）。
• 长达48小时的每小时预报数据。
• 附近ARPA物理监测站列表。

典型应用场景

• 空气质量应用程序。
• 旅行应用程序。
• 健康仪表板。
• 智能家居集成。
• 环境监测。

API端点与使用方法

1. 查找城市

• 端点: GET /cities
• 功能: 通过城市名称（完整或部分）查询，获取对应的city_id等信息。
• 示例请求: GET /cities?q=Roma
• 返回示例: [ { "city_id": "roma", "name": "Roma", "region": "Lazio", "lat": 41.9028, "lon": 12.4964 } ]

2. 获取当前空气质量

• 端点: GET /current
• 功能: 根据city_id获取指定城市的实时空气质量数据。
• 示例请求: GET /current?city_id=roma
• 返回数据包含字段: city_id, city_name, measured_at, aqi_eu, aqi_category, dominant_pollutant, pollutants (包含各污染物数值、单位及WHO限值), source。

3. 获取空气质量预报

• 端点: GET /forecast
• 功能: 根据city_id获取指定城市未来最多48小时的空气质量每小时预报。
• 参数: hours（可选，默认24，最大48）。
• 示例请求: GET /forecast?city_id=milano&hours=24
• 返回数据包含字段: city_id, city_name, forecast (包含每小时的时间time、aqi_eu及各污染物浓度值)。

4. 查找附近监测站

• 端点: GET /stations
• 功能: 根据经纬度坐标查找指定半径内的ARPA空气质量监测站。
• 参数: lat (纬度), lon (经度), radius_km (半径，公里，可选，默认30，最大100)。
• 示例请求: GET /stations?lat=45.4654&lon=9.1859&radius_km=20
• 返回数据包含字段: station_id, name, lat, lon, distance_km, pollutants_monitored。

AQI指数等级说明

• 0–25: 良好。空气清洁，无需担忧。
• 26–50: 尚可。对大多数人来说空气可接受。
• 51–75: 中等。敏感人群（哮喘患者、老人、儿童）可能会感到不适。
• 76–100: 较差。所有人都可能开始感到不适，应减少户外活动。
• 101+: 极差。避免长时间待在户外。

错误代码

• 404: 使用了不存在的city_id。请返回/cities端点重新搜索以获取正确的ID。
• 503: 数据源（ARPA或CAMS）暂时不可用。请等待几分钟后重试。
• 429: 请求次数超出当前订阅计划限制。请降低请求频率或升级计划。

订阅计划与定价

• BASIC: $0.00 / 月
• PRO: $9.99 / 月
• ULTRA: $49.99 / 月