Local Weather API

Resources

Icons

Icon Set Number 1 (Download Full Set)

Icon	File Name
	Blizzard.gif
	Clear.gif
	CloudRainThunder.gif
	CloudSleetSnowThunder.gif
	Cloudy.gif
	Fog.gif
	FreezingDrizzle.gif
	FreezingFog.gif
	FreezingRain.gif
	HeavyRain.gif
	HeavyRainSwrsDay.gif
	HeavyRainSwrsNight.gif
	HeavySleet.gif
	HeavySleetSwrsDay.gif
	HeavySleetSwrsNight.gif
	HeavySnow.gif
	HeavySnowSwrsDay.gif
	HeavySnowSwrsNight.gif
	IsoRainSwrsDay.gif
	IsoRainSwrsNight.gif
	IsoSleetSwrsDay.gif
	IsoSleetSwrsNight.gif
	IsoSnowSwrsDay.gif
	IsoSnowSwrsNight.gif
	mist.gif
	ModRain.gif
	ModRainSwrsDay.gif
	ModSleet.gif
	ModSleetSwrsDay.gif
	ModSleetSwrsNight.gif
	ModSnow.gif
	ModSnowSwrsDay.gif
	ModSnowSwrsNight.gif
	OccLightRain.gif
	OccLightSleet.gif
	OccLightSnow.gif
	Overcast.gif
	PartCloudRainThunderDay.gif
	PartCloudRainThunderNight.gif
	PartCloudSleetSnowThunderDay.gif
	PartCloudSleetSnowThunderNight.gif
	PartlyCloudyDay.gif
	PartlyCloudyNight.gif
	Sunny.gif

Icon Set Number 2 (Download Full Set)

Icon	File Name
	Blizzard.png
	Clear.png
	CloudRainThunder.png
	CloudSleetSnowThunder.png
	Cloudy.png
	Fog.png
	FreezingDrizzle.png
	FreezingFog.png
	FreezingRain.png
	HeavyRain.png
	HeavyRainSwrsDay.png
	HeavyRainSwrsNight.png
	HeavySleet.png
	HeavySleetSwrsDay.png
	HeavySleetSwrsNight.png
	HeavySnow.png
	HeavySnowSwrsDay.png
	HeavySnowSwrsNight.png
	IsoRainSwrsDay.png
	IsoRainSwrsNight.png
	IsoSleetSwrsDay.png
	IsoSleetSwrsNight.png
	IsoSnowSwrsDay.png
	IsoSnowSwrsNight.png
	mist.png
	ModRain.png
	ModRainSwrsDay.png
	ModSleet.png
	ModSleetSwrsDay.png
	ModSleetSwrsNight.png
	ModSnow.png
	ModSnowSwrsDay.png
	ModSnowSwrsNight.png
	OccLightRain.png
	OccLightSleet.png
	OccLightSnow.png
	Overcast.png
	PartCloudRainThunderDay.png
	PartCloudRainThunderNight.png
	PartCloudSleetSnowThunderDay.png
	PartCloudSleetSnowThunderNight.png
	PartlyCloudyDay.png
	PartlyCloudyNight.png
	Sunny.png

Descriptions

Codes and Descriptions (Download)

Code	Description
0	Sunny skies/Clear skies
1	Partly cloudy skies
2	Cloudy skies
3	Overcast skies
10	Mist
21	Patchy rain possible
22	Patchy snow possible
23	Patchy sleet possible
24	Patchy freezing drizzle possible
29	Thundery outbreaks possible
38	Blowing snow
39	Blizzard
45	Fog
49	Freezing fog
50	Patchy light drizzle
51	Light drizzle
56	Freezing drizzle
57	Heavy freezing drizzle
60	Patchy light rain
61	Light rain
62	Moderate rain at times
63	Moderate rain
64	Heavy rain at times
65	Heavy rain
66	Light freezing rain
67	Moderate or heavy freezing rain
68	Light sleet
69	Moderate or heavy sleet
70	Patchy light snow
71	Light snow
72	Patchy moderate snow
73	Moderate snow
74	Patchy heavy snow
75	Heavy snow
79	Ice pellets
80	Light rain shower
81	Moderate or heavy rain shower
82	Torrential rain shower
83	Light sleet showers
84	Moderate or heavy sleet showers
85	Light snow showers
86	Moderate or heavy snow showers
87	Light showers of ice pellets
88	Moderate or heavy showers of ice pellets
91	Patchy light rain with thunder
92	Moderate or heavy rain with thunder
93	Patchy light snow with thunder
94	Moderate or heavy snow with thunder

