TWCDataBundle

Symfony2 bundle for working with The Weather Channel API

Introduction

This Bundle enables integration The Weather Channel API.

Note: Only /data/... resource api

Installation

Add this bundle and kriswallsmith Buzz library to your project as Git submodules:

 $ git submodule add git://github.com/kriswallsmith/Buzz.git vendor/buzz
 $ git submodule add git://github.com/suncat2000/TWCDataBundle.git vendor/bundles/SunCat/TWCDataBundle

 //app/autoload.php
 $loader->registerNamespaces(array(
       // ...
       'Buzz'      => __DIR__.'/../vendor/buzz/lib',
       'SunCat'    => __DIR__.'/../vendor/bundles',
       // ...
 ));

Add this bundle to your application's kernel:

 //app/AppKernel.php
 public function registerBundles()
 {
     return array(
         // ...
         new SunCat\TWCDataBundle\TWCDataBundle(),
         // ...
     );
 }

Configure the twc_data service in your YAML configuration:

   #app/config/config.yml
   twc_data:
       apikey: your_api_key
       format: json        # or xml; optional, default: json
       units: m            # or s; optional, default: m
       locale: en_GB       # optional, default: en_GB
       country: UK         # optional, default: UK

Usage example

<?php
// src/Acme/YourBundle/Command/LocSearchCommand.php

        class LocSearchCommand extends ContainerAwareCommand
        {
            /**
             * @see Command
             */
            protected function configure()
            {
                $this
                    ->setName('weather:locsearch')
                    ->setDescription('Get location ID of city by city name')
                    ->addOption('city', 0, InputOption::VALUE_REQUIRED, 'City name')
                    ->setHelp(<<<EOF
        The <info>weather:locsearch</info> command get location ID.
        
        <info>php app/console weather:locsearch --city=london</info>
        
        EOF
                    )
                ;
            }

            /**
             * {@inheritdoc}
             */
            protected function execute(InputInterface $input, OutputInterface $output)
            {
                $twcData = $this->getContainer()->get('twc_data.api_data');
                $twcData->setCommand('locsearch');
                $cityName = $input->getOption('city');

                if(!$cityName){
                    throw new \Exception('Enter city name');
                }

                $twcData->setResourcePart($cityName);
                $data = $twcData->getData();

                //
                // put your code
                //
            }

        }

Run command:

        php app/console weather:locsearch --city=london

Query string parameters to TWC API:

        $twcData->setCountry('UK');
        $twcData->enabledCountry(false); // disable `country` param in query string to TWC API
        $twcData->setParams(array('day' => '0,1,2'));
        $twcData->setParams(array('start' => 1293840000, 'end' => 1296518399));

The Weather Channel® API Implementation Guide

Support & Download

suncat2000 / TWCDataBundle