Feature

EntityDraftv1.0.0-rc.2

A feature: a natural or built object with a place and properties, such as a wellsite, a dwelling or a road. As in ISO 19101. A feature where a framework judges effects is a receptor and has a receptor class.

https://opendevelopmentstandards.org/schema/1.0.0-rc.2/core/Feature.json

Fields

Every entity also has the fields of the Entity base. The first row lists them.

From the Entity baseidnamedescriptionidentifierslinkscreatedAtupdatedAt
  • idRequired
    textnot empty

    The record's id: unique within the document. Fields that point at the record hold this id.

  • name
    text

    The name people use for the record.

  • description
    text

    What the record is, in words.

  • identifiers

    Ids the record has in other systems.

  • links

    Open-ended links to other records.

  • createdAt
    date-time (RFC 3339)

    When the record was created, in its producer's system.

  • updatedAt
    date-time (RFC 3339)

    When the record last changed, in its producer's system.

Links

Held by Records that embed this one, with their field that holds it.

Examples

An id that another example defines opens that record.

Full example

{
  "id": "feature-wellsite",
  "name": "Wellsite 04-12",
  "type": "site",
  "location": {
    "point": {
      "type": "Point",
      "coordinates": [
        -113.815,
        52.268,
        912.4
      ]
    },
    "crs": {
      "code": "EPSG:4617",
      "name": "NAD83(CSRS)",
      "verticalDatum": "CGVD2013",
      "verticalCode": "EPSG:6647",
      "coordinateEpoch": 2010
    },
    "absoluteHeight": 912.4,
    "positioning": {
      "method": "gnss_rtk",
      "horizontalAccuracy": 0.02,
      "verticalAccuracy": 0.03,
      "confidenceLevel": 95,
      "determinedAt": "2026-07-02T10:15:00-06:00"
    },
    "geographicIdentifiers": [
      {
        "type": "legal_land_description",
        "scheme": "ca.dls",
        "value": "04-12-038-27W4"
      }
    ],
    "linearReference": {
      "line": "feature-pipeline",
      "distance": {
        "amount": 12.4,
        "unit": "km"
      }
    }
  },
  "geometry": {
    "type": "Polygon",
    "coordinates": [
      [
        [
          -113.8157,
          52.2676
        ],
        [
          -113.8143,
          52.2676
        ],
        [
          -113.8143,
          52.2684
        ],
        [
          -113.8157,
          52.2684
        ],
        [
          -113.8157,
          52.2676
        ]
      ]
    ],
    "positioning": {
      "method": "surveyed",
      "horizontalAccuracy": 0.05,
      "confidenceLevel": 95
    },
    "original": {
      "file": "file-site-plan",
      "layer": "lease_boundary",
      "feature": "17",
      "geometryType": "CurvePolygon",
      "crs": {
        "code": "EPSG:3402"
      },
      "changes": [
        {
          "type": "curves_linearized",
          "tolerance": 0.01
        },
        {
          "type": "reprojected"
        }
      ]
    }
  },
  "sources": [
    {
      "id": "source-compressor",
      "name": "Compressor package",
      "type": "compressor"
    }
  ],
  "structures": [
    {
      "id": "structure-wall",
      "name": "Sound wall",
      "type": "barrier"
    }
  ]
}
Show 2 more examples

Minimal example: the required fields only

{
  "id": "feature-wellsite"
}

Full example 2

{
  "id": "feature-dwelling",
  "name": "Dwelling 450 m north-east",
  "type": "building",
  "receptorClass": "dwelling",
  "location": {
    "point": {
      "type": "Point",
      "coordinates": [
        -113.8104,
        52.2709
      ]
    },
    "relativeHeight": 1.5
  }
}

Changes and file

Changes

  1. 0.1.0 First version.

Schema file

