Class: Services_Weather_Globalweather

Source Location: /Services_Weather-1.3.2/Weather/Globalweather.php

Class Overview

Services_Weather_Common
   |
   --Services_Weather_Globalweather

PEAR::Services_Weather_Globalweather

Author(s):

Alexander Wirtz <alex at pc4p.net>

Version:

Inherited Variables

Inherited Methods

Class: Services_Weather_Common

Services_Weather_Common::calculateDewPoint(): Calculate dewpoint from temperature and humidity This is only an approximation, there is no exact formula, this one here is called Magnus-Formula
Services_Weather_Common::calculateHumidity(): Calculate humidity from temperature and dewpoint This is only an approximation, there is no exact formula, this one here is called Magnus-Formula
Services_Weather_Common::calculateWindChill(): Calculate windchill from temperature and windspeed (enhanced formula)
Services_Weather_Common::convertDistance(): Convert distance between km, ft and sm
Services_Weather_Common::convertPressure(): Convert pressure between in, hpa, mb, mm and atm
Services_Weather_Common::convertSpeed(): Convert speed between mph, kmh, kt, mps, fps and bft
Services_Weather_Common::convertTemperature(): Convert temperature between f and c
Services_Weather_Common::getUnitsFormat(): Returns the selected units format
Services_Weather_Common::polar2cartesian(): Convert polar coordinates to cartesian coordinates
Services_Weather_Common::setCache(): Enables caching the data, usage strongly recommended
Services_Weather_Common::setDateTimeFormat(): Changes the representation of time and dates (see http://www.php.net/date)
Services_Weather_Common::setHttpTimeout(): Sets the timeout in seconds for HTTP requests
Services_Weather_Common::setUnitsFormat(): Changes the representation of the units (standard/metric)

Class Details

[line 54]
PEAR::Services_Weather_Globalweather

This class acts as an interface to the soap service of capescience.com. It searches for given locations and retrieves current weather data.

GlobalWeather is a SOAP frontend for METAR data, provided by CapeScience. If you want to use METAR, you should try this class first, as it is much more comfortable (and also a bit faster) than the native METAR-class provided by this package. On the other hand, this service won't supply TAFs, the forecast system accompanying METAR, so you have to make the call here...

For a working example, please take a look at docs/Services_Weather/examples/globalweather-basic.php

Author: Alexander Wirtz <alex@pc4p.net>
Version: 1.3
Link: http://www.capescience.com/webservices/globalweather/index.shtml
Example: example not found
License: http://www.php.net/license/2_02.txt

[ Top ]

Method Detail

getForecast [line 409]

bool getForecast(
[
$id = null], [int
$days = null], [string
$unitsFormat = null], string
$int)

GlobalWeather has no forecast per se, so this function is just for compatibility purposes.

Deprecated:
Access: public

Parameters:

string	`$int`	—
int	`$days`	—
string	`$unitsFormat`	—
	`$id`	—

[ Top ]

getLocation [line 234]

PEAR_Error|array getLocation(
[string
$id = ""])

Returns the data for the location belonging to the ID

Throws: PEAR_Error
Access: public

Parameters:

string $id —

[ Top ]

getWeather [line 290]

PEAR_Error|array getWeather(
[string
$id = ""], [string
$unitsFormat = ""])

Returns the weather-data for the supplied location

Throws: PEAR_Error
Access: public

Parameters:

string	`$id`	—
string	`$unitsFormat`	—

[ Top ]

searchLocation [line 157]

PEAR_Error|array|string searchLocation(
string
$location, [bool
$useFirst = false])

Searches IDs for given location, returns array of possible locations or single ID

Throws: PEAR_Error::SERVICES_WEATHER_ERROR_UNKNOWN_LOCATION
Throws: PEAR_Error::SERVICES_WEATHER_ERROR_WRONG_SERVER_DATA
Access: public

Parameters:

string	`$location`	—
bool	`$useFirst`	—	If set, first ID of result-array is returned

[ Top ]

searchLocationByCountry [line 194]

PEAR_Error|array searchLocationByCountry(
[string
$country = ""])

Returns IDs with location-name for a given country or all available countries, if no value was given

Throws: PEAR_Error::SERVICES_WEATHER_ERROR_UNKNOWN_LOCATION
Throws: PEAR_Error::SERVICES_WEATHER_ERROR_WRONG_SERVER_DATA
Access: public

Parameters:

string $country —

[ Top ]