新加坡 PM2.5 实时查询数据 API
将新加坡五区域空气质量数据接入健康管理和出行决策
覆盖新加坡全岛北部、南部、东部、西部、中部五个区域，实时提供 PM2.5 浓度（微克/立方米）、空气质量等级及更新时间，支持全区域查询、单区域查询、历史趋势和超标预警。
让空气质量从模糊感知变为区域级精准数据
为什么需要这个数据服务
新加坡空气质量数据以原始发布格式呈现，区域划分固定但缺乏标准化接口和空气质量等级映射。直接用于健康管理和出行决策时，需要额外处理和分级计算。
原始数据格式分散，接入成本高
PM2.5 数据以区域为单位发布，更新时间和数据格式不统一，每次接入都需要重新解析和映射，消耗开发资源。
缺乏空气质量等级自动映射
原始数据只提供 PM2.5 浓度数值，缺乏与空气质量等级（良好/中等/不健康）的自动映射，需要使用者自行计算和判断。
历史趋势难以获取和分析
原始数据只提供当前时点数据，缺乏历史趋势查询能力，难以支持健康管理和长期环境监测分析。
超标事件无法自动预警
空气质量变化时缺乏自动化通知机制，需要人工持续监控，无法及时触发空气净化器联动或出行建议调整。
从原始监测数据到实时查询接口
GooFuture 将新加坡空气质量监测数据经过实时处理，转化为可直接调用的 API。
客户无需自行处理浓度分级和区域映射，可直接通过 API 获取标准化空气质量数据和预警推送。
API 产品能力
面向健康管理、空气净化联动和出行决策场景，提供四个核心接口。所有接口返回标准化 JSON，包含 PM2.5 浓度、空气质量等级、区域标识和更新时间。
全区域 PM2.5 查询
查询新加坡全岛五个区域（北部、南部、东部、西部、中部）的实时 PM2.5 浓度和空气质量等级，返回整体概况和区域对比。
curl "https://api.goofuture.com/v1/sg/pm25" \
-H "Authorization: Bearer {api_key}"{
"date": "2024-07-17",
"updated_timestamp": "2024-07-17T14:15:43+08:00",
"regions": {
"west": {
"pm25": 12,
"level": "良好",
"latitude": 1.35735,
"longitude": 103.7
},
"east": {
"pm25": 18,
"level": "良好",
"latitude": 1.35735,
"longitude": 103.94
},
"north": {
"pm25": 11,
"level": "良好",
"latitude": 1.41803,
"longitude": 103.82
},
"south": {
"pm25": 8,
"level": "良好",
"latitude": 1.29587,
"longitude": 103.82
},
"central": {
"pm25": 7,
"level": "良好",
"latitude": 1.35735,
"longitude": 103.82
}
}
}按区域查询
通过区域名称（west/east/north/south/central）查询指定区域的实时 PM2.5 浓度、空气质量等级和更新时间。
curl "https://api.goofuture.com/v1/sg/pm25/west" \
-H "Authorization: Bearer {api_key}"{
"region": "west",
"name": "西部",
"pm25": 12,
"level": "良好",
"latitude": 1.35735,
"longitude": 103.7,
"updated_timestamp": "2024-07-17T14:15:43+08:00"
}历史趋势查询
查询指定区域过去 24 小时、7 天或 30 天的 PM2.5 浓度变化趋势，返回小时粒度数据，支持健康管理和长期环境监测分析。
curl "https://api.goofuture.com/v1/sg/pm25/history?region=west&period=24h" \
-H "Authorization: Bearer {api_key}"{
"region": "west",
"period": "24h",
"data": [
{
"timestamp": "2024-07-16T14:00:00+08:00",
"pm25": 15,
"level": "良好"
},
{
"timestamp": "2024-07-16T15:00:00+08:00",
"pm25": 14,
"level": "良好"
}
]
}超标预警
订阅指定区域的 PM2.5 超标预警，当浓度超过设定阈值时通过 Webhook 推送通知，适用于空气净化器联动和出行建议。
curl -X POST "https://api.goofuture.com/v1/sg/pm25/alerts" \
-H "Authorization: Bearer {api_key}" \
-H "Content-Type: application/json" \
-d '{"region": "west", "threshold": 55, "webhook_url": "https://your-app.com/webhook"}'{
"alert_id": "alt_pm25_001",
"region": "west",
"threshold": 55,
"status": "active",
"created_at": "2024-07-17T14:15:43+08:00"
}真实业务场景
不同角色和不同阶段的企业，如何使用新加坡 PM2.5 实时查询数据 API。
健康管理应用
健康类应用通过 API 展示用户所在区域的实时 PM2.5 浓度和空气质量等级，提供个性化出行和防护建议。
空气净化器联动
智能家居平台通过 Webhook 接收超标预警，自动触发空气净化器档位调整，实现空气质量与设备联动。
户外出行决策
户外运动和导航应用通过查询区域 PM2.5 数据，推荐适宜运动的区域和时段，提升用户健康体验。
室内办公环境
办公楼宇管理平台通过区域 PM2.5 数据调整新风系统运行策略，优化室内空气质量管理。
新加坡 PM2.5 数据概览
数据覆盖新加坡全岛五个区域，按小时频率更新，提供浓度数值和空气质量等级。
数据质量与差异化能力
GooFuture 将原始空气质量监测数据清洗为可直接查询的结构化数据，降低数据接入和维护成本。
实时同步
按小时频率同步全岛五区域 PM2.5 数据，确保查询结果反映最新空气质量状态，避免过期信息误导。
浓度分级自动映射
按 PM2.5 浓度自动映射空气质量等级（良好/中等/不健康/非常不健康），无需使用者自行计算和判断。
历史趋势存储
按小时粒度存储历史数据，支持 24 小时、7 天、30 天趋势查询，为健康管理和长期分析提供数据基础。
超标预警推送
支持自定义阈值和 Webhook 推送，当区域 PM2.5 超标时自动触发通知，便于联动设备和调整运营策略。
区域坐标关联
每个区域关联经纬度坐标，支持在地图上可视化展示，便于集成到导航和位置服务应用中。
三步接入
从咨询到生产查询，最快可在数小时内完成。
联系顾问
说明健康管理、出行或 IoT 场景中的空气质量数据需求，确认需要覆盖的区域范围和预警阈值。
确认方案
双方确认接口范围、调用量、历史数据周期和推送方式。如需要 Webhook 超标预警或定制集成，在此阶段约定。
开始查询
获取 API Key 和接口文档，通过标准 REST 查询。集成过程中提供技术支持，确保实时空气质量数据可直接用于应用。
持续维护
按小时频率同步数据，超标事件通过 Webhook 推送。顾问持续跟进数据延迟和接口稳定性。
# 查询全岛五区域 PM2.5
curl "https://api.goofuture.com/v1/sg/pm25" \
-H "Authorization: Bearer {api_key}"
# 查询西部区域实时数据
curl "https://api.goofuture.com/v1/sg/pm25/west" \
-H "Authorization: Bearer {api_key}"
# 查询西部过去 24 小时趋势
curl "https://api.goofuture.com/v1/sg/pm25/history?region=west&period=24h" \
-H "Authorization: Bearer {api_key}" 选择适合你的方案
从低频健康查询到高频实时监测，从单区域到全岛预警，提供四种方案。
常见问题
关于数据覆盖、更新频率、接口能力和计费方式的常见问题。
数据覆盖哪些区域？
覆盖新加坡全岛五个区域：北部（North）、南部（South）、东部（East）、西部（West）、中部（Central）。每个区域提供实时 PM2.5 浓度（微克/立方米）和空气质量等级。
数据更新频率是多少？
PM2.5 数据通常每小时更新一次。GooFuture 按实时频率同步，并通过 API 返回最新的浓度数据。历史趋势数据按小时粒度存储。
能否集成到智能家居或空气净化器？
可以。接口返回标准化 JSON，包含五区域 PM2.5 浓度和空气质量等级，可通过 Webhook 推送超标事件，直接触发空气净化器联动或智能家居场景切换。
支持哪些空气质量等级？
支持 PM2.5 浓度分级：0-55 为良好（Good），56-150 为中等（Moderate），151-250 为不健康（Unhealthy），251 及以上为非常不健康（Very Unhealthy）。
如何计费？
按套餐月请求量计费。基础版适合低频查询，标准版支持实时查询和趋势分析，专业版和企业版支持更高并发、超标推送和定制集成。请联系顾问获取具体方案。
是否支持历史数据查询？
标准版及以上支持历史趋势查询。可查询指定区域过去 24 小时、7 天或 30 天的 PM2.5 浓度变化，返回小时粒度数据。
是否支持 Webhook 超标预警？
标准版及以上支持 Webhook 超标推送。当指定区域 PM2.5 浓度超过设定阈值时，系统自动推送预警通知至指定端点。
数据范围是否覆盖新加坡以外？
当前数据仅覆盖新加坡全岛五个监测区域。其他国家和地区的数据不在本服务范围内。
将新加坡空气质量数据接入健康管理和出行决策
从实时浓度到历史趋势，从区域分级到超标预警，让空气质量数据驱动健康生活。