Show the JSON Schema
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://opendevelopmentstandards.org/schema/1.0.0-rc.2/core/Feature.json",
  "title": "Feature",
  "description": "A feature: a natural or built object with a place and properties, such as a wellsite, a dwelling or a road. As in ISO 19101. A feature where a framework judges effects is a receptor and has a receptor class.",
  "$ref": "Entity.json",
  "type": "object",
  "properties": {
    "type": {
      "type": "string",
      "pattern": "^[a-z0-9]+(_[a-z0-9]+)*(\\.[a-z0-9]+(_[a-z0-9]+)*)*$",
      "x-ods-vocabulary": "core/feature_types",
      "description": "What sort of feature it is, such as `site` or `building`."
    },
    "receptorClass": {
      "type": "string",
      "pattern": "^[a-z0-9]+(_[a-z0-9]+)*(\\.[a-z0-9]+(_[a-z0-9]+)*)*$",
      "x-ods-vocabulary": "core/receptor_classes",
      "description": "For a receptor: its class, such as `dwelling`. A framework's criteria apply by class."
    },
    "location": {
      "$ref": "Location.json",
      "description": "Where the record is, as one point."
    },
    "geometry": {
      "$ref": "Geometry.json",
      "description": "The record's shape: a line or an area."
    },
    "properties": {
      "type": "array",
      "items": {
        "$ref": "Property.json"
      },
      "description": "Facts about the record. Each `type` comes from a quantities vocabulary."
    },
    "sources": {
      "type": "array",
      "items": {
        "$ref": "Source.json"
      },
      "description": "The sources on the feature."
    },
    "structures": {
      "type": "array",
      "items": {
        "$ref": "Structure.json"
      },
      "description": "The structures on the feature."
    }
  },
  "patternProperties": {
    "^x-": {}
  },
  "unevaluatedProperties": false,
  "examples": [
    {
      "id": "feature-wellsite"
    },
    {
      "id": "feature-wellsite",
      "name": "Wellsite 04-12",
      "type": "site",
      "location": {
        "point": {
          "type": "Point",
          "coordinates": [
            -113.815,
            52.268,
            912.4
          ]
        },
        "crs": {
          "code": "EPSG:4617",
          "name": "NAD83(CSRS)",
          "verticalDatum": "CGVD2013",
          "verticalCode": "EPSG:6647",
          "coordinateEpoch": 2010
        },
        "absoluteHeight": 912.4,
        "positioning": {
          "method": "gnss_rtk",
          "horizontalAccuracy": 0.02,
          "verticalAccuracy": 0.03,
          "confidenceLevel": 95,
          "determinedAt": "2026-07-02T10:15:00-06:00"
        },
        "geographicIdentifiers": [
          {
            "type": "legal_land_description",
            "scheme": "ca.dls",
            "value": "04-12-038-27W4"
          }
        ],
        "linearReference": {
          "line": "feature-pipeline",
          "distance": {
            "amount": 12.4,
            "unit": "km"
          }
        }
      },
      "geometry": {
        "type": "Polygon",
        "coordinates": [
          [
            [
              -113.8157,
              52.2676
            ],
            [
              -113.8143,
              52.2676
            ],
            [
              -113.8143,
              52.2684
            ],
            [
              -113.8157,
              52.2684
            ],
            [
              -113.8157,
              52.2676
            ]
          ]
        ],
        "positioning": {
          "method": "surveyed",
          "horizontalAccuracy": 0.05,
          "confidenceLevel": 95
        },
        "original": {
          "file": "file-site-plan",
          "layer": "lease_boundary",
          "feature": "17",
          "geometryType": "CurvePolygon",
          "crs": {
            "code": "EPSG:3402"
          },
          "changes": [
            {
              "type": "curves_linearized",
              "tolerance": 0.01
            },
            {
              "type": "reprojected"
            }
          ]
        }
      },
      "sources": [
        {
          "id": "source-compressor",
          "name": "Compressor package",
          "type": "compressor"
        }
      ],
      "structures": [
        {
          "id": "structure-wall",
          "name": "Sound wall",
          "type": "barrier"
        }
      ]
    },
    {
      "id": "feature-dwelling",
      "name": "Dwelling 450 m north-east",
      "type": "building",
      "receptorClass": "dwelling",
      "location": {
        "point": {
          "type": "Point",
          "coordinates": [
            -113.8104,
            52.2709
          ]
        },
        "relativeHeight": 1.5
      }
    }
  ],
  "x-ods-status": "draft",
  "x-ods-kind": "entity",
  "x-ods-module": "core",
  "x-ods-changes": {
    "0.1.0": "First version."
  }
}