11、合宙Air模块Luat开发：通过http协议获取天气信息

目录

点击这里查看所有博文

  本系列博客，理论上适用于合宙的Air202、Air268、Air720x、Air720S以及最近发布的Air720U（我还没拿到样机，应该也能支持）。

  先不管支不支持，如果你用的是合宙的模块，那都不妨一试，也许会有意外收获。

  我使用的是Air720SL模块，如果在其他模块上不能用，那就是底层core固件暂时还没有支持，这里的代码是没有问题的。例程仅供参考！

一、前言

  最近我又变懒了许多，本来计划这篇博客应该是在上篇博客JSON讲完后紧接着继续讲的。相当于一个JSON的实战，用来做一下练习。可惜的是计划赶不上变化，懒惰使我把这篇博客硬生生的拖了一个多月才写完，罪过罪过。

  说到天气预报，我想起来我小时候的一件事，具体是几十年前的事情我都忘了。就忽略时间单纯的说说这件事吧。

  在很久很久以前，我爸妈在家做农活的时候，尤其是夏天，天黑得比较晚。我爸妈在地里做农活，那时候天不完全黑下来正常情况下一般不会提前回来，等天黑之后也就七点半了，回来烧烧饭吃完就八点多。

  这时候出现一个问题天气预报错过了怎么办，不知道天气就不好安排明天干什么。尤其是雷阵雨，有时候开着大太阳雨就下来了，我经历过好几次晒着被子突然就下雨了，然后就狗比了。

  不知道天气预报很麻烦，那时候又没有智能手机不能上网查天气预报，我又不在家，错过天气预报那就是错过了。后来我就给我妈的手机订阅了一个天气预报的服务，一天一条短信通知。一个月下来好像是6块钱，现在看6块钱啥也不是，也就一瓶饮料。那时候不得了一块钱能买两个大饼，六块钱就是我一个星期的早饭，是真贵啊。仔细算算一个月下来也就六块钱也还可以接受。

  后来有了智能手机可以上网查询天气预报了，虽然现在我也不用下地干活，但是不知道天气预报会让我不安。直到现在我手机里面第一屏永远都是天气预报。

  有时候我也想这些软件是怎么获得天气预报的呢，不用猜了这肯定是和网络有关。你说巧不巧，我们现在用的合宙的模块就可以联网。既然可以联网那就有办法能够知道天气预报怎么获取，只不过它没有图形化的操作系统，能够使用的工具那就是代码。

  闲话扯了这么多，朕倦了，回归正题。

二、现在是正事了

2.1 http简述

  长话短说，本篇博客主要是使用http协议发送get请求，获取天气预报的信息然后进行解析打印出来。一般情况下get请求的信息里面的body内容都是JSON字符串，这就用到了我上篇博客说讲到的JSON字符串的生成与解析，在学习新的知识的基础上，顺便对上篇博客所学的内容进行一下复习。

  有关http相关知识，我这里就不讲了，自行去了解。一句话概括就是http其实是基于tcp，只不过带上了http规定的的通讯报文格式。在进行一次连接后立即关闭，是一个短连接。

  有兴趣的小伙伴可以使用tcp的连接，带上http的通讯报文。模拟一下http协议是怎么交互信息的。

  今天我就不模拟了，因为合宙官方已经封装了http协议的通讯包（合宙牛逼，破音~！！）。我们直接拿来用就行了。

  知道了怎么才能获取信息后，还得知道向谁要。我本来是准备使用京东的api平台的天气服务，请求数据下来一看一大堆数据那家伙叫一个多，解析起来不方便。对于小白来讲那也许就是从入门到放弃了。经过再三考虑选择心知天气，体验了一下效果还不错，body报文挺简洁的。

2.2 查询文档获取请求地址

  官方给出了示例，北京今天和未来 4 天的预报https://api.seniverse.com/v3/weather/daily.json?key=SQfjxV9fAdBJq9jDr&location=beijing&language=zh-Hans&unit=c&start=0&days=5

  要注意的是，获取指定城市未来最多 15 天每天的白天和夜间预报，以及昨日的历史天气。付费用户可获取全部数据，免费用户只返回 3 天天气预报。

  然后对照下表替换，自己的信息，对于我们学习的话，一般情况下只需要替换key和location。

  有的同学要是懒的话，干脆不用替换。直接用官方的示例api就行了。我就是这种懒人，什么都不改，直接用，管他三七二十一，反正是学习。

2.3 测试API

  复制2.2小节里面提到的API，直接在浏览器地址栏粘贴访问，得到如下内容。

  复制到JSON校验地址进行格式化检验，可以知道请求API后，服务器返回的数据确实是json字符串。

  或者开启浏览器的开发者模式，选择网络标签，进行抓包。浏览器会自动将返回的body数据进行 JSON解析预览。

三、编写测试程序

  编写http代码之前，需要引用require "http"包

3.1、编写http请求程序

local function Test_Task()

    local key = "SQfjxV9fAdBJq9jDr"
    local location = "beijing"
    local language = "zh-Hans"
    local unit = "c"
    local start = "0"
    local days = "5"
    local url = string.format("https://api.seniverse.com/v3/weather/daily.json?key=%s&location=%s&language=%s&unit=%s&start=%s&days=%s", key, location, language, unit, start, days)
    while true do
        http.request("GET", url, nil, nil, nil, nil, cbFnc)
        sys.wait(30000)
    end
end

3.2、编写JSON解析程序

