【NodeMCU实时天气时钟温湿度项目 6】解析天气信息JSON数据并显示在 TFT 屏幕上（心知天气版）

本文链接：https://blog.csdn.net/qq_15776011/article/details/138584107

今天是第六专题，主要内容是：导入ArduinoJson功能库，借助该库解析从【心知天气】官网返回的JSON数据，并显示在 TFT 屏幕上。

        如您需要了解其它专题的内容，请点击下面的链接。
        第一专题内容，请参考：连接点亮SPI-TFT屏幕和UI布局设计
        第二专题内容，请参考：WIFI模式设置及连接
        第三专题内容，请参考：连接SHT30传感器，获取并显示当前环境温湿度数据（I2C）
        第四专题内容，请参考：通过NTPClient库获取实时网络时间并显示在TFT屏幕上
        第五专题内容，请参考：获取关于城市天气实况和天气预报的JSON信息（心知天气版）

一、【心知天气】官网JSON数据特点

        1、通过API返回的JSON数据，是未经压缩的明文JSON数据，可以直接使用ArduinoJson功能库解析需要的数值，JSON数据解析过程简单方便。
        2、天气实况数据。付费用户可获取全部数据；免费用户只返回天气现象文字、天气现象代码和气温 3 项数据，可供使用的数据比较少。数据更新频率，国内城市在 15 分钟左右，国际城市在 20 分钟左右。
        3、天气预报数据。可获取指定城市未来最多 15 天每天的白天和夜间预报。一般每天更新 3-4 次。付费用户可获取全部数据，免费用户只返回 3 天天气预报，可供使用的数据比较少。
        说明：如果仅作程序调试使用，可申请开通试用版，能通过API获取全部数据，试用期14天。

二、添加ArduinoJson库

        1、ArduinoJson库。是为 Arduino 和 IOT(Internet Of Things，物联网)开的 C++ JSON库，使用简单、高效，通用性强，在Github具备很高的活跃度。支持JSON数据的序列化、反序列化（或称序列化还原、解析）、MessagePack、流数据、过滤以及其他功能。官网链接，Github站点。
        2、添加库方法。打开 PlatformIO 界面，选择 Libraries 图标，在搜索栏内输入 ArduinoJson，在查询结果中选择ArduinoJson by Benoit Blanchon库，,添加到项目中。

        3、使用方法。解析JSON天气信息数据的程序代码，我们一般借助ArduinoJson官网提供的工具助手（Assistant），先生成基本代码，然后根据项目需要进行取舍，或进行格式转换后，再复制到项目中。本文第三部分我们进行示例说明。

        4、重要文档。关于安装库，建构和解析JSON，官方示例，API参考，FAQ等有关信息，请查阅官网 documentation 的内容。

三、解析JSON数据方法步骤

这是从【心知天气】官网通过API请求返回的原始JSON数据。

// 这是从【心知天气】官网通过API请求返回的原始JSON数据
{"results":[{"location":{"id":"WWE0TGW4PX6N","name":"济南","country":"CN","path":"济南,济南,山东,中国","timezone":"Asia/Shanghai","timezone_offset":"+08:00"},"now":{"text":"晴","code":"0","temperature":"28","feels_like":"27","pressure":"989","humidity":"31","visibility":"26.6","wind_direction":"南","wind_direction_degree":"201","wind_speed":"30.0","wind_scale":"5","clouds":"15","dew_point":""},"last_update":"2024-05-10T11:07:41+08:00"}]}

在这部分，我们以【心知天气】返回的JSON数据为例，来说明生成解析代码的方法。
1、打开ArduinoJson官网。点选页面上方菜单栏 [Assistant]，显示以下界面。Board项，选择NodeMCU 1.0 (ESP-12E Module)；Mode项，选择 Deserialize ；Input项，选择 String。点击右下方按钮 [Next：JSON]。

        2、复制JSON代码。将上述JSON原始数据复制到页面的【Input】输入框内，点击右下方按钮【Next：Program】。

        3、生成解析程序代码。以下输入框内，就是使用助手自动生成解析代码。将代码复制到项目中，稍加调整修改后，就可以很方便地取出JSON内的数值了。

        4、测试。新建一个项目，把以下代码复制到 main.cpp 中，然后编译上传到开发板。

#include <Arduino.h>
#include <ArduinoJson.h>

void setup()
{
  // Initialize serial port
  Serial.begin(9600);
  while (!Serial)
    continue;

  // JSON input string.
  const