Difference between revisions of "闪电数据接口"

From Caiyun Wiki
Jump to: navigation, search
(Created page with "TODO")
 
Line 1: Line 1:
TODO
+
==授权与认证 ==
 +
请先至彩云开放平台[https://dashboard.caiyunapp.com/user/sign_up/ 注册],注册后可以获得 token 。
 +
 
 +
使用本接口,开发者token需要额外开通权限,请联系商务:'''[mailto:api@caiyunapp.com api@caiyunapp.com]'''
 +
 
 +
== API 地址 ==
 +
<nowiki>https://api.caiyunapp.com/v1/lightning?bounds=85.873123,0.048410,129.728954,55.057315&duration=90&token=TOKEN</nowiki>
 +
 
 +
== 参数说明 ==
 +
* <code>bounds</code>: <code>lng1,lat1,lng2,lat2</code> 边界范围,顺序为【左下,右上】 
 +
* <code>duration</code>: 最近多少秒的数据,支持范围为 0~600
 +
 
 +
== 返回结构 ==
 +
 
 +
=== 字段说明 ===
 +
{| class="wikitable"
 +
|字段
 +
|含义
 +
|备注
 +
|-
 +
|status
 +
|响应状态
 +
|
 +
|-
 +
|server_time
 +
|服务器时间
 +
|
 +
|-
 +
|start_time
 +
|数据开始时间
 +
|
 +
|-
 +
|version
 +
|内部版本号
 +
|
 +
|-
 +
|statistic. count
 +
|累计多少次闪电
 +
|
 +
|-
 +
|statistic. max_intensity
 +
|
 +
|
 +
|-
 +
|statistic. max_slope
 +
|
 +
|
 +
|-
 +
|data.*
 +
|见下表格
 +
|
 +
|}
 +
{| class="wikitable"
 +
|字段
 +
|含义
 +
|备注
 +
|-
 +
|time_step
 +
|内部定义的时间步长,等价于时间戳
 +
|
 +
|-
 +
|slope
 +
|回击最大陡度
 +
|
 +
|-
 +
|count
 +
|当前网格区间有多少个闪电
 +
|
 +
|-
 +
|strength
 +
|回击峰值强度
 +
|kA 千安培
 +
|-
 +
|intensity
 +
|回击峰值强度
 +
|kA 千安培,区分正负值
 +
|-
 +
|lat
 +
|纬度
 +
|
 +
|-
 +
|lng
 +
|经度
 +
|
 +
|}

Revision as of 05:56, 14 July 2021

授权与认证 

请先至彩云开放平台注册,注册后可以获得 token 。

使用本接口,开发者token需要额外开通权限,请联系商务:api@caiyunapp.com

API 地址

https://api.caiyunapp.com/v1/lightning?bounds=85.873123,0.048410,129.728954,55.057315&duration=90&token=TOKEN

参数说明

  • boundslng1,lat1,lng2,lat2 边界范围,顺序为【左下,右上】 
  • duration: 最近多少秒的数据,支持范围为 0~600

返回结构

字段说明

字段 含义 备注
status 响应状态
server_time 服务器时间
start_time 数据开始时间
version 内部版本号
statistic. count 累计多少次闪电
statistic. max_intensity
statistic. max_slope
data.* 见下表格
字段 含义 备注
time_step 内部定义的时间步长,等价于时间戳
slope 回击最大陡度
count 当前网格区间有多少个闪电
strength 回击峰值强度 kA 千安培
intensity 回击峰值强度 kA 千安培,区分正负值
lat 纬度
lng 经度