当前位置：首页 > news >正文

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

news 来源：原创 2025/6/16 14:27:21

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

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

项目简介

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

项目地址：GitHub - NingZiXi/weather

功能亮点

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

免费数据支持对比

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

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

快速开始

1. 克隆项目

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

idf.py add-dependency "ningzixi/weather^1.1.0"

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

git clone https://github.com/NingZiXi/weather

2. 获取 API 密钥

高德 API：访问高德地图开放平台获取密钥。
心知天气 API：访问心知天气获取密钥。
和风天气 API：除了获取密钥外，还需要配置 host。密钥获取地址为和风天气控制台，host 配置地址为和风天气设置。

3. 基本用法

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

#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);}
}