如何将 ESP32 快速接入高德、心知、和风天气API 获取天气信息

ESP32 Weather 组件:打造属于你的智能天气站

这里推荐大家使用 ESP32 Weather 组件快速接入高德、心知、和风三种天气 API,获取丰富的天气数据。

项目简介

ESP32 Weather 是一个基于 ESP32 IDF 的第三方组件,它支持高德、心知、和风三种天气 API,能够自动识别位置并获取包括温度、湿度、风向风速等在内的丰富天气数据。项目还提供了美观的终端输出和 HTTPS 加密传输,确保数据安全。用户可以轻松地将其集成到 ESP32 项目中,快速实现天气信息的获取和展示。

项目地址:GitHub - NingZiXi/weather

功能亮点

  • 三合一 API 支持:可以选择高德、心知、和风天气中的任意一种 API,这为用户提供了更多的选择和灵活性。
  • 智能定位:组件能够自动识别你的位置,无需手动配置,大大简化了使用过程。
  • 数据丰富:涵盖了温度、湿度、风速、降水等多种天气数据,满足了不同用户的需求。
  • 终端美化:控制台输出美观大方,堪比艺术品,提升了用户体验。
  • 安全可靠:采用 HTTPS 加密传输和 CRT 证书验证,确保数据的安全性。

免费数据支持对比

功能特性 高德天气 心知天气 和风天气
实时天气 ✅ ✅ ✅
温度 ✅ ✅ ✅
湿度 ✅ ❌ ✅
风向风速 ✅ ❌ ✅
风力 ✅ ❌ ✅
气压 ❌ ❌ ✅
能见度 ❌ ❌ ✅
体感温度 ❌ ❌ ✅
降水量 ❌ ❌ ✅
云量 ❌ ❌ ✅
露点温度 ❌ ❌ ✅
免费调用次数 30 万/日 无次数限制 1000/日
是否需要付费 可选 可选 可选

从上表可以看出,和风天气虽然免费调用次数较少,但免费版的服务与付费版相同,数据也较为丰富,因此推荐使用和风天气。

快速开始

1. 克隆项目

要将组件添加到项目中,可以在 IDF 终端执行以下命令:

bash 复制代码
idf.py add-dependency "ningzixi/weather^1.1.0"

或者直接克隆本仓库到项目的 components 目录下:

bash 复制代码
git clone https://github.com/NingZiXi/weather

2. 获取 API 密钥

3. 基本用法

以下是一个简单的示例代码,展示如何使用该组件获取天气信息并打印到终端:

c 复制代码
#include "weather.h"

void app_main() {
    // 省略联网部分
    weather_config_t config = {
        .api_key = WEATHER_HEFENG_KEY,
        .api_host = WEATHER_HEFENG_HOSE,    // 和风天气需要配置host
        .city = NULL, // city为NULL自动根据IP地址获取位置,也可以指定城市
        // .city = "北京",
        .type = WEATHER_HEFENG  //可更改为api配置WEATHER_AMAP或WEATHER_XINZHI
    };

    weather_info_t *info = weather_get(&config);
    if (info) {
        weather_print_info(info); // 打印天气信息
        weather_info_free(info);
    }
}

更多 API 接口可以查看 weather.h 文件。

串口输出示例

以下是串口输出的天气信息示例:

总结

如果你觉得这个项目不错,别忘了给它一个 Star 支持哦!

相关推荐
2501_922639583 小时前
率能半导体 SS8230 H桥驱动芯片:15V/1.8A,覆盖摄像机、玩具、机器人三大场景
stm32·单片机·嵌入式硬件·硬件工程
橘为己有4415 小时前
STM32:I2C(1)
stm32·单片机·嵌入式硬件
少司府7 小时前
嵌入式外设篇(三)GPIO·三:MCU系统结构、总线与统一编制
linux·python·stm32·单片机·嵌入式硬件·mcu·嵌入式软件
2501_922639588 小时前
率能半导体 SS8812T双通道H桥驱动芯片:36V/1.6A,覆盖POS打印机、安防相机、办公自动化、游戏机、机器人五大应用场景
stm32·单片机·嵌入式硬件·硬件工程
booboosui8 小时前
编号没变,消息还是来了:Mac 端通知读取漏第二条的原因
android
ScilogyHunter8 小时前
[14] TMS570LC4357_VIM向量中断:128 通道、双 VIM 与硬件向量分发
单片机·编辑器·vim·excel·hercules·tms570
国科安芯9 小时前
FPGA上电偶发不启动:多轨电源时序、PGOOD与并联供电的FAE排查笔记——ASP4644S2B在星载智能处理板中的工程应用分析
笔记·单片机·嵌入式硬件·fpga开发·低轨卫星·抗辐射
国科安芯1 天前
卫星控制板偶发复位:MCU供电、时钟、ECC与总线的联合定位——AS32S601ZIT2在星载控制单元中的FAE排查方法
单片机·嵌入式硬件·mcu·risc-v·抗辐射·通信芯片
雨白1 天前
单例设计模式:从 Java/Kotlin 实现到 Android 实战
android
hai_android1 天前
一行 asLiveData,背后是一座生命周期的桥
android·java·kotlin