{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://docs.demiton.io/registers/utility_location/v1.json",
  "title": "utility_location contract v1",
  "type": "object",
  "required": [
    "project",
    "quality_level",
    "quality_level_scheme",
    "utility_type"
  ],
  "properties": {
    "depth_m": {
      "type": "number",
      "description": "the depth of the utility below surface",
      "x-demiton-requiredness": "optional",
      "x-demiton-unit": "m",
      "x-demiton-type": "decimal"
    },
    "project": {
      "type": "string",
      "description": "the project the utility was located on",
      "x-demiton-requiredness": "required",
      "x-demiton-reference": true
    },
    "geometry": {
      "type": "object",
      "description": "the located point or line",
      "x-demiton-requiredness": "optional"
    },
    "validated": {
      "type": "boolean",
      "description": "whether the position is validated",
      "x-demiton-requiredness": "optional"
    },
    "asset_owner": {
      "type": "string",
      "description": "the utility owner or network operator",
      "x-demiton-requiredness": "optional"
    },
    "external_id": {
      "type": "string",
      "description": "the source's own feature id",
      "x-demiton-requiredness": "optional"
    },
    "utility_type": {
      "type": "string",
      "description": "the service, e.g. water, gas, electrical or telecommunications",
      "x-demiton-requiredness": "required"
    },
    "quality_level": {
      "type": "string",
      "description": "the quality level of the location information, QL-D to QL-A",
      "x-demiton-requiredness": "required"
    },
    "vertical_datum": {
      "type": "string",
      "description": "the datum any depth or level is referenced to, e.g. AHD",
      "x-demiton-requiredness": "optional"
    },
    "detection_method": {
      "type": "string",
      "description": "how the position was obtained, e.g. records, electromagnetic locator, ground-penetrating radar or trial pit",
      "x-demiton-requiredness": "optional"
    },
    "horizontal_datum": {
      "type": "string",
      "description": "the datum and projection of the geometry, e.g. MGA2020 zone 56",
      "x-demiton-requiredness": "optional"
    },
    "report_reference": {
      "type": "string",
      "description": "the survey report the location comes from",
      "x-demiton-requiredness": "optional"
    },
    "vertical_accuracy_m": {
      "type": "number",
      "description": "the vertical accuracy of the position",
      "x-demiton-requiredness": "optional",
      "x-demiton-unit": "m",
      "x-demiton-type": "decimal"
    },
    "quality_level_scheme": {
      "type": "string",
      "description": "the scheme and edition the level is from, e.g. AS 5488.1:2022",
      "x-demiton-requiredness": "required"
    },
    "horizontal_accuracy_m": {
      "type": "number",
      "description": "the horizontal accuracy of the position",
      "x-demiton-requiredness": "optional",
      "x-demiton-unit": "m",
      "x-demiton-type": "decimal"
    }
  },
  "x-demiton-register-type": "utility_location",
  "x-demiton-contract-version": "1.0.3",
  "x-demiton-store": "tenant",
  "x-demiton-axes": [],
  "x-demiton-measures": [],
  "x-demiton-provenance": {
    "standards": [
      {
        "code": "AHD / AUSGeoid2020",
        "title": "Australian Height Datum with AUSGeoid2020 separation model",
        "access": "full_text_verified",
        "region": "Australia",
        "edition": "AHD71; AUSGeoid2020",
        "checked_on": "2026-09-14"
      },
      {
        "code": "AS 5488.1:2022",
        "title": "Classification of Subsurface Utility Information (SUI)",
        "access": "public_summary",
        "region": "Australia",
        "edition": "2022 (2nd ed.)",
        "checked_on": "2026-09-14"
      },
      {
        "code": "GDA2020 / MGA2020",
        "title": "Geocentric Datum of Australia 2020 and Map Grid of Australia 2020",
        "access": "full_text_verified",
        "region": "Australia",
        "edition": "GDA2020 (ITRF2014 @ 2020.0)",
        "checked_on": "2026-09-14"
      },
      {
        "code": "INSPIRE Data Specification on Coordinate Reference Systems (D2.8.I.1)",
        "title": "INSPIRE CRS Technical Guidelines: ETRS89 horizontal, EVRS vertical",
        "access": "full_text_verified",
        "region": "European Union",
        "edition": "TG v3.2rc2 (release 2024.1)",
        "checked_on": "2026-09-14"
      },
      {
        "code": "RFC 7946",
        "title": "The GeoJSON Format",
        "access": "full_text_verified",
        "clause": "s 4",
        "region": "International",
        "edition": "August 2016",
        "checked_on": "2026-09-14"
      },
      {
        "code": "NZGD2000 / NZTM2000 / NZVD2016",
        "title": "New Zealand Geodetic Datum 2000, NZ Transverse Mercator 2000, NZ Vertical Datum 2016 (NZGeoid2016)",
        "access": "full_text_verified",
        "region": "New Zealand",
        "edition": "NZGD2000 (1998); NZVD2016 (2016)",
        "checked_on": "2026-09-14"
      },
      {
        "code": "OSGB36 / ETRS89 / OSTN15 / OSGM15 (ODN)",
        "title": "Ordnance Survey National Grid, ETRS89 and the definitive transformations",
        "access": "full_text_verified",
        "region": "United Kingdom",
        "edition": "OSTN15 / OSGM15",
        "checked_on": "2026-09-14"
      },
      {
        "code": "PAS 128:2022",
        "title": "Specification for underground utility detection, verification and location",
        "access": "public_summary",
        "region": "United Kingdom",
        "edition": "2022 (2nd ed.)",
        "checked_on": "2026-09-14"
      },
      {
        "code": "ASCE/UESI/CI 38-22",
        "title": "Standard Guideline for Investigating and Documenting Existing Utilities",
        "access": "paywalled_secondary",
        "region": "United States",
        "edition": "2022",
        "checked_on": "2026-09-14"
      },
      {
        "code": "ASCE/UESI/CI 75-22",
        "title": "Standard Guideline for Recording and Exchanging Utility Infrastructure Data",
        "access": "paywalled_secondary",
        "region": "United States",
        "edition": "2022",
        "checked_on": "2026-09-14"
      },
      {
        "code": "NAD 83(2011) / NAVD 88 (NSRS)",
        "title": "US official horizontal and vertical datums, being replaced by NATRF2022 et al.",
        "access": "full_text_verified",
        "region": "United States",
        "edition": "NAD 83 (2011/PA11/MA11) epoch 2010.00; NAVD 88",
        "checked_on": "2026-09-14"
      }
    ]
  },
  "description": "Subsurface utilities on a site, with their AS 5488 quality level.",
  "x-demiton-contract-url": "https://docs.demiton.io/registers/utility_location/",
  "x-demiton-register-catalog": "https://docs.demiton.io/concepts/register-catalog"
}