Platform weather (v1)

You are viewing version 1

This contract has been superseded. See the current version (v2).

Platform weather is one of Demiton's published registers for Australian civil construction. Current Bureau of Meteorology observations by region. Demiton keeps it current from the systems a contractor already runs and publishes the record's shape as a versioned JSON Schema, so the same question works whichever system produced the record.

Part of Platform in the register catalog.

Register ID

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

Each record is

An eventSomething that happened at a point in time.

Status

AvailableFilled today from connected systems, uploads or public data.

Data

PublicShared, from public sources such as procurement portals.

Version

v1 (1.0.1)Superseded by v2.

Download JSON Schema

Standards

This register's contract was designed against these standards and laws. Holding these records does not by itself certify compliance.

• GDA2020Geocentric Datum of Australia 2020Australia · GDA2020 (Determination 2017) · public summary

Connectors

Connected today

Demiton keeps this register current from these systems now.

• Bureau of Meteorology

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: 7 required, 9 optional.

Required

Every record carries these fields.

geohashText

BOM 6-character region identity; the shelf's geographic key and the geographic_area create-anchor.

source_idText

Source-native record identity and idempotency key (bom:{geohash}:{observed_date}).

observed_atDate and timeISO 8601, with time zone

When the reading was taken; the event time and freshness ordering.

region_codeTextUnit: AU state/territory code (e.g. QLD, NSW)

The required REGION_CODE axis; resolves the fact's region and its partition bucket.

temperature_cNumberUnit: °C

Air temperature — the reading that makes a weather observation useful.

source_datasetText

Producer identity, labels the fact origin.

jurisdiction_codeTextUnit: ISO 3166-2 AU state code

Jurisdiction the observation is published for; drives the partition bucket.

Optional

Present when the source system records them.

conditionsText

Free-text sky/condition summary.

region_nameText

Human-readable region label to accompany region_code.

feels_like_cNumberUnit: °C

Apparent temperature.

humidity_pctNumberUnit: %

Relative humidity.

station_nameText

BOM station label for the observation.

wind_directionTextUnit: compass point

Wind direction as BOM publishes it.

wind_speed_kmhNumberUnit: km/h

Wind speed at the station.

rain_probabilityNumberUnit: %

Probability of precipitation.

rain_since_9am_mmNumberUnit: mm

Rainfall since 9am local — BOM's own rainfall convention.

Version history

• v2 (current)
• v1

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

Show the full JSON Schema

Loading the schema…