闪电快报专线接口上线：全球闪电定位数据低延迟查询与实时推送

观天者数据站开发者模块上线闪电快报专线接口，提供全球闪电定位数据的近实时 REST 查询与 WebSocket 主动推送，支持获取落点经纬度、发生时间、极性和质量参考字段，适用于强对流监测、低空运行、能源保障与实时告警系统。

发表于 2026/07/17

作者 观天者

18 分钟阅读

闪电快报专线接口上线：全球闪电定位数据低延迟查询与实时推送

观天者数据站开发者模块现已上线 闪电快报专线接口。

这是面向实时雷电监测和业务系统接入场景推出的低延迟数据产品，提供 全球闪电定位数据 的近实时 REST 查询与 WebSocket 主动推送。开发者可以获取闪电发生时间、WGS84 经纬度、极性以及定位质量参考字段，并将新的闪电落点直接接入地图、告警规则、数据中台或行业应用。

用户可以通过观天者数据站开发者模块开通和管理接口应用：

观天者数据站开发者模块

接口说明、鉴权方式、字段定义和多语言接入示例可以参考官方文档：

闪电快报官方文档

为什么需要低延迟闪电定位接口

闪电是强对流天气中非常重要的一类观测信号。雷暴发展过程中，闪电活动的出现、增强、聚集和移动，能够帮助业务系统感知对流天气的实时变化。

对于天气监控、低空飞行、电力巡检、户外活动保障和自动化告警来说，仅仅能够查询历史闪电记录还不够。很多业务真正关心的是：

新的闪电落点发生后，系统能多快收到？
能否持续获取数据，而不是反复轮询接口？
每条记录是否包含可直接上图的经纬度和精确时间？
能否根据极性和质量参考字段进行进一步筛选？
服务重启或网络重连后，怎样补齐连接前的短时数据？
如何把闪电事件接入告警、消息队列和实时可视化系统？

闪电快报专线接口正是为这类场景准备的。它提供最近分钟窗口查询和逐落点实时推送，让开发者可以围绕“刚刚发生了什么”建立稳定的数据接入流程。

核心特点

1. 全球闪电定位数据近实时到达

闪电快报提供全球范围的闪电定位记录。REST 接口可以查询最近 1～5 分钟 的数据，WebSocket 则在新落点到达后主动推送。

这种设计更适合持续运行的业务系统。开发者不需要等待长周期数据文件生成，也不必先处理复杂的资料目录，就可以直接获取结构化的闪电落点数据。

需要说明的是，闪电快报定位于近期数据接入，不支持任意时段的历史回溯。如果业务需要长期统计或历史个例分析，应在接收数据后按自身需求持续存储，或结合其他历史数据产品使用。

2. 同时支持 REST 查询和 WebSocket 推送

REST 与 WebSocket 分别适合不同的接入阶段。

REST 接口用于拉取最近几分钟的数据，适合系统启动、连接恢复和短时补数。默认查询最近 1 分钟，也可以通过 minutes 参数查询最近 1～5 分钟。

WebSocket 用于持续接收新落点。连接并订阅后，服务端会在新记录到达时逐条推送，客户端不需要高频轮询。

官方推荐的接入方式是：

先通过 REST 查询最近 5 分钟，建立当前数据窗口；
再连接 WebSocket 并发送订阅消息；
持续接收增量数据，并在本地完成去重、展示或存储。

由于 WebSocket 建立后不会回放历史数据，这种“REST 补窗口 + WebSocket 接增量”的组合方式可以降低启动和重连时遗漏数据的风险。

3. 提供落点、时间、极性与质量参考字段

每条闪电记录对应一次闪电解译结果，主要包含：

time：闪电发生时间的 Unix 纳秒时间戳；
obser_datetime：UTC 时区的 ISO 8601 观测时间；
lat、lon：WGS84 坐标系下的落点经纬度；
alt：高度字段，当前记录中常为 0；
pol：闪电极性，一般为 -1 或 +1，0 多表示未知；
mds：最大时间偏差，可作为定位质量参考；
mcg：探测站覆盖角度间隙，可作为几何质量参考；
status：状态或质量标记；
region：网络区域编号；
arrived_at：数据进入本服务的 UTC 时间。

对于多数业务，发生时间和经纬度是最核心的字段，可以直接用于地图落点、空间聚类、距离计算和时间序列统计。mds 与 mcg 可以作为进一步的质量参考，具体筛选规则建议根据实际样本和业务要求确定。

4. 专线产品提供 99.9% SLA

闪电快报属于观天者数据站专线接口产品，提供 99.9% 可用性保障，按时长订阅，并与机场快报等专线产品共享同一套应用配额。

对于持续运行的实时监控、自动化告警和行业数据产品来说，稳定性与时效性同样重要。专线接口的定位，就是让这类数据可以更自然地进入生产系统，而不只是用于偶尔查询。

使用 REST 获取最近闪电记录

闪电快报 REST Base URL 为：

https://special.data-api.skyviewor.host/fast-lightning

查询最近 5 分钟闪电定位记录，可以使用：

        
      
curl -s \
  -H "Authorization: Bearer <YOUR_API_KEY>" \
  "https://special.data-api.skyviewor.host/fast-lightning/rest/strikes?minutes=5"

minutes 可以取 1～5，不传时默认查询最近 1 分钟。响应中会包含实际查询窗口、返回条数、分钟桶列表和闪电记录数组。

一个简化后的响应结构如下：

        
      
