May 24, 2018

You are here:
< All Topics
image_pdfDownload as PDF

Forecast Soil Temperature and Soil Moisture

We’ve updated our Forecast API with soil temperature and soil moisture data.  The new properties, “soilTemperatures” and “soilMoisture” support the same temporal resolution and query string parameter options as the previous Forecast data, such as ?blockSize=24.  Both are also available at four different height levels, as seen in this example:

"soilTemperatures": [
    {
        "depth": "0-0.1 m below ground",
        "average": 23.280274311701458,
        "max": 25.234960556030273,
        "min": 21.87548828125,
        "units": "C"
    },
    {
        "depth": "0.1-0.4 m below ground",
        "average": 16.724999904632568,
        "max": 16.75,
        "min": 16.649999618530273,
        "units": "C"
    },
    {
        "depth": "0.4-1 m below ground",
        "average": 13.338225046793619,
        "max": 13.377226829528809,
        "min": 13.297206878662109,
        "units": "C"
    },
    {
        "depth": "1-2 m below ground",
        "average": 9.5112450520197545,
        "max": 9.5558004379272461,
        "min": 9.4738674163818359,
        "units": "C"
    }
],
"soilMoisture": [
    {
        "depth": "0-0.1 m below ground",
        "average": 24.891666650772095,
        "max": 25.899999618530273,
        "min": 23.80000114440918
    },
    {
        "depth": "0.1-0.4 m below ground",
        "average": 23.297066132227581,
        "max": 23.51373291015625,
        "min": 23.01373291015625
    },
    {
        "depth": "0.4-1 m below ground",
        "average": 22.691666603088379,
        "max": 22.799999237060547,
        "min": 22.399999618530273
    },
    {
        "depth": "1-2 m below ground",
        "average": 28.258333047231037,
        "max": 28.299999237060547,
        "min": 28.200000762939453
    }
]

If you want to exclude the new soil data, use the ?properties= query string parameter to explicitly list the properties you are interested in.  For example:
https://api.awhere.com/v2/weather/locations/40,-95/forecasts?properties=temperatures, precipitation
To review the full response and property details, see the documentation here: Forecast Weather.

Was this article helpful?
0 out Of 5 Stars
5 Stars 0%
4 Stars 0%
3 Stars 0%
2 Stars 0%
1 Stars 0%
How can we improve this article?
Table of Contents