前言
随着 Web 前端技术的转变和发展,前端工程师们越来越需要依赖于各种 NPM 包来增加自己的开发效率,特别是在开发与 API 相关的 Web 应用时,如天气预报类网站,就会需要依赖于一些天气 API 的 NPM 包来快速调用并获取到相应的天气数据。而其中,开源 NPM 包 openweather-apis-us 就是一款非常不错的天气 API 包,尤其适用于美国以及其它北美洲地区的天气获取。
本篇文章将主要介绍 openweather-apis-us 这个 NPM 包的使用教程,内容既详细又有深度和学习指导意义,同时也包含相应的示例代码,帮助读者更好地应用该 NPM 包到自己的 Web 前端开发中。
openweather-apis-us 的简介
openweather-apis-us 是一款支持美国和北美洲地区的天气 API,该 NPM 包可用于 Node.js 和浏览器环境,用于查询实时和预测数据。它支持以下天气数据查询:
- 实时天气
- 逐小时预测
- 逐日预测
它是采用 Promise 的方式进行封装,可以快速、简便地从适用于美国和北美洲地区的天气 API 中获取到所需要的数据,并对数据进行格式化处理,方便后续在前端应用中进行渲染。
注:由于该 NPM 包需要 API Key,使用前需要先申请 OpenWeather 的 API Key.
openweather-apis-us 的安装
安装 openweather-apis-us 很简单,只需在终端中输入以下命令即可:
npm install --save openweather-apis-us
接下来,在文件头部引入 openweather-apis-us:
const Weather = require('openweather-apis-us');
openweather-apis-us 的使用
1. API Key 的设置
使用前需要设置正确的 API Key,API Key 的设置非常简单,在引入 openweather-apis-us 后,仅需使用如下方式设置即可:
const Weather = require('openweather-apis-us'); Weather.setApiKey('YOUR_APP_ID');
注:'YOUR_APP_ID' 请替换为你的 OpenWeather API Key。
2. 查询实时天气
可以使用以下方法查询所需地点的实时天气:
Weather.getCurrentWeatherByCityName('New York') .then(weather => { console.log(weather); }) .catch(err => { console.log(err); });
以上代码将输出类似下面的 JSON 格式实时天气数据:
-- -------------------- ---- ------- - ------ - ---- ------- ---- ----- -- -------- - - --- ---- ----- -------- ------------ ------ ----- ----- ----- - -- ----- ----------- ----- - ----- ------- ----------- ------ --------- ------- --------- ------- --------- ----- --------- -- -- ----------- ------ ----- - ------ ---- ---- -- -- ------- - ---- - -- --- ----------- ---- - ----- -- --- ----- -------- ----- -------- ----------- ------- ---------- -- --------- ------- --- -------- ----- ---- ------ ---- --- -
3. 查询逐小时预测
可以使用以下方法查询所需地点的未来 4 小时内的天气预测:
Weather.getHourlyForecastByCityName('New York') .then(weather => { console.log(weather); }) .catch(err => { console.log(err); });
以上代码将输出类似下面的 JSON 格式逐小时预测的天气数据:
-- -------------------- ---- ------- - - --- ----------- ----- - ----- ------- ----------- ------- --------- ------- --------- ------- --------- ----- --------- --- ---------- ----- ----------- ---- -- - --- ----------- ----- - ----- ------- ----------- ------- --------- ------- --------- ------- --------- ----- --------- --- ---------- ----- ----------- ---- -- --- -- ------ -
4. 查询逐日预测
可以使用以下方法查询所需地点的未来 5 天的天气预测:
Weather.getDailyForecastByCityName('New York') .then(weather => { console.log(weather); }) .catch(err => { console.log(err); });
以上代码将输出类似下面的 JSON 格式逐日预测的天气数据:
-- -------------------- ---- ------- - - --- ----------- -------- ----------- ------- ----------- ----- - ---- ----- ---- ----- ---- ----- ------ ----- ---- ----- ----- ---- -- ----------- - ---- ----- ------ ----- ---- ----- ----- ---- -- --------- ----- --------- --- ---------- ----- ----------- ---- --------- ---- -------- - - --- ---- ----- -------- ------------ ------ ----- ----- ----- - -- ------- -- ---- -- ---- ---- -- --- -- ------ -
总结
通过本文的介绍,我们可以看到 openweather-apis-us 这个 NPM 包的使用非常简单,并且支持多种不同的查询方式,包括实时天气、逐小时天气预测、逐日天气预测等等。对于 Web 前端工程师来说,这一点非常重要,因为天气 API 在很多时候都是不可或缺的,如天气预报类网站项目就需要调用和使用天气 API 来提供相应的服务。希望读者可以通过本文了解到 openweather-apis-us 这一款 NPM 包,帮助读者更好地完成自己的 Web 前端开发任务。
来源:JavaScript中文网 ,转载请注明来源 https://www.javascriptcn.com/post/600562d981e8991b448e0377