npm 包 openweathermap-node 使用教程-JavaScript中文网-JavaScript教程资源分享门户

openweathermap-node 是一款可以让前端开发者在自己的应用中获取实时天气数据的 npm 包。本文将对该包的使用方法进行详细介绍，并提供示例代码。

什么是 openweathermap-node

openweathermap-node 是一个基于 Node.js 的 npm 包，开发者可以使用它来获取全球各地的实时天气数据。它支持对城市、坐标、地区和国家的搜索，以及对当前天气、天气预报、历史天气和时间数据的搜索。

openweathermap-node 的优势有:

支持全球多条线路，保证数据准确
支持结构化数据导出，数据格式统一
提供图表式界面，可视化表达数据

如何使用 openweathermap-node

要使用 openweathermap-node，首先需要进入 npm 官网进行该包的安装。

npm install openweathermap-node --save

安装完成后，在代码中引用 openweathermap-node 并创建一个实例。在实例初始化时需要传入 OpenWeatherMap API 密钥，这个密钥可以在 openweathermap.org 上注册账户后获得。如果您还没有注册账户，请访问 openweathermap.org 并根据提示进行操作。

const OpenWeatherMapHelper = require("openweathermap-node");

const helper = new OpenWeatherMapHelper({
    APPID: "你的 API 密钥"
});

创建实例后，我们可以调用实例中提供的各种方法来获取天气数据。

获取实时天气数据

下面是获取某个城市实时天气数据的示例代码:

helper.getCurrentWeatherByCityName("北京", (err, cityWeather) => {
    if (err) {
        console.log(err);
    } else {
        console.log(cityWeather);
    }
});

在这个示例中，我们调用了 getCurrentWeatherByCityName 方法，并传入了要查询的城市名称 "北京"。该方法的第二个参数是一个回调函数，当获取到天气数据后就会自动调用该函数。回调函数的第一个参数是一个错误对象，如果获取数据时出现错误则会传递该对象；回调函数的第二个参数是一个城市天气对象，包含了该城市的实时天气数据。

获取天气预报数据

下面是获取某个城市未来 3 天的天气预报数据的示例代码：

helper.getThreeHourForecastByCityName("北京", (err, cityForecast) => {
    if (err) {
        console.log(err);
    } else {
        console.log(cityForecast);
    }
});

在这个示例中，我们调用了 getThreeHourForecastByCityName 方法，并传入了要查询的城市名称 "北京"。该方法的第二个参数是一个回调函数，当获取到天气预报数据后就会自动调用该函数。回调函数的第一个参数是一个错误对象，如果获取数据时出现错误则会传递该对象；回调函数的第二个参数是一个城市预报对象，包含了该城市未来 3 天的天气预报数据。

获取历史天气数据

下面是获取某个城市过去 24 小时的历史天气数据的示例代码:

helper.getHistoricalWeatherByCityName("北京", (err, cityHistory) => {
    if (err) {
        console.log(err);
    } else {
        console.log(cityHistory);
    }
});

在这个示例中，我们调用了 getHistoricalWeatherByCityName 方法，并传入了要查询的城市名称 "北京"。该方法的第二个参数是一个回调函数，当获取到历史天气数据后就会自动调用该函数。回调函数的第一个参数是一个错误对象，如果获取数据时出现错误则会传递该对象；回调函数的第二个参数是一个城市历史天气对象，包含了该城市过去 24 小时的历史天气数据。

获取时间和日出/日落时间数据

下面是获取某个城市当前时间和日出/日落时间数据的示例代码:

helper.getTimeByCityName("北京", (err, cityTime) => {
    if (err) {
        console.log(err);
    } else {
        console.log(cityTime);
    }
});

在这个示例中，我们调用了 getTimeByCityName 方法，并传入了要查询的城市名称 "北京"。该方法的第二个参数是一个回调函数，当获取到时间和日出/日落时间数据后就会自动调用该函数。回调函数的第一个参数是一个错误对象，如果获取数据时出现错误则会传递该对象；回调函数的第二个参数是一个城市时间对象，包含了该城市的当前时间和日出/日落时间数据。

总结

通过以上介绍，我们了解了如何使用 openweathermap-node 包来获取实时天气、天气预报、历史天气、时间和日出/日落时间数据。希望本文对您有所帮助！

来源：JavaScript中文网，转载请注明来源 https://www.javascriptcn.com/post/600562f581e8991b448e0b49