- /doc 文件夹中包含项目截图和以下将要描述的文档(PDF文档 )。
- weather-web 项目： 天气Web服务。
- weather-weixin 项目：查询天气微信小程序（微信扫描下图可以查看）。
- 项目中一些关键Key已经去除，开发者可以自行添加，如有问题可以留言或者邮件联系。
- 欢迎 fork 和 star ~
设计该服务，主要有以下几个原因：
- 目前的一些天气API（高德、百度等）都只有3天的预报，不能提供长期预报。
- 第三方API有调用次数限制、认证情况比较麻烦。
该服务存在以下缺陷：
- 依赖第三方网站，第三方网站的网页结构变化后需要重新修改代码。
- 第三方服务器崩溃或者提供反爬技术的话，该服务失效。
本服务只是为了学习交流使用。
如果开发者需要基于该服务项目进行开发的话，需要了解该服务的一些结构。该服务（weather-web项目）的总体结构如下图所示。
其中，淡粉色部分表示支持查询的接口，淡紫色部分表示第三方的接口或网站，淡绿色部分是项目中主要的几个类。使用该服务，需要注意一下几个方面：
- 如果是按经纬度查询，则需要利用第三方API（腾讯的API）将经纬度转换为对应的城市名称。
- 因为最后是根据查询城市的拼音找到解析数据的网页的，所以需要事先爬取城市名称和拼音的关系，最后统一转换为按拼音查询。
- 为了减少频繁爬取第三方数据，该服务按天粒度进行更新，每次查询的时候会比对天气日期，如果过期才会重新爬取，否则则会返回缓存中的数据。 为了服务的快速，服务所有数据都在内存中，并没有落盘。
访问接口如下表所示，接口中中文部分表示需要提供的参数。开发者在部署服务后，最终的访问接口是：协议（http 或 https）+ 主机地址 + 接口。
| 功能 | 接口 |
|---|---|
| 按经纬度进行查询 | /weather/?latitude=纬度&longitude=经度 |
| 按城市名称中文（或拼音）进行查询 | /weather/城市名称或拼音 |
开放测试接口：https://weather.mindawei.cn/weather/
以杭州为例：
- https://weather.mindawei.cn/weather/hangzhou
- https://weather.mindawei.cn/weather/杭州
- https://weather.mindawei.cn/weather/?latitude=30.27415&longitude=120.15515
返回的结果是Json格式，包含30天天气基本情况，具体如下所示：
{
"queryName": "泰州", // 查询的城市名字，如果无数据返回空
"date": "2018-01-06", // 第一天数据日期，缓存可以判断是否过期
"weatherItems": [ // 天气情况数组，30天
{
"date": "01月06日", // 日期
"dayKind": "今天", // 星期几，前三天是今天明天后天
"weather": "雪", // 天气描述
"weatherImg": "b15.png", // 天气用什么图片表示
"minTemperature": "-6", // 最低温度
"maxTemperature": "4", // 最高温度
"wind": "东北风 3级" // 风力描述
},
...
]
}
基于该服务可以构建一些天气查询应用。为了演示该服务，写了一个小程序。下面几幅图就是小程序项目（weather-weixin）的演示效果图。小程序启动时可以根据经纬度给出一个当前位置的天气情况，之后可以根据查询关键字更新数据。
- 如果要支持经纬度查询，则需要配置WeatherWebConfig.txt中的腾讯地图API KEY。
- 由于小程序使用https，所以如果要运行小程序，则需要将域名指向Web服务主机，申请证书，并配置src/main/resources下的application.properties文件。
- project.config.json中填入你申请的appid。
- pages\index\index.js内容中开头部分的baseUrl替换成：Web服务地址的部署地址+”weather/”。