https://github.com/mindawei/weather

一个天气查询服务：爬取数据、Web服务、小程序展示
https://github.com/mindawei/weather

html java maven mini-program spring-boot weather-service

Last synced: 23 days ago
JSON representation

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

• Host: GitHub
• URL: https://github.com/mindawei/weather
• Owner: mindawei
• Created: 2018-01-06T04:08:14.000Z (almost 7 years ago)
• Default Branch: master
• Last Pushed: 2018-03-26T13:46:28.000Z (over 6 years ago)
• Last Synced: 2024-11-07T02:36:20.919Z (about 2 months ago)
• Topics: html, java, maven, mini-program, spring-boot, weather-service
• Language: Java
• Homepage:
• Size: 1.24 MB
• Stars: 55
• Watchers: 5
• Forks: 10
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

• Awesome-Miniprogram - 天气预报小程序

README

        
### 前置说明

1. /doc 文件夹中包含项目截图和以下将要描述的文档(PDF文档 )。

2. weather-web 项目： 天气Web服务。 

3. weather-weixin 项目：查询天气微信小程序（微信扫描下图可以查看）。

![查询天气小程序](https://github.com/mindawei/weather/blob/master/doc/imgs/weahter-weixin.jpg)

4. 项目中一些关键Key已经去除，开发者可以自行添加，如有问题可以留言或者邮件联系。

5. 欢迎 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/

以杭州为例：

* https://weather.mindawei.cn/weather/hangzhou

* https://weather.mindawei.cn/weather/杭州

* https://weather.mindawei.cn/weather/?latitude=30.27415&longitude=120.15515

## 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/”。