GeoNet API

Welcome to the FITS API.

The GeoNet project makes all its data and images freely available. Please ensure you have read and understood our Data Policy and Disclaimer before using any of these services.

The FITS API provides access to the observations and associated meta data in the Field Time Series database. If you are looking for other data then please check the full range of data available from GeoNet.

Endpoints

The following endpoints are available:

• /map - Simple maps of sites.
• /method - Look up method information.
• /observation - Look up observations.
• /observation/stats - Get observation statistics.
• /plot - Simple plots of observations.
• /site - Look up site information.
• /spark - Simple spark lines of recent observations.
• /type - Look up observation type information.

Versioning

API queries may be versioned via the Accept header. Please specify the Accept header for your request exactly as specified for the endpoint query you are using.

If you don't specify an Accept header with a version then your request will be routed to the current highest API version of the query.

Taking advantage of the API versioning will pay dividends in the future for any client that you write. We use the jq command for JSON pretty printing etc. A curl command might look like:

curl -H "Accept: application/vnd.geo+json;version=1" "http://...API-QUERY..." | jq .

You may also be able to find a browser plugin to help with setting the Accept header for requests.

Compression

The response for a query can be compressed. If your client can handle a compressed response then the reduced download size is a great benifit. Gzip compression is supported. You can request a compressed response by including gzip in your Accept-Encoding header.

Bugs

The code that provide these services is available at https://github.com/GeoNet/fits If you believe you have found a bug please raise an issue or pull request there. Alternatively contact us detailing the issue.