...
| Table of Contents | ||||
|---|---|---|---|---|
|
Data endpoints
...
Datasources
All information in EcoPlots belongs to one of multiple datasetsdatasources. To retrieve more details about the available datasets datasources in EcoPlots, you can should use the /datasetsdatasources endpoint.
Request example:
| Code Block |
|---|
curl -X POST "https://ecoplots-test.tern.org.au/api/v1.0/datasetsdatasources?dformat=ndjson" -H "accept: */*" -H "Authorization: apikey-v1 aAbBcC...xXyYzZ" -H "Content-Type: application/json" -d "{\"query\":{}}" |
...
| Code Block |
|---|
{
"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>.",
"versionabstract":"2022-03-05N/A",
"creatorversion":"Sparrow2023-04-19",
B. "created":null,
Tokmakoff, A. , Leitch, E. , Guerin, G. , O'Neill, S. , Macdonald, C. , Lowe, A. , Flitton, R. , Saleeba, T. , Coish, C. and TERN Surveillance "creator":"TERN Surveillance Monitoring ",
"creatorId":"https://w3id.org/tern/resources/6be8678c-f354-47da-9667-46daf2a23ac7",
"publisher":"Terrestrial Ecosystem Research Network (TERN)",
"publisherpublisherId":"TERNhttps://w3id.org/tern/resources/a083902d-d821-41be-b663-1d7cb33eea66",
"citationspatial_extent_min_longitude":"Sparrow113.25800323486328,
B. , Tokmakoff, A. , Leitch, E. , Guerin, G. , O'Neill, S. , McDonald, C. , Lowe, A. , Flitton, R. , Saleeba, T. , Coish, C. and TERN Surveillance (2021). TERN Surveillance monitoring program: Ecological Plot Survey Data and Samples collected from Field Sites across Australia. Terrestrial Ecosystem Research Network (TERN)." "spatial_extent_min_latitude":-42.09260177612305,
"spatial_extent_max_longitude":152.89999389648438,
"spatial_extent_max_latitude":-10.70300006866455
}
...
{ ... } |
Datasets
Information in EcoPlots may belong to a smaller datasets, part off the main datasource (also called project). To retrieve more details about the available datasets in EcoPlots, you can use the /datasets endpoint.
Request example:
| Code Block |
|---|
curl -X POST "https://ecoplots-test.tern.org.au/api/v1.0/datasets?dformat=ndjson" -H "accept: */*" -H "Authorization: apikey-v1 aAbBcC...xXyYzZ" -H "Content-Type: application/json" -d "{\"query\":{}}" |
Response example:
| Code Block |
|---|
{
"project":"Biomass",
"projectId":"http://linked.data.gov.au/dataset/tern-ecosystem-processes/dataset-biomass",
"dataset":"TERN Ecosystem Processes",
"datasetId":"http://linked.data.gov.au/dataset/tern-ecosystem-processes",
"description":"The TERN Ecosystem Processes above-ground woody biomass Database contains diameter, height and above-ground woody biomass data collected across 15 TERN operated sites spanning 11 vegetation types such as: Mallee woodlands, Eucalypt forests and Rainforests. This database provides above-ground woody biomass values across multiple spatial scales: plant communities, plant individuals and individual stems.",
"abstract":null,
"version":null,
"created":null,
"creator":"TERN Ecosystem Processes",
"creatorId":"https://w3id.org/tern/resources/8f2acf9f-3cf2-48c7-b911-ed1b1113932e",
"publisher":"Terrestrial Ecosystem Research Network (TERN)",
"publisherId":"https://w3id.org/tern/resources/a083902d-d821-41be-b663-1d7cb33eea66",
"spatial_extent_min_longitude":116.93900299072266,
"spatial_extent_min_latitude":-43.09550094604492,
"spatial_extent_max_longitude":153.08799743652344,
"spatial_extent_max_latitude":-13.178999900817871
}
...
{ ... } |
Sites and SiteVisits
EcoPlots primarily contains on data collected in survey plots across Australia, hence other core information you can access is Plot/Site and SiteVisit. [Read more about Sites]
/sites and /sitevisits endpoints serve all the ecological sites (and their visits) information, including basic description of the site, latitude and longitude coordinates, establishment dates, visit dates and other useful details.
...
All ecological measurements (plant height, animal count, soil pH, air temperature) in Ecoiplots are represented as observations. [Read more about Observations]
You can use this endpoint to extract observations based on several search criteria (see Search queries).
Request example:
| Code Block |
|---|
curl -X POST "https://ecoplots-test.tern.org.au/api/v1.0/observations?dformat=ndjson" -H "accept: */*" -H "Authorization: apikey-v1 your-api-key" -H "Content-Type: application/json" -d "{\"query\":{\"dataset\":[\"http://linked.data.gov.au/dataset/ausplots\"],\"site_id\":[\"http://linked.data.gov.au/dataset/ausplots/site-nsabbs0001\"],\"feature_type\":[\"http://linked.data.gov.au/def/tern-cv/b311c0d3-4a1a-4932-a39c-f5cdc1afa611\"],\"observed_property\":[\"http://linked.data.gov.au/def/tern-cv/56195246-ec5d-4050-a1c6-af786fbec715\"]}}" |
...
In the TERN Ontology, a Feature of Interest (FOI) is an ecological scale (e.g. plant individual, animal population, soil, climate). Observations are grouped by ecological scales (FOI) and the FOI type and feature id for each observation are returned with the observation. [Read more about Feature of Interest]
However, every instance of FOI may have additional attributes related exclusively to the instance. This information can be accessed via the /foi/attributes endpoint.
...