晴天钟 Documentation

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 时，会返回天文用途的数据，返回值的含义：