All ecological measurements (plant height, animal count, soil pH, air temperature) in Ecoplots are represented as observations. (TERN’s LinkedData site has more information about Observations).
Observations
To retrieve observation data available in EcoPlots, you should use the /observations endpoint.
Request example:
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\"]}}"
Response example:
{
"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 endpoint.
Request example:
curl -X POST "http://localhost:5000/api/v1.0/observations/attributes?dformat=ndjson" -H "accept: */*" -H "Content-Type: application/json" -d "{\"page_number\":1,\"page_size\":10,\"query\":{\"dataset\":[\"http://linked.data.gov.au/dataset/ausplots\"],\"site_id\":[\"http://linked.data.gov.au/dataset/ausplots/site-nsabbs0001\"]}}"
Response example:
{
"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"
}
Users may be only be interested in a small number of the observations that are available. In that case, it would be useful to use extract observations based on several search criteria. Refer to the Search queries section for more details.
0 Comments