{ "schema_version": "proposed-poc-1.0", "data_mode": "synthetic_example", "disclaimer": "All asset names, locations, dimensions, thresholds, readings and forecasts are fictional examples of the format. They are not actual DBKL/JPS/MetMalaysia inventory records, sensor readings or forecasts. This is not an official agency API contract.", "site": { "site_id": "POC-DEMO-DM", "name": "Dataran Merdeka — example POC context", "status": "proposed_pilot_not_confirmed" }, "metadata": { "source_id": "SOURCE-DEMO", "source_name": "Synthetic dataset for the POC guide", "coordinate_reference": "WGS84", "coordinate_order": [ "longitude", "latitude" ], "timezone": "Asia/Kuala_Lumpur", "vertical_datum": { "id": "DEMO-LOCAL-DATUM", "name": "Fictional local datum; not an official reference level", "verified": false }, "null_policy": "null means unknown or unavailable; never replace missing readings with zero", "cross_references": "Related asset IDs may be in other examples; use the combined file for all IDs." }, "assets": { "type": "FeatureCollection", "features": [ { "type": "Feature", "id": "RIV-DEMO-001", "geometry": { "type": "LineString", "coordinates": [ [ 101.6955, 3.1518 ], [ 101.6956, 3.1508 ], [ 101.6957, 3.1498 ] ] }, "properties": { "asset_id": "RIV-DEMO-001", "asset_type": "river", "name": "Example river segment", "site_id": "POC-DEMO-DM", "data_mode": "synthetic_example", "data_owner": null, "verification_status": "unverified_example", "source_id": "SOURCE-DEMO", "updated_at": "2026-09-11T14:00:00+08:00", "flow_direction": "coordinate_order_upstream_to_downstream", "length_m": 223, "typical_width_m": 18.0, "roughness_manning_n": 0.035, "vertical_datum_id": "DEMO-LOCAL-DATUM", "cross_sections": [ { "section_id": "XS-DEMO-001", "chainage_m": 111, "profile": [ { "offset_m": 0, "elevation_m": 28.8 }, { "offset_m": 3, "elevation_m": 24.0 }, { "offset_m": 15, "elevation_m": 24.0 }, { "offset_m": 18, "elevation_m": 28.8 } ] } ], "water_level_sensor_ids": [ "WL-DEMO-001" ], "downstream_boundary": { "type": "external_outlet", "boundary_id": "BOUNDARY-DEMO-OUTLET", "water_level_series_id": null, "status": "requires_verified_boundary_data" } } }, { "type": "Feature", "id": "DRN-DEMO-001", "geometry": { "type": "LineString", "coordinates": [ [ 101.6928, 3.1502 ], [ 101.6936, 3.1502 ] ] }, "properties": { "asset_id": "DRN-DEMO-001", "asset_type": "drain", "name": "Example drain A", "site_id": "POC-DEMO-DM", "data_mode": "synthetic_example", "data_owner": null, "verification_status": "unverified_example", "source_id": "SOURCE-DEMO", "updated_at": "2026-09-11T14:00:00+08:00", "upstream_catchment_id": "CAT-DEMO-001", "downstream_asset_id": "CUL-DEMO-001", "flow_direction": "coordinate_order_upstream_to_downstream", "length_m": 89, "section_shape": "rectangular", "width_m": 1.2, "internal_depth_m": 1.0, "material": "concrete", "roughness_manning_n": 0.015, "vertical_datum_id": "DEMO-LOCAL-DATUM", "upstream_invert_elevation_m": 25.6, "downstream_invert_elevation_m": 25.2 } }, { "type": "Feature", "id": "WL-DEMO-001", "geometry": { "type": "Point", "coordinates": [ 101.6956, 3.1508 ] }, "properties": { "asset_id": "WL-DEMO-001", "asset_type": "water_level_sensor", "name": "Example water-level sensor", "site_id": "POC-DEMO-DM", "data_mode": "synthetic_example", "data_owner": null, "verification_status": "unverified_example", "source_id": "SOURCE-DEMO", "updated_at": "2026-09-11T14:00:00+08:00", "monitored_asset_id": "RIV-DEMO-001", "sensor_type": "radar", "measurement": "water_surface_elevation", "unit": "m", "vertical_datum_id": "DEMO-LOCAL-DATUM", "reporting_interval_seconds": 300, "last_calibrated_at": null, "calibration_status": "not_verified", "gauge_zero_elevation_m": 24.0, "thresholds": { "metric": "water_surface_elevation", "unit": "m", "vertical_datum_id": "DEMO-LOCAL-DATUM", "alert": 27.0, "warning": 28.0, "danger": 28.5, "approval_status": "illustrative_not_approved" } } }, { "type": "Feature", "id": "RG-DEMO-001", "geometry": { "type": "Point", "coordinates": [ 101.6932, 3.1512 ] }, "properties": { "asset_id": "RG-DEMO-001", "asset_type": "rain_gauge", "name": "Example rain gauge", "site_id": "POC-DEMO-DM", "data_mode": "synthetic_example", "data_owner": null, "verification_status": "unverified_example", "source_id": "SOURCE-DEMO", "updated_at": "2026-09-11T14:00:00+08:00", "sensor_type": "tipping_bucket", "resolution_mm": 0.2, "reporting_interval_seconds": 300, "last_calibrated_at": null, "calibration_status": "not_verified" } }, { "type": "Feature", "id": "WX-DEMO-001", "geometry": { "type": "Point", "coordinates": [ 101.6932, 3.1512 ] }, "properties": { "asset_id": "WX-DEMO-001", "asset_type": "weather_station", "name": "Example weather station", "site_id": "POC-DEMO-DM", "data_mode": "synthetic_example", "data_owner": null, "verification_status": "unverified_example", "source_id": "SOURCE-DEMO", "updated_at": "2026-09-11T14:00:00+08:00", "reporting_interval_seconds": 600 } }, { "type": "Feature", "id": "PMP-DEMO-001", "geometry": { "type": "Point", "coordinates": [ 101.6942, 3.1503 ] }, "properties": { "asset_id": "PMP-DEMO-001", "asset_type": "pump_house", "name": "Example pump house", "site_id": "POC-DEMO-DM", "data_mode": "synthetic_example", "data_owner": null, "verification_status": "unverified_example", "source_id": "SOURCE-DEMO", "updated_at": "2026-09-11T14:00:00+08:00", "intake_asset_id": "PND-DEMO-001", "discharge_asset_id": "RIV-DEMO-001", "discharge_location": { "type": "Point", "coordinates": [ 101.6956, 3.1508 ] }, "power_supply": "grid_with_backup_generator", "rated_total_capacity_m3_s": 0.7, "pumps": [ { "pump_id": "PUMP-DEMO-A", "rated_flow_m3_s": 0.35, "rated_head_m": 5.0 }, { "pump_id": "PUMP-DEMO-B", "rated_flow_m3_s": 0.35, "rated_head_m": 5.0 } ], "control_access": "read_only_for_poc" } }, { "type": "Feature", "id": "PND-DEMO-001", "geometry": { "type": "Polygon", "coordinates": [ [ [ 101.694, 3.15 ], [ 101.6944, 3.15 ], [ 101.6944, 3.1504 ], [ 101.694, 3.1504 ], [ 101.694, 3.15 ] ] ] }, "properties": { "asset_id": "PND-DEMO-001", "asset_type": "retention_pond", "name": "Example retention pond", "site_id": "POC-DEMO-DM", "data_mode": "synthetic_example", "data_owner": null, "verification_status": "unverified_example", "source_id": "SOURCE-DEMO", "updated_at": "2026-09-11T14:00:00+08:00", "surface_area_at_full_supply_m2": 2000, "storage_capacity_m3": 6000, "geometry_note": "Footprint schematic; example hydraulic area is not computed from this polygon.", "vertical_datum_id": "DEMO-LOCAL-DATUM", "bottom_elevation_m": 23.0, "full_supply_elevation_m": 26.0, "inlet_asset_ids": [ "CUL-DEMO-001" ], "outlet_asset_ids": [ "PMP-DEMO-001" ], "stage_storage_curve": [ { "water_surface_elevation_m": 23.0, "storage_m3": 0 }, { "water_surface_elevation_m": 24.2, "storage_m3": 2400 }, { "water_surface_elevation_m": 26.0, "storage_m3": 6000 } ], "spillway": { "crest_elevation_m": 26.0, "width_m": 2.0, "destination_asset_id": "RIV-DEMO-001", "status": "illustrative_unverified" } } }, { "type": "Feature", "id": "CUL-DEMO-001", "geometry": { "type": "LineString", "coordinates": [ [ 101.6936, 3.1502 ], [ 101.694, 3.1502 ] ] }, "properties": { "asset_id": "CUL-DEMO-001", "asset_type": "culvert", "name": "Example culvert", "site_id": "POC-DEMO-DM", "data_mode": "synthetic_example", "data_owner": null, "verification_status": "unverified_example", "source_id": "SOURCE-DEMO", "updated_at": "2026-09-11T14:00:00+08:00", "upstream_asset_id": "DRN-DEMO-001", "downstream_asset_id": "PND-DEMO-001", "flow_direction": "coordinate_order_upstream_to_downstream", "section_shape": "box", "barrel_count": 1, "internal_width_m": 1.2, "internal_height_m": 1.0, "length_m": 44, "roughness_manning_n": 0.015, "vertical_datum_id": "DEMO-LOCAL-DATUM", "inlet_invert_elevation_m": 25.2, "outlet_invert_elevation_m": 25.1, "flap_gate_present": false } }, { "type": "Feature", "id": "CAT-DEMO-001", "geometry": { "type": "Polygon", "coordinates": [ [ [ 101.6918, 3.1498 ], [ 101.6938, 3.1498 ], [ 101.6938, 3.1518 ], [ 101.6918, 3.1518 ], [ 101.6918, 3.1498 ] ] ] }, "properties": { "asset_id": "CAT-DEMO-001", "asset_type": "catchment", "name": "Example catchment", "site_id": "POC-DEMO-DM", "data_mode": "synthetic_example", "data_owner": null, "verification_status": "unverified_example", "source_id": "SOURCE-DEMO", "updated_at": "2026-09-11T14:00:00+08:00", "area_m2": 49200, "area_basis": "rounded_schematic_polygon_area", "impervious_area_percent": 78, "mean_slope_percent": 1.2, "rainfall_gauge_id": "RG-DEMO-001", "outlet_asset_id": "DRN-DEMO-001", "runoff_model_parameters": { "method": "illustrative_runoff_coefficient", "runoff_coefficient": 0.75, "travel_time_minutes": 10, "calibration_status": "not_calibrated" } } }, { "type": "Feature", "id": "RD-DEMO-001", "geometry": { "type": "LineString", "coordinates": [ [ 101.6928, 3.15 ], [ 101.6936, 3.15 ] ] }, "properties": { "asset_id": "RD-DEMO-001", "asset_type": "road_segment", "name": "Example road segment", "site_id": "POC-DEMO-DM", "data_mode": "synthetic_example", "data_owner": null, "verification_status": "unverified_example", "source_id": "SOURCE-DEMO", "updated_at": "2026-09-11T14:00:00+08:00", "length_m": 89, "lane_count": 2, "critical_access": false, "drainage_asset_ids": [ "DRN-DEMO-001" ], "vertical_datum_id": "DEMO-LOCAL-DATUM", "low_point_elevation_m": 26.2, "survey_status": "not_surveyed" } } ] }, "observations": [ { "observation_id": "OBS-DEMO-DRN-001", "asset_id": "DRN-DEMO-001", "source_record_id": "OBS-DEMO-DRN-001", "source_id": "SOURCE-DEMO", "observed_at": "2026-09-11T14:00:00+08:00", "received_at": "2026-09-11T14:00:05+08:00", "data_mode": "synthetic_example", "quality_flag": "example_unverified", "measurements": { "blockage_estimate": { "value": 20, "unit": "percent", "method": "visual_estimate" }, "sediment_depth": { "value": 0.1, "unit": "m" } }, "observation_type": "field_inspection", "condition": "requires_cleaning" }, { "observation_id": "OBS-DEMO-WL-001", "asset_id": "WL-DEMO-001", "source_record_id": "OBS-DEMO-WL-001", "source_id": "SOURCE-DEMO", "observed_at": "2026-09-11T14:00:00+08:00", "received_at": "2026-09-11T14:00:05+08:00", "data_mode": "synthetic_example", "quality_flag": "example_unverified", "measurements": { "water_surface_elevation": { "value": 26.4, "unit": "m", "vertical_datum_id": "DEMO-LOCAL-DATUM" }, "gauge_height": { "value": 2.4, "unit": "m", "gauge_zero_elevation_m": 24.0, "vertical_datum_id": "DEMO-LOCAL-DATUM" }, "battery_voltage": { "value": 12.4, "unit": "V" } }, "observation_type": "sensor_reading", "monitored_asset_id": "RIV-DEMO-001" }, { "observation_id": "OBS-DEMO-RG-001", "asset_id": "RG-DEMO-001", "source_record_id": "OBS-DEMO-RG-001", "source_id": "SOURCE-DEMO", "observed_at": "2026-09-11T14:00:00+08:00", "received_at": "2026-09-11T14:00:05+08:00", "data_mode": "synthetic_example", "quality_flag": "example_unverified", "measurements": { "rainfall_interval": { "value": 4.0, "unit": "mm", "period_start": "2026-09-11T13:55:00+08:00", "period_end": "2026-09-11T14:00:00+08:00" }, "rainfall_intensity": { "value": 48.0, "unit": "mm/h", "averaging_period_seconds": 300, "method": "interval_mm_times_3600_divided_by_seconds" }, "rainfall_last_hour": { "value": 23.4, "unit": "mm", "period_start": "2026-09-11T13:00:00+08:00", "period_end": "2026-09-11T14:00:00+08:00" }, "rainfall_since_midnight": { "value": 31.2, "unit": "mm", "period_start": "2026-09-11T00:00:00+08:00", "period_end": "2026-09-11T14:00:00+08:00" } }, "observation_type": "sensor_reading", "interval_boundary": "start_exclusive_end_inclusive" }, { "observation_id": "OBS-DEMO-WX-001", "asset_id": "WX-DEMO-001", "source_record_id": "OBS-DEMO-WX-001", "source_id": "SOURCE-DEMO", "observed_at": "2026-09-11T14:00:00+08:00", "received_at": "2026-09-11T14:00:05+08:00", "data_mode": "synthetic_example", "quality_flag": "example_unverified", "measurements": { "air_temperature": { "value": 27.5, "unit": "degC" }, "relative_humidity": { "value": 88, "unit": "percent" }, "wind_speed": { "value": 2.8, "unit": "m/s" }, "wind_direction_from": { "value": 240, "unit": "degree_true_north" }, "air_pressure": { "value": 1008.2, "unit": "hPa" } }, "observation_type": "weather_observation", "condition_code": "rain" }, { "observation_id": "OBS-DEMO-PMP-001", "asset_id": "PMP-DEMO-001", "source_record_id": "OBS-DEMO-PMP-001", "source_id": "SOURCE-DEMO", "observed_at": "2026-09-11T14:00:00+08:00", "received_at": "2026-09-11T14:00:05+08:00", "data_mode": "synthetic_example", "quality_flag": "example_unverified", "measurements": { "intake_water_surface_elevation": { "value": 24.2, "unit": "m", "vertical_datum_id": "DEMO-LOCAL-DATUM" }, "receiving_water_surface_elevation": { "value": 26.4, "unit": "m", "vertical_datum_id": "DEMO-LOCAL-DATUM" }, "total_discharge_flow": { "value": 0.3, "unit": "m3/s" }, "total_dynamic_head": { "value": 4.5, "unit": "m" } }, "observation_type": "pump_telemetry", "operating_mode": "automatic", "power_status": "available", "alarm_codes": [], "pump_statuses": [ { "pump_id": "PUMP-DEMO-A", "status": "running", "discharge_flow_m3_s": 0.3 }, { "pump_id": "PUMP-DEMO-B", "status": "standby", "discharge_flow_m3_s": 0.0 } ] }, { "observation_id": "OBS-DEMO-PND-001", "asset_id": "PND-DEMO-001", "source_record_id": "OBS-DEMO-PND-001", "source_id": "SOURCE-DEMO", "observed_at": "2026-09-11T14:00:00+08:00", "received_at": "2026-09-11T14:00:05+08:00", "data_mode": "synthetic_example", "quality_flag": "example_unverified", "measurements": { "water_surface_elevation": { "value": 24.2, "unit": "m", "vertical_datum_id": "DEMO-LOCAL-DATUM" }, "stored_volume": { "value": 2400, "unit": "m3", "method": "example_stage_storage_curve" }, "available_storage": { "value": 3600, "unit": "m3", "method": "capacity_minus_stored_volume" } }, "observation_type": "derived_asset_state" } ], "forecasts": [ { "forecast_id": "FC-DEMO-001", "site_id": "POC-DEMO-DM", "coverage_asset_id": "CAT-DEMO-001", "source_id": "SOURCE-DEMO", "data_mode": "synthetic_example", "issued_at": "2026-09-11T13:00:00+08:00", "valid_from": "2026-09-11T14:00:00+08:00", "valid_to": "2026-09-11T17:00:00+08:00", "condition_code": "rain", "rain_probability_percent": 70, "official_warning": null, "quality_flag": "example_unverified" } ], "incidents": [ { "incident_id": "INC-DEMO-001", "site_id": "POC-DEMO-DM", "source_id": "SOURCE-DEMO", "source_record_id": "INC-DEMO-001", "data_mode": "synthetic_example", "incident_type": "surface_flooding", "geometry": { "type": "Point", "coordinates": [ 101.693, 3.15 ] }, "reported_at": "2026-09-01T15:35:00+08:00", "started_at": "2026-09-01T15:20:00+08:00", "receded_at": "2026-09-01T16:10:00+08:00", "max_depth": { "value": 0.18, "unit": "m", "reference": "local_road_surface" }, "affected_area": { "value": 300, "unit": "m2", "method": "field_estimate" }, "affected_asset_ids": [ "RD-DEMO-001", "DRN-DEMO-001" ], "verification_status": "example_unverified", "status": "closed_example", "rainfall_observation_ids": [], "water_level_observation_ids": [], "matching_event_data_status": "required_for_historical_replay", "actions": [ { "action_id": "ACTION-DEMO-001", "action_type": "drain_inspection", "recorded_at": "2026-09-01T15:50:00+08:00", "status": "completed_example", "note": "Example drainage inspection note." } ], "evidence_files": [] } ] }