1. 简介

晴天钟是一系列天气预测产品的总称,它们主要提取于美国国家大气海洋局/气候环境预测局(NOAA/NCEP)的“全球预测系统”(Global Forecast System, GFS)数值模式。由叶泉志开发,目前由中国科学院上海天文台中国天文科普网提供硬件及网络支持。

2. 使用

域名是 http://7timer.org ,IP 访问 http://202.127.24.18/ 。域名不太稳定,通常用 IP 访问 。由于它使用的是 Google 地图,所有要开启翻墙代理,还要选择英文,否则就看不到地图了。

我通常用它来查看天文用途的天气预报。在地图上单击选点,然后选择 ASTRO :

就可以看到天文用途的三天天气预报:

各种图标的含义:

3. API

有两种 API :图表 API 和程序 API 。

图表 API

调用图表 API 将会返回类似晴天钟网站所见的预报图表,API 是一个 URL ,返回的图表为PNG格式,直接用浏览器访问如下 URL 即可:

http://202.127.24.18/v4/bin/astro.php?lon=113.17&lat=23.09&ac=0&lang=en&unit=metric&output=internal&tzshift=0

可以通过参数来控制返回结果,这些参数的含义:

  • lon, lat - 指定地点的经纬度,必须是浮点数。
  • ac – 高度改正,只对天文用途预报有效。可取 0(默认)、2 或 7。只适用于图表 API。
  • lang – 语言,en 表示英文,zh-CN 表示中文。只适用于图表 API 。
  • unit – 公制或英制,metric/imperial 。对程序 API 无效。
  • output – 可设定为 internal(图表输出)、xml 或 json(程序 API )。
  • tzshift – 时区微调,可取 0、1 或 -1。对程序 API 无效。
  • product – 为程序 API 选择产品,应为 astro(天文用途), civil, civillight, meteo 或 two 。

程序 API

程序 API 若被成功调用,将会返回一系列数据。这些数据使用 XML 或 JSON 格式封装,其地址分别为:

XML: http://202.127.24.18v4/bin/api.pl?lon=118.093&lat=24.468&product=astro&output=xml JSON: http://202.127.24.18/v4/bin/api.pl?lon=118.093&lat=24.468&product=astro&output=json

product 设为 astro 时,会返回天文用途的数据,返回值的含义:

变量返回值定义
云量10%-6%
26%-19%
319%-31%
431%-44%
544%-56%
656%-69%
769%-81%
881%-94%
994%-100%
抬升指数-10小于-7
-6-7至-5
-4-5至-3
-1-3至0
20至4
64至8
108至11
15大于11
2米气温-76至60-76摄氏度至+60摄氏度
视宁度1<0.5”
20.5”-0.75”
30.75”-1”
41”-1.25”
51.25”-1.5”
61.5”-2”
72”-2.5”
8>2.5”
透明度1<0.3
20.3-0.4
30.4-0.5
40.5-0.6
50.6-0.7
60.7-0.85
70.85-1
8>1
2米相对湿度-40%-5%
-35%-10%
-210%-15%
-115%-20%
020%-25%
125%-30%
230%-35%
335%-40%
440%-45%
545%-50%
650%-55%
755%-60%
860%-65%
965%-70%
1070%-75%
1175%-80%
1280%-85%
1385%-90%
1490%-95%
1595%-99%
16100%
10米风速1低于0.3米/秒(无风)
20.3-3.4米/秒(1-2级)
33.4-8.0米/秒(3-4级)
48.0-10.8米/秒(5级)
510.8-17.2米/秒(6-7级)
617.2-24.5米/秒(8-9级)
724.5-32.6米/秒(10-11级)
8超过32.6米/秒(12级或以上)
降水类型snow(雪)、rain(雨)、none(无)
无效值-9999无效值