自动站数据接口 - Revision history

Ringsaturn at 03:49, 28 October 2020

2020-10-28T03:49:52Z

Ringsaturn at 03:44, 28 October 2020

2020-10-28T03:44:29Z

Ringsaturn at 03:42, 28 October 2020

2020-10-28T03:42:16Z

Ringsaturn: /* 可选字段及含义对照表 */

2020-10-28T03:39:52Z

‎可选字段及含义对照表

Ringsaturn at 03:37, 28 October 2020

2020-10-28T03:37:05Z

Ringsaturn at 03:32, 28 October 2020

2020-10-28T03:32:54Z

Ringsaturn at 03:30, 28 October 2020

2020-10-28T03:30:36Z

Ringsaturn: Created page with " 请求样例： http://api.caiyunapp.com/v1/surf/nearest/?token=TOKEN&lng=110.8840&lat=21.6594"

2020-10-28T03:27:23Z

Created page with " 请求样例： http://api.caiyunapp.com/v1/surf/nearest/?token=TOKEN&lng=110.8840&lat=21.6594"

New page

请求样例：

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

@@ Line 19: / Line 19: @@
 定制返回特定的字段，如 <code>PRE_1h</code>：
-[http://api.caiyunapp.com/v1/surf/nearest/?token=TOKEN&lng=119&lat=30&fields=Station_Id_d,location,PRE_1h <code>http://api.caiyunapp.com/v1/surf/nearest/?token=TOKEN&lng=119&lat=30&fields=Station_Id_d,location,PRE_1h</code>]
+<code>http://api.caiyunapp.com/v1/surf/nearest/?token=TOKEN&lng=119&lat=30&fields=Station_Id_d,location,PRE_1h,pub_timestamp</code>
 === 返回结构和说明 ===
 <syntaxhighlight lang="json" line="1" start="1">
+{
-   "status":"ok",
+   "status": "ok",
-   "result":[
+   "result": [
+     {
-       "Station_Id_d":733855,
+       "Station_Id_d": 731901,
-       "location":{
+       "location": {
-         "type":"Point",
+         "type": "Point",
-         "coordinates":[
+         "coordinates": [
-.980599999999996,
+.1392,
-.0886
+.6767
+         ]
        },
-       "PRE_1h":"0",
+       "PRE_1h": "0",
-       "TEM":"17.9",
+       "pub_timestamp": 1603850400
      },
+     {
-       "Station_Id_d":737567,
+       "Station_Id_d": 736102,
-       "location":{
+       "location": {
-         "type":"Point",
+         "type": "Point",
-         "coordinates":[
+         "coordinates": [
-.908299999999997,
+.7267,
-.622499999999999
+.6108
+         ]
        },
-       "PRE_1h":"0",
+       "PRE_1h": "0",
-       "TEM":"18.5",
+       "pub_timestamp": 1603850400
      },
+   ]
@@ Line 75: / Line 73: @@
+|
+|
 |-
 |<code>PRE_1h</code>

← Older revision		Revision as of 03:44, 28 October 2020
Line 11:		Line 11:

	== 请求样例 ==		== 请求样例 ==
		+	'''<u>目前仅支持返回一定距离内最多10个站点的数据。</u>'''
		+
	简单的方式为：		简单的方式为：

@@ Line 1: / Line 1: @@
-<u>本接口尚在测试与开发中，API 参数和返回结构可能会有调整</u>
+ <u>本接口尚在测试与开发中，API 参数和返回结构可能会有调整</u>。
 ==授权与认证==
@@ Line 76: / Line 76: @@
 |<code>PRE_1h</code>
 |最近一小时降水量
-|str 形式的 float
+|str 形式的 float，或者 null
 |<code>mm/1h</code>
 |数据类型可能变更
 |}

@@ Line 58: / Line 58: @@
 !字段符号
 !字段含义
 !单位
 !备注
 |-
+|<code>Station_Id_d</code>
+|站点编号
+|
+|
 |-
+|<code>location</code>
+|站点坐标
+|
+|
 |-
+|<code>PRE_1h</code>
+|最近一小时降水量
+|str 形式的 float
+|<code>mm/1h</code>
 |}

@@ Line 11: / Line 11: @@
 == 请求样例 ==
 [http://api.caiyunapp.com/v1/surf/nearest/?token=TOKEN&lng=110.8840&lat=21.6594 <code>http://api.caiyunapp.com/v1/surf/nearest/?token=TAkhjf8d1nlSlspN&lng=110.8840&lat=21.6594</code>]
-== 返回结构和说明 ==
+定制返回特定的字段，如 <code>PRE_1h</code>：
 <syntaxhighlight lang="json" line="1" start="1">
+{
@@ Line 47: / Line 53: @@
+}
 </syntaxhighlight>

@@ Line 1: / Line 1: @@
 ==授权与认证==
 请先至彩云开放平台[https://dashboard.caiyunapp.com/user/sign_up/ 注册]，注册后可以获得 token 。
-使用本接口，开发者token需要额外开通权限，请联系商务：'''api@caiyunapp.com'''
+使用本接口，开发者token需要额外开通权限，请联系商务：'''[mailto:api@caiyunapp.com api@caiyunapp.com]'''
 把您的 token 拼到 API 请求的 URL 中，如: [http://api.caiyunapp.com/v1/surf/nearest/?token=TOKEN&lng=110.8840&lat=21.6594 <code>http://api.caiyunapp.com/v1/surf/nearest/?token=TAkhjf8d1nlSlspN&lng=110.8840&lat=21.6594</code>]
-其中 TAkhjf8d1nlSlspN 就是一个共用测试 token 。不要把私有token 告诉任何人！
+其中 <code>TAkhjf8d1nlSlspN</code> 就是一个共用测试 token 。不要把私有token 告诉任何人！
 == 请求样例 ==

← Older revision		Revision as of 03:30, 28 October 2020
Line 1:		Line 1:
		+	==授权与认证==
		+	请先至彩云开放平台[https://dashboard.caiyunapp.com/user/sign_up/ 注册]，注册后可以获得 token 。

−	~~请求样例：~~	+	使用本接口，开发者token需要额外开通权限，请联系商务：'''api@caiyunapp.com'''

−	http://api.caiyunapp.com/v1/surf/nearest/?token=TOKEN&lng=110.8840&lat=21.6594	+	把您的 token 拼到 API 请求的 URL 中，如: [http://api.caiyunapp.com/v1/surf/nearest/?token=TOKEN&lng=110.8840&lat=21.6594 <code>http://api.caiyunapp.com/v1/surf/nearest/?token=TAkhjf8d1nlSlspN&lng=110.8840&lat=21.6594</code>]
		+
		+	其中 TAkhjf8d1nlSlspN 就是一个共用测试 token 。不要把私有token 告诉任何人！
		+
		+	== 请求样例 ==
		+	[http://api.caiyunapp.com/v1/surf/nearest/?token=TOKEN&lng=110.8840&lat=21.6594 <code>http://api.caiyunapp.com/v1/surf/nearest/?token=TAkhjf8d1nlSlspN&lng=110.8840&lat=21.6594</code>]
		+
		+	== 返回结构和说明 ==
		+	<syntaxhighlight lang="json" line="1" start="1">
		+	{
		+	"status":"ok",
		+	"result":[
		+	{
		+	"Station_Id_d":733855,
		+	"location":{
		+	"type":"Point",
		+	"coordinates":[
		+	117.980599999999996,
		+	32.0886
		+	]
		+	},
		+	"PRE_1h":"0",
		+	"TEM":"17.9",
		+	"VIS":null
		+	},
		+	{
		+	"Station_Id_d":737567,
		+	"location":{
		+	"type":"Point",
		+	"coordinates":[
		+	117.908299999999997,
		+	30.622499999999999
		+	]
		+	},
		+	"PRE_1h":"0",
		+	"TEM":"18.5",
		+	"VIS":null
		+	},
		+	]
		+	}
		+	</syntaxhighlight>