Response Fields

Response Fields Current Weather

Field	Type	Format	Description
lat	decimal		weather station latitude
lon	decimal		weather station longitude
alt_m	decimal	meters	weather station altitude
alt_f	decimal	feet	weather station altitude
wx_desc	string	text	weather description
wx_code	integer	integer	weather code
wx_icon	string	.gif	weather icon file name
temp_c	1 decimal	Celcius	temperature
temp_f	1 decimal	Fahrenheit	temperature
feelslike_c	1 decimal	Celcius	feel like temperature
feelslike_f	1 decimal	fahrenheit	feel like temperature
windspd_mph	integer	miles per hour	maximum mean wind speed
windspd_kmh	integer	kilometers per hour	maximum mean wind speed
windspd_kts	integer	knots	maximum mean wind speed
windspd_ms	1 decimal	metres per second	maximum mean wind speed
winddir_deg	integer	degrees (0-360)	direction wind is coming from
winddir_compass	string	16 Point	direction wind is coming from
cloudtotal_pct	integer	percent	amount of total cloud
humid_pct	integer	percent	humidity level
dewpoint_c	1 decimal	Celcius	dewpoint
dewpoint_f	1 decimal	Fahrenheit	dewpoint
vis_km	1 decimal	kilometers	visibility
vis_mi	1 decimal	miles	visibility
slp_mb	integer	millibars	sea level pressure
slp_in	2 decimal	inches	sea level pressure

Response Fields Forecast Weather

Field

Type

Format

Description

Day

date

date/time stamp

day / date

local time

sunrise_time

time

HH:mm

civil sunrise time

sunset_time

time

HH:mm

civil sunset time

moonrise_time

time

HH:mm

moonrise time

moonset_time

time

HH:mm

moonset time

moonphase

phase the moon is in

temp_max_c

1 decimal

celcius

maximum temperature

temp_max_f

1 decimal

fahrenheit

maximum temperature

temp_min_c

1 decimal

celcius

minimum temperature

temp_min_f

1 decimal

fahrenheit

minimum temperature

precip_total_mm

1 decimal

millimeters

total amount of precipitation

precip_total_in

1 decimal

inches

total amount of precipitation

rain_total_mm

1 decimal

millimeters

total amount of precipitation falling as rain

rain_total_in

1 decimal

inches

total amount of precipitation falling as rain

snow_total_mm

1 decimal

millimeters

total amount of precipitation falling as snow

snow_total_in

1 decimal

inches

total amount of precipitation falling as snow

prob_precip_pct

integer

percent

probability of precipitation falling

humid_max_pct

integer

percent

maximum humidity level

humid_min_pct

integer

percent

minimum humidity level

windspd_max_mph

integer

miles per hour

maximum mean wind speed

windspd_max_kmh

integer

kilometers per hour

maximum mean wind speed

windspd_max_kts

integer

knots

maximum mean wind speed

windspd_max_ms

1 decimal

metres per second

maximum mean wind speed

windgst_max_mph

integer

miles per hour

maximum wind gust

windgst_max_kmh

integer

kilometers per hour

maximum wind gust

windgst_max_kts

integer

knots

maximum wind gust

windgst_max_ms

1 decimal

metres per second

maximum wind gust

slp_max_in

2 decimal

inches

maximum sea level pressure

slp_max_mb

integer

millibars

maximum sea level pressure

slp_min_in

2 decimal

inches

minimum sea level pressure

slp_min_mb

integer

millibars

minimum sea level pressure

Timeframes - list of 3 hourly timeframes

