彩云天气常见问题 - Revision history

Ringsaturn: /* 如何正确重试接口 */

2021-09-18T15:10:20Z

‎如何正确重试接口

Ringsaturn at 03:07, 17 September 2021

2021-09-17T03:07:32Z

Ringsaturn at 03:03, 17 September 2021

2021-09-17T03:03:59Z

Mingli at 11:34, 7 April 2020

2020-04-07T11:34:24Z

Liuzhonghua at 11:18, 15 April 2019

2019-04-15T11:18:08Z

Liuzhonghua at 09:26, 29 March 2019

2019-03-29T09:26:58Z

Liuzhonghua at 10:55, 25 March 2019

2019-03-25T10:55:49Z

Liuzhonghua at 10:52, 25 March 2019

2019-03-25T10:52:48Z

Liuzhonghua at 10:52, 25 March 2019

2019-03-25T10:52:26Z

Liuzhonghua at 04:34, 8 March 2019

2019-03-08T04:34:45Z

@@ Line 47: / Line 47: @@
      print("failed")
      retry_times += 1
-     time.sleep(retry_times)
+     time.sleep(retry_times*retry_times)
      continue

← Older revision		Revision as of 03:07, 17 September 2021
Line 56:		Line 56:

	按照 99.9% 可用率，一般每1万次调用中，有100次左右的超时属于正常范围。		按照 99.9% 可用率，一般每1万次调用中，有100次左右的超时属于正常范围。
		+
		+	额外的超时可能会导致总调用量有小幅度的增长，对计费会有比较轻微的影响。

	== 算法相关 ==		== 算法相关 ==

← Older revision		Revision as of 03:03, 17 September 2021
Line 23:		Line 23:

	API接口仅支持返回过去一天的历史数据，接口默认返回当前时刻到未来的数据。需要调用过去一天的数据，可以在 URL 后加参数 <code>begin=时间戳</code> 即可。		API接口仅支持返回过去一天的历史数据，接口默认返回当前时刻到未来的数据。需要调用过去一天的数据，可以在 URL 后加参数 <code>begin=时间戳</code> 即可。
		+
		+	=== 如何正确重试接口 ===
		+	# 发起 API 调用
		+	# 如果失败，则等待时间随超时次数指数增长
		+	<syntaxhighlight lang="python3" line="1">
		+	#!/usr/bin/env python3
		+
		+	import time
		+
		+	import requests
		+
		+
		+	URL = "http://api.caiyunapp.com"
		+	MAX_RETRY = 3
		+	data = {}
		+
		+	retry_times = 0
		+	while retry_times <= MAX_RETRY:
		+	try:
		+	data = requests.get(URL).json()
		+	break
		+	except Exception:
		+	print("failed")
		+	retry_times += 1
		+	time.sleep(retry_times)
		+	continue
		+
		+	print(data)
		+	</syntaxhighlight>
		+
		+	任何外部/内部的接口都可能因为各种原因发生请求失败，代码里应做好对应的容错/兜底机制。
		+
		+	按照 99.9% 可用率，一般每1万次调用中，有100次左右的超时属于正常范围。

	== 算法相关 ==		== 算法相关 ==

@@ Line 1: / Line 1: @@
-# 如何做气象数据质控的
+== 彩云天气 App 相关 ==
-# [[局部天气项目|如何做短临降水预报的]]
-# 如何做雾霾短期预报的
+=== 彩云天气 App 采用了那种地图坐标？ ===
-# 雷达降水强度（intensity）和雨量站降水强度（precipitation）的区别
-# 如何使用分钟级降水强度，计算24小时累计降水量(mm)
+彩云天气 App 使用 GCJ－02 坐标系统
-# [[实时降水强度和分钟级的第0帧降水强度是相同的吗？]]
-# 如何使用数值天气预报数据的
+== 彩云天气 API 相关 ==
-# 短临预报和短期预报自然语言描述（description）是什么
-# 主要天气现象（skycon）有哪些，优先级如何
+* 雷达降水强度（intensity）和雨量站降水强度（precipitation）的区别
-# [[雾和灰霾的区别]]
+* 如何使用分钟级降水强度，计算24小时累计降水量(mm)
-# [[生活指数（life_index）有哪些]]
+* 短临预报和短期预报自然语言描述（description）是什么
-# 美标和国标的AQI有何不同
+* 主要天气现象（skycon）有哪些，优先级如何
-# [[如何计算日出日落]]
+* [[雾和灰霾的区别]]
-# [[天气相关的时间计算]]
+* [[生活指数（life_index）有哪些]]
-# [[中国气象站点表]]
+* 美标和国标的AQI有何不同
-# [[中国县和城区级行政区划表]]
+* 实时降水强度和分钟级的第0帧降水强度是相同的吗？
-# [[中国县和城区级行政区划表（2019-02）]]
-# [[中国乡镇街道级行政区划表1]]
+=== 彩云天气 API 调用次数是如何计算的？ ===
-# [[中国乡镇街道级行政区划表2]]
-# [[中国环保站点表]]
+用户发出一次 URL 请求并得到返回数据为一次调用
-# [[WMO国际交换气象站点表]]
-# [https://open.caiyunapp.com/Template:%E9%A2%84%E8%AD%A6%E7%B1%BB%E5%9E%8B 预警类型]
+=== 彩云天气 API 是否支持返回历史数据 ===
-# [[天气现象图标]]

@@ Line 15: / Line 15: @@
 # [[中国气象站点表]]
 # [[中国县和城区级行政区划表]]
 # [[中国乡镇街道级行政区划表1]]
 # [[中国乡镇街道级行政区划表2]]

← Older revision		Revision as of 10:55, 25 March 2019
Line 20:		Line 20:
	# [[WMO国际交换气象站点表]]		# [[WMO国际交换气象站点表]]
	# [https://open.caiyunapp.com/Template:%E9%A2%84%E8%AD%A6%E7%B1%BB%E5%9E%8B 预警类型]		# [https://open.caiyunapp.com/Template:%E9%A2%84%E8%AD%A6%E7%B1%BB%E5%9E%8B 预警类型]
		+	# [[天气现象图标]]