Laravel Open Weather API
Laravel OpenWeather API (openweather-laravel-api) is a Laravel package to connect Open Weather Map APIs ( https://openweathermap.org/api ) and access free API services (current weather, weather forecast, weather history) easily.
| APIs | Get data by |
|---|---|
| Current Weather | By city name, city ID, geographic coordinates, ZIP code |
| One Call API | By geographic coordinates |
| 4 Day 3 Hour Forecast | By city name, city ID, geographic coordinates, ZIP code |
| 5 Day Historical | By geographic coordinates |
| Air Pollution | By geographic coordinates |
| Geocoding API | By geographic coordinates |
Install the package through Composer. On the command line:
composer require rakibdevs/openweather-laravel-api
If Laravel > 7, no need to add provider
Add the following to your providers array in config/app.php:
'providers' => [
// ...
RakibDevs\Weather\WeatherServiceProvider::class,
],
'aliases' => [
//...
'Weather' => RakibDevs\Weather\Weather::class,
];
Add API key and desired language in .env
OPENWEATHER_API_KEY=
OPENWEATHER_API_LANG=en
Publish the required package configuration file using the artisan command:
$ php artisan vendor:publish
Edit the config/openweather.php file and modify the api_key value with your Open Weather Map api key.
return [
'api_key' => env('OPENWEATHER_API_KEY', ''),
'onecall_api_version' => '2.5',
'historical_api_version' => '2.5',
'forecast_api_version' => '2.5',
'polution_api_version' => '2.5',
'geo_api_version' => '1.0',
'lang' => env('OPENWEATHER_API_LANG', 'en'),
'date_format' => 'm/d/Y',
'time_format' => 'h:i A',
'day_format' => 'l',
'temp_format' => 'c' // c for celcius, f for farenheit, k for kelvin
];Now you can configure API version from config as One Call API is upgraded to version 3.0. Please set available api version in config.
Here you can see some example of just how simple this package is to use.
use RakibDevs\Weather\Weather;
$wt = new Weather();
$info = $wt->getCurrentByCity('dhaka'); // Get current weather by city name
Access current weather data for any location on Earth including over 200,000 cities! OpenWeather collect and process weather data from different sources such as global and local weather models, satellites, radars and vast network of weather stations
// By city name
$info = $wt->getCurrentByCity('dhaka');
// By city ID - download list of city id here http://bulk.openweathermap.org/sample/
$info = $wt->getCurrentByCity(1185241);
// By Zip Code - string with country code
$info = $wt->getCurrentByZip('94040,us'); // If no country code specified, us will be default
// By coordinates : latitude and longitude
$info = $wt->getCurrentByCord(23.7104, 90.4074);{
"coord": {
"lon": 90.4074
"lat": 23.7104
}
"weather":[
0 => {
"id": 721
"main": "Haze"
"description": "haze"
"icon": "50d"
}
]
"base": "stations"
"main": {
"temp": 26
"feels_like": 25.42
"temp_min": 26
"temp_max": 26
"pressure": 1009
"humidity": 57
}
"visibility": 3500
"wind": {
"speed": 4.12
"deg": 280
}
"clouds": {
"all": 85
}
"dt": "01/09/2021 04:16 PM"
"sys": {
"type": 1
"id": 9145
"country": "BD"
"sunrise": "01/09/2021 06:42 AM"
"sunset": "01/09/2021 05:28 PM"
}
"timezone": 21600
"id": 1185241
"name": "Dhaka"
"cod": 200
}
Make just one API call and get all your essential weather data for a specific location with OpenWeather One Call API.
// By coordinates : latitude and longitude
$info = $wt->getOneCallByCord(23.7104, 90.4074);4 day forecast is available at any location or city. It includes weather forecast data with 3-hour step.
// By city name
$info = $wt->get3HourlyByCity('dhaka');
// By city ID - download list of city id here http://bulk.openweathermap.org/sample/
$info = $wt->get3HourlyByCity(1185241);
// By Zip Code - string with country code
$info = $wt->get3HourlyByZip('94040,us'); // If no country code specified, us will be default
// By coordinates : latitude and longitude
$info = $wt->get3HourlyByCord(23.7104, 90.4074);Get access to historical weather data for the previous 5 days.
// By coordinates : latitude, longitude and date
$info = $wt->getHistoryByCord(23.7104, 90.4074, '2020-01-09');Air Pollution API provides current, forecast and historical air pollution data for any coordinates on the globe
Besides basic Air Quality Index, the API returns data about polluting gases, such as Carbon monoxide (CO), Nitrogen monoxide (NO), Nitrogen dioxide (NO2), Ozone (O3), Sulphur dioxide (SO2), Ammonia (NH3), and particulates (PM2.5 and PM10).
Air pollution forecast is available for 5 days with hourly granularity. Historical data is accessible from 27th November 2020.
// By coordinates : latitude, longitude and date
$info = $wt->getAirPollutionByCord(23.7104, 90.4074);Geocoding API is a simple tool that we have developed to ease the search for locations while working with geographic names and coordinates. -> Direct geocoding converts the specified name of a location or area into the exact geographical coordinates; -> Reverse geocoding converts the geographical coordinates into the names of the nearby locations.
// By city name
$info = $wt->getGeoByCity('dhaka');
// By coordinates : latitude, longitude and date
$info = $wt->getGeoByCity(23.7104, 90.4074);- 60 calls/minute
- 1,000,000 calls/month
- 1000 calls/day when using Onecall requests
Laravel Open Weather API is licensed under The MIT License (MIT).
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent