介绍
wundergrounded 是一个用于获取天气数据的 npm 包,它可以获取全球范围内各地的实时天气数据,包括温度、湿度、风速等各种信息,而且数据更新频率很高,适用于前端和后端开发。
安装
使用 npm 安装 wundergrounded:
npm install wundergrounded
使用
初始化
首先,需要在代码中引入 wundergrounded:
const wundergrounded = require('wundergrounded');
然后,需要设置 API 密钥,可以在 wundergrounded 官网上申请:
wundergrounded.setApiKey('your_api_key');
获取天气数据
接下来,可以使用 wundergrounded 的 getWeather
方法获取天气数据:
-- -------------------- ---- ------- ------------------------------------ -------- ------------ -- - ------------------------------ --------------------------- ---------------------------- -- -------------- -- - --------------------- ---
getWeather
方法接受两个参数,分别是城市名和国家名,可以根据需要自由地组合这两个参数。获取到天气数据后,可以直接使用返回对象的属性访问各种数据,比如温度、湿度、风速等。
示例
以下是一个使用 wundergrounded 获取北京和上海天气数据的例子:
-- -------------------- ---- ------- ----- -------------- - -------------------------- ----- ------ - --------------- --------------------------------- ------------------------------------ -------- ------------ -- - ------------------------ ------------------------- ----------------------- ---------------------- -------------------- ----------------- ------ ------------------------ -- -------------- -- - --------------------- --- ------------------------------------- -------- ------------ -- - ------------------------- ------------------------- ----------------------- ---------------------- -------------------- ----------------- ------ ------------------------ -- -------------- -- - --------------------- ---
输出结果:
Beijing: Temperature: 21℃ Humidity: 36% Wind speed: 7km/h Shanghai: Temperature: 27℃ Humidity: 83% Wind speed: 7km/h
深度
数据格式
wundergrounded 返回的天气数据格式如下:
-- -------------------- ---- ------- - ------------ ------- --------- ------- ---------- ------- --------- ------- --------------------- ------- ------------------------ ------- --------- ------- ----------- ------- -------- ------- -------------- ------- ----- ------- -
其中,各属性的含义如下:
temperature
: 温度,单位摄氏度。humidity
: 湿度,百分比。windSpeed
: 风速,单位千米/小时。windGust
: 阵风速度,单位千米/小时。windDirection.degree
: 风向角度,从北开始计算,单位度数。windDirection.direction
: 风向方向,比如N
表示北风。pressure
: 气压,单位帕斯卡。visibility
: 能见度,单位千米。uvIndex
: 紫外线指数。precipitation
: 降水量,单位毫米。icon
: 天气图标,是一个字符串。
异常处理
wundergrounded 返回的 Promise 可能会发生异常,比如网络连接不上、API 密钥不正确等,因此在使用时需要注意异常处理。一般来说,可以使用 Promise 的 catch 方法捕获异常,比如:
-- -------------------- ---- ------- ------------------------------------ -------- ------------ -- - -- --------- ------------------ -- -------------- -- - -- ---- --------------------- ---
API 限制
wundergrounded 提供的 API 有一些限制,比如:
- 每分钟最多请求 10 次;
- 免费版每天最多请求 500 次;
- 免费版每秒最多请求 10 次;
- 免费版仅支持实时天气数据,历史数据需要购买专业版。
在使用时,需要注意合理使用 API,以免超出限制。
总结
使用 wundergrounded,可以轻松获取全球范围内各地的天气数据,这对于一些天气相关的前端和后端应用来说非常有用。在使用时,需要注意 API 限制和异常处理等问题,以确保程序正常运行。
来源:JavaScript中文网 ,转载请注明来源 https://www.javascriptcn.com/post/600671138dd3466f61ffe542