快速 METAR 专线接口上线：低延迟机场天气报文查询与 WebSocket 推送
观天者数据站开发者模块上线快速 METAR 专线接口，面向中国境内 225+ 机场提供低延迟 METAR/SPECI 最新报文查询服务，支持 HTTP RESTful 查询、结构化解析结果和 WebSocket 主动推送，适用于航空气象、低空经济、机场天气监控和实时数据产品开发。
观天者数据站现已在官方网站上线 开发者 模块，并同步推出 快速 METAR 专线接口。
这是面向实时机场天气接入场景的一组低延迟数据接口，提供中国境内 225+ 机场 最新 METAR/SPECI 报文的快速查询与主动推送能力。相比更适合历史回溯和常规查询的标准 METAR 接口，快速 METAR 专线接口更强调时效性：数据仅保留最新一批报文，目标是让开发者尽快拿到机场最新天气实况。
用户可以通过观天者数据站开发者模块进入接口服务：
接口说明、鉴权方式和多语言接入示例可以参考官方文档：
为什么需要快速 METAR 接口
METAR 是航空气象业务中非常重要的机场实况天气报文，通常记录机场附近的风、能见度、天气现象、云况、温度、露点、气压等关键信息。对于机场运行、航线保障、低空飞行、无人机任务规划、天气监控看板和气象数据产品来说，METAR 往往是判断机场实时天气状态的基础数据。
过去，很多用户使用 METAR 数据时，主要关注的是“能不能查到”和“能不能下载”。这类需求更适合历史数据查询、批量导出和结构化分析。
但在实时业务系统中，问题会变成另外一种形式：
- 机场新报文发布后，系统能多快感知到？
- 前端天气看板是否需要不断轮询？
- 多个机场的最新报文能否统一订阅？
- 报文到达后，能不能直接触发告警、刷新页面或写入业务数据库？
- 如果只关心最新天气状态，是否还需要每次都走历史查询链路？
快速 METAR 专线接口就是为这类场景准备的。它不以长周期历史回溯为目标，而是专门面向“最新报文”和“低延迟接入”做了接口设计。
核心特点
1. 约 1 分钟延迟，更适合实时业务
快速 METAR 专线接口提供的是最新一批 METAR/SPECI 数据，延迟约 1 分钟。对于机场天气监控、低空运行辅助、自动化告警、实时展示大屏和数据中台增量接入等场景来说，这类低延迟能力会比普通历史查询接口更合适。
如果你的系统只是偶尔下载某个机场过去几天或过去几年的报文，标准 METAR 数据集已经可以满足大部分需求；如果你的系统需要持续关注“现在机场天气变了吗”，快速 METAR 会更加直接。
2. 覆盖中国境内 225+ 机场
快速 METAR 当前面向中国境内 225+ 机场提供 METAR/SPECI 最新报文服务。开发者可以按 ICAO 四字代码查询指定机场，例如 ZBAA、ZSPD、ZGGG 等，也可以在 WebSocket 场景下订阅指定机场或全部机场。
这对于需要同时监控多个机场天气状态的系统尤其有价值。例如低空飞行平台、航空气象看板、机场运行辅助系统、区域天气监测服务，都可以围绕机场列表建立统一的数据接入流程。
3. 支持原始报文和结构化结果
快速 METAR 同时提供两类结果：
- 原始 METAR/SPECI 报文；
- 解析后的结构化 METAR 数据。
原始报文适合专业航空气象用户、报文存档和人工复核；结构化结果则更适合程序直接处理，例如读取温度、露点、风速、气压、CAVOK 标识等字段，用于页面展示、阈值告警或后续计算。
4. 同时支持 HTTP RESTful 查询和 WebSocket 推送
快速 METAR 提供两种典型接入方式。
如果你的系统只需要在某个时刻主动查询最新数据，可以使用 HTTP RESTful 接口：
1
2
3
curl -s \
-H "Authorization: Bearer <YOUR_API_KEY>" \
"https://special.data-api.skyviewor.host/fast-metar/rest/raw?icaos=ZBAA,ZSPD,ZGGG"
如果希望获取结构化结果，可以使用：
1
2
3
curl -s \
-H "Authorization: Bearer <YOUR_API_KEY>" \
"https://special.data-api.skyviewor.host/fast-metar/rest/parsed?icaos=ZBAA,ZSPD,ZGGG"
如果你的系统需要持续监听新报文，建议使用 WebSocket 推送。连接建立后，客户端订阅机场列表，新报文到达时服务端会主动下发，避免频繁轮询。
WebSocket 原始报文推送端点：
1
wss://special.data-api.skyviewor.host/fast-metar/ws/raw
WebSocket 结构化数据推送端点：
1
wss://special.data-api.skyviewor.host/fast-metar/ws/parsed
订阅指定机场时，客户端发送：
1
{"action": "subscribe", "icaos": ["ZBAA", "ZGGG"]}
订阅全部机场时，可以发送：
1
{"action": "subscribe", "icaos": ["*"]}
当新的 METAR/SPECI 报文到达后，服务端会推送 new_metar_arrived 类型消息。对于实时业务来说，这种方式更容易和消息队列、数据库写入、前端状态更新、告警规则引擎衔接。
与标准 METAR 接口有什么不同
观天者数据站后续会同时保留不同层次的 METAR 数据服务。它们并不是互相替代关系，而是面向不同使用场景。
标准 METAR 接口更适合历史查询、回溯分析、批量下载和常规数据处理。它可以帮助用户围绕时间范围获取历史报文，适合科研分析、模型检验、样本构建和历史天气复盘。
快速 METAR 专线接口则更适合实时接入。它只提供最新一批数据，不用于历史回溯；但它的优势是延迟更低，并且支持 WebSocket 主动推送。对于开发者来说，可以把它理解为“机场天气最新状态通道”。
简单来说：
| 使用需求 | 推荐接口 |
|---|---|
| 查询历史 METAR 报文 | 标准 METAR / 历史数据查询 |
| 下载长周期机场天气数据 | 中国机场 METAR 历史数据服务 |
| 获取最新机场报文 | 快速 METAR RESTful 接口 |
| 新报文到达后自动通知系统 | 快速 METAR WebSocket 推送 |
| 实时天气看板、告警、数据产品接入 | 快速 METAR 专线接口 |
如果一个业务系统既需要历史回溯，也需要实时更新，可以把两类接口组合使用：历史数据用于初始化和补齐，快速 METAR 用于持续接收最新增量。
适合哪些场景
机场天气实时看板
对于需要展示多个机场当前天气状态的系统，可以通过快速 METAR 接口获取最新报文，并将温度、风、能见度、气压、天气现象等要素展示在看板上。
如果使用 WebSocket 推送，页面或后端服务不必频繁轮询。一旦新报文到达，系统就可以立即刷新对应机场状态。
航空气象和运行辅助
航空气象服务通常需要持续关注机场天气变化。快速 METAR 可以用于机场实况监控、低能见度天气跟踪、大风天气识别、雷雨天气提示和运行条件辅助判断。
对于专业用户，原始 METAR 报文本身仍然具有重要价值；对于自动化系统，结构化字段则更方便进入规则判断和告警流程。
低空经济和无人机运行保障
低空飞行对风、能见度、降水、低云和强对流天气比较敏感。虽然 METAR 不能替代所有低空场景所需的局地观测和精细预报，但机场 METAR 仍然是稳定、标准化、持续更新的地面天气信息来源。
对于无人机航线规划、低空运行风险提示和区域天气监控来说，快速 METAR 可以作为实时气象底座的一部分。
数据产品和自动化告警
很多气象数据产品并不只是“查一次数据”，而是需要持续运行。快速 METAR 的 WebSocket 推送能力可以帮助开发者把新报文到达事件接入后端流程，例如：
- 写入数据库；
- 更新缓存；
- 推送前端；
- 触发阈值告警；
- 发送企业微信、钉钉或邮件通知；
- 进入消息队列供下游服务消费。
这类场景中，主动推送通常比定时轮询更自然，也更容易控制系统延迟。
如何开始接入
开发者可以先访问观天者数据站官网，进入开发者模块：
https://datastation.skyviewor.com/developer
快速 METAR 接口的基础地址为：
1
https://special.data-api.skyviewor.host/fast-metar
接口支持两种鉴权方式：
- API Key 直接鉴权；
- Token 鉴权。
RESTful 查询可以直接在 Authorization Header 中携带 API Key。WebSocket 场景下，如果是浏览器端接入，由于浏览器原生 WebSocket API 不支持自定义 Header，建议先用 API Key 换取临时 Token，再通过 URL Query 传入。
更完整的鉴权说明、请求参数、响应字段、限流规则和 Python、JavaScript、TypeScript、Go、Java、C#、PHP 示例，可以参考官方文档：
如果希望了解 METAR 报文本身的字段含义，也可以阅读我们此前整理的说明文章：
使用建议
如果你是第一次接入，建议先从少量机场开始测试，例如 ZBAA,ZSPD,ZGGG。先确认返回字段、时间格式、原始报文内容和结构化解析结果是否符合业务预期，再扩大到更多机场。
如果是后端服务接入，可以优先使用 WebSocket 订阅，并在本地做好重连、心跳、日志和去重处理。对于需要展示当前状态的系统，也建议保留每个机场最后一条报文的缓存，这样前端刷新或服务重启后可以更快恢复状态。
如果是历史分析、统计建模或批量下载场景，则不建议把快速 METAR 当成历史接口使用。快速 METAR 的定位是最新报文低延迟接入；历史数据仍建议使用观天者数据站的 METAR 历史数据服务。
立即使用
如果你正在开发机场天气监控、航空气象服务、低空经济平台、无人机运行保障系统，或者需要把中国机场最新 METAR/SPECI 报文接入自己的业务系统，可以访问观天者数据站开发者模块：
快速 METAR 官方文档：
https://docs.datastation.skyviewor.com/developer/dedicated/fast-metar/
观天者数据站将继续围绕气象数据查询、开发者接口、实时数据推送和行业数据产品，提供更多可直接用于科研、业务和工程开发的数据服务。