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.

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

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.

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