chimilevschi / laravel-weather
Package for get the weather data
Fund package maintenance!
MichaelNabil230
Requires
- php: ^8.2
- illuminate/contracts: ^9.0 | ^10.0 | ^11.0
- spatie/laravel-package-tools: ^1.16.4
Requires (Dev)
- larastan/larastan: v2.9.8
- laravel/pint: v1.17.0
- nunomaduro/collision: v8.3.0
- orchestra/testbench: v9.1.2
- pestphp/pest: v2.34.9
- pestphp/pest-plugin-arch: v2.7.0
- pestphp/pest-plugin-laravel: v2.4.0
- phpstan/extension-installer: ^1.3.1
- phpstan/phpstan-deprecation-rules: ^1.2.0
- phpstan/phpstan-phpunit: ^1.4.0
This package is auto-updated.
Last update: 2025-07-13 08:43:47 UTC
README
Download Meteorological Data from OPEN-METEO API (https://open-meteo.com/en)
Open-Meteo collaborates with National Weather Services providing Open Data with 11 to 2 km resolution. Our high performance APIs select the best weather model for your location and provide data as a simple JSON API.
APIs are free without any API key for open-source developers and non-commercial use. You can embed them directly into your app.
Installation
You can install the package via composer:
composer require chimilevschi/laravel-weather
You can publish the config file with:
php artisan vendor:publish --tag="laravel-weather-config"
This is the contents of the published config file:
return [ 'temperature_unit' => 'celsius', 'wind_speed_unit' => 'kmh', 'precipitation_unit' => 'mm', 'time_format' => 'iso8601', 'timezone' => 'GMT', ];
Usage
$weather = \Clevada\Weather\Weather::location(30.0812558, 31.2511902) ->current() ->get();
Functions:
| Parameter | Format | Required | Default |
|---|---|---|---|
| currentWeather | Bool | No | false |
| temperatureUnit | String | No | celsius |
| windSpeedUnit | String | No | kmh |
| precipitationUnit | String | No | kmh |
| timeFormat | String | No | iso8601 |
| timezone | String | No | UTC |
| pastDays | Integer (0-2) | No | 0 |
15-minutely Functions:
| Variable | Valid time | Unit |
|---|---|---|
| temperature_2m_15min | Instant | °C (°F) |
| relativeHumidity_2m_15min | Instant | % |
| dewPoint_2m_15min | Instant | °C (°F) |
| apparentTemperature_15min | Instant | °C (°F) |
| windSpeed_10m_15min | Instant | km/h (mph, m/s, knots) |
| windSpeed_80m_15min | Instant | km/h (mph, m/s, knots) |
| windDirection_10m_15min | Instant | ° |
| windDirection_80m_15min | Instant | ° |
| windGusts_10m_15min | Preceding 15 minutes max | km/h (mph, m/s) |
| shortwaveRadiation_15min | Preceding 15 minutes mean | W/m² |
| directRadiation_15min | Preceding 15 minutes mean | W/m² |
| directNormalIrradiance_15min | Preceding 15 minutes mean | W/m² |
| diffuseRadiation_15min | Preceding 15 minutes mean | W/mv² |
| globalTiltedIrradiance_15min | Preceding 15 minutes mean | W/mv² |
| sunshineDuration_15Min | Preceding 15 minutes sum | Seconds |
| precipitation_15min | Preceding 15 minutes sum | mm (inch) |
| snowfall_15min | Preceding 15 minutes sum | cm (inch) |
| rain_15min | Preceding 15 minutes sum | mm (inch) |
| cape_15min | Instant | J/kg |
| visibility_15min | Instant | meters |
| weatherCode_15min | Instant | WMO code |
Hourly Functions:
| Variable | Valid time | Unit |
|---|---|---|
| temperature_2m | Instant | °C (°F) |
| relativeHumidity_2m | Instant | % |
| dewPoint_2m | Instant | °C (°F) |
| apparentTemperature | Instant | °C (°F) |
| pressureMsl | Instant | hPa |
| cloudCover | Instant | % |
| cloudCoverLow | Instant | % |
| cloudCoverMid | Instant | % |
| cloudCoverHigh | Instant | % |
| windSpeed_10m | Instant | km/h (mph, m/s, knots) |
| windSpeed_80m | Instant | km/h (mph, m/s, knots) |
| windSpeed_120m | Instant | km/h (mph, m/s, knots) |
| windSpeed_180m | Instant | km/h (mph, m/s, knots) |
| windDirection_10m | Instant | ° |
| windDirection_80m | Instant | ° |
| windDirection_120m | Instant | ° |
| windDirection_180m | Instant | ° |
| windGusts_10m | Preceding hour max | km/h (mph, m/s) |
| shortwaveRadiation | Preceding hour mean W/m² | |
| directRadiation | Preceding hour mean | W/m² |
| diffuseRadiation | Preceding hour mean | W/mv² |
| vaporPressureDeficit | Instant | kPa |
| evapotranspiration | Preceding hour sum | mm (inch) |
| precipitation | Preceding hour sum | mm (inch) |
| precipitationProbability | Preceding hour probability | % |
| hourlyWeatherCode | Instant | WMO code |
| snowHeight | Instant | meters |
| freezingLevelHeight | Instant | meters |
| soilTemperature_0cm | Instant | °C (°F) |
| soilTemperature_6cm | Instant | °C (°F) |
| soilTemperature_18cm | Instant | °C (°F) |
| soilTemperature_54cm | Instant | °C (°F) |
| soilMoisture_0_1cm | Instant | m³/m³ |
| soilMoisture_1_3cm | Instant | m³/m³ |
| soilMoisture_3_9cm | Instant | m³/m³ |
| soilMoisture_9_27cm | Instant | m³/m³ |
| soilMoisture_27_81cm | Instant | m³/m³ |
| allHourly | - | - |
Daily Functions:
| Variable | Unit |
|---|---|
| temperature_2mMax | °C (°F) |
| temperature_2mMin | °C (°F) |
| apparentTemperatureMax | °C (°F) |
| apparentTemperatureMin | °C (°F) |
| precipitationSum | mm |
| precipitationHours | hours |
| dailyWeatherCode | WMO code |
| sunrise | iso8601 |
| sunset | iso8601 |
| windSpeed_10mMax | km/h (mph, m/s, knots) |
| windGusts_10mMax | km/h (mph, m/s, knots) |
| windDirection_10mDominant | ° |
| shortwaveRadiationSum | MJ/m² |
| allDaily | - |
WMO Weather interpretation codes (WW):
| Code | Description |
|---|---|
| 0 | Clear sky |
| 1, 2, 3 | Mainly clear, partly cloudy, and overcast |
| 45, 48 | Fog and depositing rime fog |
| 51, 53, 55 | Drizzle: Light, moderate, and dense intensity |
| 56, 57 | Freezing Drizzle: Light and dense intensity |
| 61, 63, 65 | Rain: Slight, moderate, and heavy intensity |
| 66, 67 | Freezing Rain: Light and heavy intensity |
| 71, 73, 75 | Snowfall: Slight, moderate, and heavy intensity |
| 77 | Snow grains |
| 80, 81, 82 | Rain showers: Slight, moderate, and violent |
| 85, 86 | Snow showers slight and heavy |
| 95 * | Thunderstorm: Slight or moderate |
| 96, 99 * | Thunderstorm with slight and heavy hail |
Testing
composer test
License
The MIT License (MIT). Please see License File for more information.