Site geology

Ground conditions and geology recorded for a site.

Part of Projects in the register catalog.

Register ID

site_geologyUse this name to ask for the register. The API calls it a shelf ID.

Each record is

A stateThe current value of something, replaced when it changes.

Status

DeclaredDefined, and fills when a source produces its first record.

Data

OrganisationPrivate to each organisation's own workspace.

Version

v1Current version.

Download JSON SchemaSee an example record

Connectors

Connected today

Demiton keeps this register current from these systems now.

No system fills this register yet.

On the roadmap

Systems in the planned connector rollout that can fill this register. Partial means the system holds only some of its fields.

None planned yet.

Fields

15 fields: 4 required, 11 optional.

Required

Every record carries these fields.

projectText

The project whose site coordinate was resolved.

Example: BWG-2025-001

formation_nameText

The named surface geology unit under the site.

Example: Bandanna Formation

map_sourceText

Which map service actually answered (1:100k state service vs 1:1M national fallback)

Example: Geoscience Queensland 1:100,000 series

contentText

The prose answer a content search can match.

Example: Site is underlain by the Bandanna Formation - interbedded…

Optional

Present when the source system records them.

lithologyText

Prose lithology description of the unit.

Example: Interbedded sandstone, siltstone, mudstone and coal

ageText

The unit's geological age / period.

Example: Permian

map_symbolText

The map sheet's unit symbol/code for the unit.

Example: Pb

map_scaleWhole numberUnit: ratio (store the denominator N of 1:N)

Nominal scale of the product the answer came from; null where the product is a compilation with no single scale.

Example: 100000

resolved_atDate and timeISO 8601, with time zone

When the coordinate was resolved.

Example: 2026-02-10T01:00:00Z

resolver_versionText

Which resolver contract produced the answer.

Example: geology-resolver-v3

classification_schemeText

Which classification vocabulary the description/symbol follows (e.g. AS 1726:2017, BS 5930:2015+A1:2020, ASTM D2487-17(2025))

Example: AS 1726:2017

source_formatText

The exchange format/version the answer came from (AGS 4.2, DIGGS 2.6, DIGGS 3.0, vendor/map service)

Example: vendor/map service

horizontal_datumText

The datum the source coordinate is in (GDA2020 today)

Example: GDA2020

projection_zoneText

The grid projection and zone, where the source states one.

Example: MGA2020 Zone 55

vertical_datumText

The vertical reference the source depths/heights are relative to (AHD in Australia)

Example: AHD

Example record

A sample from Bridgeworks Group, Demiton's demonstration company. The values are illustrative; the shape is exactly what the contract describes.

site_geology.example.json

{
  "age": "Permian",
  "classification_scheme": "AS 1726:2017",
  "content": "Site is underlain by the Bandanna Formation - interbedded sandstone, siltstone and coal measures of Permian age.",
  "formation_name": "Bandanna Formation",
  "horizontal_datum": "GDA2020",
  "lithology": "Interbedded sandstone, siltstone, mudstone and coal",
  "map_scale": 100000,
  "map_source": "Geoscience Queensland 1:100,000 series",
  "map_symbol": "Pb",
  "project": "BWG-2025-001",
  "projection_zone": "MGA2020 Zone 55",
  "resolved_at": "2026-02-10T01:00:00Z",
  "resolver_version": "geology-resolver-v3",
  "source_format": "vendor/map service",
  "vertical_datum": "AHD"
}

Use this contract

The contract is a standard JSON Schema (draft 2020-12) document, so any JSON Schema validator can check a record against it. Keywords starting with x-demiton- add Demiton's own meaning, such as units and requiredness, and validators ignore them.

Schema URL

https://docs.demiton.io/registers/site_geology/v1.json

Show the full JSON Schema

Loading the schema…