Utility location

Subsurface utilities on a site, with their AS 5488 quality level.

Part of Projects in the register catalog.

Register ID

utility_locationUse 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

PlannedDefined ahead of the connector that will fill it.

Data

OrganisationPrivate to each organisation's own workspace.

Version

v1Current version.

Download JSON Schema

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

16 fields: 5 required, 11 optional.

Required

Every record carries these fields.

source_systemText

Which bound system emitted the row.

projectText

The project the utility was located on.

utility_typeText

The service, e.g. water, gas, electrical or telecommunications.

quality_levelText

The quality level of the location information, QL-D to QL-A.

quality_level_schemeText

The scheme and edition the level is from, e.g. AS 5488.1:2022.

Optional

Present when the source system records them.

external_idText

The source's own feature id.

detection_methodText

How the position was obtained, e.g. records, electromagnetic locator, ground-penetrating radar or trial pit.

validatedTrue or false

Whether the position is validated.

geometryGroup of fields

The located point or line.

horizontal_datumText

The datum and projection of the geometry, e.g. MGA2020 zone 56.

vertical_datumText

The datum any depth or level is referenced to, e.g. AHD.

depth_mDecimal numberUnit: m

The depth of the utility below surface.

horizontal_accuracy_mDecimal numberUnit: m

The horizontal accuracy of the position.

vertical_accuracy_mDecimal numberUnit: m

The vertical accuracy of the position.

asset_ownerText

The utility owner or network operator.

report_referenceText

The survey report the location comes from.

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/utility_location/v1.json

Show the full JSON Schema

Loading the schema…