By endroid

This bundle enables you to use Endroid OpenWeatherMap as a service in your Symfony project. It also provides an API controller that takes a local API request, adds the API key (APPID) to it and returns the corresponding OpenWeatherMap API response. This enables you to expose the OpenWeatherMap API on your own domain without having to bother about passing your API key on every request and creating a new instance each time you make a request.

For more information see the endroid/OpenWeatherMap repository and the OpenWeatherMap API.

• Symfony
• Dependencies:
• Buzz
• OpenWeatherMap

{
    "require": {
        "endroid/openweathermap-bundle": "dev-master"
    }
}

$ curl -s http://getcomposer.org/installer | php
$ php composer.phar update endroid/openweathermap-bundle

Composer will install the bundle to your project's vendor/endroid directory.

<?php
// app/AppKernel.php

public function registerBundles()
{
    $bundles = array(
        // ...
        new Endroid\Bundle\OpenWeatherMapBundle\EndroidOpenWeatherMapBundle(),
    );
}

endroid_open_weather_map:
    api_key: "..."
    api_url: "..." // optional
    units: "..." // optional

If you don't want to expose the OpenWeatherMap API via your application, you can skip this section.

EndroidOpenWeatherMapBundle:
    resource:	"@EndroidOpenWeatherMapBundle/Controller/"
    type:		annotation
    prefix:		/openweathermap/api

This exposes the OpenWeatherMap API via /openweathermap/api. This means that instead of sending a request to http://api.openweathermap.org/ you can now send an unsigned request to /openweathermap/api/*. Make sure you secure this area if you don't want others to be able to post on your behalf.

After installation and configuration, the service can be directly referenced from within your controllers.

<?php

$openWeatherMap = $this->get('endroid.openweathermap');

// Retrieve the current weather for Breda
$weather = $openWeatherMap->getWeather('Breda,nl');

// Or retrieve the weather using the generic query method
$response = $openWeatherMap->query('weather', array('q' => 'Breda,nl'));
$weather = json_decode($response->getContent());

This bundle is under the MIT license. For the full copyright and license information, please view the LICENSE file that was distributed with this source code.