自动站数据接口

From Caiyun Wiki
Jump to: navigation, search
本接口尚在测试与开发中,API 参数和返回结构可能会有调整

授权与认证

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

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

把您的 token 拼到 API 请求的 URL 中,如: http://api.caiyunapp.com/v1/surf/nearest/?token=TAkhjf8d1nlSlspN&lng=110.8840&lat=21.6594

其中 TAkhjf8d1nlSlspN 就是一个共用测试 token 。不要把私有token 告诉任何人!

请求样例

目前仅支持返回一定距离内最多10个站点的数据。

简单的方式为:

http://api.caiyunapp.com/v1/surf/nearest/?token=TAkhjf8d1nlSlspN&lng=110.8840&lat=21.6594

定制返回特定的字段,如 PRE_1h

http://api.caiyunapp.com/v1/surf/nearest/?token=TOKEN&lng=119&lat=30&fields=Station_Id_d,location,PRE_1h,pub_timestamp

返回结构和说明

 1 {
 2   "status": "ok",
 3   "result": [
 4     {
 5       "Station_Id_d": 731901,
 6       "location": {
 7         "type": "Point",
 8         "coordinates": [
 9           116.1392,
10           33.6767
11         ]
12       },
13       "PRE_1h": "0",
14       "pub_timestamp": 1603850400
15     },
16     {
17       "Station_Id_d": 736102,
18       "location": {
19         "type": "Point",
20         "coordinates": [
21           118.7267,
22           31.6108
23         ]
24       },
25       "PRE_1h": "0",
26       "pub_timestamp": 1603850400
27     },
28   ]
29 }

可选字段及含义对照表

字段符号 字段含义 数据类型 单位 备注
Station_Id_d 站点编号 int
location 站点坐标 GeoJSON Point
pub_timestamp 数据发布时间 int Unix 时间戳
PRE_1h 最近一小时降水量 str 形式的 float,或者 null mm/1h 数据类型可能变更
TEM 温度 str 形式的 float,或者 null 摄氏度 数据类型可能变更
VIS 能见度 str 形式的 float,或者 null 公里 数据类型可能变更