BBC News Labs Documentation

Documentation for BBC News Labs APIs & #newsHACK events

Weather API: 3 day forecast

Description

The 3 Day JSON Forecast feed provides forecast data for day and night weather for today and the following 2 days. The information switches automatically to show the overnight forecast at 16:00 GMT, and the current day changes at 04:00 GMT. If the feed is used correctly there is no effort involved in letting the feed switch over by itself.

You need to be aware that after 1600 GMT then the current days weather detail will appear as Null in the feed, as only the night time details are valid. The night time icons and Low temp should be shown as a minimum.

Table of properties and values

The following properties are included in the JSON:

general properties

locationId

the geoId, as stored in Locator

locationName

name of the place, as stored in Locator

country

containing country, as stored in Locator

latitude

floating point to 3 decimal places

longitude

floating point to 3 decimal places

timezoneName

e.g. "Europe/London"

date

in ISO 8601 format

dayName

e.g. "Thursday"

dayNameAbbreviation

e.g. "Thu"

daytime forecast

(valid beween 0400 and 1600hrs)

sunrise

in ISO 8601 format

visibility

e.g. "Good"

weatherCode

Met Office descriptive code

wind direction

e.g. "SW"

wind direction desc

e.g. "South Westerly"

windspeed mph

e.g. 15

windspeed kph

e.g. 24

weatherType

Met Office description, e.g. "Sunny intervals"

weatherSymbol mobile

URL of the relevant daytime weather icon image, smallest size

weatherSymbol webSmall

URL of the relevant daytime weather icon image, larger size

weatherSymbol webMedium

URL of the relevant daytime weather icon image, largest size

humidityPercent

e.g. 80

pressureMillibars

e.g. 1017

maxTemperature centigrade

maximum day temperature in C, e.g. 14

maxTemperature fahrenheit

maximum day temperature in F, e.g. 57

night time forecast

Valid Between 1600 and 0400(+1day)

sunset

in ISO 8601 format

weatherCode

Met Office descriptive code

weatherType

weatherSymbol mobile

URL of the relevant night-time weather icon image, smallest size

weatherSymbol webSmall

URL of the relevant night-time weather icon image, larger size

weatherSymbol webMedium

URL of the relevant night-time weather icon image, largest size

minTemperature centigrade

minimum night temperature in C, e.g. 14

minTemperature fahrenheit

minimum night temperature in F, e.g. 57

URL


Questions and Feedback

All comments are moderated for approval.