Data endpoints - sites and site visits

Sites and SiteVisits

EcoPlots is primarily concerned with data collected in survey plots across Australia. The core information accessible is about Sites and SiteVisits. (TERN’s LinkedData site has more information about Sites and Site visits)

/sites and /sitevisits endpoints serves all the ecological site (and visit) information, including a basic description of the site, latitude and longitude coordinates, establishment dates, visit dates and other useful details.

Sites

Request example:

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

Response excerpt:

{
   "dataset":"TERN Surveillance Monitoring",
   "datasetId":"http://linked.data.gov.au/dataset/ausplots",
   "siteName":"WAACOO0006",
   "siteId":"http://linked.data.gov.au/dataset/ausplots/site-waacoo0006",
   "siteType":"site",
   "siteTypeId":"http://linked.data.gov.au/def/tern-cv/5bf7ae21-a454-440b-bdd7-f2fe982d8de4",
   "dateCommissioned":"2013-08-20",
   "description":"Jilbadgi Nature Reserve, About 1.5km NE of Boodarding Rock, which is 37km SSE of Yellowdine. Salmon gum woodland immediately south of access track to Jilbadgi NR from Gt Eastern Hwy.",
   "dimension":"100.0x100.0",
   "latitude":"-31.596380",
   "longitude":"119.824100",
   "altitude":"N/A",
   "polygonWkt":"POLYGON((119.82412222 -31.59637778, 119.824125 -31.595475, 119.82517778 -31.595475, 119.82517778 -31.596375, 119.82412222 -31.59637778))",
   "pointWkt":"POINT(119.82412222 -31.59637778)",
   "pointPositionWithinPlot":"South West",
   "pointPositionWithinPlotId":"http://linked.data.gov.au/def/tern-cv/4dd22567-d692-44e7-b29d-b80eaff829dc"
}
{
   "dataset":"TERN Surveillance Monitoring",
   "datasetId":"http://linked.data.gov.au/dataset/ausplots",
   "siteName":"WAACOO0011",
   "siteId":"http://linked.data.gov.au/dataset/ausplots/site-waacoo0011",
   "siteType":"site",
   "siteTypeId":"http://linked.data.gov.au/def/tern-cv/5bf7ae21-a454-440b-bdd7-f2fe982d8de4",
   "dateCommissioned":"2013-10-04",
   "description":"Boorabbin National Park, About 6km south of Boorabbin on a large gypsum dune jutting into a lake chain.",
   "dimension":"100.0x100.0",
   "latitude":"-31.252840",
   "longitude":"120.341900",
   "altitude":"N/A",
   "polygonWkt":"POLYGON((120.34193861 -31.25283625, 120.34192222 -31.25188611, 120.34297222 -31.25188611, 120.34297222 -31.25278889, 120.34193861 -31.25283625))",
   "pointWkt":"POINT(120.34193861 -31.25283625)",
   "pointPositionWithinPlot":"South West",
   "pointPositionWithinPlotId":"http://linked.data.gov.au/def/tern-cv/4dd22567-d692-44e7-b29d-b80eaff829dc"
}
...
{
   "dataset":"TERN Surveillance Monitoring",
   "datasetId":"http://linked.data.gov.au/dataset/ausplots",
   "siteName":"WAACOO0007",
   "siteId":"http://linked.data.gov.au/dataset/ausplots/site-waacoo0007",
   "siteType":"site",
   "siteTypeId":"http://linked.data.gov.au/def/tern-cv/5bf7ae21-a454-440b-bdd7-f2fe982d8de4",
   "dateCommissioned":"2013-10-15",
   "description":"North part of Jilbadgi NR about 0.3 km west of Boodarding Rock.",
   "dimension":"100.0x100.0",
   "latitude":"-31.606720",
   "longitude":"119.807500",
   "altitude":"N/A",
   "polygonWkt":"POLYGON((119.80754722 -31.60672222, 119.80754722 -31.60582222, 119.8086 -31.60582222, 119.8086 -31.60672222, 119.80754722 -31.60672222))",
   "pointWkt":"POINT(119.80754722 -31.60672222)",
   "pointPositionWithinPlot":"South West",
   "pointPositionWithinPlotId":"http://linked.data.gov.au/def/tern-cv/4dd22567-d692-44e7-b29d-b80eaff829dc"
}

SiteVisits

Request example:

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

Response excerpt:

Site or SiteVisit attributes

Site and SiteVisits can have additional attributes not defined in the Site and SiteVisits class as they may be dataset specific (i.e. the attribute is not shared/used across other datasets, so it is not explicitly defined in the ontology).

You can download all these attributes through the /sites/attributes and /sitevisits/attributes endpoints.

Request example:

Response excerpt:

Users may be only interested in sites that belong to a specific dataset, or sites within a specific geographic region across all datasets. In that case, it would be useful to use a search query to narrow the results. Refer to the Search queries section for more details.