{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://docs.demiton.io/registers/asset_meter_reading/v1.json",
  "title": "asset_meter_reading contract v1",
  "type": "object",
  "required": [
    "asset",
    "read_at"
  ],
  "properties": {
    "asset": {
      "type": "string",
      "description": "the machine the reading belongs to",
      "x-demiton-requiredness": "required",
      "x-demiton-reference": true
    },
    "device": {
      "type": "string",
      "description": "the telematics unit that produced the reading",
      "x-demiton-requiredness": "optional",
      "x-demiton-reference": true
    },
    "driver": {
      "type": "string",
      "description": "the driver logged in at the reading",
      "x-demiton-requiredness": "optional",
      "x-demiton-reference": true
    },
    "read_at": {
      "type": "string",
      "description": "when the reading was taken",
      "x-demiton-requiredness": "required",
      "format": "date-time",
      "x-demiton-type": "datetime"
    },
    "odometer": {
      "type": "number",
      "description": "the odometer reading",
      "x-demiton-requiredness": "optional",
      "x-demiton-unit": "km",
      "x-demiton-type": "decimal"
    },
    "external_id": {
      "type": "string",
      "description": "the source system's id for the reading, where it has one",
      "x-demiton-requiredness": "optional"
    },
    "engine_hours": {
      "type": "number",
      "description": "the engine-hours meter reading",
      "x-demiton-requiredness": "optional",
      "x-demiton-unit": "hours",
      "x-demiton-type": "decimal"
    },
    "location_label": {
      "type": "string",
      "description": "where the machine was, as text",
      "x-demiton-requiredness": "optional"
    },
    "reading_source": {
      "type": "string",
      "description": "whether the reading is GPS-derived or from the CAN bus",
      "x-demiton-requiredness": "optional"
    },
    "ignition_status": {
      "type": "string",
      "description": "whether the ignition was on at the reading",
      "x-demiton-requiredness": "optional"
    },
    "odometer_at_install": {
      "type": "number",
      "description": "the odometer when the device was fitted",
      "x-demiton-requiredness": "optional",
      "x-demiton-unit": "km",
      "x-demiton-type": "decimal"
    }
  },
  "x-demiton-register-type": "asset_meter_reading",
  "x-demiton-contract-version": "1.0.3",
  "x-demiton-store": "tenant",
  "x-demiton-axes": [
    {
      "axis": "asset",
      "requirement": "required",
      "role": "subject"
    }
  ],
  "x-demiton-measures": [],
  "x-demiton-provenance": {
    "standards": [
      {
        "code": "Privacy Act 1988 (Cth)",
        "title": "Privacy Act 1988 - Australian Privacy Principles",
        "access": "full_text_verified",
        "clause": "APP 3",
        "region": "Australia",
        "edition": "APP Guidelines ch 3 v1.2 (2026-05-13)",
        "checked_on": "2026-09-14"
      },
      {
        "code": "Workplace Surveillance Act 2005 (NSW)",
        "title": "Workplace Surveillance Act 2005 (tracking surveillance of employees)",
        "access": "public_summary",
        "clause": "s 10",
        "region": "Australia",
        "edition": "in force (compilation 2025-06-14)",
        "checked_on": "2026-09-14"
      },
      {
        "code": "ISO/TS 15143-3",
        "title": "Earth-moving machinery and mobile road construction machinery - Worksite data exchange - Telematics data (AEMP 2.0)",
        "access": "paywalled_secondary",
        "region": "International",
        "edition": "2020 (SA TS ISO 15143.3:2021 AU and PD ISO/TS 15143-3:2020 UK identical adoptions)",
        "checked_on": "2026-09-14"
      },
      {
        "code": "49 CFR Part 395 Subpart B",
        "title": "FMCSA - Hours of Service of Drivers - Electronic Logging Devices",
        "access": "full_text_verified",
        "clause": "s 395.26(b)",
        "region": "United States",
        "edition": "current (ELD mandate from 2017-12-18)",
        "checked_on": "2026-09-14"
      }
    ]
  },
  "description": "Odometer and engine-hour readings, as recorded.",
  "x-demiton-contract-url": "https://docs.demiton.io/registers/asset_meter_reading/",
  "x-demiton-register-catalog": "https://docs.demiton.io/concepts/register-catalog"
}