npm 包 wundergrounded 使用教程

阅读时长 5 分钟读完

介绍

wundergrounded 是一个用于获取天气数据的 npm 包,它可以获取全球范围内各地的实时天气数据,包括温度、湿度、风速等各种信息,而且数据更新频率很高,适用于前端和后端开发。

安装

使用 npm 安装 wundergrounded:

使用

初始化

首先,需要在代码中引入 wundergrounded:

然后,需要设置 API 密钥,可以在 wundergrounded 官网上申请:

获取天气数据

接下来,可以使用 wundergrounded 的 getWeather 方法获取天气数据:

-- -------------------- ---- -------
------------------------------------ --------
  ------------ -- -
    ------------------------------
    ---------------------------
    ----------------------------
  --
  -------------- -- -
    ---------------------
  ---

getWeather 方法接受两个参数,分别是城市名和国家名,可以根据需要自由地组合这两个参数。获取到天气数据后,可以直接使用返回对象的属性访问各种数据,比如温度、湿度、风速等。

示例

以下是一个使用 wundergrounded 获取北京和上海天气数据的例子:

-- -------------------- ---- -------
----- -------------- - --------------------------

----- ------ - ---------------
---------------------------------

------------------------------------ --------
  ------------ -- -
    ------------------------
    ------------------------- -----------------------
    ---------------------- --------------------
    ----------------- ------ ------------------------
  --
  -------------- -- -
    ---------------------
  ---

------------------------------------- --------
  ------------ -- -
    -------------------------
    ------------------------- -----------------------
    ---------------------- --------------------
    ----------------- ------ ------------------------
  --
  -------------- -- -
    ---------------------
  ---

输出结果:

深度

数据格式

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

纠错
反馈