/forecast-php

PHP API Wrapper for Forecast.io

Primary LanguagePHPMIT LicenseMIT

Forecast PHP

Latest Version Software License Build Status Coverage Status Quality Score SensioLabs Insight Total Downloads

A PHP client package for the Forecast.io API.

Want to use this inside a Laravel application? Check out the Laravel-Forecast package.

Install

Via Composer

$ composer require nwidart/forecast-php

Usage

$forecast = new \Nwidart\ForecastPhp\Forecast('your_api_key');

// Simple latitude and longitude
$info = $forecast->get('40.7324296', '-73.9977264');

// Fetch weather at a given time
$info = $forecastPhp->get('40.7324296', '-73.9977264', '2013-05-06T12:00:00-0400');

// Add options to the request
$info = $forecastPhp->setOptions(['units' => 'si',])->get('40.7324296', '-73.9977264');

For more details and all available options check the official documentation.

An example response:

{
  "latitude": 40.7324296,
  "longitude": -73.9977264,
  "timezone": "America/New_York",
  "offset": -4,
  "currently": {
    "time": 1438445386,
    "summary": "Partly Cloudy",
    "icon": "partly-cloudy-day",
    "nearestStormDistance": 63,
    "nearestStormBearing": 360,
    "precipIntensity": 0,
    "precipProbability": 0,
    "temperature": 84.71,
    "apparentTemperature": 85.39,
    "dewPoint": 62.25,
    "humidity": 0.47,
    "windSpeed": 7.95,
    "visibility": 10,
    "cloudCover": 0.59,
    "pressure": 1010.33,
    "ozone": 323.24
  },
  "minutely": {
    ...
  },
  "hourly": {
    ...
  },
  "daily": {
    ...
  },
  "flags": {
    ...
  },
  "headers": {
    ...
  }
}

Testing

$ phpunit

Contributing

Please see CONTRIBUTING for details.

Credits

License

The MIT License (MIT). Please see License File for more information.