Weather using Google's API
Switch branches/tags
Nothing to show
Pull request Compare This branch is even with Geczy:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.

Google Weather API

Google Weather API is a PHP based library for retrieving and displaying weather at any location, utilizing Google's weather API.

Live examples

Quick start

Clone the repo, git clone git://, or download the latest release.


$googleWeather = new \Geczy\Weather\GoogleWeatherAPI();
$weatherData = $googleWeather->getWeather('Los Angeles');

/* Your view file that formats the array response $weatherData. */


You can display multiple weather data on one page, in different languages, degrees, etc. Start by setting your defaults, and then using the functions provided to display multiple versions of weather.

Overriding defaults

Simply instantiate GoogleWeatherAPI with your own variables to override the defaults. For example:

$defaults = array(
	'degree'   => 'c',
	'language' => 'fr',

$googleWeather = new \Geczy\Weather\GoogleWeatherAPI($defaults);

Retrieve a location


Retrieve in Celsius or Fahrenheit

$googleWeather->setDegree('c'); // 'c' or 'f'

Set a language


Custom weather icons

Icon sets included are:

  • Google
  • Dotvoid
  • KWeather
  • NYTimes
  • Yahoo

See a suggestion in views/example1.php for using these icons.

Example response

Here's an example of what getWeather() will return:

array (size=3)
  'info' =>
	array (size=3)
	  'city' => string 'Los Angeles, CA' (length=15)
	  'zip' => string 'Los+Angeles' (length=11)
	  'unit' => string 'US' (length=2)
  'current' =>
	array (size=5)
	  'condition' => string 'Cloudy' (length=6)
	  'temp_f' => string '66' (length=2)
	  'humidity' => string 'Humidity: 73%' (length=13)
	  'icon' => string 'cloudy.gif' (length=94)
	  'wind_condition' => string 'Wind: N at 0 mph' (length=16)
  'forecast' =>
	array (size=4)
	  'Sun' =>
		array (size=4)
		  'low' => string '63' (length=2)
		  'high' => string '79' (length=2)
		  'icon' => string 'mostly_sunny.gif' (length=100)
		  'condition' => string 'Mostly Sunny' (length=12)
	  'Mon' =>
		array (size=4)
		  'low' => string '64' (length=2)
		  'high' => string '81' (length=2)
		  'icon' => string 'sunny.gif' (length=93)
		  'condition' => string 'Clear' (length=5)
	  'Tue' =>
		array (size=4)
		  'low' => string '64' (length=2)
		  'high' => string '84' (length=2)
		  'icon' => string 'mostly_sunny.gif' (length=100)
		  'condition' => string 'Mostly Sunny' (length=12)
	  'Wed' =>
		array (size=4)
		  'low' => string '64' (length=2)
		  'high' => string '82' (length=2)
		  'icon' => string 'sunny.gif' (length=93)
		  'condition' => string 'Clear' (length=5)

Bug tracker

Have a bug? Please create an issue here on GitHub!

Copyright and License

Copyright 2012 Matthew Gates

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this work except in compliance with the License. You may obtain a copy of the License in the LICENSE file, or at:

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.