Request Components

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

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

You can query Past Weather data up to 7-days into the past. Past Weather queries require you define a ‘Time’. When you query Past Weather it will use the closest available data to your chosen location.

The Past Weather ‘Data Type’ is defined within the query using the text “pwx” or “past”

api/trigger/{Location}/past {Element} {Time} {Operator} {Value}

api/trigger/51.50,-0.12/past yesterday temperature gt 10

You can query Current Weather data. There is no need to define a ‘Time’ when querying Current Weather. When you query Current Weather it will use the closest available data to your chosen location.

The Current Weather ‘Data Type’ is defined within the query using the text “cwx” or “current”

api/trigger/{Location}/Current {Element} {Operator} {Value}

api/trigger/51.50,-0.12/current temperature gt 10

You can query Forecast Weather data up to 7-days into the future. Forecast Weather queries require you define a ‘Time’. When you query Forecast Weather it will use the closest available data to your chosen location.

The Forecast Weather ‘Data Type’ is defined within the query using the text “fwx” or “forecast”.

api/trigger/{Location}/forecast {Element} {TimePeriod} {Operator} {Value}

api/trigger/51.50,-0.12/forecast tomorrow temperature gt 10

For a specific interval between two points in time, must contain two dates in the following format. The hour part (hh) is optional.: "yyyy.mm.dd,yyyy.mm.dd" or "yyyy.mm.dd.hh,yyyy.mm.dd.hh"

The day period can prefix a date with the following format: "day_period.yyyy.mm.dd"

The day period option helps run queries for specific periods in the day across multiple days. Day period prefix can be:

• "day" - from 06:00 to 18:00
• "night" - from 18:00 to 06:00 of the next day
• "morning" - from 06:00 to 12:00
• "afternoon" - from 12:00 to 18:00
• "evening" - from 18:00 to 00:00
• "overnight" - from 00:00 to 06:00
• "am" - from 00:00 to 12:00
• "pm" - from 12:00 to 00:00

The day period can prefix a time frame between two dates, with the following format: "prefix.yyyy.mm.dd,yyyy.mm.dd"

For a predefined time span use the following format: "predefined_timespan"
or you can postfix it with a day period: "predefined_timespan.day_period"

• "tomorrow" for "Forecast" data
• "yesterday" for "Past" data

The Precipitation Type element is defined within the query using the text “weather” or “wx”.

The Temperature element is defined within the query using the text “temperature” or “temp”. The Temperature element can be used for the following ‘Data Types’;

• Past
• Current
• Forecast

When using the Temperature element within the query the following ‘Operators’, ‘Values’ and ‘Units’ can be applied;

The Relative Humidity element is defined within the query using the text “humidity” or “hum”. The Relative Humidity element can be used for the following ‘Data Types’;

• Past
• Current
• Forecast

When using the Relative Humidity element within the query the following ‘Operators’, ‘Values’ and ‘Units’ can be applied;

The Wind Speed element is defined within the query using the text “windspeed” or “wspd”. The Wind Speed element can be used for the following ‘Data Types’;

• Past
• Current
• Forecast

When using the Wind Speed element within the query the following ‘Operators’, ‘Values’ and ‘Units’ can be applied;

The Wind Direction element is defined within the query using the text “winddirection” or “wdir”. The Wind Direction element can be used for the following ‘Data Types’;

• Past
• Current
• Forecast

When using the Wind Direction element within the query the following ‘Operators’, ‘Values’ and ‘Units’ can be applied;

The Cloud Cover element is defined within the query using the text “Cloud” or “cld”. The Cloud Cover element can be used for the following ‘Data Types’;

• Past
• Current
• Forecast

When using the Cloud Cover element within the query the following ‘Operators’, ‘Values’ and ‘Units’ can be applied;

The Visibility element is defined within the query using the text “visibility” or “vis”. The Visibility element can be used for the following ‘Data Types’;

• Past
• Current
• Forecast

When using the Visibility element within the query the following ‘Operators’, ‘Values’ and ‘Units’ can be applied;

The Air Pressure element is defined within the query using the text “pressure” or “pres”. The Air Pressure element can be used for the following ‘Data Types’;

• Past
• Current
• Forecast

When using the Air Pressure element within the query the following ‘Operators’, ‘Values’ and ‘Units’ can be applied;

The Precipitation Amount element is defined within the query using the text “precipitation” or “preciptl”. The Precipitation Amount element can be used for the following ‘Data Types’;

• Forecast

When using the Precipitation Amount element within the query the following ‘Operators’, ‘Values’ and ‘Units’ can be applied;

The Rainfall Amount element is defined within the query using the text “raintl”. The Rainfall Amount element can be used for the following ‘Data Types’;

• Forecast

When using the Rainfall Amount element within the query the following ‘Operators’, ‘Values’ and ‘Units’ can be applied;

The Snowfall Amount element is defined within the query using the text “snowtl”. The Snowfall Amount element can be used for the following ‘Data Types’;

• Forecast

When using the Snowfall Amount element within the query the following ‘Operators’, ‘Values’ and ‘Units’ can be applied;