API Documentation

The API access the datasets stored on The Gatton Smart Farm server https://grf-smartfarm.daf.qld.gov.au/

All data is returned as a JSON file

List of available stations

https://grf-smartfarm.daf.qld.gov.au/api/stations If successful, then something like this

{"status":"success","length":50,"data":[{"deviceName":"0310B6F4","latitude":"-27.314293","longitude":"151.746227","region":"ed","name":"Acland","onboard":"1","OldName":""},{"deviceName":"0310B690","latitude":"-28.600556","longitude":"151.824119","region":"gb","name":"Amiens","onboard":"1","OldName":""},

deviceName
Station ID
longitude, latitude
as you would expect
region
The region where the station is
ed
Eastern Downs
sed
Southeastern Downs
lv
Lockyer Valley
gb
Granite Belt
ot
Other
name
Locality
onboard
1 for yes, 0 for not responding

All data for a station and variable

https://grf-smartfarm.daf.qld.gov.au/api/0310B692/airtemp If successful, then something like this for station 0310B692 and air temperature

{"status":"success","length":466158,"data":[{"timestamp":1616022900,"AEST":"2021-03-18T09:15:00","value":24.85},{"timestamp":1616023800,"AEST":"2021-03-18T09:30:00","value":23.37},...

AEST
Australian Eastern Standard Time
timestamp
Unix epoch time, seconds since 1 Jan 1970 midnight GMT
value
Data record, in this example air temperature in oC

Last record for a station and variable

https://grf-smartfarm.daf.qld.gov.au/api/last/GB4237/vpd If successful, then something like this for station GB4237 and VPD

{"status":"success","length":1,"data":[{"timestamp":1691029800,"AEST":"2023-08-03 12:30:00","value":0.760747}]}

Details the same as above

Data for a station and variable where the timestamp is greater than or equal to a Unix epoch time

https://grf-smartfarm.daf.qld.gov.au/api/since/0310B692/airtemp/1678754880 If successful, then something like this for station 0310B692 and air temperature

{"status":"success","length":386295,"data":[{"timestamp":1678755000,"AEST":"2023-03-14T10:50:00","value":28.99},{"timestamp":1678755300,"AEST":"2023-03-14T10:55:00","value":29.03},...

Weather station data available

airtemp
Air Temperature (oC)
airtempforecast
Bias-corrected Air Temperature Forecast (oC)
maxtempforecast
Bias-corrected Maximum Air Temperature Forecast (oC)
mintempforecast
Bias-corrected Minimum Air Temperature Forecast (oC)
rainfall
Rainfall (mm)
rainfallforecast
Forecast daily rainfall (mm)
p10
10% probability of at least x mm
p25
25% probability of at least x mm
p50
50% probability of at least x mm
pop
Probability of at least 0.2 mm (%)
vpd
Vapour Pressure Deficit (kPa)
deltat
Delta-T (oC)
dewpoint
Dew point Temperature (oC)
et0
Evapotranspiration (mm)
rh
Relative Humidity (%)
radiation
Solar Radiation (W/m2)
windspeed
Wind Speed (m/s)
winddir
Wind Direction (degrees)
battery
Battery Voltage (mV)