Endpoint Detail: Nearest-station
The data from the nearest station to a given point(s) can be queried. This is done using the api/nearest-station endpoint. Points must be in WGS84 format, and if multiple are provided must be separated by ; (semicolon), while the number of points is limited to 10 per query.
Data types
The dataTypes parameter in the body must be a list of items. Even if querying a single item.
The number of dataTypes is limited to 5 per query.
Available data types differ per time scale, please refer to the table below:
| Time scale | Available data types |
|---|---|
| Hourly | temperature_mean, temperature_min, temperature_max, rain, solar_radation, sunshine_duration, wind_direction, leaf_wetness, wind_speed_max, wind_speed, evaporation, dew_point, humidity, humidity_min, humidity_max |
| Daily | temperature_mean, temperature_min, temperature_max, temperature_median, rain_sum, solar_radiation_sum, sunshine_duration_sum, wind_direction_mean, wind_direction_median, humidity_mean, humidity_min, humidity_max, humidity_median, leaf_wetness_mean, leaf_wetness_median, leaf_wetnes_min, leaf_wetness_max, wind_speed_mean, wind_speed_min, wind_speed_max, evaporation_sum, dew_point_mean, dew_point_median, dew_point_min, dew_point_max, rain_mean, rain_min, rain_max, solar_rad_std_sum, solar_rad_std_mean, solar_rad_std_min, solar_rad_std_max, et0 |
| Monthly | temperature_mean, temperature_min, temperature_max, temperature_median, rain_sum, solar_radiation_sum, sunshine_duration_sum, wind_direction_mean, wind_direction_median, humidity_mean, humidity_min, humidity_max, humidity_median, leaf_wetness_mean, leaf_wetness_median, leaf_wetnes_min, leaf_wetness_max, wind_speed_mean, wind_speed_min, wind_speed_max, evaporation_sum, dew_point_mean, dew_point_median, dew_point_min, dew_point_max, rain_mean, rain_min, rain_max, solar_rad_std |
Time scales
When querying the nearest station data, a timeScale parameter must be provided in the options
dictionary of the body.
Available options are one of the following: "hourly", "daily", "monthly".
The date formats for querying the different time scales are as follows:
| Time scale | Date format |
|---|---|
| Hourly | yyyy-mm-ddThh:mm:ss (where the mm:ss should always be 00:00 as you are only querying hourly data. Hours are from 00:00:00 (midnight) - 23:00:00) |
| Daily | yyyy-mm-dd |
| Monthly | yyyy-mm |
Nearest Station Hourly Request
POST https://api.terraclim.co.za/api/nearest-station/
{
"dataTypes": ["temperature_mean", "temperature_min", "humidity"],
"options": {
"timeScale": "hourly"
},
"wkts": "POINT (29.068916666 -24.33177777)",
"startDate": "2020-07-12T00:00:00",
"endDate": "2020-07-13T00:00:00"
}
Nearest Station Hourly Response
Status: OK (200)
Content-Type: application/json
{
"POINT (29.068916666 -24.33177777)": {
"metadata": {
"station_lat": -24.33177777,
"station_lon": 29.068916666,
"station_elevation": 1170.7,
"distance_from_point_m": 0.0,
"actual_nearest": true
},
"data": {
"2020-07-12T00:00:00": {
"temperature_mean": 5.716666666666666,
"temperature_min": null,
"humidity": 46.166666666666664
},
"2020-07-13T00:00:00": {
"temperature_mean": 10.491666666666667,
"temperature_min": null,
"humidity": 40.166666666666664
}
}
}
}
Nearest Station Daily Request
POST https://api.terraclim.co.za/api/nearest-station/
{
"dataTypes": ["temperature_mean", "et0", "humidity_max", "solar_radiation_sum"],
"options": {
"timeScale": "daily"
},
"wkts": "POINT (30.999443 -25.817709);POINT (30.345306 -29.374156)",
"startDate": "2021-12-10",
"endDate": "2021-12-12"
}
Nearest Station Hourly Response
Status: OK (200)
Content-Type: application/json
{
"POINT (30.999443 -25.817709)": {
"metadata": {
"station_lat": -25.807614,
"station_lon": 30.999309,
"station_elevation": 813.4,
"distance_from_point_m": 1122.59446878,
"actual_nearest": true
},
"data": {
"2021-12-10": {
"temperature_mean": 22.937088734379262,
"et0": 4.1,
"humidity_max": 97,
"solar_radiation_sum": null
},
"2021-12-11": {
"temperature_mean": 24.1075,
"et0": 5.2,
"humidity_max": 97,
"solar_radiation_sum": null
},
"2021-12-12": {
"temperature_mean": 23.819999999999997,
"et0": 7.3,
"humidity_max": 92,
"solar_radiation_sum": null
}
}
},
"POINT (30.345306 -29.374156)": {
"metadata": {
"station_lat": -29.40774444,
"station_lon": 30.242661111,
"station_elevation": 1239.9,
"distance_from_point_m": 10622.79811665,
"actual_nearest": true
},
"data": {
"2021-12-10": {
"temperature_mean": 21.95917267917268,
"et0": null,
"humidity_max": 96.81818181818181,
"solar_radiation_sum": null
},
"2021-12-11": {
"temperature_mean": 24.767445356503742,
"et0": null,
"humidity_max": 90.10355914265847,
"solar_radiation_sum": null
},
"2021-12-12": {
"temperature_mean": 23.335506953797704,
"et0": null,
"humidity_max": 96,
"solar_radiation_sum": null
}
}
}
}
Nearest Station Monthly Request
POST https://api.terraclim.co.za/api/nearest-station/
{
"dataTypes": ["temperature_mean", "temperature_min", "dew_point_median", "rain_max", "rain_mean"],
"options": {
"timeScale": "monthly"
},
"wkts": "POINT (30.333306 -29.254156);POINT(30.345306 -29.374156)",
"startDate": "2020-02",
"endDate": "2020-03"
}
Nearest Station Monthly Response
Status: OK (200)
Content-Type: application/json
{
"POINT (30.333306 -29.254156)": {
"metadata": {
"station_lat": -29.254156,
"station_lon": 30.330306,
"station_elevation": 1526.1,
"distance_from_point_m": 291.03996533,
"actual_nearest": true
},
"data": {
"2020-02-01": {
"temperature_mean": 17.999185314498135,
"temperature_min": 13.905790142012437,
"dew_point_median": null,
"rain_max": 0.08571428571428573,
"rain_mean": 0.011538461538461537
},
"2020-03-01": {
"temperature_mean": 16.71616689578228,
"temperature_min": 12.318017751479289,
"dew_point_median": null,
"rain_max": 0.028571428571428574,
"rain_mean": 0.01628787878787879
}
}
},
"POINT(30.345306 -29.374156)": {
"metadata": {
"station_lat": -29.40774444,
"station_lon": 30.242661111,
"station_elevation": 1239.9,
"distance_from_point_m": 10622.79811665,
"actual_nearest": true
},
"data": {
"2020-02-01": {
"temperature_mean": 20.838721829769064,
"temperature_min": 16.733333333333334,
"dew_point_median": null,
"rain_max": 0.10000000000000002,
"rain_mean": 0.011111111111111113
},
"2020-03-01": {
"temperature_mean": null,
"temperature_min": null,
"dew_point_median": null,
"rain_max": 0,
"rain_mean": 0
}
}
}
}