Schema

Site

Type: Node


The area on which a Cycle occurred. Typically a field for growing crops or grazing animals, an aquaculture pond, a building, or semi-natural vegetation.


Field Type Required Definition
description string No

A description of the Site, including information that cannot be captured with other fields.

organisation Organisation No

A reference to the Organisation this Site is managed by.

siteType string Yes

The type of the Site. Definitions for agricultural land follow FAOSTAT, where cropland here means arable land and permanent crops. The additional term "glass or high accessible cover" is defined by EUROSTAT.

Possible values are: forest, other natural vegetation, cropland, glass or high accessible cover, permanent pasture, animal housing, pond, river or stream, lake, sea or ocean, agri-food processor, food retailer

tenure string No

The ownership status of the Site following EUROSTAT terminology.

Possible values are: farming on owned land, farming on rented land, farming on common land, share farming, other tenure model

numberOfSites number No

If data on multiple Sites are aggregated and represented as a single Site, the number of Sites.

boundary GeoJSON No

A nested GeoJSON object for the Site boundary of type 'FeatureCollection', 'Feature' or 'GeometryCollection'. For cropland the boundary should represent area under cultivation (also called sown area).

area number No

The area of the Site in hectares. For cropland, this is area under cultivation (also called sown area) only. Uncultivated area can be added by creating a new Site and linking it under the same Organisation. Harvested area can be defined for each Cycle using the field harvestedArea. If the numberOfSites is higher than one, the mean area should be recorded. If the Site is a country or region, the area is the area represented by the Cycle data (e.g., the area of the sampled farms).

areaSd number No

The standard deviation of area, if there are multiple Sites.

areaMin number No

The minimum of area, if there are multiple Sites.

areaMax number No

The maximum of area, if there are multiple Sites.

latitude number No

The latitude of the centroid of the Site (-90 to 90, WGS84 datum). We recommend providing latitude with five decimal place precision (which roughly corresponds to 1 meter precision at the equator).

longitude number No

The longitude of the centroid of the Site (-180 to 180, WGS84 datum). We recommend providing longitude with five decimal place precision (which roughly corresponds to 1 meter precision at the equator).

country Term Yes

The country from the Glossary.

region Term No

The most specific geographical region from the Glossary.

glnNumber string No
startDate string No

The date in which the Site in its current form was established in ISO 8601 format (YYYY-MM-DD, YYYY-MM, or YYYY).

endDate string No

The date in which the Site in its current form ceased to exist in ISO 8601 format (YYYY-MM-DD, YYYY-MM, or YYYY).

defaultMethodClassification string No

The default classification of the method used to acquire or estimate all Infrastructure and Management data in the Cycle. Only required if the Site contains data on Infrastructure and Management. It can be overridden by specifying a methodClassification for each Infrastructure item or Management data item.

  • physical measurement means the amount is quantified using weighing, volume measurement, metering, chemical methods, or other physical approaches.
  • verified survey data means the data are initially collected through surveys; all or a subset of the data are verified using physical methods; and erroneous survey data are discarded or corrected.
  • non-verified survey data means the data are collected through surveys that have not been subjected to verification.
  • modelled means a previously calibrated model is used to estimate this data point from other data points describing this Cycle.
  • estimated with assumptions means a documented assumption is used to estimate this data point from other data points describing this Cycle.
  • consistent external sources means the data are taken from external datasets referring to different producers/enterprises:
    • Using the same technology (defined as the same System or the same key Practices as those specified in the Cycle);
    • At the same date (defined as occurring within the startDate and endDate of the Cycle); and
    • In the same region or country.
    Modelling or assumptions may have also been used to transform these data.
  • inconsistent external sources means the data are taken from external datasets referring to different producers/enterprises:
    • Using a different technology (defined as a different System or using different key Practices to those specified in the Cycle);
    • At a different date (defined as occurring within the startDate and endDate of the Cycle); or
    • In a different region or country.
    Modelling or assumptions may have also been used to transform these data.
  • expert opinion means the data have been estimated by experts in the field.
  • unsourced assumption means the data do not have a clear source and/or are based on assumptions only.

Possible values are: physical measurement, verified survey data, non-verified survey data, modelled, estimated with assumptions, consistent external sources, inconsistent external sources, expert opinion, unsourced assumption

defaultMethodClassificationDescription string No

A justification of the defaultMethodClassification used. If the data were estimated with assumptions this field should also describe the assumptions.

defaultSource Source No

The default Source for all data in the Site which can be overridden by specifying a source for each Measurement or item of Infrastructure. Not required (but recommended) for public uploads (i.e., where dataPrivate is false).

measurements List[Measurement] No

The Measurements taken on the Site.

measurements cannot be duplicated. The following fields determine whether a Measurement is unique: term.@id, dates, startDate, endDate, measurementDuration, depthUpper, depthLower, method.@id, methodDescription

management List[Management] No

The Management of the Site.

management cannot be duplicated. The following fields determine whether a Management is unique: term.@id, startDate, endDate

infrastructure List[Infrastructure] No

The Infrastructure on the Site.

infrastructure cannot be duplicated. The following fields determine whether an Infrastructure is unique: term.@id

dataPrivate boolean Yes

If these data are private. Private means that Hestia administrators can access these data and you can grant access to other platform users, but these data will not be made available to any other users of the platform or distributed to third parties.

Defaults to: False


Internal Properties

The following properties are automatically set when data are uploaded to the Hestia platform. If they are included in a file which is uploaded, they will be overwritten.

Field Type Definition
@context string The location of the JSON-LD context file.
@id string The unique ID assigned to the Node by Hestia.
@type string Site
name string

An automatically generated name for the Site composed of: siteType, "-", organisation.name, "-", region "," country, "-", description.

boundaryArea number

The area in km2 of the boundary. This field is automatically calculated when boundary is provided.

ecoregion string
awareWaterBasinId string

The AWARE water basin identifier.

originalId string

The identifier for these data in the source database.

schemaVersion string

The version of the schema when these data were created.

added array[string]

A list of fields that have been added to the original dataset.

addedVersion array[string]

A list of versions of the model used to add these fields.

updated array[string]

A list of fields that have been updated on the original dataset.

updatedVersion array[string]

A list of versions of the model used to update these fields.

aggregated boolean

If this Cycle has been 'aggregated' using data from multiple Cycles.

aggregatedVersion string

A version of the aggregation engine corresponding to this Cycle.

aggregatedSites List[Site]

Sites used to aggregated this Site.

aggregatedSources List[Source]

Sources used to aggregated this Site.

createdAt date

Date created on Hestia in ISO 8601 format (YYYY-MM-DD).

updatedAt date

Last update date on Hestia in ISO 8601 format (YYYY-MM-DD).


Example 1