EcoPlots endpoints allows access to a number of other more specialised data points.
Feature of interest attributes
During a sampling event, observations (e.g. number of flowers, vegetation height, body mass) are performed on features of interest (foi). Features of interest are the “real world” objects that we are interested in sampling/measuring across different ecological scales (e.g. plant individual, animal population, soil profile or climate). TERN’s LinkedData site has more information about Features of Interest.
Every instance of a FOI has additional attributes related exclusively to that instance. For example, the FOI is an individual plant, and there can be multiple instances of the FOI such as a specific tree or plant (tree1, tree2, tree3, etc).
This information can be accessed via the /foi/attributes endpoint.
Request example:
curl -X POST "https://ecoplots.tern.org.au/api/v1.0/foi/attributes?dformat=ndjson" -H "accept: */*" -H "X-Api-Key: aAbBcC...xXyYzZ" -H "Content-Type: application/json" -d "{\"query\":{}}"
Response excerpt:
{
"attributeId":"http://linked.data.gov.au/dataset/ausplots/soil_characterisation-attr-lower_depth-122923",
"featureId":"http://linked.data.gov.au/dataset/ausplots/site_visit_id-58580-soil_char_id-122923",
"attributeName":"soil depth max",
"attributeConceptId":"http://linked.data.gov.au/def/tern-cv/263d7143-e88d-4105-83e7-00d75035a2b3",
"value":0.1,
"valueId":"N/A",
"valueUnit":"Metre",
"valueUnitId":"http://qudt.org/vocab/unit/M"
}
{
"attributeId":"http://linked.data.gov.au/dataset/ausplots/soil_characterisation-attr-upper_depth-122923",
"featureId":"http://linked.data.gov.au/dataset/ausplots/site_visit_id-58580-soil_char_id-122923",
"attributeName":"soil depth min",
"attributeConceptId":"http://linked.data.gov.au/def/tern-cv/376efe60-0550-42b4-b90b-110015806dc7",
"value":0.0,
"valueId":"N/A",
"valueUnit":"Metre",
"valueUnitId":"http://qudt.org/vocab/unit/M"
}
...
{
"attributeId":"http://linked.data.gov.au/dataset/ausplots/soil_characterisation-attr-layer_barcode-122923",
"featureId":"http://linked.data.gov.au/dataset/ausplots/site_visit_id-58580-soil_char_id-122923",
"attributeName":"voucher barcode",
"attributeConceptId":"http://linked.data.gov.au/def/tern-cv/6d351831-45da-403c-919b-1cee41950488",
"value":"NST004264",
"valueId":"N/A",
"valueUnit":"N/A",
"valueUnitId":"N/A"
}
Instrument attributes
When an instrument was used to measure the result of an observation, the type of instrument and the instrument instance identifier was recorded along the observation data.
Information about instrument attributes that are related exclusively to an instance can be accessed via the /systems/attributes endpoint.
Request example:
curl -X POST "https://ecoplots.tern.org.au/api/v1.0/systems/attributes?dformat=ndjson" -H "accept: */*" -H "X-Api-Key: aAbBcC...xXyYzZ" -H "Content-Type: application/json" -d "{\"query\":{}}"
Response excerpt:
{
"attributeId":"http://linked.data.gov.au/dataset/ausplots/tern_basal_area-attr-basal_area_factor-475048",
"instrumentId":"http://linked.data.gov.au/dataset/ausplots/tern_basal_area-inst-basal_area-475048",
"attributeName":"basal area factor",
"attributeConceptId":"http://linked.data.gov.au/def/tern-cv/dd34fc05-012d-4092-9324-a4cbcf29bf0a",
"value":0.1,
"valueId":"N/A",
"valueUnit":"Unitless",
"valueUnitId":"http://qudt.org/vocab/unit/UNITLESS"
}
...
{
"attributeId":"http://linked.data.gov.au/dataset/ausplots/tern_basal_area-attr-basal_area_factor-475069",
"instrumentId":"http://linked.data.gov.au/dataset/ausplots/tern_basal_area-inst-basal_area-475069",
"attributeName":"basal area factor",
"attributeConceptId":"http://linked.data.gov.au/def/tern-cv/dd34fc05-012d-4092-9324-a4cbcf29bf0a",
"value":1.0,
"valueId":"N/A",
"valueUnit":"Unitless",
"valueUnitId":"http://qudt.org/vocab/unit/UNITLESS"
}
Taxon
EcoPlots stores Taxonomic information about all vegetative species collected in the various datasets. This information is sourced from Australian Plant Name Index
Taxon data can be retrieved using the /taxon endpoint.
Request example:
curl -X POST "https://ecoplots.tern.org.au/api/v1.0/taxon?dformat=ndjson" -H "accept: */*" -H "X-Api-Key: aAbBcC...xXyYzZ" -H "Content-Type: application/json" -d "{\"query\":{}}"
Response excerpt:
{
"taxonID":"https://id.biodiversity.org.au/taxon/apni/51612493",
"scientificNameID":"https://id.biodiversity.org.au/name/apni/54714",
"scientificName":"Boraginaceae Juss.",
"scientificNameAuthorship":"Juss.",
"acceptedNameID":"https://id.biodiversity.org.au/taxon/apni/51612493",
"acceptedName":"Boraginaceae Juss.",
"nameAccordingToID":"https://id.biodiversity.org.au/reference/apni/46762",
"nameAccordingTo":"CHAH (2008), Australian Plant Census",
"namePublishedInID":"None",
"namePublishedIn":"None",
"namePublishedInYear":"None",
"originalNameUsageID":"None",
"originalNameUsage":"None",
"parentNameUsageID":"None",
"parentNameUsage":"None",
"conceptID":"https://id.biodiversity.org.au/instance/apni/650956",
"nomenclaturalStatus":"nom. cons.",
"nomenclaturalCode":"ICN",
"taxonomicStatus":"accepted",
"higherClassification":"Plantae|Charophyta|Equisetopsida|Magnoliidae|Asteranae|Boraginaceae",
"kingdom":"Plantae",
"class":"Equisetopsida",
"order":"None",
"family":"Boraginaceae",
"subfamily":"None",
"genus":"None",
"subgenus":"None",
"phylum":"None",
"specificEpithet":"None",
"cultivarEpithet":"None",
"genericName":"None",
"infragenericEpithet":"None",
"infraspecificEpithet":"None",
"taxonRank":"None",
"taxonRemarks":"None",
"verbatimTaxonRank":"None",
"vernacularName":"None"
}{
"taxonID":"https://id.biodiversity.org.au/node/apni/2892197",
"scientificNameID":"https://id.biodiversity.org.au/name/apni/114499",
"scientificName":"Eucalyptus crebra F.Muell.",
"scientificNameAuthorship":"F.Muell.",
"acceptedNameID":"https://id.biodiversity.org.au/node/apni/2892197",
"acceptedName":"Eucalyptus crebra F.Muell.",
"nameAccordingToID":"https://id.biodiversity.org.au/reference/apni/42942",
"nameAccordingTo":"CHAH (2006), Australian Plant Census",
"namePublishedInID":"None",
"namePublishedIn":"None",
"namePublishedInYear":"None",
"originalNameUsageID":"None",
"originalNameUsage":"None",
"parentNameUsageID":"None",
"parentNameUsage":"None",
"conceptID":"https://id.biodiversity.org.au/instance/apni/612750",
"nomenclaturalStatus":"",
"nomenclaturalCode":"ICN",
"taxonomicStatus":"accepted",
"higherClassification":"Plantae|Charophyta|Equisetopsida|Magnoliidae|Rosanae|Myrtales|Myrtaceae|Eucalyptus|crebra",
"kingdom":"Plantae",
"class":"Equisetopsida",
"order":"None",
"family":"Myrtaceae",
"subfamily":"None",
"genus":"None",
"subgenus":"None",
"phylum":"None",
"specificEpithet":"None",
"cultivarEpithet":"None",
"genericName":"None",
"infragenericEpithet":"None",
"infraspecificEpithet":"None",
"taxonRank":"None",
"taxonRemarks":"None",
"verbatimTaxonRank":"None",
"vernacularName":"None"
}
Add Comment