Helios APIs: Observations (Search)
Using aggregations, we can summarize our search results in powerful ways
to identify trends that would not otherwise be apparent using the raw
observation data. When we use the
time aggregation, the
API will return a list of time periods and the total number of observations
matching our query for each of those time periods.
In this example, we are going to look for roads with full snow coverage
in Colorado over a one month span. Our API query uses the
This will return a list of individual observation points that we can
review. Instead of looking through all of this raw data, we are
going to append an
aggs query parameter to aggregate the
results over time. The new query looks like this:
aggs=time query option, our API response now
returns the total number of observations in our time range that
had snow on the road, with the totals provided separately for each day.
We also specified a query option of
will tell the API not to return any of the raw point data. This step
is optional, but if you only care about the aggregation data, it will
help reduce the overall size of the API response.
With our new daily totals, we can begin to identify which days experienced the most severe weather events.