local function cbFnc(result, prompt, head, body)
    log.info("cbFnc", result, prompt)
    if result and body then
        log.info("cbFnc", "bodyLen=" .. body:len())
        
        local tjsondata, result, errinfo = json.decode(body)
        if result and type(tjsondata) == "table" then
            local results = tjsondata["results"][1]
            
            local name = results["location"]["name"]
            log.info("name:", name)
            
            local daily1 = results["daily"][1]
            log.info("date:", daily1["date"])
            log.info("text_day:", daily1["text_day"])
            log.info("text_night:", daily1["text_night"])
            
            local daily2 = results["daily"][2]
            log.info("date:", daily2["date"])
            log.info("text_day:", daily2["text_day"])
            log.info("text_night:", daily2["text_night"])
            
            local daily3 = results["daily"][3]
            log.info("date:", daily3["date"])
            log.info("text_day:", daily3["text_day"])
            log.info("text_night:", daily3["text_night"])
            
            log.info("last_update:", results["last_update"])
        
        else
            log.info("testJson.decode error", errinfo)
        end
    end
end

四、下载完整程序到开发板验证

  完整代码在此，自取

--必须在这个位置定义PROJECT和VERSION变量
--PROJECT：ascii string类型，可以随便定义，只要不使用,就行
--VERSION：ascii string类型，如果使用Luat物联云平台固件升级的功能，必须按照"X.X.X"定义，X表示1位数字；否则可随便定义
PROJECT = "LED"
VERSION = "0.0.1"
require "sys"
--加载日志功能模块，并且设置日志输出等级
--如果关闭调用log模块接口输出的日志，等级设置为log.LOG_SILENT即可
require "log"
LOG_LEVEL = log.LOGLEVEL_TRACE

require "http"

local function cbFnc(result, prompt, head, body)
    log.info("cbFnc", result, prompt)
    if result and body then
        log.info("cbFnc", "bodyLen=" .. body:len())
        
        local tjsondata, result, errinfo = json.decode(body)
        if result and type(tjsondata) == "table" then
            local results = tjsondata["results"][1]
            
            local name = results["location"]["name"]
            log.info("name:", name)
            
            local daily1 = results["daily"][1]
            log.info("date:", daily1["date"])
            log.info("text_day:", daily1["text_day"])
            log.info("text_night:", daily1["text_night"])
            
            local daily2 = results["daily"][2]
            log.info("date:", daily2["date"])
            log.info("text_day:", daily2["text_day"])
            log.info("text_night:", daily2["text_night"])
            
            local daily3 = results["daily"][3]
            log.info("date:", daily3["date"])
            log.info("text_day:", daily3["text_day"])
            log.info("text_night:", daily3["text_night"])
            
            log.info("last_update:", results["last_update"])
        
        else
            log.info("testJson.decode error", errinfo)
        end
    end
end


local function Test_Task()

    local key = "SQfjxV9fAdBJq9jDr"
    local location = "beijing"
    local language = "zh-Hans"
    local unit = "c"
    local start = "0"
    local days = "5"
    local url = string.format("https://api.seniverse.com/v3/weather/daily.json?key=%s&location=%s&language=%s&unit=%s&start=%s&days=%s", key, location, language, unit, start, days)
    while true do
        http.request("GET", url, nil, nil, nil, nil, cbFnc)
        sys.wait(30000)
    end
end

local function user_main()
    sys.wait(10000)
    sys.taskInit(Test_Task)
end

--启动系统框架
sys.taskInit(user_main)
sys.init(0, 0)
sys.run()

  下载完成后打开监视功能，接收到的天气数据解析成功，有能力的小伙伴可以试试将解析出来的数据显示在oled屏幕上，做个UI比这逼格更高。

[2020-05-06 20:54:17.820] [I]-[socket:connect-coreid,prot,addr,port,cert,timeout] 0 TCPSSL api.seniverse.com 443 nil 120
[2020-05-06 20:54:18.346] [I]-[socket:on_response:] 0 SOCKET_CONNECT 0
[2020-05-06 20:54:18.361] [I]-[socket:connect: connect ok]
[2020-05-06 20:54:18.375] [D]-[socket.send] total 161 bytes first 30 bytes GET /v3/weather/daily.json?key
[2020-05-06 20:54:18.500] [I]-[socket:on_response:] 0 SOCKET_SEND 0
[2020-05-06 20:54:18.507] [I]-[cbFnc] true 200
[2020-05-06 20:54:18.511] [I]-[cbFnc] bodyLen=995
[2020-05-06 20:54:18.522] [I]-[name:] 北京
[2020-05-06 20:54:18.525] [I]-[date:] 2020-05-06
[2020-05-06 20:54:18.537] [I]-[text_day:] 多云
[2020-05-06 20:54:18.541] [I]-[text_night:] 小雨
[2020-05-06 20:54:18.552] [I]-[date:] 2020-05-07
[2020-05-06 20:54:18.556] [I]-[text_day:] 小雨
[2020-05-06 20:54:18.568] [I]-[text_night:] 小雨
[2020-05-06 20:54:18.572] [I]-[date:] 2020-05-08
[2020-05-06 20:54:18.584] [I]-[text_day:] 阴
[2020-05-06 20:54:18.588] [I]-[text_night:] 多云
[2020-05-06 20:54:18.598] [I]-[last_update:] 2020-05-06T17:25:53+08:00
[2020-05-06 20:54:18.602] [I]-[socket:sock_close] 0
[2020-05-06 20:54:18.614] [I]-[socket:on_response:] 0 SOCKET_CLOSE 0
[2020-05-06 20:54:26.219] DBG: print com USB 断开连接 COM4 CommError (31),[WinError 0] 操作成功完成。

不会下载的点击这里，进去查看我的第二篇博文2、Air720SL模块Luat开发：第一个Luat的Hello World里面讲了怎么下载
这里只是我的学习笔记，拿出来给大家分享，欢迎大家批评指正，本篇教程到此结束