{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://docs.demiton.io/registers/site_bore_reference/v2.json",
  "title": "site_bore_reference contract v2",
  "type": "object",
  "required": [
    "bores_within_radius",
    "content",
    "horizontal_datum",
    "logged_bores_within_radius",
    "nearest_bore_distance_m",
    "nearest_bore_rock_depth_m",
    "project",
    "radius_m",
    "source"
  ],
  "properties": {
    "source": {
      "type": "string",
      "description": "the register and vintage the answer was resolved from (e.g. the NGIS NSW extract)",
      "x-demiton-requiredness": "required"
    },
    "content": {
      "type": "string",
      "description": "one sentence stating the resolved answer",
      "x-demiton-requiredness": "required"
    },
    "project": {
      "type": "string",
      "description": "the tenant project whose site coordinate the answer is about",
      "x-demiton-requiredness": "required",
      "x-demiton-reference": true
    },
    "radius_m": {
      "type": "integer",
      "description": "the search radius the counts and distances were computed at",
      "x-demiton-requiredness": "required",
      "x-demiton-unit": "m"
    },
    "datum_epoch": {
      "type": "string",
      "description": "the epoch where the horizontal datum is frame-based",
      "x-demiton-requiredness": "optional"
    },
    "resolved_at": {
      "type": "string",
      "description": "when the answer was resolved",
      "x-demiton-requiredness": "optional",
      "format": "date-time",
      "x-demiton-type": "datetime"
    },
    "register_state": {
      "type": "jurisdiction",
      "description": "the state register the answer came from",
      "x-demiton-requiredness": "optional"
    },
    "rock_lith_code": {
      "type": "string",
      "description": "the `MajorLithCode` that evidenced rock",
      "x-demiton-requiredness": "optional"
    },
    "horizontal_datum": {
      "type": "string",
      "description": "the horizontal datum (and, where frame-based, the realisation) the site coordinate was expressed in",
      "x-demiton-requiredness": "required"
    },
    "resolver_version": {
      "type": "string",
      "description": "which resolver/method version produced the answer",
      "x-demiton-requiredness": "optional"
    },
    "rock_lith_scheme": {
      "type": "string",
      "description": "the code list/edition the lithology code belongs to (NGIS `MajorLithCode`; AS 1726:2017 / AGS 4.2 / DIGGS for other sources)",
      "x-demiton-requiredness": "optional"
    },
    "bores_within_radius": {
      "type": "integer",
      "description": "number of registered bores inside `radius_m`",
      "x-demiton-requiredness": "required",
      "x-demiton-unit": "dimensionless (named absence, not \"count\")"
    },
    "nearest_logged_bore_id": {
      "type": "integer",
      "description": "the source register's `bore_id` for the nearest logged bore",
      "x-demiton-requiredness": "optional"
    },
    "nearest_bore_distance_m": {
      "type": "number",
      "description": "distance from the project site coordinate to the nearest registered bore within the radius",
      "x-demiton-requiredness": "required",
      "x-demiton-unit": "m",
      "x-demiton-type": "decimal"
    },
    "nearest_bore_rock_depth_m": {
      "type": "number",
      "description": "shallowest `depth_top_m` of an interval whose `MajorLithCode` is in the rock allowlist, in the nearest logged bore; null means no rock evidenced, and null is a first-class answer",
      "x-demiton-requiredness": "required",
      "x-demiton-unit": "m (below ground level)",
      "x-demiton-type": "decimal"
    },
    "logged_bores_within_radius": {
      "type": "integer",
      "description": "how many of those carry a lithology log",
      "x-demiton-requiredness": "required",
      "x-demiton-unit": "dimensionless"
    },
    "nearest_bore_drilled_depth_m": {
      "type": "number",
      "description": "total drilled depth of the nearest logged bore",
      "x-demiton-requiredness": "optional",
      "x-demiton-unit": "m",
      "x-demiton-type": "decimal"
    },
    "nearest_logged_bore_distance_m": {
      "type": "number",
      "description": "distance to the nearest bore that carries a log",
      "x-demiton-requiredness": "optional",
      "x-demiton-unit": "m",
      "x-demiton-type": "decimal"
    }
  },
  "x-demiton-register-type": "site_bore_reference",
  "x-demiton-contract-version": "2.0.1",
  "x-demiton-store": "tenant",
  "x-demiton-axes": [
    {
      "axis": "project",
      "requirement": "required",
      "role": "subject"
    }
  ],
  "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 1289 series",
        "title": "Methods of testing soils for engineering purposes",
        "access": "paywalled_secondary",
        "region": "Australia",
        "edition": "series; parts separately dated (AS 1289.0:2014)",
        "checked_on": "2026-09-14"
      },
      {
        "code": "AS 1726:2017",
        "title": "Geotechnical site investigations",
        "access": "public_summary",
        "region": "Australia",
        "edition": "2017 (4th ed.)",
        "checked_on": "2026-09-14"
      },
      {
        "code": "AS 5488.1:2022",
        "title": "Classification of Subsurface Utility Information (SUI)",
        "access": "public_summary",
        "region": "Australia",
        "edition": "2022",
        "checked_on": "2026-09-14"
      },
      {
        "code": "AS ISO 19650.1/.2:2019",
        "title": "Information management using BIM (identical to ISO 19650-1/-2:2018)",
        "access": "public_summary",
        "region": "Australia",
        "edition": "2019",
        "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": "National Measurement (Recognized-Value Standard of Measurement of Position) Determination 2017",
        "title": "Legal definition of GDA2020 under National Measurement Act 1960 (Cth) s 8A",
        "access": "public_summary",
        "clause": "s 8A NMA 1960",
        "region": "Australia",
        "edition": "2017 (a 2026 Determination is cited elsewhere; conflicting)",
        "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": "EPSG Geodetic Parameter Dataset",
        "title": "IOGP CRS registry (EPSG:7844 GDA2020, EPSG:7855 MGA zone 55, EPSG:4326 WGS 84 ensemble)",
        "access": "full_text_verified",
        "region": "International",
        "edition": "v13.102",
        "checked_on": "2026-09-14"
      },
      {
        "code": "ISO 14688-1:2017 / ISO 14688-2:2017",
        "title": "Geotechnical investigation and testing - Identification and classification of soil",
        "access": "paywalled_secondary",
        "region": "International",
        "edition": "2017 (EN ISO / BS EN ISO 2018 adoptions)",
        "checked_on": "2026-09-14"
      },
      {
        "code": "ISO 22475-1:2021",
        "title": "Geotechnical investigation and testing - Sampling methods and groundwater measurements - Part 1: Technical principles for the sampling of soil, rock and groundwater",
        "access": "paywalled_secondary",
        "region": "International",
        "edition": "2021 (EN ISO 22475-1:2021)",
        "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": "AGS 4.2",
        "title": "Electronic Transfer of Geotechnical and Geoenvironmental Data",
        "access": "public_summary",
        "region": "United Kingdom",
        "edition": "Edition 4.2 (2025-12-31)",
        "checked_on": "2026-09-14"
      },
      {
        "code": "BS 5930:2015+A1:2020",
        "title": "Code of practice for ground investigations",
        "access": "public_summary",
        "region": "United Kingdom",
        "edition": "2015+A1:2020",
        "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": "Underground utility detection",
        "access": "public_summary",
        "region": "United Kingdom",
        "edition": "2022",
        "checked_on": "2026-09-14"
      },
      {
        "code": "ASCE/UESI/CI 38-22",
        "title": "Investigating and Documenting Existing Utilities",
        "access": "paywalled_secondary",
        "region": "United States",
        "edition": "2022",
        "checked_on": "2026-09-14"
      },
      {
        "code": "ASTM D2487-17(2025)",
        "title": "Classification of Soils for Engineering Purposes (USCS)",
        "access": "public_summary",
        "region": "United States",
        "edition": "D2487-17 reapproved 2025",
        "checked_on": "2026-09-14"
      },
      {
        "code": "ASTM D2488",
        "title": "Description and Identification of Soils (Visual-Manual Procedures)",
        "access": "paywalled_secondary",
        "region": "United States",
        "edition": "D2488-26 (per NBS index)",
        "checked_on": "2026-09-14"
      },
      {
        "code": "DIGGS",
        "title": "Data Interchange for Geotechnical and Geoenvironmental Specialists",
        "access": "public_summary",
        "region": "United States",
        "edition": "2.6 (production); 3.0 released 2026-03-30 (authority unverified)",
        "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": "Borehole records referenced for a site.",
  "x-demiton-contract-url": "https://docs.demiton.io/registers/site_bore_reference/",
  "x-demiton-register-catalog": "https://docs.demiton.io/concepts/register-catalog"
}