{
  "minutes": 1,
  "from": "2026-07-13T13:36:00+00:00",
  "to": "2026-07-13T13:36:45+00:00",
  "count": 1,
  "data": [
    {
      "obser_datetime": "2026-07-13T13:36:00.123456+00:00",
      "lat": 39.9042,
      "lon": 116.4074,
      "pol": -1,
      "mds": 1234,
      "mcg": 54,
      "arrived_at": "2026-07-13T13:36:00.456789+00:00"
    }
  ]
}

如果所选时间窗内没有闪电数据，接口仍会返回 HTTP 200，count 为 0，data 为空数组。客户端应把这种响应视为“查询成功但当前无数据”，而不是接口异常。

使用 WebSocket 接收新落点

WebSocket 端点为：

wss://special.data-api.skyviewor.host/fast-lightning/ws/strikes

连接成功后，客户端发送以下消息开始接收数据：

        
      
{"action": "subscribe"}

新落点到达时，服务端会推送 new_strike 类型消息。与批量 REST 响应不同，每条 WebSocket 消息中的 data 是一个闪电对象，而不是数组：

        
      
{
  "type": "new_strike",
  "data": {
    "obser_datetime": "2026-07-13T13:36:00.123456+00:00",
    "lat": 39.9042,
    "lon": 116.4074,
    "pol": -1,
    "arrived_at": "2026-07-13T13:36:00.456789+00:00"
  }
}

如果需要暂停接收，可以发送：

        
      
{"action": "unsubscribe"}

WebSocket 订阅后会接收全量新落点，当前不支持按经纬度范围或 region 过滤。需要关注特定区域的业务，可以在客户端收到数据后，根据经纬度边界、多边形范围或距离条件进行本地筛选。

适合哪些业务场景

强对流天气实时监控

闪电活动可以作为雷暴监测的重要信息来源。将闪电落点叠加到雷达回波、卫星云图、地面观测和预警信息上，可以帮助用户更完整地观察强对流系统的位置、发展和移动。

实时系统可以按时间窗统计闪电数量、生成落点密度图，或监测某一区域闪电活动是否突然增强。需要注意的是，闪电定位数据应与其他气象资料综合使用，不应单独替代专业的天气预警产品。

低空经济与无人机运行

雷暴和闪电对无人机、通航飞行及低空作业具有明显风险。低空运行平台可以根据作业区或航线周边的闪电落点，计算一定半径内近期闪电数量，并触发风险提示、任务暂停或人工复核流程。

由于接口提供的是全球经纬度落点，开发者可以按自身业务区域进行空间过滤，而不受固定行政区划限制。

电力、能源与基础设施保障

电网、风电场、光伏场站、通信设施和大型户外设备都可能关注雷电活动。闪电快报可以用于实时地图、设备周边风险监测和雷击事件辅助核对。

例如，系统可以持续订阅新落点，计算落点与输电线路、变电站或风机位置的距离。当闪电进入设定范围时，触发告警或记录事件，供后续运维分析使用。

户外活动与公共安全

景区、体育场馆、露天施工、港口和大型户外活动可以利用近期闪电落点建立区域告警规则。当监控区域附近出现新的闪电活动时，系统可以通知值守人员，并结合雷达和官方预警决定是否采取避险措施。

气象数据产品与可视化

对于天气地图、强对流监控大屏和气象应用，WebSocket 推送可以直接驱动前端地图更新。每次收到 new_strike 消息后，将落点加入当前图层，并按时间自动清理过期记录，就可以形成持续更新的闪电分布视图。

鉴权与连接管理

闪电快报支持两种鉴权方式：

API Key 直接鉴权；
使用 API Key 换取有效期 5 分钟的临时 Token，再调用 REST 或建立 WebSocket 连接。

后端程序可以在 Authorization Header 中直接携带 API Key。浏览器原生 WebSocket API 无法设置自定义握手 Header，因此浏览器场景建议先在后端换取临时 Token，再通过 WebSocket URL 的 token Query 参数连接。

接口当前的主要配额与连接限制为：

项目	限制
HTTP QPS	每个应用 2
WebSocket 同时连接数	每个应用 3
临时 Token 有效期	5 分钟
单个 WebSocket 连接最长时长	24 小时

服务端每 5 分钟会发送一次应用层 JSON 心跳消息 {"type":"ping"}，客户端建议回复 {"action":"pong"}。连接达到 24 小时上限前，服务端会提前发送通知，客户端应准备好重新获取 Token、重建连接和恢复订阅。

当 REST 请求超过 QPS 限制时，服务端会返回 HTTP 429，客户端应采用退避重试，避免立即高频重发。REST 和 WebSocket 分别独立限流，REST 请求不会占用 WebSocket 连接数。

更完整的关闭码、心跳规则和 Python、JavaScript、TypeScript、Go、Java、C#、PHP 示例，请以官方文档为准。

接入建议

第一次接入时，建议先使用 REST 查询最近 5 分钟，并检查时间字段、经纬度范围、极性和质量参考字段是否符合业务处理方式。

接入 WebSocket 后，建议在客户端完成以下工作：

使用时间与坐标等字段建立去重策略；
对目标业务区域进行本地空间过滤；
处理网络断开、24 小时连接上限和自动重连；
在重连时用 REST 补齐最近时间窗；
对地图上的旧落点设置合理的过期时间；
记录服务端关闭码和请求 ID，便于排查问题；
将 API Key 保存在服务端，不要直接暴露在浏览器代码中。

闪电快报专线接口强调的是近期数据和持续推送。如果需要建立长期闪电档案，应将收到的数据写入自己的数据库或对象存储，并设计好时间分区、空间索引和数据保留策略。

立即使用

如果你正在开发强对流天气监控、低空运行保障、电力设施风险监测、户外安全告警或实时气象可视化产品，可以进入观天者数据站开发者模块：