API开发文档

和风天气API为用户提供一个简洁的RESTful API接口,用以访问基于位置的天气数据,包括实况天气、30天预报、逐小时预报、空气质量AQI,灾害预警、分钟级降水、生活指数等天气数据服务。

地理信息API

通过地理信息API获取你需要查询的城市信息,包括城市或POI的Location ID、坐标、行政区划关系。

城市天气API

用途最广泛的城市级天气数据,可获取全球超过15万个城市的天气实况、预报,另外包括中国境内分钟降水数据。

格点天气API

中国地区1公里格点精细化天气,包括天气实况和预报。

天气指数API

获取全球城市的天气指数,包括穿衣、运动、洗车、紫外线等16类指数。

灾害预警API

获取各国官方极端天气预警及其他灾害预警信息。

空气API

支持中国城市、监测站点的实时空气质量数据,并提供全国城市空气质量预报。

历史数据API

获取最近10天天气和空气质量数据

热带气旋(台风)API

提供全球台风追踪,包括实时台风位置、台风路径、台风预报等信息。

天文API

天文数据主要包括太阳和月亮的相关数据,包括日出日落、月相、太阳高度角等数据。

海洋API

提供全球上千个港口或沿海地区潮汐、潮流数据,包括满潮、干潮时间和逐小时预报。

不做假设

无论任何时候,不要假定返回的数据都是完整的,或者对返回数据的长度、范围进行假设。例如:当我们的数据源缺少某些数据的时候可能会导致字段缺失;高纬度地区某一天可能会出现没有日出日落的情况;天气状况可能会增加新的代码;当我们的功能升级时,可能在数据返回中增加新的字段或参数。因此在你的程序中必须考虑如何处理这种问题。

Gzip压缩

v7版本API默认采用gizp压缩,可大幅降低流量,提高响应速度,请对你获取到的数据进行解压。

多语言

和风天气API v7版本支持31种主流语言

如需要查看更早期的版本的开发文档请访问 S6版本,S6版本的技术支持截止于2020年6月1日。