EcoPlots is primarily concerned with data collected in survey plots across Australia. The core information you can access is about Sites and SiteVisits. (TERN’s LinkedData site has more information about Observations).
Observations
All ecological measurements (plant height, animal count, soil pH, air temperature) in Ecoiplots Ecoplots are represented as observations. [Read more about]You can use this endpoint . Observations can also have additional attributes. An example of an attribute would be an “angle count point name”, but not all sampling protocols record this attribute. Therefore that property does not belong to the Observation itself and it is defined as an additional attribute. (TERN’s LinkedData site has more information about Observations).
Users may be only be interested in a small number of the observations or observation attributes that are available. In that case, it is best to extract observations based on several search criteria (see Search queries). Refer to the Search queries section for more details.
...
Observations
To retrieve observation data available in EcoPlots, you should use the /observations endpoint.
Please note that using this cURL request without any search parameters will results in a huge data download into the commandline. The below example cURL request example has used pagination to restrict the response to one page containing five results. Visit EcoPlots API- paginating results for more details on pagination.
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-keyX-Api-Key: aAbBcC...xXyYzZ" -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\"]page_num\":1,\"page_size\":5,\"query\":{}}" |
Response exampleexcerpt:
| Code Block |
|---|
{
"dataset":"TERN Surveillance Monitoring",
"datasetId":"http://linked.data.gov.au/dataset/ausplots",
"featureId":"http://linked.data.gov.au/dataset/ausplots/site_visit_id-58580-plant_occurr_id-54882275",
"featureType":"plant occurrence",
"featureTypeId":"http://linked.data.gov.au/def/tern-cv/b311c0d3-4a1a-4932-a39c-f5cdc1afa611",
"observationId":"http://linked.data.gov.au/dataset/ausplots/point_intercept-obs-species_name-54882275",
"resultTime":"2018-05-11T00:00:00Z",
"parameter":"scientific name",
"parameterId":"http://linked.data.gov.au/def/tern-cv/56195246-ec5d-4050-a1c6-af786fbec715",
"result":"Boraginaceae",
"resultId":"N/A",
"resultUnit":"N/A",
"resultUnitId":"N/A",
"method":"Vegetation vouchering - vascular plants",
"methodId":"http://linked.data.gov.au/def/ausplots-cv/1d39b897-d6d3-40e9-8113-8ebeab2cd38e",
"instrumentId":"N/A",
"instrumentType":"N/A",
"instrumentTypeId":"N/A",
"siteName":"NSABBS0001",
"siteId":"http://linked.data.gov.au/dataset/ausplots/site-nsabbs0001",
"siteVisitName":"20180511",
"siteVisitId":"http://linked.data.gov.au/dataset/ausplots/sv-58580",
"transectName":"NSABBS0001-transect-E4-W4",
"transectId":"http://linked.data.gov.au/dataset/ausplots/site-nsabbs0001-transect-e4-w4"
}
...
{
"dataset":"TERN Surveillance Monitoring",
"datasetId":"http://linked.data.gov.au/dataset/ausplots",
"featureId":"http://linked.data.gov.au/dataset/ausplots/site_visit_id-58580-plant_occurr_id-54882275",
"featureType":"plant occurrence",
"featureTypeId":"http://linked.data.gov.au/def/tern-cv/b311c0d3-4a1a-4932-a39c-f5cdc1afa611",
"observationId":"http://linked.data.gov.au/dataset/ausplots/point_intercept-obs-species_name-54882275",
"resultTime":"2018-05-11T00:00:00Z",
"parameter":"scientific name",
"parameterId":"http://linked.data.gov.au/def/tern-cv/56195246-ec5d-4050-a1c6-af786fbec715",
"result":"Boraginaceae",
"resultId":"N/A",
"resultUnit":"N/A",
"resultUnitId":"N/A",
"method":"Vegetation vouchering - vascular plants",
"methodId":"http://linked.data.gov.au/def/ausplots-cv/1d39b897-d6d3-40e9-8113-8ebeab2cd38e",
"instrumentId":"N/A",
"instrumentType":"N/A",
"instrumentTypeId":"N/A",
"siteName":"NSABBS0001",
"siteId":"http://linked.data.gov.au/dataset/ausplots/site-nsabbs0001",
"siteVisitName":"20180511",
"siteVisitId":"http://linked.data.gov.au/dataset/ausplots/sv-58580",
"transectName":"NSABBS0001-transect-E4-W4",
"transectId":"http://linked.data.gov.au/dataset/ausplots/site-nsabbs0001-transect-e4-w4"
} |
Observation attributes
Observations can have additional attributes. E.g., an observation might have an attribute “angle count point name”, but not all sampling protocols record this attribute, so the property does not belong to the Observation itself and it is defined as an additional attribute.
You can download all these attributes through the /observations/attributes endpointYou can download observation attributes through the /observations/attributes endpoint. A list of all the attributes that are available to be searched is available on TERN’s LinkedData Attributes page.
Please note that using this cURL request without any search parameters will results in a huge data download into the commandline. The below example cURL request example has used pagination to restrict the response to one page containing five results. Visit EcoPlots API- paginating results for more details on pagination.
Request example:
| Code Block |
|---|
curl -X POST "httphttps://localhost:5000ecoplots.tern.org.au/api/v1.0/observations/attributes?dformat=ndjson" -H "accept: */*" -H "X-Api-Key: aAbBcC...xXyYzZ" -H "Content-Type: application/json" -d "{\"page_numbernum\":1,\"page_size\":1050,\"query\":{\"dataset\":[\"http://linked.data.gov.au/dataset/ausplots\"],\"site_id\":[\"http://linked.data.gov.au/dataset/ausplots/site-nsabbs0001\"]}}" |
Response exampleexcerpt:
| Code Block |
|---|
{
"attributeId":"http://linked.data.gov.au/dataset/ausplots/tern_basal_area-attr-point_id-475048",
"observationId":"http://linked.data.gov.au/dataset/ausplots/tern_basal_area-obs-basal_area-475048",
"attributeName":"angle count point name",
"attributeConceptId":"http://linked.data.gov.au/def/tern-cv/46d2e568-72cd-4df3-b0ed-4ebdaf771e4c",
"value":"NW",
"valueId":"N/A",
"valueUnit":"N/A",
"valueUnitId":"N/A"
}
...
{
"attributeId":"http://linked.data.gov.au/dataset/ausplots/tern_basal_area-attr-point_id-475069",
"observationId":"http://linked.data.gov.au/dataset/ausplots/tern_basal_area-obs-basal_area-475069",
"attributeName":"angle count point name",
"attributeConceptId":"http://linked.data.gov.au/def/tern-cv/46d2e568-72cd-4df3-b0ed-4ebdaf771e4c",
"value":"E",
"valueId":"N/A",
"valueUnit":"N/A",
"valueUnitId":"N/A"
} |