This page lists notable changes to the service. If you experience that the service behaves in new or unexpected ways,
the changelog might give a hint.
There is a new filter field in the observations/ endpoint,
which allows you to request only certain qualities of data. For example you can request only the best qualities 0 and 1
by writing 0,1 in the
qualites field. If you do not write anything in the field you will get all the qualities of data.
Please be aware that some types of data (such as averages over time) do not have qualities, and so if you try to filter on quality
you will get no data returned. You can read more about about what the quality codes mean in
When using the
nearest() function for
geometry in the
sources/ endpoint, an arbitrary number of sources
nearestmaxcount) may now be returned. Distances from the reference point are included in the output.
Note that the
geometry feature currently applies to point sources only (i.e. weather stations, prefixed with 'SN').
The request for observations now
return status code 503 (Service unavailable) when there are to many requests in progress.
Retry-After is set
to the number of seconds to wait before retrying the request.
As part of improving the overall resource allocation in Frost,
a request for observations will be rejected if the response may result in more than 1000000 individual values. Moreover, it will not
be possible to specify more than 1000 interval repetitions for the
R1001/2018-.../2018-... will be rejected).
A request that exceeds any of these limits will be rejected with
referencetime=latest in a request for observations,
Cache-Control/max-age in the HTTP response header is set to the minimum value of the normal update periods of any of the following elements
occurring in the request:
If none of these elements are requested, the default value is 3600.
limit to reduce response time when specifying
referencetime=latest in a
request for observations.
maxage: don't retrieve observations older than this duration
limit: return values for at most
limit observation times for each source/element combination, counting from the most recent time
Updated IDs of elements and code tables:
|Old element ID||New element ID||Old convention element code|
|Old code table ID||New code table ID|
Removed leading zeros from a couple of time offset values:
Updated element IDs that previously matched one the following patterns:
- In the observations/ endpoint,
the referencetime parameter now accepts the word 'latest' to specify the latest available observation.
- If 'latest' is specified for referencetime, the response header for now contains max-age=3600 as the value of Cache-Control.
This will be fine for most elements. At a later point, the value of max-age may depend on the element in the request that is
expected to be updated most frequently.