{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://publicschema.org/agri/AgriculturalParcel.schema.json",
  "title": "AgriculturalParcel",
  "description": "An identified, delimited area of land used or usable for agricultural production, as recorded by the source for a stated period. It is a land-use unit. It is not a cadastral parcel, a title unit or a census parcel of one tenure type, although its boundary may coincide with any of them. Use by one or more farms is recorded separately. A split or merge creates a new parcel, which names the parcels it came from and closes their validity; a corrected measurement or geometry of the same land keeps the parcel.",
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "The full display name of the record. Depending on the concept, this is a person's or group's name, or the title of a program, instrument, scoring rule, or software product."
    },
    "identifiers": {
      "type": "array",
      "items": {
        "oneOf": [
          {
            "$ref": "https://publicschema.org/Identifier.schema.json"
          },
          {
            "type": "string",
            "description": "URI or identifier reference"
          }
        ],
        "description": "Identifiers carried by this entity, such as national ID numbers, program IDs, or identifiers asserted by an identity document."
      }
    },
    "spatial_geometry": {
      "type": "array",
      "items": {
        "oneOf": [
          {
            "$ref": "https://publicschema.org/SpatialGeometry.schema.json"
          },
          {
            "type": "string",
            "description": "URI or identifier reference"
          }
        ],
        "description": "A geometric representation of the described resource. The type of that resource, not this property, says what the shape belongs to. It is separate from an address or a named administrative area."
      }
    },
    "parcel_area": {
      "$ref": "https://publicschema.org/QuantityValue.schema.json",
      "description": "The measured area of the agricultural parcel, with its unit of measure."
    },
    "location": {
      "oneOf": [
        {
          "$ref": "https://publicschema.org/Location.schema.json"
        },
        {
          "type": "string",
          "description": "URI or identifier reference"
        }
      ],
      "description": "The geographic location of the subject of this record, captured as coordinates or administrative area."
    },
    "land_spatial_units": {
      "type": "array",
      "items": {
        "oneOf": [
          {
            "$ref": "https://publicschema.org/land/LandSpatialUnit.schema.json"
          },
          {
            "type": "string",
            "description": "URI or identifier reference"
          }
        ],
        "description": "The land administration spatial units, such as cadastral parcels, that the agricultural parcel lies on, as recorded by the source. Their boundaries need not coincide. The link does not make the agricultural parcel a title unit or state who holds rights in the land."
      }
    },
    "predecessor_parcels": {
      "type": "array",
      "items": {
        "oneOf": [
          {
            "$ref": "https://publicschema.org/agri/AgriculturalParcel.schema.json"
          },
          {
            "type": "string",
            "description": "URI or identifier reference"
          }
        ],
        "description": "The agricultural parcels from which this parcel was formed by a split, merge or other change of boundary. The predecessors keep their own identities and validity periods."
      }
    },
    "valid_from": {
      "type": "string",
      "format": "date",
      "description": "The first calendar day on which the registration, permission, certification or other stated fact applies, as its source states it, when known. A later suspension, withdrawal or correction is recorded separately and does not overwrite this date."
    },
    "valid_to": {
      "type": "string",
      "format": "date",
      "description": "The last calendar day on which the registration, permission, certification or other stated fact applies, as its source states it. A later suspension, withdrawal or correction is recorded separately and does not overwrite this date. If absent, the end is unknown, not unlimited."
    }
  }
}