Data endpoints - datasources and datasets

Datasources and datasets occupy the highest levels of the TERN EcoPlots data hierarchy. All information in EcoPlots belongs to one or multiple datasources. That main datasource may also be further subset into one or more datasets (that may also be referred to as projects).

Datasources

To retrieve details about the datasources that are available in EcoPlots, you should use the /datasources endpoint.

Request example:

curl -X POST "https://ecoplots.tern.org.au/api/v1.0/datasources?dformat=ndjson" -H "accept: */*" -H "X-Api-Key: aAbBcC...xXyYzZ" -H "Content-Type: application/json" -d "{\"query\":{}}"

Response excerpt:

{
   "dataset":"TERN Surveillance Monitoring",
   "datasetId":"http://linked.data.gov.au/dataset/ausplots",
   "description":"<p> AusPlots is a collection of ecological data and samples gathered from a network of plots and transects across Australia by the TERN Ecosystem Surveillance team, using standardised methodologies. </p> <p>The AusPlots collection provides the ecological infrastructure to: </p> <ul><li>quantify the richness and cover of plant species (including weeds); </li><li>quantify the diversity and abundance of soil biodiversity; </li><li>assess the state, spatial heterogeneity and structural complexity of vegetation, including life-stage; </li><li>record vegetation and soil parameters that assist with the validation of remotely sensed ecological products;</li><li>analyse vegetation structure and change based on a series of photo reference images; </li><li>better estimate soil carbon and nutrient stocks; </li><li>conduct taxonomic validation studies based on collected plant voucher specimens; </li><li>conduct DNA barcoding and population genetic profiling based on collected tissue samples. </li></ul> <p> Overall this information will progress understanding of ecosystem processes, structure and function, and more generally progress understanding of the response to disturbance and longer-term environmental change of rangeland ecosystems, which underpins sustainable management practice.</p>.",
   "abstract":"N/A",
   "version":"2023-04-19",
   "created":null,
   "creator":"TERN Surveillance Monitoring ",
   "creatorId":"https://w3id.org/tern/resources/6be8678c-f354-47da-9667-46daf2a23ac7",
   "publisher":"Terrestrial Ecosystem Research Network (TERN)",
   "publisherId":"https://w3id.org/tern/resources/a083902d-d821-41be-b663-1d7cb33eea66",
   "spatial_extent_min_longitude":113.25800323486328,
   "spatial_extent_min_latitude":-42.09260177612305,
   "spatial_extent_max_longitude":152.89999389648438,
   "spatial_extent_max_latitude":-10.70300006866455
}
...
{ ... }

Datasets

Datasets or projects are subsets of the main datasource. To retrieve more details about the available datasets in EcoPlots, you can use the /datasets endpoint.

Request example:

curl -X POST "https://ecoplots.tern.org.au/api/v1.0/datasets?dformat=ndjson" -H "accept: */*" -H "X-Api-Key: aAbBcC...xXyYzZ" -H "Content-Type: application/json" -d "{\"query\":{\"dataset\": [\"http://linked.data.gov.au/dataset/tern-ecosystem-processes\"]}}"

Response excerpt: