{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://publicschema.org/agri/HoldingParcelLink.schema.json",
  "title": "HoldingParcelLink",
  "description": "A dated statement that a farm uses all or part of an agricultural parcel. Several farms may use the same parcel. The link does not by itself assert exclusive use, ownership or a legal right.",
  "type": "object",
  "properties": {
    "linked_holding": {
      "oneOf": [
        {
          "$ref": "https://publicschema.org/agri/Farm.schema.json"
        },
        {
          "type": "string",
          "description": "URI or identifier reference"
        }
      ],
      "description": "The farm that uses the linked parcel or facility."
    },
    "linked_parcel": {
      "oneOf": [
        {
          "$ref": "https://publicschema.org/agri/AgriculturalParcel.schema.json"
        },
        {
          "type": "string",
          "description": "URI or identifier reference"
        }
      ],
      "description": "The agricultural parcel used by the farm during the relationship period."
    },
    "used_area": {
      "$ref": "https://publicschema.org/QuantityValue.schema.json",
      "description": "The area of the linked parcel that this farm uses. Areas used by different farms may overlap; do not add them without an allocation rule."
    },
    "parcel_tenure": {
      "type": "string",
      "enum": [
        "owned_with_title",
        "owned_without_title",
        "rented",
        "sharecropped",
        "communal",
        "state_allocated",
        "informal",
        "borrowed",
        "other"
      ],
      "$comment": "https://publicschema.org/vocab/agri/land-tenure",
      "description": "The arrangement under which the farm uses the linked parcel, such as ownership, rental or sharecropping, as reported by the source. A farm may own one parcel and rent another. This describes how the farm uses the parcel; it is not a record of land rights, which a land tenure assertion states."
    },
    "parcel_land_use": {
      "$ref": "https://publicschema.org/CodedValue.schema.json",
      "description": "The use the farm makes of the linked parcel, such as temporary crops, permanent crops or permanent meadows and pastures, as a code from a stated scheme such as the FAO World Programme for the Census of Agriculture land use classes. Where parts of the parcel have different uses, record one link per part with its used area."
    },
    "start_date": {
      "type": "string",
      "format": "date",
      "description": "The date on which this became effective."
    },
    "end_date": {
      "type": "string",
      "format": "date",
      "description": "The last day on which this is effective. A period includes both its start date and its end date, so a period that applies only on 30 June 2026 has start date 2026-06-30 and end date 2026-06-30."
    },
    "evidence_assertions": {
      "type": "array",
      "items": {
        "oneOf": [
          {
            "$ref": "https://publicschema.org/EvidenceAssertion.schema.json"
          },
          {
            "type": "string",
            "description": "URI or identifier reference"
          }
        ],
        "description": "Statements identifying sources that support or contradict this statement."
      }
    }
  }
}