天气API开发概述

和风天气API为用户提供一个简洁的RESTful Web接口,用以访问基于位置的天气数据。当前API最新版本为v7

获取城市地理位置

天气API提供了基于地理位置的天气数据,因此在获取天气数据前,第一步就是获取地理位置:

  • 通过城市名称搜索,支持模糊搜索
  • 通过经纬度获取
  • 通过ADcode(仅限中国城市)

你可以通过城市信息搜索获取到精准的地理位置信息,这些位置信息均包含Location ID(例如北京的Location ID为101010100),你需要使用这个Location ID去获取该地点的天气预报、实况等数据。

获取天气数据

和风天气API v7版本提供如下天气数据内容:

  • 3-15天天气预报(全球)
  • 未来7天逐小时天气预报(全球)
  • 实况天气(全球)
  • 1公里格点实况天气(中国)
  • 1公里格点逐天预报天气(中国)
  • 1公里格点逐小时预报天气(中国)
  • 分钟级降雨预报(中国)
  • 极端天气灾害预警(中国、美国、欧洲)
  • 中国4A和5A级景点3-7天天气预报(中国)
  • 生活指数(全球)
  • 历史天气(全球)
  • 太阳角度(全球)
  • 日出日落(全球)
  • 月升月落(全球)
  • 台风路径和周围天气(中国)
  • 卫星云图(中国、美国、欧洲、日本)
  • 中国空气质量指数实况(中国)
  • 中国未来7天空气质量预报(中国)

多语言

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

Gzip压缩

和风天气API默认使用gzip压缩,有效降低流量提高访问速度。

注意事项

  • 无论任何时候,不要假定返回的数据都是完整的,或者对返回数据的长度、范围进行假设。例如:当我们的数据源缺少某些数据的时候可能会导致字段缺失;高纬度地区某一天可能会出现没有日出日落的情况;天气状况可能会增加新的代码;当我们的功能升级时,可能在数据返回中增加新的字段或参数。因此在你的程序中必须考虑如何处理这种问题。
  • 如非必要,不要缓存数据,确保每次获取的都是最新的数据,最新的城市ID或最新的天气状况代码。
  • 所有预报数据都不能保证100%准确,因此可能会出现实况温度要高于或低于当天预报的最高/最低温度。
  • 实况数据均为近实时数据,相比真实的物理世界会5-20分钟的延迟,请根据实况数据中的obsTime确定数据对应的准确时间。
  • v7版本API默认采用gizp压缩,可降低你的设备带宽流量,提高响应速度。
  • 使用移动端或服务端SDK,可以大幅减轻你的工作量。

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