Field	Type	Format	Description
Timeframe			forecast timeframe
date
time	00:00		local time
wx_desc	string	text	weather description
wx_desc_short	text	text	short weather description
wx_code	integer	integer	weather code
wx_icon	string	.gif	weather icon file name
temp_c	1 decimal	Celcius	temperature
temp_f	1 decimal	Fahrenheit	temperature
feelslike_c	1 decimal	Celcius	feel like temperature
feelslike_f	1 decimal	fahrenheit	feel like temperature
winddir_deg	integer	degrees (0-360)	direction wind is coming from
winddir_compass	string	16 Point	direction wind is coming from
windspd_mph	integer	miles per hour	maximum mean wind speed
windspd_kmh	integer	kilometers per hour	maximum mean wind speed
windspd_kts	integer	knots	maximum mean wind speed
windspd_ms	1 decimal	metres per second	maximum mean wind speed
windgst_mph	integer	miles per hour	maximum wind gust
windgst_kmh	integer	kilometers per hour	maximum wind gust
windgst_kts	integer	knots	maximum wind gust
windgst_ms	1 decimal	metres per second	maximum wind gust
cloud_low_pct	integer	percent	amount of low level cloud
cloud_mid_pct	integer	percent	amount of mid level cloud
cloud_high_pct	integer	percent	amount of high level cloud
cloudtotal_pct	integer	percent	amount of total cloud
precip_mm	1 decimal	millimeters	amount of precipitation
precip_in	1 decimal	inches	amount of precipitation
rain_mm	1 decimal	millimeters	amount of precipitation falling as rain
rain_in	1 decimal	inches	amount of precipitation falling as rain
snow_mm	1 decimal	millimeters	amount of precipitation falling as snow
snow_in	1 decimal	inches	amount of precipitation falling as snow
snow_accum_cm	1 decimal	centimetres	amount of fresh snowfall - if accumulated
snow_accum_in	1 decimal	inches	amount of fresh snowfall - if accumulated
prob_precip_pct	string or "<1"	percent	probability of precipitation falling
humid_pct	integer	percent	humidity level
dewpoint_c	1 decimal	Celcius	dewpoint
dewpoint_f	1 decimal	Fahrenheit	dewpoint
vis_km	1 decimal	kilometers	visibility
vis_mi	1 decimal	miles	visibility
slp_mb	integer	millibars	sea level pressure
slp_in	2 decimal	inches	sea level pressure

Request Parameters

Location

There are two different ways to specify the location:
Latitude/Longitude Co-ordinates or post code/zipcode.

Latitute/Longitude (Lat/Lon)

Valid decimal geolocation coordinates with the following format: "latitude,longitude", with no more than 3 decimal places.

Example: Current Weather for New York

http://api.weatherunlocked.com/api/current/40.71,-74.00?app_id=APP_ID&app_key=APP_KEY

Postcode/Zipcode

A valid postcode with the following format: "country.postcode"
where country can be the available countries in our system.

Country	Value	Format (@ = Letter, # = Number)
United Kingdom	'uk'	'uk.postcode'
United States	'us'	'us.#####'
Argentina	'ar'	'ar.@####@@@'
Austria	'at'	'at.#####'
Australia	'au'	'au.#####'
Belgium	'be'	'be.####'
Brazil	'br'	'br.#####-###'
Canada	'ca'	'ca.@#@ #@#'
Denmark	'dk'	'dk.####'
Finland	'fi'	'fi.#####'
France	'fr'	'fr.#####'
Germany	'de'	'de.postcode'
Ireland	'ie'	'ie.@@@'
Italy	'it'	'it.#####'
Netherlands	'nl'	'nl.####'
Norway	'no'	'no.####'
Spain	'es'	'es.#####'
Sweden	'se'	'se.### ##'

Example: Current Weather and UK postcode

http://api.weatherunlocked.com/api/current/uk.G3 8ND?app_id=APP_ID&app_key=APP_KEY

Example: Forecast Weather and US zipcode

http://api.weatherunlocked.com/api/forecast/us.33109?app_id=APP_ID&app_key=APP_KEY

Please contact us if you would like postcodes to be made available for another country.

Optional Parameters

Language

Add the 'lang' parameter to get weather descriptions in your language.

Available Languages

Language	Value
English	default
Danish	'da'
French	'fr'
Italian	'it'
German	'de'
Dutch	'nl'
Spanish	'es'
Norwegian	'no'
Swedish	'sv'
Turkish	'tr'
Bulgarian	'bg'
Czech	'cs'
Hungarian	'hu'
Polish	'pl'
Romanian	'rm'
Russian	'ru'
Slovak	'sk'

Example: Forecast Weather with Italian descriptions

http://api.weatherunlocked.com/api/forecast/40.7,-74?lang=it&app_id=APP_ID&app_key=APP_KEY