「更新公告」心知天气 V3 版 API & 全球 2.4 万城市数据上线
心知天气V3版API是心知天气团队全新重构的天气数据API系统。我们非常含蓄且低调的将之命名为——V3版API。V3不是在V2基础上的简单升级，而是心知天气从数据采集处理到分发的全新平台。
心知天气V3版API的10大新功能
一、支持全球2.4万个城市
V3支持的城市数量从之前的全球3,467个增加到了全球24,373个！上图中的每个亮点就是其中一个城市。而这仅仅只是开始，我们会继续增加更多的地点点亮地球的每个城市每个角落。
二、全新的接口和更丰富的数据内容
- 天气预报支持多达15天
天气预报天数增加到了15天，让你提前知道2周后的天气情况。 - 生活指数增加至27项
生活指数从6项增加到了5大类27项，包括：穿衣、紫外线强度、洗车、旅游、感冒、运动、交通、路况、晾晒、雨伞、空调开启、啤酒、逛街、夜生活、约会、晨练、钓鱼、划船、放风筝、过敏、美发、化妆、风寒、防晒、空气污染扩散条件、舒适度、心情。 - 新增昨日天气数据 /weather/daily.json
V2的future.json升级为了V3的daily.json，支持同时返回昨天和预报数据。用户想参考昨天的温度来决定今天的穿衣？现在so easy。 - 新增日出日落接口 /geo/sun.json
查看全球各地每天日出日落时间，对于喜欢拍摄或观赏日出日落的朋友来说是非常有用的。 - 新增月初月落和月相接口 /geo/moon.json
查看全球各地每天月出月落时间和月相，让依赖潮汐的海洋工作者和喜欢拍摄夜空的摄影爱好者的生活更美好。 - 新增农历、节气和生肖接口 /life/chinese_calendar.json
查询任何一个公历日期对应的农历日期、农历传统节日、二十四节气、天干地支纪年月日及生肖属相。 - 新增位置查询接口 /location/search.json
根据城市中文名、英文名、拼音缩写、经纬度、IP地址查询城市的ID、国家、时区等信息。 - 天气实况新增云量和露点数据
天气实况新增了clouds云量和dew_point露点这两个新的数据，目前仅支持国外城市。
三、融合更多数据源
心知天气通过融合多个气象数据源使得我们的天气数据更加准确、丰富和稳定。在V2版基础上，V3版API融合了更多国内外气象数据源，因此V3版API支持了更多城市和更多数据，进一步提高了稳定性和准确性。
四、全球IP和经纬度自动定位
V3版API采用了三套国内外IP地址数据库，从而支持了全球的IP地址自动定位（V2版API仅支持中国IP地址定位）。同样，我们的经纬度自动定位现在也支持全球2.4万城市了！
五、全新的城市ID
当城市数量增加到2.4万个后，以及为了再接纳未来新增的地点，我们需要一套更加科学合理的地点ID编码方法。经过讨论和实验，我们决定以每个地点经纬度的geohash做为这个地点的ID编码。这套编码无关国家主权、无关政治地缘，而是纯粹的对应着这个地球上的一个位置，从而解决了某些地区和城市的归属变更问题。全球的天气是没有国界的，而科学的编码方式也不应该有偏见。
例如：北京 WX4FBXXFKE4F、旧金山 9Q8YYK8YUV1U、西雅图 C23NB62W20TF
六、标准化的返回格式
V3版统一了所有API的返回结果的JSON格式，并在HTTP响应头中返回相对应的状态码（HTTP Status Code）。
当API正确返回结果时，返回的HTTP状态码为200，所有的结果都在results的数组中，并且每个结果中都包含了所查询城市的location位置信息。
当因为会员级别不足、访问量余额不足、key错误等原因API返回错误信息时，返回HTTP状态码为相应的错误代码，例如以下是当key错误时，返回的HTTP状态码为403 (Forbidden)。返回结果中的status则描述了详细的错误原因。
七、支持JSONP
我们收到了不少用户反馈，希望能够在网页中直接调用心知天气API接口，而不需要通过服务器中转。因此我们在V3版中增加JSONP的支持。
八、更安全的签名验证方式
在原有的key验证方式的基础上，我们增加了新的更安全的签名验证方式。使用签名验证方式是通过HMAC-SHA1对请求参数加密后得到的签名字串进行身份验证，避免了将API密钥（key）明文包含在请求中而造成泄露。
九、API接口定制
在V3版中，我们全新开发了一套API模板引擎——Mirage（[mə’rɑʒ] n. 海市蜃楼；幻想，妄想）。通过Mirage我们可以灵活的定制API接口的输出格式和内容。如果你认为我们提供的接口中包含你不需要的冗余数据，如果你希望以新的方式组合数据，我们很高兴为你提供快速的API接口定制服务。
十、冰山之下
除了Mirage模板引擎外，我们还开发了全新的Drizzle数据采集和处理平台、Hailstone位置查询服务。这些看不见的内部系统，为性能和稳定性的提升、未来更多城市和功能的增加做好了充分的准备。