Skip to content

一个天气查询服务:爬取数据、Web服务、小程序展示

Notifications You must be signed in to change notification settings

mindawei/weather

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

22 Commits
 
 
 
 
 
 
 
 

Repository files navigation

前置说明

  1. /doc 文件夹中包含项目截图和以下将要描述的文档(PDF文档 )。
  2. weather-web 项目: 天气Web服务。
  3. weather-weixin 项目:查询天气微信小程序(微信扫描下图可以查看)。

查询天气小程序

  1. 项目中一些关键Key已经去除,开发者可以自行添加,如有问题可以留言或者邮件联系。
  2. 欢迎 fork 和 star ~

天气服务说明文档

1背景

1.1意义

  设计该服务,主要有以下几个原因:

  1. 目前的一些天气API(高德、百度等)都只有3天的预报,不能提供长期预报。
  2. 第三方API有调用次数限制、认证情况比较麻烦。

1.2不足

  该服务存在以下缺陷:

  1. 依赖第三方网站,第三方网站的网页结构变化后需要重新修改代码。
  2. 第三方服务器崩溃或者提供反爬技术的话,该服务失效。

1.3 声明

  本服务只是为了学习交流使用。

2服务结构

  如果开发者需要基于该服务项目进行开发的话,需要了解该服务的一些结构。该服务(weather-web项目)的总体结构如下图所示。

  其中,淡粉色部分表示支持查询的接口,淡紫色部分表示第三方的接口或网站,淡绿色部分是项目中主要的几个类。使用该服务,需要注意一下几个方面:

  1. 如果是按经纬度查询,则需要利用第三方API(腾讯的API)将经纬度转换为对应的城市名称。
  2. 因为最后是根据查询城市的拼音找到解析数据的网页的,所以需要事先爬取城市名称和拼音的关系,最后统一转换为按拼音查询。
  3. 为了减少频繁爬取第三方数据,该服务按天粒度进行更新,每次查询的时候会比对天气日期,如果过期才会重新爬取,否则则会返回缓存中的数据。 为了服务的快速,服务所有数据都在内存中,并没有落盘。

3服务接口

3.1访问接口

  访问接口如下表所示,接口中中文部分表示需要提供的参数。开发者在部署服务后,最终的访问接口是:协议(http 或 https)+ 主机地址 + 接口。

功能 接口
按经纬度进行查询 /weather/?latitude=纬度&longitude=经度
按城市名称中文(或拼音)进行查询 /weather/城市名称或拼音

开放测试接口https://weather.mindawei.cn/weather/

以杭州为例:

3.2返回结果

  返回的结果是Json格式,包含30天天气基本情况,具体如下所示:


{
    "queryName": "泰州",  // 查询的城市名字,如果无数据返回空
    "date": "2018-01-06",  // 第一天数据日期,缓存可以判断是否过期
    "weatherItems": [     // 天气情况数组,30天
        {
            "date": "01月06日",      // 日期
            "dayKind": "今天",        // 星期几,前三天是今天明天后天 
            "weather": "雪",           // 天气描述
            "weatherImg": "b15.png",   // 天气用什么图片表示
            "minTemperature": "-6",    // 最低温度 
            "maxTemperature": "4",     // 最高温度
            "wind": "东北风 3级"     // 风力描述
        },
        ...
    ]
}

4基于该服务的小程序

  基于该服务可以构建一些天气查询应用。为了演示该服务,写了一个小程序。下面几幅图就是小程序项目(weather-weixin)的演示效果图。小程序启动时可以根据经纬度给出一个当前位置的天气情况,之后可以根据查询关键字更新数据。

5项目实际部署

5.1运行Web服务

  1. 如果要支持经纬度查询,则需要配置WeatherWebConfig.txt中的腾讯地图API KEY。
  2. 由于小程序使用https,所以如果要运行小程序,则需要将域名指向Web服务主机,申请证书,并配置src/main/resources下的application.properties文件。

5.2运行小程序

  1. project.config.json中填入你申请的appid。
  2. pages\index\index.js内容中开头部分的baseUrl替换成:Web服务地址的部署地址+”weather/”。

About

一个天气查询服务:爬取数据、Web服务、小程序展示

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published