Site

Site

Type:Node

View examples

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. Sites can also be whole farms, regions, or countries.

FieldTypeRequiredDefinition
description
stringNo

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

organisation
OrganisationNo

A reference to the Organisation this Site is managed by.

siteType
stringYes

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, tank, river or stream, lake, sea or ocean, agri-food processor, food retailer

tenure
stringNo

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
numberNo

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

boundary
objectNo

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

area
numberNo

The area of the Site in hectares. For cropland, this must be area under cultivation, also called sown area. Harvested area, which can be less than sown area, can be defined for each Cycle using the field harvestedArea. If data from more than one Site has been averaged (numberOfSites is greater than one) the area must also be the mean area across Sites and not the sum of areas. If the Site is a country or region, the area must be the area represented by the Cycle data (e.g., the area of the sampled farms or the area of maize production in a country).

This field has additional validation rules when set:

  • functionalArea must not be set.

areaSd
numberNo

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

areaMin
numberNo

The minimum of area, if there are multiple Sites.

areaMax
numberNo

The maximum of area, if there are multiple Sites.

latitude
numberNo

The latitude of the centroid of the Site (-90 to 90, WGS84 datum). Latitude should be provided with at least five decimal place precision (which roughly corresponds to 1 meter precision at the equator).

longitude
numberNo

The longitude of the centroid of the Site (-180 to 180, WGS84 datum). Longitude should be provided with at least five decimal place precision.

country
TermYes

The country from the Glossary.

This field has additional validation rules when set:

  • the country.termType must have one of the following values: region.

region
TermNo

The most specific geographical region from the Glossary.

This field has additional validation rules when set:

  • the region.termType must have one of the following values: region.

glnNumber
stringNo

The Global Location Number.

startDate
stringNo

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

endDate
stringNo

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
stringNo

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

This field has additional validation rules when set:

  • defaultMethodClassificationDescription must also be set.

defaultMethodClassificationDescription
stringNo

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

defaultSource
SourceNo

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, methodClassification

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

This field has additional validation rules when set:

  • defaultMethodClassification must also be set.

infrastructure
List[Infrastructure]No

The Infrastructure on the Site.

infrastructure cannot be duplicated. The following fields determine whether a Infrastructure is unique: infrastructureId

This field has additional validation rules when set:

  • defaultMethodClassification must also be set.

dataPrivate
booleanYes

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.

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.

FieldTypeDefinition
@context

The location of the JSON-LD context file.

@id

The unique ID assigned to the Node by HESTIA.

@type

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, used for validation and gap filling. This field is automatically calculated when boundary is provided.

ecoregion
string

The WWF Terrestrial Ecoregion name.

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 Site has been 'aggregated' using data from multiple Sites.

aggregatedDataValidated
boolean

If this aggregated Site has been validated by the HESTIA team.

aggregatedVersion
string

A version of the aggregation engine corresponding to this Site.

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

{
  "@context": "https://DOMAIN/schema/Site.jsonld",
  "@id": "site",
  "@type": "Site",
  "siteType": "cropland",
  "name": "Field 1",
  "organisation": {
    "@id": "org",
    "@type": "Organisation",
    "name": "La Ferme du Grand Roc"
  },
  "boundary": {
    "type": "FeatureCollection",
    "features": [
      {
        "type": "Feature",
        "properties": {},
        "geometry": {
          "type": "Polygon",
          "coordinates": [
            [
              [
                6.9052934646606445,
                49.16690366996946
              ],
              [
                6.903340816497803,
                49.16568302182135
              ],
              [
                6.900680065155029,
                49.16423784775604
              ],
              [
                6.9001007080078125,
                49.16369063491694
              ],
              [
                6.8998003005981445,
                49.163255666551734
              ],
              [
                6.900315284729004,
                49.16308729067498
              ],
              [
                6.901495456695557,
                49.16392916433382
              ],
              [
                6.903705596923828,
                49.165023578693386
              ],
              [
                6.903920173645019,
                49.1649534246523
              ],
              [
                6.906323432922362,
                49.16608990788086
              ],
              [
                6.9052934646606445,
                49.16690366996946
              ]
            ]
          ]
        }
      }
    ]
  },
  "area": 4.465786,
  "country": {
    "@id": "GADM-FRA",
    "@type": "Term",
    "name": "France",
    "termType": "region"
  },
  "region": {
    "@id": "GADM-FRA.6.9.3_1",
    "@type": "Term",
    "name": "Forbach (Districts), Moselle (Department), Grand Est (Region), France",
    "termType": "region"
  },
  "ecoregion": "Western European broadleaf forests",
  "defaultSource": {
    "@id": "source",
    "@type": "Source",
    "name": "Gigou (1990)"
  },
  "defaultMethodClassification": "physical measurement",
  "defaultMethodClassificationDescription": "Specifications regarding site infrastructure were provided by the manufacturer.",
  "measurements": [
    {
      "@type": "Measurement",
      "term": {
        "@id": "soilPh",
        "@type": "Term",
        "name": "Soil pH",
        "termType": "measurement"
      },
      "method": {
        "@id": "cacl2MethodSoilPh",
        "@type": "Term",
        "name": "CaCl2 method, soil pH",
        "termType": "methodMeasurement"
      },
      "methodClassification": "on-site physical measurement",
      "dates": [
        "1989-01-01"
      ],
      "value": [
        7.6
      ]
    },
    {
      "@type": "Measurement",
      "term": {
        "@id": "organicCarbonPerKgSoil",
        "@type": "Term",
        "name": "Organic carbon (per kg soil)",
        "units": "g C / kg soil",
        "termType": "measurement"
      },
      "method": {
        "@id": "chromicAcidWetOxidation",
        "@type": "Term",
        "name": "Chromic acid wet oxidation",
        "termType": "methodMeasurement"
      },
      "methodClassification": "on-site physical measurement",
      "dates": [
        "1989-01",
        "1989-01-01",
        "1989-01-01T20:20:39"
      ],
      "value": [
        0.1,
        0.36,
        0.4
      ],
      "depthUpper": 0,
      "depthLower": 30
    }
  ],
  "infrastructure": [
    {
      "@type": "Infrastructure",
      "infrastructureId": "dripIrrigationEquipment",
      "term": {
        "@id": "dripIrrigationEquipment",
        "@type": "Term",
        "name": "Drip irrigation equipment",
        "termType": "irrigation"
      },
      "startDate": "1988-01-01",
      "defaultLifespan": 25,
      "source": {
        "@id": "s66765d",
        "@type": "Source",
        "name": "Gigou (1990)"
      },
      "inputs": [
        {
          "@type": "Input",
          "term": {
            "@id": "polyvinylChloride",
            "@type": "Term",
            "name": "Polyvinyl Chloride",
            "units": "kg",
            "termType": "material"
          },
          "value": [
            1100
          ]
        }
      ]
    }
  ],
  "dataPrivate": false
}

Example 2

{
  "@context": "https://DOMAIN/schema/Site.jsonld",
  "@id": "site",
  "@type": "Site",
  "siteType": "cropland",
  "name": "Land use change example",
  "country": {
    "@id": "GADM-BRA",
    "@type": "Term",
    "name": "Brazil",
    "termType": "region"
  },
  "management": [
    {
      "@type": "Management",
      "term": {
        "@id": "forest",
        "@type": "Term",
        "name": "Forest",
        "termType": "landCover"
      },
      "value": 5.9,
      "startDate": "1990-01-01",
      "endDate": "1990-12-31"
    },
    {
      "@type": "Management",
      "term": {
        "@id": "annualCropland",
        "@type": "Term",
        "name": "Annual cropland",
        "termType": "landCover"
      },
      "value": 94.15,
      "startDate": "1990-01-01",
      "endDate": "1990-12-31"
    },
    {
      "@type": "Management",
      "term": {
        "@id": "permanentCropland",
        "@type": "Term",
        "name": "Permanent cropland",
        "termType": "landCover"
      },
      "value": 0,
      "startDate": "1990-01-01",
      "endDate": "1990-12-31"
    },
    {
      "@type": "Management",
      "term": {
        "@id": "permanentPasture",
        "@type": "Term",
        "name": "Permanent pasture",
        "termType": "landCover"
      },
      "value": 0,
      "startDate": "1990-01-01",
      "endDate": "1990-12-31"
    },
    {
      "@type": "Management",
      "term": {
        "@id": "maizePlant",
        "@type": "Term",
        "name": "Maize plant",
        "termType": "landCover"
      },
      "value": 100,
      "startDate": "2010-01-01",
      "endDate": "2010-12-31"
    }
  ],
  "defaultSource": {
    "@id": "source",
    "@type": "Source",
    "name": "Cordoba (2024)"
  },
  "defaultMethodClassification": "verified survey data",
  "defaultMethodClassificationDescription": "Data from site visits and historical maps",
  "dataPrivate": false
}