Today forecast

Weather forecast for the next 24 hours divided into 4 time periods. Notice that either geonameid OR lat and lon should be set. If both are set, geonameid will take precedence.

version
format
geonameid
lat
lon
app
expire
signature
// PHP example on how to generate the signature

$app = "name-registered-with-tv2";
$expire = gmdate("Y-m-d-H-i-s", strtotime("+15 minutes"));
$secret = "my-private-secret-provided-by-tv2";

// entire query string without signature parameter
$query = "foo=bar&baz=daz&app=$app&expire=expire"

$signature = md5($query.$secret);

Hourly forecast

Hourly weather forecast for the next 48 hours. Notice that either geonameid OR lat and lon should be set. If both are set, geonameid will take precedence.

version
format
geonameid
lat
lon
app
expire
signature
// PHP example on how to generate the signature

$app = "name-registered-with-tv2";
$expire = gmdate("Y-m-d-H-i-s", strtotime("+15 minutes"));
$secret = "my-private-secret-provided-by-tv2";

// entire query string without signature parameter
$query = "foo=bar&baz=daz&app=$app&expire=expire"

$signature = md5($query.$secret);

Daily forecast

Daily weather forecast for up to 14 days from now. Notice that either geonameid OR lat and lon should be set. If both are set, geonameid will take precedence.

version
format
geonameid
lat
lon
from
to
app
expire
signature
// PHP example on how to generate the signature

$app = "name-registered-with-tv2";
$expire = gmdate("Y-m-d-H-i-s", strtotime("+15 minutes"));
$secret = "my-private-secret-provided-by-tv2";

// entire query string without signature parameter
$query = "foo=bar&baz=daz&app=$app&expire=expire"

$signature = md5($query.$secret);

Warnings

Warnings on the location for the next 48 hours

version
format
geonameid
app
expire
signature
// PHP example on how to generate the signature

$app = "name-registered-with-tv2";
$expire = gmdate("Y-m-d-H-i-s", strtotime("+15 minutes"));
$secret = "my-private-secret-provided-by-tv2";

// entire query string without signature parameter
$query = "foo=bar&baz=daz&app=$app&expire=expire"

$signature = md5($query.$secret);

Sunrise and -set information

Given a place with a geonameid, get information about when the sun rise and set. Notice that either geonameid OR lat and lon should be set. If both are set, geonameid will take precedence.

version
format
geonameid
lat
lon
app
expire
signature
// PHP example on how to generate the signature

$app = "name-registered-with-tv2";
$expire = gmdate("Y-m-d-H-i-s", strtotime("+15 minutes"));
$secret = "my-private-secret-provided-by-tv2";

// entire query string without signature parameter
$query = "foo=bar&baz=daz&app=$app&expire=expire"

$signature = md5($query.$secret);

Symbol icons

returns the correct icon for the specified symbol

size
name
format

Wind icons

returns the correct icon for the specified wind icon. For wind speeds of 0 (zero), use the speed in stead of direction.

size
direction
format

Search

Search in the Geonames API in the engine module.

version
format
q
app
expire
signature
// PHP example on how to generate the signature

$app = "name-registered-with-tv2";
$expire = gmdate("Y-m-d-H-i-s", strtotime("+15 minutes"));
$secret = "my-private-secret-provided-by-tv2";

// entire query string without signature parameter
$query = "foo=bar&baz=daz&app=$app&expire=expire"

$signature = md5($query.$secret);

Nearby

Find a nearby geolocation from lat/lon

version
format
lat
lon
app
expire
signature
// PHP example on how to generate the signature

$app = "name-registered-with-tv2";
$expire = gmdate("Y-m-d-H-i-s", strtotime("+15 minutes"));
$secret = "my-private-secret-provided-by-tv2";

// entire query string without signature parameter
$query = "foo=bar&baz=daz&app=$app&expire=expire"

$signature = md5($query.$secret);

Toponym

get a toponym from the Geonames API in the engine module

version
format
geonameid
app
expire
signature
// PHP example on how to generate the signature

$app = "name-registered-with-tv2";
$expire = gmdate("Y-m-d-H-i-s", strtotime("+15 minutes"));
$secret = "my-private-secret-provided-by-tv2";

// entire query string without signature parameter
$query = "foo=bar&baz=daz&app=$app&expire=expire"

$signature = md5($query.$secret);