Documentation

Retrieve current weather information based on user's location.

NPM VersionInstall SizeTotal Downloads

Source Code

Repository: Location Weather Info

Features

Get user's current weather information based on:

  • Co-ordinates (Latitude & Longitude)
  • Location Name (Street/City/State/Country)

Installation

Using npm:

1 $ npm install location-weather-info

Using yarn:

1 $ yarn add location-weather-info

Example

Step-1: Import LocationWeatherInfo after installation.

1 import LocationWeatherInfo from 'location-weather-info';

Step-2: Declare the constructor and pass your API KEY. Your can get your API_KEY from Open Weather Map. You must login to get your secret key.

1 const weather = new LocationWeatherInfo(API_KEY);

Step-3: Now you can get the current weather info based on Co-ordinates (Latitude & Longitude) or Location Name.

1 //Get weather by Co-ordinates (latitude, longitude)
2 const weatherByCoords = weather.getWeatherByCoords(35, 139);
3 console.log(weatherByCoords);
4
5 //Get weather by Location Name
6 const weatherByLocationName = weather.getWeatherByLocation("Tokyo");
7 console.log(weatherByLocationName);

N.B: Both function returns promise, it might be needed to handle from client side.

Output

If you pass the required arguments then you will get the response with an object like:

1{success: true, data: weatherData}

If any error is occurred then the response will be:

1{success: false, error: errorMessage}

Browser Support

ChromeFirefoxSafariOperaEdgeIE
Latest ✔Latest ✔Latest ✔Latest ✔Latest ✔11 ✔

Caution

This open source project is beginner friendly and made only for learning purpose, where we used Open Weather Map v2.5 with free-tier API end points. That's why your secret API key may revealed as payload. So in case of production you may purchase and handle the API end points manually instead of using this package. Also you can follow their guidelines here.

Author

@SharifRahat