长期天气预报服务：自建解决方案与接口

本文档是一份关于天气服务的说明文档，由DaWeiMin编写于2018年1月6日。文档的主要目标是为了克服现有天气API（如高德、百度）提供的短期预报限制以及第三方API的调用次数限制和认证复杂性问题。服务主要包括两个组成部分：天气Web服务（weather-web项目）和一个用于演示的小程序（weather-weixin项目），可通过扫描二维码体验。 1. **服务背景**： - 设计这个服务的原因有两个关键点： - 缺乏长期天气预报：当前的主流天气API只能提供3天的预测，无法满足用户对于长期预报的需求。 - 第三方API局限性：API调用次数有限制，且认证过程繁琐，可能影响服务的稳定性和用户体验。 2. **服务不足与声明**： - 服务依赖第三方网站，当这些网站的网页结构发生变化时，需要调整代码以保持兼容性。 - 对第三方服务器的稳定性有依赖，如果对方服务中断或采用反爬策略，服务可能会受到影响。 - 本服务仅为学习交流目的而设计，并非商业化项目。 3. **服务结构**： - 服务架构包括内部缓存机制，以减少对第三方数据的频繁请求。数据按天更新，只有过期的数据才会重新抓取，否则返回缓存中的信息。 - 用户可以通过经纬度或城市名称（拼音）查询天气，需通过腾讯API将经纬度转换为城市名，并预先爬取城市名与拼音的对应关系。 4. **服务接口**： - 提供了两种访问接口：一是按经纬度查询（如/weather/?latitude=...&longitude=...），二是按城市名称或拼音查询（如/weather/城市名或拼音）。 - 返回结果采用JSON格式，包含了查询城市30天的基本天气信息，包括查询城市名和每日天气数据。 综上，这份文档详细介绍了作者设计天气服务的初衷，服务架构中的关键组件，以及如何通过提供的接口获取天气数据。同时，也揭示了服务的一些限制和优化策略，帮助开发者更好地理解和使用这一服务。