| 今天是第五专题内容，主要是介绍如何从心知天气官网，获取包含当前天气实况和未来 3 天天气预报的JSON数据信息。
在学习获取及显示天气信息前，我们务必要对JSON数据格式有个深入的了解。
如您需要了解其它专题的内容，请点击下面的链接。
第一专题内容，请参考：连接点亮SPI-TFT屏幕和UI布局设计
第二专题内容，请参考：WIFI模式设置及连接
第三专题内容，请参考：连接SHT30传感器，获取并显示当前环境温湿度数据（I2C）
第四专题内容，请参考：通过NTPClient库获取实时网络时间并显示在TFT屏幕上
一、什么是JSON？
JSON，是JavaScript Object Notation单词首字母的缩写，是一种轻量级的数据交换格式。它以易于阅读和编写的文本格式来存储和表示数据，通常用于在不同的系统之间进行数据交换。JSON数据以键值对或名值对的形式出现，可以包含对象、数组、字符串、数字等基本数据类型。它经常在Web开发、API通信等领域被广泛使用。
通过NodeMCU的WiFi模块，我们可以很容易地从【心知天气】网站获取气象信息，包括天气实况和天气预报等各类数据，这些天气数据是未经压缩的JSON格式数据。关于JSON格式数据，网上有大量文章对其作用、语法规则和应用场景进行详细介绍，请大家自行查询了解。比如，JSON 基本使用_json怎么用-CSDN博客。
二、天气实况数据
1. 天气实况。获取指定城市的天气实况，付费用户可获取全部数据，免费用户只返回天气现象文字、天气现象代码和气温 3 项数据。数据更新频率，国内城市在 15 分钟左右，国际城市在 20 分钟左右。
2. 接口地址
https://api.seniverse.com/v3/weather/now.json?key=your_api_key&location=beijing&language=zh-Hans&unit=c3. 请求参数说明
4. 返回结果示例 （免费用户仅返回 ”now" 的前三项数值）
{
"results": [
{
"location": {
"id": "C23NB62W20TF",
"name": "西雅图",
"country": "US",
"path": "西雅图,华盛顿州,美国",
"timezone": "America/Los_Angeles",
"timezone_offset": "-07:00"
},
"now": {
"text": "多云", //天气现象文字
"code": "4", //天气现象代码
"temperature": "14", //温度，单位为c摄氏度或f华氏度
"feels_like": "14", //体感温度，单位为c摄氏度或f华氏度
"pressure": "1018", //气压，单位为mb百帕或in英寸
"humidity": "76", //相对湿度，0~100，单位为百分比
"visibility": "16.09", //能见度，单位为km公里或mi英里
"wind_direction": "西北", //风向文字
"wind_direction_degree": "340", //风向角度，范围0~360，0为正北，90为正东，180为正南，270为正西
"wind_speed": "8.05", //风速，单位为km/h公里每小时或mph英里每小时
"wind_scale": "2", //风力等级，请参考：http://baike.baidu.com/view/465076.htm
"clouds": "90", //云量，单位%，范围0~100，天空被云覆盖的百分比 #目前不支持中国城市#
"dew_point": "-12" //露点温度，请参考：http://baike.baidu.com/view/118348.htm #目前不支持中国城市#
},
"last_update": "2015-09-25T22:45:00-07:00" //数据更新时间（该城市的本地时间）
}
]
}三、未来15天逐日天气预报
1. 天气预报。获取指定城市未来最多 15 天每天的白天和夜间预报。一般每天更新 3-4 次。付费用户可获取全部数据，免费用户只返回 3 天天气预报。降水预报目前只支持国内城市。
2. 接口地址及示例：北京今天和未来 4 天的预报。
https://api.seniverse.com/v3/weather/daily.json?key=your_api_key&location=beijing&language=zh-Hans&unit=c&start=0&days=5 3. 请求参数说明
4. 返回结果示例
{
"results": [{
"location": {
"id": "WX4FBXXFKE4F",
"name": "北京",
"country": "CN",
"path": "北京,北京,中国",
"timezone": "Asia/Shanghai",
"timezone_offset": "+08:00"
},
"daily": [{ //返回指定days天数的结果
"date": "2015-09-20", //日期（该城市的本地时间）
"text_day": "多云", //白天天气现象文字
"code_day": "4", //白天天气现象代码
"text_night": "晴", //晚间天气现象文字
"code_night": "0", //晚间天气现象代码
"high": "26", //当天最高温度
"low": "17", //当天最低温度
"precip": "0", //降水概率，范围0~1，单位百分比（目前仅支持国外城市）
"wind_direction": "", //风向文字
"wind_direction_degree": "255", //风向角度，范围0~360
"wind_speed": "9.66", //风速，单位km/h（当unit=c时）、mph（当unit=f时）
"wind_scale": "", //风力等级
"rainfall": "0.0", //降水量，单位mm
"humidity": "76" //相对湿度，0~100，单位为百分比
}, {
"date": "2015-09-21",
"text_day": "晴",
"code_day": "0",
"text_night": "晴",
"code_night": "0",
"high": "27",
"low": "17",
"precip": "0",
"wind_direction": "",
"wind_direction_degree": "157",
"wind_speed": "17.7",
"wind_scale": "3",
"rainfall": "0.0",
"humidity": "76"
}, {
... //更多返回结果
}],
"last_update": "2015-09-20T18:00:00+08:00" //数据更新时间（该城市的本地时间）
}]
}四、编程实现获取天气实况和未来 3 天天气预报信息
【编程环境】VSCode + PlatformIO，Platforms：Espressif 8266，Framework: Arduino
以下是具体实现代码，可以复制到 main.cpp 中，修改个别信息后，直接编译上传即可。需要修改的项目，在第五部分详细说明。
#include <ESP8266WiFi.h>
const char* host = "api.seniverse.com"; // 心知天气 API 接口地址
const int httpPort = 80; // http端口80
// 设置wifi接入信息(请根据您的WiFi信息进行修改)
const char* ssid = "xcb940";
const char* password = "87589940abc";
void wifiClientRequest();
void setup() {
//初始化串口设置
Serial.begin(9600);
Serial.println("");
//设置ESP8266工作模式为无线终端模式
WiFi.mode(WIFI_STA);
//开始连接wifi
WiFi.begin(ssid, password);
//等待WiFi连接,连接成功打印IP
while (WiFi.status() != WL_CONNECTED) {
delay(1000);
Serial.print(".");
}
Serial.println("");
Serial.println("WiFi Connected!");
wifiClientRequest();
}
void loop(){}
// 向服务器发送HTTP请求，在串口监视器打印 HTTP请示内容，HTTP响应头信息和请求的数据，包括天气实况和未来3天的天气预报（免费用户只返回3天的）
void wifiClientRequest(){
// 建立WiFi客户端对象，对象名称client
WiFiClient client;
//以下代码，请求返回天气实况信息
// 建立字符串，用于HTTP请求
String httpRequest = String("GET /v3/weather/now.json?key=your_api_key&location=beijing&language=zh-Hans&unit=c") + " HTTP/1.1\r\n" +
"Host: " + host + "\r\n" +
"Connection: close\r\n" +
"\r\n";
// 通过串口输出连接服务器名称以便查阅连接服务器的网址
Serial.print("Connecting to ");
Serial.print(host);
// 连接网络服务器，请求并返回信息
if (client.connect(host, httpPort)){
Serial.println(" Success!"); // 连接成功后串口输出“Success”信息
client.print(httpRequest); // 向服务器发送HTTP请求
Serial.println("Sending request: ");// 通过串口输出HTTP请求信息内容以便查阅
Serial.println(httpRequest);
// 通过串口输出网络服务器响应信息
Serial.println("Web Server Response:");
while (client.connected() || client.available()){
if (client.available()){
String line = client.readStringUntil('\n');
Serial.println(line);
}
}
client.stop(); // 断开与服务器的连接
Serial.print("Disconnected from "); // 并且通过串口输出断开连接信息
Serial.print(host);
} else{ // 如果连接不成功则通过串口输出“连接失败”信息
Serial.println(" connection failed!");
client.stop();
}
Serial.println("");
Serial.println("");
//以下代码，请求返回未来3天天气预报（免费用户只返回3天的数据）
// 建立字符串，用于HTTP请求
httpRequest = String("GET /v3/weather/daily.json?key=your_api_key&location=beijing&language=zh-Hans&unit=c&start=0&days=3") + " HTTP/1.1\r\n" +
"Host: " + host + "\r\n" +
"Connection: close\r\n" +
"\r\n";
// 通过串口输出连接服务器名称以便查阅连接服务器的网址
Serial.print("Connecting to ");
Serial.print(host);
// 连接网络服务器，
if (client.connect(host, httpPort)){
Serial.println(" Success!"); // 连接成功后串口输出“Success”信息
client.print(httpRequest); // 向服务器发送HTTP请求
Serial.println("Sending request: ");// 通过串口输出HTTP请求信息内容以便查阅
Serial.println(httpRequest);
// 通过串口输出网络服务器响应信息
Serial.println("Web Server Response:");
while (client.connected() || client.available()){
if (client.available()){
String line = client.readStringUntil('\n');
Serial.println(line);
}
}
client.stop(); // 断开与服务器的连接
Serial.print("Disconnected from "); // 并且通过串口输出断开连接信息
Serial.print(host);
} else{ // 如果连接不成功则通过串口输出“连接失败”信息
Serial.println(" connection failed!");
client.stop();
}
}五、特别提醒需要修改的部分信息
（1）修改WiFi连接信息
// 设置wifi接入信息(请根据您的WiFi信息进行修改)
const char* ssid = "xcb940";
const char* password = "87589940abc";（2）修改第 43 行http请求：“key = your_api_key” ------->> 修改为您自己的密钥， “location = beijing” ------->> 修改为您所希望的所在地区
//第43行
String httpRequest = String("GET /v3/weather/now.json?key=your_api_key&location=beijing&language=zh-Hans&unit=c") + " HTTP/1.1\r\n" +（3）修改第 82行http请求：“key = your_api_key”------->> 修改为您自己的密钥， “location = beijing” ------->> 修改为您所希望的所在地区
//第 82行
httpRequest = String("GET /v3/weather/daily.json?key=your_api_keyu&location=beijing&language=zh-Hans&unit=c&start=0&days=3") + " HTTP/1.1\r\n" +六、运行结果分析
程序编译上传成功执行后，如果在串口监视器找到以下包含天气信息的两个JSON数据，一个是包含天气实况的信息，另一个是包含未来 3 天天气预报的信息。那么，恭喜您：现在可以正常从心知天气官网获取天气数据信息了。
项目源代码下载：
百度网盘：https://pan.baidu.com/s/11ggPQdj9rzYP3Av97Z85Kg?pwd=aira，提取码：aira
//以下返回的天气实况
{"results":[{"location":{"id":"WX4FBXXFKE4F","name":"北京","country":"CN","path":"北京,北京,中国","timezone":"Asia/Shanghai","timezone_offset":"+08:00"},"now":{"text":"晴","code":"0","temperature":"29"},"last_update":"2024-05-08T15:44:15+08:00"}]}
//以下返回的是未来 3 天的天气预报
{"results":[{"location":{"id":"WX4FBXXFKE4F","name":"北京","country":"CN","path":"北京,北京,中国","timezone":"Asia/Shanghai","timezone_offset":"+08:00"},"daily":[{"date":"2024-05-08","text_day":"晴","code_day":"0","text_night":"晴","code_night":"1","high":"30","low":"14","rainfall":"0.00","precip":"0.00","wind_direction":"西南","wind_direction_degree":"225","wind_speed":"23.4","wind_scale":"4","humidity":"56"},{"date":"2024-05-09","text_day":"晴","code_day":"0","text_night":"多云","code_night":"4","high":"30","low":"16","rainfall":"0.00","precip":"0.00","wind_direction":"
南","wind_direction_degree":"180","wind_speed":"8.4","wind_scale":"2","humidity":"48"},{"date":"2024-05-10","text_day":"多云","code_day":"4","text_night":"多云","code_night":"4","high":"29","low":"17","rainfall":"0.00","precip":"0.00","wind_direction":"西南","wind_direction_degree":"225","wind_speed":"3.0","wind_scale":"1","humidity":"71"}],"last_update":"2024-05-07T08:00:00+08:00"}]}下一个专题，我们将解析从心知天气官网获取到的JSON数据，并把它们显示到 TFT 液晶显示屏上。敬请关注。
参考文档
1. JSON 基本使用_json怎么用-CSDN博客
