{ "openapi": "3.0.3", "info": { "title": "pdigger-outdoors · Observation API", "version": "2.0.0", "description": "A working read-only API: validated query parameters, interval filtering and signed keyset cursors. **Recorded demo data, not a live camera feed.** Page through observations, loads and samples using `links.next`. Cursors remain valid for this dataset revision; a changed dataset returns 409. Keep endpoint, filters and limit unchanged. Missing measurements and unverified classifications are `null`. Recorder session dates do not establish frame UTC. Geometry uses relative units; fill percentages are visual estimates, never measured mass or volume. Public access has no API key and no write operations. Download complete fixed JSON snapshots separately at `/demo/api/v1/`." }, "servers": [ { "url": "/api/v1", "description": "Working demo query service" } ], "tags": [ { "name": "Overview" }, { "name": "Observations" }, { "name": "Loads" }, { "name": "Tracks" }, { "name": "Scene & calendar" } ], "paths": { "/events": { "get": { "operationId": "get_events", "tags": [ "Observations" ], "summary": "Query events with cursor pagination", "description": "Executed by the read-only API service against the versioned, fully merged demo dataset. Lists are ordered by source start time then ID (observations), sample time then ID (track samples), or ID (other collections). Time ranges are inclusive. No live inference or all-day identity claim.", "parameters": [ { "in": "query", "name": "cameraId", "required": false, "description": "Exact, case-sensitive match.", "schema": { "type": "string", "maxLength": 160 } }, { "in": "query", "name": "recordingId", "required": false, "description": "Exact, case-sensitive match.", "schema": { "type": "string", "maxLength": 160 } }, { "in": "query", "name": "typeId", "required": false, "description": "Exact, case-sensitive match.", "schema": { "type": "string", "enum": [ "skid_steer", "utv", "human", "semi_trailer", "pickup", "wheel_loader" ] } }, { "in": "query", "name": "categoryId", "required": false, "description": "Exact, case-sensitive match.", "schema": { "type": "string", "enum": [ "mobile_machinery", "person", "road_vehicle", "light_vehicles" ] } }, { "in": "query", "name": "actionId", "required": false, "description": "Exact, case-sensitive match.", "schema": { "type": "string", "maxLength": 160 } }, { "in": "query", "name": "recordKind", "required": false, "description": "Use reviewed_event for reviewed activity counts; other records are contextual or isolated observations.", "schema": { "type": "string", "enum": [ "reviewed_event", "context", "isolated_observation" ] } }, { "in": "query", "name": "loadState", "required": false, "description": "Exact, case-sensitive match.", "schema": { "type": "string", "enum": [ "loaded", "empty", "not_established" ] } }, { "in": "query", "name": "cameraDirection", "required": false, "description": "Exact, case-sensitive match.", "schema": { "type": "string", "maxLength": 160 } }, { "in": "query", "name": "fromSec", "required": false, "description": "Inclusive source elapsed seconds. Event queries match intervals overlapping this bound; sample queries match sample times.", "schema": { "type": "number", "minimum": 0 } }, { "in": "query", "name": "toSec", "required": false, "description": "Inclusive source elapsed seconds. Must be at least fromSec.", "schema": { "type": "number", "minimum": 0 } }, { "in": "query", "name": "limit", "required": false, "description": "Page size. Follow links.next or pass page.nextCursor as cursor; retain all filters and the same limit.", "schema": { "type": "integer", "minimum": 1, "maximum": 100, "default": 20 } }, { "in": "query", "name": "cursor", "required": false, "description": "Opaque signed cursor returned by the previous page. It is bound to the dataset revision, endpoint, filters, ordering and limit. Not an authentication credential.", "schema": { "type": "string", "maxLength": 2048 } } ], "responses": { "200": { "description": "Query result from recorded demo observations.", "headers": { "ETag": { "schema": { "type": "string" }, "description": "Strong response validator. Send If-None-Match to receive 304 when unchanged." }, "Link": { "schema": { "type": "string" }, "description": "Next page URL with rel=\"next\", when available." }, "X-Request-Id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/eventsPage" }, "example": { "schemaVersion": "2.0.0", "datasetId": "pdigger-outdoors-v15", "demo": true, "sourceVersion": 15, "sourceCommit": "5f322b5ad3ecfce4aff5b5609456716099b28f62", "clock": "source_elapsed_seconds", "frameUtcVerified": false, "partialCoverage": true, "datasetRevision": "5318d837e37e1219e3ec72baf438cf1423a40fe7ea120f8567a8484c8527402f", "mode": "recorded_demo", "data": [ { "id": "V01", "recordingId": "recovered_native_elapsed", "cameraId": "camera-01", "typeId": "semi_trailer", "typeLabel": "Semi + trailer(s)", "categoryId": "road_vehicle", "label": "V01 · Semi + trailer(s)", "recordKind": "reviewed_event", "countsAsAcceptedPassage": true, "uniqueAllDayIdentityVerified": false, "startSec": 25024.002, "endSec": 25042.541, "startUtc": null, "endUtc": null, "supportedPresence": [ { "start": 25040.743, "end": 25041.842 } ], "actions": [ { "id": "gate_crossing", "label": "Gate crossing", "evidence": "reviewed_v4_accepted_passage", "scope": "accepted_directional_image_gate_passage", "startSec": 25040.743000000002, "endSec": 25041.842 } ], "actionIds": [ "gate_crossing" ], "movement": { "cameraDirection": "toward_bottom", "facilityDirection": null, "motionState": "passing", "imageLane": "left_silo_side" }, "loadId": "load-V01", "localAssociation": null, "evidenceKind": "gate_pair_only", "limitations": [ "cab becomes partly hidden by fixed lower-left structure; final detector box is reduced to visible chassis; exact detector crossing bracket is not a full-rig centre estimate" ], "detailUrl": "/api/v1/events/V01", "tracksUrl": "/api/v1/tracks/V01" }, { "id": "V02", "recordingId": "recovered_native_elapsed", "cameraId": "camera-01", "typeId": "semi_trailer", "typeLabel": "Semi + trailer(s)", "categoryId": "road_vehicle", "label": "V02 · Semi + trailer(s)", "recordKind": "reviewed_event", "countsAsAcceptedPassage": true, "uniqueAllDayIdentityVerified": false, "startSec": 30780.108, "endSec": 30792.356, "startUtc": null, "endUtc": null, "supportedPresence": [ { "start": 30780.973, "end": 30781.173 }, { "start": 30781.872, "end": 30782.105 }, { "start": 30782.803, "end": 30783.203 }, { "start": 30784.102, "end": 30784.335 }, { "start": 30785.266, "end": 30785.266 }, { "start": 30786.332, "end": 30786.565 }, { "start": 30788.195, "end": 30788.195 }, { "start": 30789.46, "end": 30790.159 } ], "actions": [ { "id": "gate_crossing", "label": "Gate crossing", "evidence": "reviewed_v4_accepted_passage", "scope": "accepted_directional_image_gate_passage", "startSec": 30790.592, "endSec": 30791.025 } ], "actionIds": [ "gate_crossing" ], "movement": { "cameraDirection": "toward_bottom", "facilityDirection": null, "motionState": "passing", "imageLane": "right_parked_trailer_side" }, "loadId": "load-V02", "localAssociation": null, "evidenceKind": "sampled_path", "limitations": [ "Frame-edge truncation after crossing; detector box represents cab rather than entire rig.", "No connection between raw-track IDs or absent source frames." ], "detailUrl": "/api/v1/events/V02", "tracksUrl": "/api/v1/tracks/V02" } ], "page": { "limit": 2, "returned": 2, "total": 17, "hasMore": true, "nextCursor": "eyJ2IjoxLCJkIjoiNTMxOGQ4MzdlMzdlMTIxOWUzZWM3MmJhZjQzOGNmMTQyM2E0MGZlN2VhMTIwZjg1NjdhODQ4NGM4NTI3NDAyZiIsInEiOiJmMzExZDM0NTA3M2U5ZTVlYWU3MzZiNmQ2Mzk4NWY2MGFhNzU2MGFlNzRjZmY5ZmUzNGMyNjEwNWIxYmQ4Nzk1IiwiayI6WzMwNzgwLjEwOCwiVjAyIl19.ng99xBnLshl9kF230zDdQD7MKb2NNxm3CFla9EqgtTA" }, "links": { "self": "/api/v1/events?categoryId=road_vehicle&recordKind=reviewed_event&limit=2", "next": "/api/v1/events?categoryId=road_vehicle&recordKind=reviewed_event&limit=2&cursor=eyJ2IjoxLCJkIjoiNTMxOGQ4MzdlMzdlMTIxOWUzZWM3MmJhZjQzOGNmMTQyM2E0MGZlN2VhMTIwZjg1NjdhODQ4NGM4NTI3NDAyZiIsInEiOiJmMzExZDM0NTA3M2U5ZTVlYWU3MzZiNmQ2Mzk4NWY2MGFhNzU2MGFlNzRjZmY5ZmUzNGMyNjEwNWIxYmQ4Nzk1IiwiayI6WzMwNzgwLjEwOCwiVjAyIl19.ng99xBnLshl9kF230zDdQD7MKb2NNxm3CFla9EqgtTA" } } } } }, "304": { "description": "Response unchanged (If-None-Match). No body." }, "400": { "description": "Invalid parameter, range or cursor.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "example": { "error": { "code": "invalid_parameter", "message": "Invalid parameter, range or cursor.", "field": null, "requestId": "request-id" } } } } }, "404": { "description": "Resource or route does not exist.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "example": { "error": { "code": "not_found", "message": "Resource or route does not exist.", "field": null, "requestId": "request-id" } } } } }, "405": { "description": "This API supports GET, HEAD and OPTIONS.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "example": { "error": { "code": "method_not_allowed", "message": "This API supports GET, HEAD and OPTIONS.", "field": null, "requestId": "request-id" } } } } }, "409": { "description": "Dataset changed; restart without the cursor.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "example": { "error": { "code": "stale_cursor", "message": "Dataset changed; restart without the cursor.", "field": null, "requestId": "request-id" } } } } }, "500": { "description": "Request could not be completed.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "example": { "error": { "code": "internal_error", "message": "Request could not be completed.", "field": null, "requestId": "request-id" } } } } } }, "x-codeSamples": [ { "lang": "Shell", "label": "curl", "source": "curl -sS 'https://outdoors.pdigger.com/api/v1/events?categoryId=road_vehicle&recordKind=reviewed_event&limit=2'" } ] } }, "/events/{id}": { "get": { "operationId": "get_events_id_", "tags": [ "Observations" ], "summary": "Get one event", "description": "Executed by the read-only API service against the versioned, fully merged demo dataset. Lists are ordered by source start time then ID (observations), sample time then ID (track samples), or ID (other collections). Time ranges are inclusive. No live inference or all-day identity claim.", "parameters": [ { "in": "path", "name": "id", "required": true, "schema": { "type": "string" }, "example": "V05" } ], "responses": { "200": { "description": "Query result from recorded demo observations.", "headers": { "ETag": { "schema": { "type": "string" }, "description": "Strong response validator. Send If-None-Match to receive 304 when unchanged." }, "Link": { "schema": { "type": "string" }, "description": "Next page URL with rel=\"next\", when available." }, "X-Request-Id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "type": "object", "required": [ "schemaVersion", "datasetId", "datasetRevision", "demo", "mode", "data" ], "properties": { "schemaVersion": { "type": "string", "enum": [ "2.0.0" ] }, "datasetId": { "type": "string" }, "datasetRevision": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "demo": { "type": "boolean", "enum": [ true ] }, "mode": { "type": "string", "enum": [ "recorded_demo" ] }, "sourceVersion": { "type": "integer" }, "sourceCommit": { "type": "string" }, "clock": { "type": "string", "enum": [ "source_elapsed_seconds" ] }, "frameUtcVerified": { "type": "boolean", "enum": [ false ] }, "partialCoverage": { "type": "boolean", "enum": [ true ] }, "data": { "$ref": "#/components/schemas/Event" } } }, "example": { "schemaVersion": "2.0.0", "datasetId": "pdigger-outdoors-v15", "demo": true, "sourceVersion": 15, "sourceCommit": "5f322b5ad3ecfce4aff5b5609456716099b28f62", "clock": "source_elapsed_seconds", "frameUtcVerified": false, "partialCoverage": true, "datasetRevision": "5318d837e37e1219e3ec72baf438cf1423a40fe7ea120f8567a8484c8527402f", "mode": "recorded_demo", "data": { "id": "V05", "recordingId": "recovered_native_elapsed", "cameraId": "camera-01", "typeId": "semi_trailer", "typeLabel": "Semi + trailer(s)", "categoryId": "road_vehicle", "label": "V05 · Semi + trailer(s)", "recordKind": "reviewed_event", "countsAsAcceptedPassage": true, "uniqueAllDayIdentityVerified": false, "startSec": 33605.62, "endSec": 33606.319, "startUtc": null, "endUtc": null, "supportedPresence": [], "actions": [ { "id": "gate_crossing", "label": "Gate crossing", "evidence": "reviewed_v4_accepted_passage", "scope": "accepted_directional_image_gate_passage", "startSec": 33605.619999999995, "endSec": 33606.318999999996 } ], "actionIds": [ "gate_crossing" ], "movement": { "cameraDirection": "toward_bottom", "facilityDirection": null, "motionState": "passing", "imageLane": "left_silo_side" }, "loadId": "load-V05", "localAssociation": null, "evidenceKind": "manual_landmarks_only", "limitations": [ "No claim about crossing in chunk559 or across not established chunk gap.; No full-vehicle bounding box centre timing is asserted. Timestamp refers only to the manually identified rear trailer wheel landmark.; Cab and coupling become occluded; no unseen cab motion is reconstructed.; Review ends at10s bound, last native frame9.785; no later source footage inspected." ], "detailUrl": "/api/v1/events/V05", "tracksUrl": "/api/v1/tracks/V05" } } } } }, "304": { "description": "Response unchanged (If-None-Match). No body." }, "400": { "description": "Invalid parameter, range or cursor.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "example": { "error": { "code": "invalid_parameter", "message": "Invalid parameter, range or cursor.", "field": null, "requestId": "request-id" } } } } }, "404": { "description": "Resource or route does not exist.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "example": { "error": { "code": "not_found", "message": "Resource or route does not exist.", "field": null, "requestId": "request-id" } } } } }, "405": { "description": "This API supports GET, HEAD and OPTIONS.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "example": { "error": { "code": "method_not_allowed", "message": "This API supports GET, HEAD and OPTIONS.", "field": null, "requestId": "request-id" } } } } }, "409": { "description": "Dataset changed; restart without the cursor.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "example": { "error": { "code": "stale_cursor", "message": "Dataset changed; restart without the cursor.", "field": null, "requestId": "request-id" } } } } }, "500": { "description": "Request could not be completed.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "example": { "error": { "code": "internal_error", "message": "Request could not be completed.", "field": null, "requestId": "request-id" } } } } } }, "x-codeSamples": [ { "lang": "Shell", "label": "curl", "source": "curl -sS 'https://outdoors.pdigger.com/api/v1/events/V05'" } ] } }, "/vehicles": { "get": { "operationId": "get_vehicles", "tags": [ "Observations" ], "summary": "Query vehicles with cursor pagination", "description": "Executed by the read-only API service against the versioned, fully merged demo dataset. Lists are ordered by source start time then ID (observations), sample time then ID (track samples), or ID (other collections). Time ranges are inclusive. No live inference or all-day identity claim.", "parameters": [ { "in": "query", "name": "cameraId", "required": false, "description": "Exact, case-sensitive match.", "schema": { "type": "string", "maxLength": 160 } }, { "in": "query", "name": "recordingId", "required": false, "description": "Exact, case-sensitive match.", "schema": { "type": "string", "maxLength": 160 } }, { "in": "query", "name": "typeId", "required": false, "description": "Exact, case-sensitive match.", "schema": { "type": "string", "enum": [ "skid_steer", "utv", "human", "semi_trailer", "pickup", "wheel_loader" ] } }, { "in": "query", "name": "categoryId", "required": false, "description": "Exact, case-sensitive match.", "schema": { "type": "string", "enum": [ "mobile_machinery", "person", "road_vehicle", "light_vehicles" ] } }, { "in": "query", "name": "actionId", "required": false, "description": "Exact, case-sensitive match.", "schema": { "type": "string", "maxLength": 160 } }, { "in": "query", "name": "recordKind", "required": false, "description": "Use reviewed_event for reviewed activity counts; other records are contextual or isolated observations.", "schema": { "type": "string", "enum": [ "reviewed_event", "context", "isolated_observation" ] } }, { "in": "query", "name": "loadState", "required": false, "description": "Exact, case-sensitive match.", "schema": { "type": "string", "enum": [ "loaded", "empty", "not_established" ] } }, { "in": "query", "name": "cameraDirection", "required": false, "description": "Exact, case-sensitive match.", "schema": { "type": "string", "maxLength": 160 } }, { "in": "query", "name": "fromSec", "required": false, "description": "Inclusive source elapsed seconds. Event queries match intervals overlapping this bound; sample queries match sample times.", "schema": { "type": "number", "minimum": 0 } }, { "in": "query", "name": "toSec", "required": false, "description": "Inclusive source elapsed seconds. Must be at least fromSec.", "schema": { "type": "number", "minimum": 0 } }, { "in": "query", "name": "limit", "required": false, "description": "Page size. Follow links.next or pass page.nextCursor as cursor; retain all filters and the same limit.", "schema": { "type": "integer", "minimum": 1, "maximum": 100, "default": 20 } }, { "in": "query", "name": "cursor", "required": false, "description": "Opaque signed cursor returned by the previous page. It is bound to the dataset revision, endpoint, filters, ordering and limit. Not an authentication credential.", "schema": { "type": "string", "maxLength": 2048 } } ], "responses": { "200": { "description": "Query result from recorded demo observations.", "headers": { "ETag": { "schema": { "type": "string" }, "description": "Strong response validator. Send If-None-Match to receive 304 when unchanged." }, "Link": { "schema": { "type": "string" }, "description": "Next page URL with rel=\"next\", when available." }, "X-Request-Id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/vehiclesPage" }, "example": { "schemaVersion": "2.0.0", "datasetId": "pdigger-outdoors-v15", "demo": true, "sourceVersion": 15, "sourceCommit": "5f322b5ad3ecfce4aff5b5609456716099b28f62", "clock": "source_elapsed_seconds", "frameUtcVerified": false, "partialCoverage": true, "datasetRevision": "5318d837e37e1219e3ec72baf438cf1423a40fe7ea120f8567a8484c8527402f", "mode": "recorded_demo", "data": [ { "id": "M01", "recordingId": "recovered_native_elapsed", "cameraId": "camera-01", "typeId": "skid_steer", "typeLabel": "Skid-steer", "categoryId": "mobile_machinery", "label": "M01 · Skid-steer", "recordKind": "reviewed_event", "countsAsAcceptedPassage": true, "uniqueAllDayIdentityVerified": false, "startSec": 2433.867, "endSec": 2440.79, "startUtc": null, "endUtc": null, "supportedPresence": [ { "start": 2433.867, "end": 2433.867 }, { "start": 2434.3, "end": 2434.3 } ], "actions": [ { "id": "gate_crossing", "label": "Gate crossing", "evidence": "reviewed_v4_accepted_passage", "scope": "accepted_directional_image_gate_passage", "startSec": 2433.8669999999997, "endSec": 2434.2999999999997 } ], "actionIds": [ "gate_crossing" ], "movement": { "cameraDirection": "toward_top", "facilityDirection": null, "motionState": null, "imageLane": null }, "loadId": null, "localAssociation": null, "evidenceKind": "gate_pair_only", "limitations": [ "Night glare, wet lens and split exposure limit fine details, but machine silhouette and motion are clear near gate.; Operator not separately resolved." ], "detailUrl": "/api/v1/events/M01", "tracksUrl": "/api/v1/tracks/M01" }, { "id": "M02", "recordingId": "recovered_native_elapsed", "cameraId": "camera-01", "typeId": "utv", "typeLabel": "UTV", "categoryId": "mobile_machinery", "label": "M02 · UTV", "recordKind": "reviewed_event", "countsAsAcceptedPassage": true, "uniqueAllDayIdentityVerified": false, "startSec": 3828.182, "endSec": 3829.314, "startUtc": null, "endUtc": null, "supportedPresence": [ { "start": 3828.615, "end": 3828.848 } ], "actions": [ { "id": "gate_crossing", "label": "Gate crossing", "evidence": "reviewed_v4_accepted_passage", "scope": "accepted_directional_image_gate_passage", "startSec": 3828.615, "endSec": 3828.848 } ], "actionIds": [ "gate_crossing" ], "movement": { "cameraDirection": "toward_top", "facilityDirection": null, "motionState": null, "imageLane": null }, "loadId": null, "localAssociation": null, "evidenceKind": "gate_pair_only", "limitations": [ "night glare/haze; UTV is not an ordinary passenger car; keep utility category separate; Visual utility-vehicle classification only; no road-legal status claim." ], "detailUrl": "/api/v1/events/M02", "tracksUrl": "/api/v1/tracks/M02" } ], "page": { "limit": 2, "returned": 2, "total": 42, "hasMore": true, "nextCursor": "eyJ2IjoxLCJkIjoiNTMxOGQ4MzdlMzdlMTIxOWUzZWM3MmJhZjQzOGNmMTQyM2E0MGZlN2VhMTIwZjg1NjdhODQ4NGM4NTI3NDAyZiIsInEiOiI3ZWYzMzEwZDY4ZTE3YTkwZjZlNDA0ZjZiNmVhNGY1OTI1ZTA1MzYzYjRmNjc4NjFiNTI2NzAwNWExN2NjNjJjIiwiayI6WzM4MjguMTgyLCJNMDIiXX0.H1IwNlDIuFr0kUNwWxPOnuZOpkkQYWcNOZ91MDPOYG8" }, "links": { "self": "/api/v1/vehicles?limit=2", "next": "/api/v1/vehicles?limit=2&cursor=eyJ2IjoxLCJkIjoiNTMxOGQ4MzdlMzdlMTIxOWUzZWM3MmJhZjQzOGNmMTQyM2E0MGZlN2VhMTIwZjg1NjdhODQ4NGM4NTI3NDAyZiIsInEiOiI3ZWYzMzEwZDY4ZTE3YTkwZjZlNDA0ZjZiNmVhNGY1OTI1ZTA1MzYzYjRmNjc4NjFiNTI2NzAwNWExN2NjNjJjIiwiayI6WzM4MjguMTgyLCJNMDIiXX0.H1IwNlDIuFr0kUNwWxPOnuZOpkkQYWcNOZ91MDPOYG8" } } } } }, "304": { "description": "Response unchanged (If-None-Match). No body." }, "400": { "description": "Invalid parameter, range or cursor.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "example": { "error": { "code": "invalid_parameter", "message": "Invalid parameter, range or cursor.", "field": null, "requestId": "request-id" } } } } }, "404": { "description": "Resource or route does not exist.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "example": { "error": { "code": "not_found", "message": "Resource or route does not exist.", "field": null, "requestId": "request-id" } } } } }, "405": { "description": "This API supports GET, HEAD and OPTIONS.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "example": { "error": { "code": "method_not_allowed", "message": "This API supports GET, HEAD and OPTIONS.", "field": null, "requestId": "request-id" } } } } }, "409": { "description": "Dataset changed; restart without the cursor.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "example": { "error": { "code": "stale_cursor", "message": "Dataset changed; restart without the cursor.", "field": null, "requestId": "request-id" } } } } }, "500": { "description": "Request could not be completed.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "example": { "error": { "code": "internal_error", "message": "Request could not be completed.", "field": null, "requestId": "request-id" } } } } } }, "x-codeSamples": [ { "lang": "Shell", "label": "curl", "source": "curl -sS 'https://outdoors.pdigger.com/api/v1/vehicles?limit=2'" } ] } }, "/vehicles/{id}": { "get": { "operationId": "get_vehicles_id_", "tags": [ "Observations" ], "summary": "Get one vehicle", "description": "Executed by the read-only API service against the versioned, fully merged demo dataset. Lists are ordered by source start time then ID (observations), sample time then ID (track samples), or ID (other collections). Time ranges are inclusive. No live inference or all-day identity claim.", "parameters": [ { "in": "path", "name": "id", "required": true, "schema": { "type": "string" }, "example": "V05" } ], "responses": { "200": { "description": "Query result from recorded demo observations.", "headers": { "ETag": { "schema": { "type": "string" }, "description": "Strong response validator. Send If-None-Match to receive 304 when unchanged." }, "Link": { "schema": { "type": "string" }, "description": "Next page URL with rel=\"next\", when available." }, "X-Request-Id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "type": "object", "required": [ "schemaVersion", "datasetId", "datasetRevision", "demo", "mode", "data" ], "properties": { "schemaVersion": { "type": "string", "enum": [ "2.0.0" ] }, "datasetId": { "type": "string" }, "datasetRevision": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "demo": { "type": "boolean", "enum": [ true ] }, "mode": { "type": "string", "enum": [ "recorded_demo" ] }, "sourceVersion": { "type": "integer" }, "sourceCommit": { "type": "string" }, "clock": { "type": "string", "enum": [ "source_elapsed_seconds" ] }, "frameUtcVerified": { "type": "boolean", "enum": [ false ] }, "partialCoverage": { "type": "boolean", "enum": [ true ] }, "data": { "$ref": "#/components/schemas/Event" } } }, "example": { "schemaVersion": "2.0.0", "datasetId": "pdigger-outdoors-v15", "demo": true, "sourceVersion": 15, "sourceCommit": "5f322b5ad3ecfce4aff5b5609456716099b28f62", "clock": "source_elapsed_seconds", "frameUtcVerified": false, "partialCoverage": true, "datasetRevision": "5318d837e37e1219e3ec72baf438cf1423a40fe7ea120f8567a8484c8527402f", "mode": "recorded_demo", "data": { "id": "V05", "recordingId": "recovered_native_elapsed", "cameraId": "camera-01", "typeId": "semi_trailer", "typeLabel": "Semi + trailer(s)", "categoryId": "road_vehicle", "label": "V05 · Semi + trailer(s)", "recordKind": "reviewed_event", "countsAsAcceptedPassage": true, "uniqueAllDayIdentityVerified": false, "startSec": 33605.62, "endSec": 33606.319, "startUtc": null, "endUtc": null, "supportedPresence": [], "actions": [ { "id": "gate_crossing", "label": "Gate crossing", "evidence": "reviewed_v4_accepted_passage", "scope": "accepted_directional_image_gate_passage", "startSec": 33605.619999999995, "endSec": 33606.318999999996 } ], "actionIds": [ "gate_crossing" ], "movement": { "cameraDirection": "toward_bottom", "facilityDirection": null, "motionState": "passing", "imageLane": "left_silo_side" }, "loadId": "load-V05", "localAssociation": null, "evidenceKind": "manual_landmarks_only", "limitations": [ "No claim about crossing in chunk559 or across not established chunk gap.; No full-vehicle bounding box centre timing is asserted. Timestamp refers only to the manually identified rear trailer wheel landmark.; Cab and coupling become occluded; no unseen cab motion is reconstructed.; Review ends at10s bound, last native frame9.785; no later source footage inspected." ], "detailUrl": "/api/v1/events/V05", "tracksUrl": "/api/v1/tracks/V05" } } } } }, "304": { "description": "Response unchanged (If-None-Match). No body." }, "400": { "description": "Invalid parameter, range or cursor.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "example": { "error": { "code": "invalid_parameter", "message": "Invalid parameter, range or cursor.", "field": null, "requestId": "request-id" } } } } }, "404": { "description": "Resource or route does not exist.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "example": { "error": { "code": "not_found", "message": "Resource or route does not exist.", "field": null, "requestId": "request-id" } } } } }, "405": { "description": "This API supports GET, HEAD and OPTIONS.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "example": { "error": { "code": "method_not_allowed", "message": "This API supports GET, HEAD and OPTIONS.", "field": null, "requestId": "request-id" } } } } }, "409": { "description": "Dataset changed; restart without the cursor.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "example": { "error": { "code": "stale_cursor", "message": "Dataset changed; restart without the cursor.", "field": null, "requestId": "request-id" } } } } }, "500": { "description": "Request could not be completed.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "example": { "error": { "code": "internal_error", "message": "Request could not be completed.", "field": null, "requestId": "request-id" } } } } } }, "x-codeSamples": [ { "lang": "Shell", "label": "curl", "source": "curl -sS 'https://outdoors.pdigger.com/api/v1/vehicles/V05'" } ] } }, "/humans": { "get": { "operationId": "get_humans", "tags": [ "Observations" ], "summary": "Query humans with cursor pagination", "description": "Executed by the read-only API service against the versioned, fully merged demo dataset. Lists are ordered by source start time then ID (observations), sample time then ID (track samples), or ID (other collections). Time ranges are inclusive. No live inference or all-day identity claim.", "parameters": [ { "in": "query", "name": "cameraId", "required": false, "description": "Exact, case-sensitive match.", "schema": { "type": "string", "maxLength": 160 } }, { "in": "query", "name": "recordingId", "required": false, "description": "Exact, case-sensitive match.", "schema": { "type": "string", "maxLength": 160 } }, { "in": "query", "name": "typeId", "required": false, "description": "Exact, case-sensitive match.", "schema": { "type": "string", "enum": [ "skid_steer", "utv", "human", "semi_trailer", "pickup", "wheel_loader" ] } }, { "in": "query", "name": "categoryId", "required": false, "description": "Exact, case-sensitive match.", "schema": { "type": "string", "enum": [ "mobile_machinery", "person", "road_vehicle", "light_vehicles" ] } }, { "in": "query", "name": "actionId", "required": false, "description": "Exact, case-sensitive match.", "schema": { "type": "string", "maxLength": 160 } }, { "in": "query", "name": "recordKind", "required": false, "description": "Use reviewed_event for reviewed activity counts; other records are contextual or isolated observations.", "schema": { "type": "string", "enum": [ "reviewed_event", "context", "isolated_observation" ] } }, { "in": "query", "name": "loadState", "required": false, "description": "Exact, case-sensitive match.", "schema": { "type": "string", "enum": [ "loaded", "empty", "not_established" ] } }, { "in": "query", "name": "cameraDirection", "required": false, "description": "Exact, case-sensitive match.", "schema": { "type": "string", "maxLength": 160 } }, { "in": "query", "name": "fromSec", "required": false, "description": "Inclusive source elapsed seconds. Event queries match intervals overlapping this bound; sample queries match sample times.", "schema": { "type": "number", "minimum": 0 } }, { "in": "query", "name": "toSec", "required": false, "description": "Inclusive source elapsed seconds. Must be at least fromSec.", "schema": { "type": "number", "minimum": 0 } }, { "in": "query", "name": "limit", "required": false, "description": "Page size. Follow links.next or pass page.nextCursor as cursor; retain all filters and the same limit.", "schema": { "type": "integer", "minimum": 1, "maximum": 100, "default": 20 } }, { "in": "query", "name": "cursor", "required": false, "description": "Opaque signed cursor returned by the previous page. It is bound to the dataset revision, endpoint, filters, ordering and limit. Not an authentication credential.", "schema": { "type": "string", "maxLength": 2048 } } ], "responses": { "200": { "description": "Query result from recorded demo observations.", "headers": { "ETag": { "schema": { "type": "string" }, "description": "Strong response validator. Send If-None-Match to receive 304 when unchanged." }, "Link": { "schema": { "type": "string" }, "description": "Next page URL with rel=\"next\", when available." }, "X-Request-Id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/humansPage" }, "example": { "schemaVersion": "2.0.0", "datasetId": "pdigger-outdoors-v15", "demo": true, "sourceVersion": 15, "sourceCommit": "5f322b5ad3ecfce4aff5b5609456716099b28f62", "clock": "source_elapsed_seconds", "frameUtcVerified": false, "partialCoverage": true, "datasetRevision": "5318d837e37e1219e3ec72baf438cf1423a40fe7ea120f8567a8484c8527402f", "mode": "recorded_demo", "data": [ { "id": "H01", "recordingId": "recovered_native_elapsed", "cameraId": "camera-01", "typeId": "human", "typeLabel": "Human", "categoryId": "person", "label": "H01 · Human", "recordKind": "reviewed_event", "countsAsAcceptedPassage": true, "uniqueAllDayIdentityVerified": false, "startSec": 21730.353, "endSec": 21734.78, "startUtc": null, "endUtc": null, "supportedPresence": [ { "start": 21730.986, "end": 21731.652 } ], "actions": [ { "id": "gate_crossing", "label": "Gate crossing", "evidence": "reviewed_v4_accepted_passage", "scope": "accepted_directional_image_gate_passage", "startSec": 21730.986, "endSec": 21731.652000000002 } ], "actionIds": [ "gate_crossing" ], "movement": { "cameraDirection": "toward_top", "facilityDirection": null, "motionState": null, "imageLane": null }, "loadId": null, "localAssociation": null, "evidenceKind": "gate_pair_only", "limitations": [ "small figure and night haze; A second clearly visible pedestrian also crosses but has no candidate among assigned events; candidate set is not exhaustive" ], "detailUrl": "/api/v1/events/H01", "tracksUrl": "/api/v1/tracks/H01" }, { "id": "H02", "recordingId": "recovered_native_elapsed", "cameraId": "camera-01", "typeId": "human", "typeLabel": "Human", "categoryId": "person", "label": "H02 · Human", "recordKind": "reviewed_event", "countsAsAcceptedPassage": true, "uniqueAllDayIdentityVerified": false, "startSec": 21731.885, "endSec": 21732.35, "startUtc": null, "endUtc": null, "supportedPresence": [], "actions": [ { "id": "gate_crossing", "label": "Gate crossing", "evidence": "reviewed_v4_accepted_passage", "scope": "accepted_directional_image_gate_passage", "startSec": 21731.885, "endSec": 21732.35 } ], "actionIds": [ "gate_crossing" ], "movement": { "cameraDirection": "toward_top", "facilityDirection": null, "motionState": null, "imageLane": null }, "loadId": null, "localAssociation": null, "evidenceKind": "no_plotted_coordinates", "limitations": [ "Local clip observation only; not evidence of a globally unique individual/vehicle or exhaustive recall.; Small figures and night haze; exact crossing frame54 uncertain, conservatively bracketed53–55." ], "detailUrl": "/api/v1/events/H02", "tracksUrl": "/api/v1/tracks/H02" } ], "page": { "limit": 2, "returned": 2, "total": 8, "hasMore": true, "nextCursor": "eyJ2IjoxLCJkIjoiNTMxOGQ4MzdlMzdlMTIxOWUzZWM3MmJhZjQzOGNmMTQyM2E0MGZlN2VhMTIwZjg1NjdhODQ4NGM4NTI3NDAyZiIsInEiOiI1ZGFkNGJlOTE5ZjIxYTUyMjZiODJmYmJiYTJhMTRkZmMzNmRkNTY3NzI4OGYzYWJjYjQ5MTlkZmZiYTJhNzQ1IiwiayI6WzIxNzMxLjg4NSwiSDAyIl19.z0xX7MOW458s15R3mEm2mwkPrVXovKG7GoYlo1l4Dr0" }, "links": { "self": "/api/v1/humans?limit=2", "next": "/api/v1/humans?limit=2&cursor=eyJ2IjoxLCJkIjoiNTMxOGQ4MzdlMzdlMTIxOWUzZWM3MmJhZjQzOGNmMTQyM2E0MGZlN2VhMTIwZjg1NjdhODQ4NGM4NTI3NDAyZiIsInEiOiI1ZGFkNGJlOTE5ZjIxYTUyMjZiODJmYmJiYTJhMTRkZmMzNmRkNTY3NzI4OGYzYWJjYjQ5MTlkZmZiYTJhNzQ1IiwiayI6WzIxNzMxLjg4NSwiSDAyIl19.z0xX7MOW458s15R3mEm2mwkPrVXovKG7GoYlo1l4Dr0" } } } } }, "304": { "description": "Response unchanged (If-None-Match). No body." }, "400": { "description": "Invalid parameter, range or cursor.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "example": { "error": { "code": "invalid_parameter", "message": "Invalid parameter, range or cursor.", "field": null, "requestId": "request-id" } } } } }, "404": { "description": "Resource or route does not exist.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "example": { "error": { "code": "not_found", "message": "Resource or route does not exist.", "field": null, "requestId": "request-id" } } } } }, "405": { "description": "This API supports GET, HEAD and OPTIONS.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "example": { "error": { "code": "method_not_allowed", "message": "This API supports GET, HEAD and OPTIONS.", "field": null, "requestId": "request-id" } } } } }, "409": { "description": "Dataset changed; restart without the cursor.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "example": { "error": { "code": "stale_cursor", "message": "Dataset changed; restart without the cursor.", "field": null, "requestId": "request-id" } } } } }, "500": { "description": "Request could not be completed.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "example": { "error": { "code": "internal_error", "message": "Request could not be completed.", "field": null, "requestId": "request-id" } } } } } }, "x-codeSamples": [ { "lang": "Shell", "label": "curl", "source": "curl -sS 'https://outdoors.pdigger.com/api/v1/humans?limit=2'" } ] } }, "/humans/{id}": { "get": { "operationId": "get_humans_id_", "tags": [ "Observations" ], "summary": "Get one human", "description": "Executed by the read-only API service against the versioned, fully merged demo dataset. Lists are ordered by source start time then ID (observations), sample time then ID (track samples), or ID (other collections). Time ranges are inclusive. No live inference or all-day identity claim.", "parameters": [ { "in": "path", "name": "id", "required": true, "schema": { "type": "string" }, "example": "H06" } ], "responses": { "200": { "description": "Query result from recorded demo observations.", "headers": { "ETag": { "schema": { "type": "string" }, "description": "Strong response validator. Send If-None-Match to receive 304 when unchanged." }, "Link": { "schema": { "type": "string" }, "description": "Next page URL with rel=\"next\", when available." }, "X-Request-Id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "type": "object", "required": [ "schemaVersion", "datasetId", "datasetRevision", "demo", "mode", "data" ], "properties": { "schemaVersion": { "type": "string", "enum": [ "2.0.0" ] }, "datasetId": { "type": "string" }, "datasetRevision": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "demo": { "type": "boolean", "enum": [ true ] }, "mode": { "type": "string", "enum": [ "recorded_demo" ] }, "sourceVersion": { "type": "integer" }, "sourceCommit": { "type": "string" }, "clock": { "type": "string", "enum": [ "source_elapsed_seconds" ] }, "frameUtcVerified": { "type": "boolean", "enum": [ false ] }, "partialCoverage": { "type": "boolean", "enum": [ true ] }, "data": { "$ref": "#/components/schemas/Event" } } }, "example": { "schemaVersion": "2.0.0", "datasetId": "pdigger-outdoors-v15", "demo": true, "sourceVersion": 15, "sourceCommit": "5f322b5ad3ecfce4aff5b5609456716099b28f62", "clock": "source_elapsed_seconds", "frameUtcVerified": false, "partialCoverage": true, "datasetRevision": "5318d837e37e1219e3ec72baf438cf1423a40fe7ea120f8567a8484c8527402f", "mode": "recorded_demo", "data": { "id": "H06", "recordingId": "recovered_native_elapsed", "cameraId": "camera-01", "typeId": "human", "typeLabel": "Human", "categoryId": "person", "label": "H06 · Human", "recordKind": "reviewed_event", "countsAsAcceptedPassage": true, "uniqueAllDayIdentityVerified": false, "startSec": 83597.983, "endSec": 83603.508, "startUtc": null, "endUtc": null, "supportedPresence": [ { "start": 83597.983, "end": 83603.508 } ], "actions": [ { "id": "gate_crossing", "label": "Gate crossing", "evidence": "reviewed_v4_accepted_passage", "scope": "accepted_directional_image_gate_passage", "startSec": 83600.546, "endSec": 83601.211 }, { "id": "walking", "label": "Walking", "evidence": "reviewed_passages_v4", "scope": "bounded_review_context_not_kinematic_animation", "note": "Reviewed subtype walking_person. Person nearUTV; completed vehicle entry NOT established.", "startSec": null, "endSec": null } ], "actionIds": [ "gate_crossing", "walking" ], "movement": { "cameraDirection": "toward_top", "facilityDirection": null, "motionState": null, "imageLane": null }, "loadId": null, "localAssociation": null, "evidenceKind": "sampled_path", "limitations": [ "Night glare and partial later door occlusion.; Count is one local physical passage, not unique person identity across recording.; Legacy joined-media timestamps retained in raw event are not native final-video or UTC timestamps.; No evidence of unseen inter-frame or cross-boundary activity is invented.; Person near UTV; no completed vehicle entry inferred.", "No connection between raw-track IDs or absent source frames." ], "detailUrl": "/api/v1/events/H06", "tracksUrl": "/api/v1/tracks/H06" } } } } }, "304": { "description": "Response unchanged (If-None-Match). No body." }, "400": { "description": "Invalid parameter, range or cursor.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "example": { "error": { "code": "invalid_parameter", "message": "Invalid parameter, range or cursor.", "field": null, "requestId": "request-id" } } } } }, "404": { "description": "Resource or route does not exist.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "example": { "error": { "code": "not_found", "message": "Resource or route does not exist.", "field": null, "requestId": "request-id" } } } } }, "405": { "description": "This API supports GET, HEAD and OPTIONS.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "example": { "error": { "code": "method_not_allowed", "message": "This API supports GET, HEAD and OPTIONS.", "field": null, "requestId": "request-id" } } } } }, "409": { "description": "Dataset changed; restart without the cursor.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "example": { "error": { "code": "stale_cursor", "message": "Dataset changed; restart without the cursor.", "field": null, "requestId": "request-id" } } } } }, "500": { "description": "Request could not be completed.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "example": { "error": { "code": "internal_error", "message": "Request could not be completed.", "field": null, "requestId": "request-id" } } } } } }, "x-codeSamples": [ { "lang": "Shell", "label": "curl", "source": "curl -sS 'https://outdoors.pdigger.com/api/v1/humans/H06'" } ] } }, "/loads": { "get": { "operationId": "get_loads", "tags": [ "Loads" ], "summary": "Query loads with cursor pagination", "description": "Executed by the read-only API service against the versioned, fully merged demo dataset. Lists are ordered by source start time then ID (observations), sample time then ID (track samples), or ID (other collections). Time ranges are inclusive. No live inference or all-day identity claim.", "parameters": [ { "in": "query", "name": "cameraId", "required": false, "description": "Exact, case-sensitive match.", "schema": { "type": "string", "maxLength": 160 } }, { "in": "query", "name": "recordingId", "required": false, "description": "Exact, case-sensitive match.", "schema": { "type": "string", "maxLength": 160 } }, { "in": "query", "name": "eventId", "required": false, "description": "Exact, case-sensitive match.", "schema": { "type": "string", "maxLength": 160 } }, { "in": "query", "name": "state", "required": false, "description": "Exact, case-sensitive match.", "schema": { "type": "string", "enum": [ "loaded", "empty", "not_established" ] } }, { "in": "query", "name": "materialType", "required": false, "description": "Match a verified material type; the current footage does not establish material identity.", "schema": { "type": "string", "maxLength": 160 } }, { "in": "query", "name": "minFillPercent", "required": false, "description": "Include visual fill ranges whose upper bound is at least this percentage.", "schema": { "type": "number", "minimum": 0, "maximum": 100 } }, { "in": "query", "name": "maxFillPercent", "required": false, "description": "Include visual fill ranges whose lower bound is at most this percentage.", "schema": { "type": "number", "minimum": 0, "maximum": 100 } }, { "in": "query", "name": "limit", "required": false, "description": "Page size. Follow links.next or pass page.nextCursor as cursor; retain all filters and the same limit.", "schema": { "type": "integer", "minimum": 1, "maximum": 100, "default": 20 } }, { "in": "query", "name": "cursor", "required": false, "description": "Opaque signed cursor returned by the previous page. It is bound to the dataset revision, endpoint, filters, ordering and limit. Not an authentication credential.", "schema": { "type": "string", "maxLength": 2048 } } ], "responses": { "200": { "description": "Query result from recorded demo observations.", "headers": { "ETag": { "schema": { "type": "string" }, "description": "Strong response validator. Send If-None-Match to receive 304 when unchanged." }, "Link": { "schema": { "type": "string" }, "description": "Next page URL with rel=\"next\", when available." }, "X-Request-Id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/loadsPage" }, "example": { "schemaVersion": "2.0.0", "datasetId": "pdigger-outdoors-v15", "demo": true, "sourceVersion": 15, "sourceCommit": "5f322b5ad3ecfce4aff5b5609456716099b28f62", "clock": "source_elapsed_seconds", "frameUtcVerified": false, "partialCoverage": true, "datasetRevision": "5318d837e37e1219e3ec72baf438cf1423a40fe7ea120f8567a8484c8527402f", "mode": "recorded_demo", "data": [ { "id": "load-C546-SEMI", "sourceObservationId": "C546-SEMI", "eventIds": [ "C546-SEMI" ], "state": null, "observedState": "covered_contents_not_established", "material": { "type": null, "visualDescription": null, "identityVerified": false }, "visibleFillPercent": null, "measurementBasis": "visual_estimate", "volumeM3": null, "massKg": null, "confidence": "not_estimated", "trailerCount": 1, "trailers": [ { "index": 1, "position": "single", "state": "covered_contents_not_established", "range_percent": null } ], "movement": { "cameraDirection": "stationary_or_repositioning", "facilityDirection": "waiting", "motionState": "waiting_context", "imageLane": "right_parked_trailer_side" }, "evidence": [ { "file": "evidence/additional_32600.000.jpg", "native_elapsed_sec": 32600, "timestamp_basis": "requested ffmpeg seek; decoded frame at or immediately following requested native elapsed time", "sha256": "81abf45b2e613e289e2e6e439687d594b68a636b6a198ce593683f13cc94ea6e", "image": "/demo/assets/proxies/load-evidence/additional_32600.000.jpg", "time_sec": 32600 }, { "file": "evidence/additional_33200.000.jpg", "native_elapsed_sec": 33200, "timestamp_basis": "requested ffmpeg seek; decoded frame at or immediately following requested native elapsed time", "sha256": "aa72dd97d39f8df8106633d4a1d23bee5771689f13b5f1dee129c96964144cda", "image": "/demo/assets/proxies/load-evidence/additional_33200.000.jpg", "time_sec": 33200 }, { "file": "evidence/additional_33550.000.jpg", "native_elapsed_sec": 33550, "timestamp_basis": "requested ffmpeg seek; decoded frame at or immediately following requested native elapsed time", "sha256": "08f8969e77e7eaed8849e3f4460b8fe55f49745973c64d8627b4fa7b70d69079", "image": "/demo/assets/proxies/load-evidence/additional_33550.000.jpg", "time_sec": 33550 } ], "notes": "Purple tractor with single pale trailer, physically distinct from V05. Gray continuous cover obscures load; clear cover at32600 and wrinkled reflective surface at33550. No percentage inferred. Source-local waiting episode only, not accepted gate passage." }, { "id": "load-M05", "sourceObservationId": "M05", "eventIds": [ "M05" ], "state": null, "observedState": "no_heap_visible_not_confirmed_empty", "material": { "type": null, "visualDescription": null, "identityVerified": false }, "visibleFillPercent": null, "measurementBasis": "visual_estimate", "volumeM3": null, "massKg": null, "confidence": null, "trailerCount": null, "trailers": [], "movement": { "cameraDirection": "toward_bottom", "facilityDirection": null, "motionState": "approach", "imageLane": null }, "evidence": [], "notes": "Existing policy reports glare/occlusion; do not replace not established with zero." } ], "page": { "limit": 2, "returned": 2, "total": 22, "hasMore": true, "nextCursor": "eyJ2IjoxLCJkIjoiNTMxOGQ4MzdlMzdlMTIxOWUzZWM3MmJhZjQzOGNmMTQyM2E0MGZlN2VhMTIwZjg1NjdhODQ4NGM4NTI3NDAyZiIsInEiOiJhNDFkOGRlN2RlZGM0NWQ4MTkwYTgzZTZjYjQzMGQ5NmE5ZWJhYWI0MmI2NTBiOGE4OTMzZmVjMDEyMGM1ZGM3IiwiayI6WyJsb2FkLU0wNSJdfQ.aLLq5mFW_DUCGF2Vylz0rlJp7cn8rBeLd-2FRFAJUEo" }, "links": { "self": "/api/v1/loads?limit=2", "next": "/api/v1/loads?limit=2&cursor=eyJ2IjoxLCJkIjoiNTMxOGQ4MzdlMzdlMTIxOWUzZWM3MmJhZjQzOGNmMTQyM2E0MGZlN2VhMTIwZjg1NjdhODQ4NGM4NTI3NDAyZiIsInEiOiJhNDFkOGRlN2RlZGM0NWQ4MTkwYTgzZTZjYjQzMGQ5NmE5ZWJhYWI0MmI2NTBiOGE4OTMzZmVjMDEyMGM1ZGM3IiwiayI6WyJsb2FkLU0wNSJdfQ.aLLq5mFW_DUCGF2Vylz0rlJp7cn8rBeLd-2FRFAJUEo" } } } } }, "304": { "description": "Response unchanged (If-None-Match). No body." }, "400": { "description": "Invalid parameter, range or cursor.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "example": { "error": { "code": "invalid_parameter", "message": "Invalid parameter, range or cursor.", "field": null, "requestId": "request-id" } } } } }, "404": { "description": "Resource or route does not exist.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "example": { "error": { "code": "not_found", "message": "Resource or route does not exist.", "field": null, "requestId": "request-id" } } } } }, "405": { "description": "This API supports GET, HEAD and OPTIONS.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "example": { "error": { "code": "method_not_allowed", "message": "This API supports GET, HEAD and OPTIONS.", "field": null, "requestId": "request-id" } } } } }, "409": { "description": "Dataset changed; restart without the cursor.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "example": { "error": { "code": "stale_cursor", "message": "Dataset changed; restart without the cursor.", "field": null, "requestId": "request-id" } } } } }, "500": { "description": "Request could not be completed.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "example": { "error": { "code": "internal_error", "message": "Request could not be completed.", "field": null, "requestId": "request-id" } } } } } }, "x-codeSamples": [ { "lang": "Shell", "label": "curl", "source": "curl -sS 'https://outdoors.pdigger.com/api/v1/loads?limit=2'" } ] } }, "/loads/{id}": { "get": { "operationId": "get_loads_id_", "tags": [ "Observations" ], "summary": "Get one load", "description": "Executed by the read-only API service against the versioned, fully merged demo dataset. Lists are ordered by source start time then ID (observations), sample time then ID (track samples), or ID (other collections). Time ranges are inclusive. No live inference or all-day identity claim.", "parameters": [ { "in": "path", "name": "id", "required": true, "schema": { "type": "string" }, "example": "load-V01" } ], "responses": { "200": { "description": "Query result from recorded demo observations.", "headers": { "ETag": { "schema": { "type": "string" }, "description": "Strong response validator. Send If-None-Match to receive 304 when unchanged." }, "Link": { "schema": { "type": "string" }, "description": "Next page URL with rel=\"next\", when available." }, "X-Request-Id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "type": "object", "required": [ "schemaVersion", "datasetId", "datasetRevision", "demo", "mode", "data" ], "properties": { "schemaVersion": { "type": "string", "enum": [ "2.0.0" ] }, "datasetId": { "type": "string" }, "datasetRevision": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "demo": { "type": "boolean", "enum": [ true ] }, "mode": { "type": "string", "enum": [ "recorded_demo" ] }, "sourceVersion": { "type": "integer" }, "sourceCommit": { "type": "string" }, "clock": { "type": "string", "enum": [ "source_elapsed_seconds" ] }, "frameUtcVerified": { "type": "boolean", "enum": [ false ] }, "partialCoverage": { "type": "boolean", "enum": [ true ] }, "data": { "$ref": "#/components/schemas/Load" } } }, "example": { "schemaVersion": "2.0.0", "datasetId": "pdigger-outdoors-v15", "demo": true, "sourceVersion": 15, "sourceCommit": "5f322b5ad3ecfce4aff5b5609456716099b28f62", "clock": "source_elapsed_seconds", "frameUtcVerified": false, "partialCoverage": true, "datasetRevision": "5318d837e37e1219e3ec72baf438cf1423a40fe7ea120f8567a8484c8527402f", "mode": "recorded_demo", "data": { "id": "load-V01", "sourceObservationId": "V01", "eventIds": [ "V01" ], "state": "loaded", "observedState": "visible_load", "material": { "type": null, "visualDescription": "not established; golden granular agricultural material visible", "identityVerified": false }, "visibleFillPercent": [ 75, 100 ], "measurementBasis": "visual_estimate", "volumeM3": null, "massKg": null, "confidence": "medium", "trailerCount": 1, "trailers": [ { "index": 1, "position": "single", "state": "visible_load", "range_percent": [ 75, 100 ], "surface_shape": "broad_near_rim" } ], "movement": { "cameraDirection": "toward_bottom", "facilityDirection": null, "motionState": "passing", "imageLane": "left_silo_side" }, "evidence": [ { "file": "evidence/V01_25044.002.jpg", "native_elapsed_sec": 25044.002, "timestamp_basis": "requested ffmpeg seek in verified native full video; displayed decoded frame may be the immediately following native frame", "sha256": "102fcb559445a3a0e44ad5c6ddbe392e79c61593e8f6dab14ffcb562a6fffc78", "image": "/demo/assets/proxies/load-evidence/V01_25044.002.jpg", "time_sec": 25044.002 } ], "notes": "Broad golden granular surface near rim; local recessed patches." } } } } }, "304": { "description": "Response unchanged (If-None-Match). No body." }, "400": { "description": "Invalid parameter, range or cursor.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "example": { "error": { "code": "invalid_parameter", "message": "Invalid parameter, range or cursor.", "field": null, "requestId": "request-id" } } } } }, "404": { "description": "Resource or route does not exist.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "example": { "error": { "code": "not_found", "message": "Resource or route does not exist.", "field": null, "requestId": "request-id" } } } } }, "405": { "description": "This API supports GET, HEAD and OPTIONS.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "example": { "error": { "code": "method_not_allowed", "message": "This API supports GET, HEAD and OPTIONS.", "field": null, "requestId": "request-id" } } } } }, "409": { "description": "Dataset changed; restart without the cursor.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "example": { "error": { "code": "stale_cursor", "message": "Dataset changed; restart without the cursor.", "field": null, "requestId": "request-id" } } } } }, "500": { "description": "Request could not be completed.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "example": { "error": { "code": "internal_error", "message": "Request could not be completed.", "field": null, "requestId": "request-id" } } } } } }, "x-codeSamples": [ { "lang": "Shell", "label": "curl", "source": "curl -sS 'https://outdoors.pdigger.com/api/v1/loads/load-V01'" } ] } }, "/tracks": { "get": { "operationId": "get_tracks", "tags": [ "Tracks" ], "summary": "Query tracks with cursor pagination", "description": "Executed by the read-only API service against the versioned, fully merged demo dataset. Lists are ordered by source start time then ID (observations), sample time then ID (track samples), or ID (other collections). Time ranges are inclusive. No live inference or all-day identity claim.", "parameters": [ { "in": "query", "name": "eventId", "required": false, "description": "Exact, case-sensitive match.", "schema": { "type": "string", "maxLength": 160 } }, { "in": "query", "name": "recordingId", "required": false, "description": "Exact, case-sensitive match.", "schema": { "type": "string", "maxLength": 160 } }, { "in": "query", "name": "cameraId", "required": false, "description": "Exact, case-sensitive match.", "schema": { "type": "string", "maxLength": 160 } }, { "in": "query", "name": "limit", "required": false, "description": "Page size. Follow links.next or pass page.nextCursor as cursor; retain all filters and the same limit.", "schema": { "type": "integer", "minimum": 1, "maximum": 100, "default": 20 } }, { "in": "query", "name": "cursor", "required": false, "description": "Opaque signed cursor returned by the previous page. It is bound to the dataset revision, endpoint, filters, ordering and limit. Not an authentication credential.", "schema": { "type": "string", "maxLength": 2048 } } ], "responses": { "200": { "description": "Query result from recorded demo observations.", "headers": { "ETag": { "schema": { "type": "string" }, "description": "Strong response validator. Send If-None-Match to receive 304 when unchanged." }, "Link": { "schema": { "type": "string" }, "description": "Next page URL with rel=\"next\", when available." }, "X-Request-Id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/tracksPage" }, "example": { "schemaVersion": "2.0.0", "datasetId": "pdigger-outdoors-v15", "demo": true, "sourceVersion": 15, "sourceCommit": "5f322b5ad3ecfce4aff5b5609456716099b28f62", "clock": "source_elapsed_seconds", "frameUtcVerified": false, "partialCoverage": true, "datasetRevision": "5318d837e37e1219e3ec72baf438cf1423a40fe7ea120f8567a8484c8527402f", "mode": "recorded_demo", "data": [ { "id": "track-C1386-UTV", "eventId": "C1386-UTV", "recordingId": "recovered_native_elapsed", "imageSegmentCount": 46, "worldSegmentCount": 46, "imageSampleCount": 259, "worldSampleCount": 259, "markerCount": 0, "detailUrl": "/api/v1/tracks/C1386-UTV" }, { "id": "track-C1393-LOADER", "eventId": "C1393-LOADER", "recordingId": "recovered_native_elapsed", "imageSegmentCount": 7, "worldSegmentCount": 7, "imageSampleCount": 34, "worldSampleCount": 34, "markerCount": 0, "detailUrl": "/api/v1/tracks/C1393-LOADER" } ], "page": { "limit": 2, "returned": 2, "total": 50, "hasMore": true, "nextCursor": "eyJ2IjoxLCJkIjoiNTMxOGQ4MzdlMzdlMTIxOWUzZWM3MmJhZjQzOGNmMTQyM2E0MGZlN2VhMTIwZjg1NjdhODQ4NGM4NTI3NDAyZiIsInEiOiI0YWNjYTRlZjMyYWIyMDkzODJiNDg3MzAyOGMzNmUyYzVmYjE3MmExN2M3N2RiNDlmNTE2ZmViNDQ3MDIyNWZkIiwiayI6WyJ0cmFjay1DMTM5My1MT0FERVIiXX0.2h53dSnvheu7-W0poMESh0JTIFBiv5pOLfmpF1oP2zk" }, "links": { "self": "/api/v1/tracks?limit=2", "next": "/api/v1/tracks?limit=2&cursor=eyJ2IjoxLCJkIjoiNTMxOGQ4MzdlMzdlMTIxOWUzZWM3MmJhZjQzOGNmMTQyM2E0MGZlN2VhMTIwZjg1NjdhODQ4NGM4NTI3NDAyZiIsInEiOiI0YWNjYTRlZjMyYWIyMDkzODJiNDg3MzAyOGMzNmUyYzVmYjE3MmExN2M3N2RiNDlmNTE2ZmViNDQ3MDIyNWZkIiwiayI6WyJ0cmFjay1DMTM5My1MT0FERVIiXX0.2h53dSnvheu7-W0poMESh0JTIFBiv5pOLfmpF1oP2zk" } } } } }, "304": { "description": "Response unchanged (If-None-Match). No body." }, "400": { "description": "Invalid parameter, range or cursor.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "example": { "error": { "code": "invalid_parameter", "message": "Invalid parameter, range or cursor.", "field": null, "requestId": "request-id" } } } } }, "404": { "description": "Resource or route does not exist.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "example": { "error": { "code": "not_found", "message": "Resource or route does not exist.", "field": null, "requestId": "request-id" } } } } }, "405": { "description": "This API supports GET, HEAD and OPTIONS.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "example": { "error": { "code": "method_not_allowed", "message": "This API supports GET, HEAD and OPTIONS.", "field": null, "requestId": "request-id" } } } } }, "409": { "description": "Dataset changed; restart without the cursor.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "example": { "error": { "code": "stale_cursor", "message": "Dataset changed; restart without the cursor.", "field": null, "requestId": "request-id" } } } } }, "500": { "description": "Request could not be completed.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "example": { "error": { "code": "internal_error", "message": "Request could not be completed.", "field": null, "requestId": "request-id" } } } } } }, "x-codeSamples": [ { "lang": "Shell", "label": "curl", "source": "curl -sS 'https://outdoors.pdigger.com/api/v1/tracks?limit=2'" } ] } }, "/cameras": { "get": { "operationId": "get_cameras", "tags": [ "Scene & calendar" ], "summary": "Query cameras with cursor pagination", "description": "Executed by the read-only API service against the versioned, fully merged demo dataset. Lists are ordered by source start time then ID (observations), sample time then ID (track samples), or ID (other collections). Time ranges are inclusive. No live inference or all-day identity claim.", "parameters": [ { "in": "query", "name": "limit", "required": false, "description": "Page size. Follow links.next or pass page.nextCursor as cursor; retain all filters and the same limit.", "schema": { "type": "integer", "minimum": 1, "maximum": 100, "default": 20 } }, { "in": "query", "name": "cursor", "required": false, "description": "Opaque signed cursor returned by the previous page. It is bound to the dataset revision, endpoint, filters, ordering and limit. Not an authentication credential.", "schema": { "type": "string", "maxLength": 2048 } } ], "responses": { "200": { "description": "Query result from recorded demo observations.", "headers": { "ETag": { "schema": { "type": "string" }, "description": "Strong response validator. Send If-None-Match to receive 304 when unchanged." }, "Link": { "schema": { "type": "string" }, "description": "Next page URL with rel=\"next\", when available." }, "X-Request-Id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/camerasPage" }, "example": { "schemaVersion": "2.0.0", "datasetId": "pdigger-outdoors-v15", "demo": true, "sourceVersion": 15, "sourceCommit": "5f322b5ad3ecfce4aff5b5609456716099b28f62", "clock": "source_elapsed_seconds", "frameUtcVerified": false, "partialCoverage": true, "datasetRevision": "5318d837e37e1219e3ec72baf438cf1423a40fe7ea120f8567a8484c8527402f", "mode": "recorded_demo", "data": [ { "id": "camera-01", "name": "Bean receiving yard", "recordingIds": [ "recovered_native_elapsed" ], "intrinsicsAndPose": { "schema": "bean.camera.relative.v1", "coordinate_system": "+X image right, +Y image up, -Z camera forward; camera atorigin", "position": [ 0, 0, 0 ], "target": [ 0, 0, -1 ], "up": [ 0, 1, 0 ], "orbit_up": [ -0.09011274034171156, 0.9391225629783461, 0.3315546798540018 ], "orbit_target": [ 1.9229033279991516, -0.7047745229318159, -12.100791613544434 ], "orbit_position": [ 6.922903327999151, 2.2952254770681844, -1.100791613544434 ], "image_width": 1280, "image_height": 720, "fx": 695.3742571593541, "fy": 695.3742571593541, "cx": 639.5, "cy": 359.5, "fov_y_degrees": 54.74182223336583, "aspect": 1.7777777777777777, "near": 0.05, "far": 1000, "estimated": true, "calibrated": false, "lens_model": "approximate pinhole; visible wide-angle barrel distortion NOT calibrated or rectified", "lens_distortion": { "coefficients": null, "calibrated": false, "wide_angle_barrel_distortion_visible": true }, "source_orientation_estimate": { "image_up_clockwise_tilt_degrees": -5.480989409980479, "downward_pitch_degrees": 19.36316541907975, "height_above_estimated_road_relative_units": 4.847221834004483, "source": "image-perspective road-plane refinement, not surveyed camera pose" }, "physical_camera_pose": null, "physical_camera_height_m": null, "meters_per_unit": null, "log_depth_to_z": { "formula": "z=10*exp(alpha*(raw_log_depth-center))", "alpha": 1.1742178226598412, "center": -0.0419921875, "median_road_z_relative_units": 10, "arbitrary_similarity_scale": true }, "fit": { "method": "robust angular consistency between Marigold depth gradients and independently predicted Marigold camera normals", "pixel_count": 20000, "median_angle_degrees": 9.205952891135224, "p90_angle_degrees": 26.25030723119412, "focal_bound_pixels": [ 300, 1800 ], "not_independent_validation": true, "bound_limited": false, "parameter_intervals_are_not_statistical_confidence": true }, "ground_plane": { "normal": [ -0.09011274034171156, 0.9391225629783461, 0.3315546798540018 ], "constant": 4.847221834004483, "equation": "dot(normal, point) + constant = 0", "fit_roi": "road_fit_mask.png", "estimated": true, "units": "relative", "rms_relative_units": null, "median_abs_relative_units": null, "normal_model_median": [ -0.054290124250490235, 0.747742978162053, 0.661765079932607 ], "source": "robust untruncated same-event apparent-height constraints + observed road horizon; explicit plane approximation", "plane_support_points": 32530 }, "warnings": [ "Single-image reconstruction is a 2.5D visible-surface mesh, not a full surveyed scene.", "Depth is affine-invariant in logspace; chosen transform and size units are estimates, not physical dimensions.", "No known dimension or camera metadata available: metric sizes and height cannot be recovered.", "Wide-angle lens distortion is visible and uncalibrated; road positions and camera intrinsics are approximate.", "Occluded backsides and sky remain missing; do not close holes or bridge depth discontinuities.", "Derived road-plane refinement replaces inconsistent monocular depth perspective; structures remain inferred and are not surveyed.", "Residual wide-angle distortion remains uncalibrated. Source-body alignment is approximate; camera-normal consistency is not survey calibration." ], "refinement": { "schema": "bean.world_refinement.v1", "method": "Reviewed road rays intersect one estimated horizon-consistent plane; nearest-road smooth log-depth correction extended to adjacent nonroad surfaces, preserving Marigold local shape and all source image UVs.", "horizonCenterPixels": 114, "horizonSlopePixelsPerXPixel": -0.0959541852087195, "horizonSensitivityRangePixels": [ 94, 134 ], "notStatisticalConfidence": true, "constraints": [ { "eventId": "V02", "unclippedSamples": 17, "robustHeightRegressionHorizonCenter": 111.22549805912243 }, { "eventId": "V09", "unclippedSamples": 33, "robustHeightRegressionHorizonCenter": 117.16127275141837 } ], "rejectedConstraint": { "eventId": "V08", "reason": "turning/full-vs-cab box aspect changes violate constant apparent-height assumption" }, "originalGroundPlane": { "normal": [ -0.07470200832793479, 0.7785174577371796, 0.6231614381123175 ], "constant": 7.2569284413026995, "equation": "dot(normal, point) + constant = 0", "fit_roi": "road_fit_mask.png", "estimated": true, "units": "relative", "rms_relative_units": 0.18039678578762114, "median_abs_relative_units": 0.12838913803128005, "normal_model_median": [ -0.054290124250490235, 0.747742978162053, 0.661765079932607 ], "source": "robust plane fit to inferred depth, orientation checked with predicted road normals", "plane_support_points": 32530 }, "gauge": "preserve original plane depth at source pixel(639.5,500); arbitrary relative units", "roadConstraintPixels": 522513, "normalConventionVerified": "+X image right,+Y image up,+Z viewer; no axes conversion bug", "normalConventionSource": "https://huggingface.co/docs/diffusers/main/en/using-diffusers/marigold_usage#surface-normals-estimation", "physicalCalibration": false, "silhouetteScaleFittingRequired": true, "release": "release_v4", "focalPrior": "Original approximate f695 retained after independent visible upright-line review rejected f306/raw-normal combination; not physical camera calibration.", "shapePrior": "Constant corrected articulated-truck total length/height <=7; bounded visual prior, not physical measurement.", "rejectedCandidates": [ "f306 with raw Marigold normal predicts vertical vanishing point near image bottom and contradicts observed upright stacks", "unbounded rear length fits with L/H about13 overfit source hull and are not physically credible" ] } }, "image": { "width": 1280, "height": 720, "uvConvention": "u right, v down, normalized source image coordinates", "referenceSource": "attempt_00001/chunk_000661.mp4", "referenceTimeSec": 39678.605, "priorReportReference": { "referenceSource": "attempt_00001/chunk_000631.mp4", "referenceTimeSec": 37860.223 }, "referenceFrame": 80, "referenceImageSha256": "5f35e17c5d5708b689283dab53014d4032cb4f7d9795b78087df0f5fbf420020", "referenceSourceSha256": "8c93c30c3411c8ca4bb0cf716365f8b564c7700bce78666abf48e5ffd43074c2" } } ], "page": { "limit": 2, "returned": 1, "total": 1, "hasMore": false, "nextCursor": null }, "links": { "self": "/api/v1/cameras?limit=2", "next": null } } } } }, "304": { "description": "Response unchanged (If-None-Match). No body." }, "400": { "description": "Invalid parameter, range or cursor.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "example": { "error": { "code": "invalid_parameter", "message": "Invalid parameter, range or cursor.", "field": null, "requestId": "request-id" } } } } }, "404": { "description": "Resource or route does not exist.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "example": { "error": { "code": "not_found", "message": "Resource or route does not exist.", "field": null, "requestId": "request-id" } } } } }, "405": { "description": "This API supports GET, HEAD and OPTIONS.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "example": { "error": { "code": "method_not_allowed", "message": "This API supports GET, HEAD and OPTIONS.", "field": null, "requestId": "request-id" } } } } }, "409": { "description": "Dataset changed; restart without the cursor.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "example": { "error": { "code": "stale_cursor", "message": "Dataset changed; restart without the cursor.", "field": null, "requestId": "request-id" } } } } }, "500": { "description": "Request could not be completed.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "example": { "error": { "code": "internal_error", "message": "Request could not be completed.", "field": null, "requestId": "request-id" } } } } } }, "x-codeSamples": [ { "lang": "Shell", "label": "curl", "source": "curl -sS 'https://outdoors.pdigger.com/api/v1/cameras?limit=2'" } ] } }, "/cameras/{id}": { "get": { "operationId": "get_cameras_id_", "tags": [ "Observations" ], "summary": "Get one camera", "description": "Executed by the read-only API service against the versioned, fully merged demo dataset. Lists are ordered by source start time then ID (observations), sample time then ID (track samples), or ID (other collections). Time ranges are inclusive. No live inference or all-day identity claim.", "parameters": [ { "in": "path", "name": "id", "required": true, "schema": { "type": "string" }, "example": "camera-01" } ], "responses": { "200": { "description": "Query result from recorded demo observations.", "headers": { "ETag": { "schema": { "type": "string" }, "description": "Strong response validator. Send If-None-Match to receive 304 when unchanged." }, "Link": { "schema": { "type": "string" }, "description": "Next page URL with rel=\"next\", when available." }, "X-Request-Id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "type": "object", "required": [ "schemaVersion", "datasetId", "datasetRevision", "demo", "mode", "data" ], "properties": { "schemaVersion": { "type": "string", "enum": [ "2.0.0" ] }, "datasetId": { "type": "string" }, "datasetRevision": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "demo": { "type": "boolean", "enum": [ true ] }, "mode": { "type": "string", "enum": [ "recorded_demo" ] }, "sourceVersion": { "type": "integer" }, "sourceCommit": { "type": "string" }, "clock": { "type": "string", "enum": [ "source_elapsed_seconds" ] }, "frameUtcVerified": { "type": "boolean", "enum": [ false ] }, "partialCoverage": { "type": "boolean", "enum": [ true ] }, "data": { "$ref": "#/components/schemas/Camera" } } }, "example": { "schemaVersion": "2.0.0", "datasetId": "pdigger-outdoors-v15", "demo": true, "sourceVersion": 15, "sourceCommit": "5f322b5ad3ecfce4aff5b5609456716099b28f62", "clock": "source_elapsed_seconds", "frameUtcVerified": false, "partialCoverage": true, "datasetRevision": "5318d837e37e1219e3ec72baf438cf1423a40fe7ea120f8567a8484c8527402f", "mode": "recorded_demo", "data": { "id": "camera-01", "name": "Bean receiving yard", "recordingIds": [ "recovered_native_elapsed" ], "intrinsicsAndPose": { "schema": "bean.camera.relative.v1", "coordinate_system": "+X image right, +Y image up, -Z camera forward; camera atorigin", "position": [ 0, 0, 0 ], "target": [ 0, 0, -1 ], "up": [ 0, 1, 0 ], "orbit_up": [ -0.09011274034171156, 0.9391225629783461, 0.3315546798540018 ], "orbit_target": [ 1.9229033279991516, -0.7047745229318159, -12.100791613544434 ], "orbit_position": [ 6.922903327999151, 2.2952254770681844, -1.100791613544434 ], "image_width": 1280, "image_height": 720, "fx": 695.3742571593541, "fy": 695.3742571593541, "cx": 639.5, "cy": 359.5, "fov_y_degrees": 54.74182223336583, "aspect": 1.7777777777777777, "near": 0.05, "far": 1000, "estimated": true, "calibrated": false, "lens_model": "approximate pinhole; visible wide-angle barrel distortion NOT calibrated or rectified", "lens_distortion": { "coefficients": null, "calibrated": false, "wide_angle_barrel_distortion_visible": true }, "source_orientation_estimate": { "image_up_clockwise_tilt_degrees": -5.480989409980479, "downward_pitch_degrees": 19.36316541907975, "height_above_estimated_road_relative_units": 4.847221834004483, "source": "image-perspective road-plane refinement, not surveyed camera pose" }, "physical_camera_pose": null, "physical_camera_height_m": null, "meters_per_unit": null, "log_depth_to_z": { "formula": "z=10*exp(alpha*(raw_log_depth-center))", "alpha": 1.1742178226598412, "center": -0.0419921875, "median_road_z_relative_units": 10, "arbitrary_similarity_scale": true }, "fit": { "method": "robust angular consistency between Marigold depth gradients and independently predicted Marigold camera normals", "pixel_count": 20000, "median_angle_degrees": 9.205952891135224, "p90_angle_degrees": 26.25030723119412, "focal_bound_pixels": [ 300, 1800 ], "not_independent_validation": true, "bound_limited": false, "parameter_intervals_are_not_statistical_confidence": true }, "ground_plane": { "normal": [ -0.09011274034171156, 0.9391225629783461, 0.3315546798540018 ], "constant": 4.847221834004483, "equation": "dot(normal, point) + constant = 0", "fit_roi": "road_fit_mask.png", "estimated": true, "units": "relative", "rms_relative_units": null, "median_abs_relative_units": null, "normal_model_median": [ -0.054290124250490235, 0.747742978162053, 0.661765079932607 ], "source": "robust untruncated same-event apparent-height constraints + observed road horizon; explicit plane approximation", "plane_support_points": 32530 }, "warnings": [ "Single-image reconstruction is a 2.5D visible-surface mesh, not a full surveyed scene.", "Depth is affine-invariant in logspace; chosen transform and size units are estimates, not physical dimensions.", "No known dimension or camera metadata available: metric sizes and height cannot be recovered.", "Wide-angle lens distortion is visible and uncalibrated; road positions and camera intrinsics are approximate.", "Occluded backsides and sky remain missing; do not close holes or bridge depth discontinuities.", "Derived road-plane refinement replaces inconsistent monocular depth perspective; structures remain inferred and are not surveyed.", "Residual wide-angle distortion remains uncalibrated. Source-body alignment is approximate; camera-normal consistency is not survey calibration." ], "refinement": { "schema": "bean.world_refinement.v1", "method": "Reviewed road rays intersect one estimated horizon-consistent plane; nearest-road smooth log-depth correction extended to adjacent nonroad surfaces, preserving Marigold local shape and all source image UVs.", "horizonCenterPixels": 114, "horizonSlopePixelsPerXPixel": -0.0959541852087195, "horizonSensitivityRangePixels": [ 94, 134 ], "notStatisticalConfidence": true, "constraints": [ { "eventId": "V02", "unclippedSamples": 17, "robustHeightRegressionHorizonCenter": 111.22549805912243 }, { "eventId": "V09", "unclippedSamples": 33, "robustHeightRegressionHorizonCenter": 117.16127275141837 } ], "rejectedConstraint": { "eventId": "V08", "reason": "turning/full-vs-cab box aspect changes violate constant apparent-height assumption" }, "originalGroundPlane": { "normal": [ -0.07470200832793479, 0.7785174577371796, 0.6231614381123175 ], "constant": 7.2569284413026995, "equation": "dot(normal, point) + constant = 0", "fit_roi": "road_fit_mask.png", "estimated": true, "units": "relative", "rms_relative_units": 0.18039678578762114, "median_abs_relative_units": 0.12838913803128005, "normal_model_median": [ -0.054290124250490235, 0.747742978162053, 0.661765079932607 ], "source": "robust plane fit to inferred depth, orientation checked with predicted road normals", "plane_support_points": 32530 }, "gauge": "preserve original plane depth at source pixel(639.5,500); arbitrary relative units", "roadConstraintPixels": 522513, "normalConventionVerified": "+X image right,+Y image up,+Z viewer; no axes conversion bug", "normalConventionSource": "https://huggingface.co/docs/diffusers/main/en/using-diffusers/marigold_usage#surface-normals-estimation", "physicalCalibration": false, "silhouetteScaleFittingRequired": true, "release": "release_v4", "focalPrior": "Original approximate f695 retained after independent visible upright-line review rejected f306/raw-normal combination; not physical camera calibration.", "shapePrior": "Constant corrected articulated-truck total length/height <=7; bounded visual prior, not physical measurement.", "rejectedCandidates": [ "f306 with raw Marigold normal predicts vertical vanishing point near image bottom and contradicts observed upright stacks", "unbounded rear length fits with L/H about13 overfit source hull and are not physically credible" ] } }, "image": { "width": 1280, "height": 720, "uvConvention": "u right, v down, normalized source image coordinates", "referenceSource": "attempt_00001/chunk_000661.mp4", "referenceTimeSec": 39678.605, "priorReportReference": { "referenceSource": "attempt_00001/chunk_000631.mp4", "referenceTimeSec": 37860.223 }, "referenceFrame": 80, "referenceImageSha256": "5f35e17c5d5708b689283dab53014d4032cb4f7d9795b78087df0f5fbf420020", "referenceSourceSha256": "8c93c30c3411c8ca4bb0cf716365f8b564c7700bce78666abf48e5ffd43074c2" } } } } } }, "304": { "description": "Response unchanged (If-None-Match). No body." }, "400": { "description": "Invalid parameter, range or cursor.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "example": { "error": { "code": "invalid_parameter", "message": "Invalid parameter, range or cursor.", "field": null, "requestId": "request-id" } } } } }, "404": { "description": "Resource or route does not exist.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "example": { "error": { "code": "not_found", "message": "Resource or route does not exist.", "field": null, "requestId": "request-id" } } } } }, "405": { "description": "This API supports GET, HEAD and OPTIONS.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "example": { "error": { "code": "method_not_allowed", "message": "This API supports GET, HEAD and OPTIONS.", "field": null, "requestId": "request-id" } } } } }, "409": { "description": "Dataset changed; restart without the cursor.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "example": { "error": { "code": "stale_cursor", "message": "Dataset changed; restart without the cursor.", "field": null, "requestId": "request-id" } } } } }, "500": { "description": "Request could not be completed.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "example": { "error": { "code": "internal_error", "message": "Request could not be completed.", "field": null, "requestId": "request-id" } } } } } }, "x-codeSamples": [ { "lang": "Shell", "label": "curl", "source": "curl -sS 'https://outdoors.pdigger.com/api/v1/cameras/camera-01'" } ] } }, "/recordings": { "get": { "operationId": "get_recordings", "tags": [ "Scene & calendar" ], "summary": "Query recordings with cursor pagination", "description": "Executed by the read-only API service against the versioned, fully merged demo dataset. Lists are ordered by source start time then ID (observations), sample time then ID (track samples), or ID (other collections). Time ranges are inclusive. No live inference or all-day identity claim.", "parameters": [ { "in": "query", "name": "cameraId", "required": false, "description": "Exact, case-sensitive match.", "schema": { "type": "string", "maxLength": 160 } }, { "in": "query", "name": "sessionDate", "required": false, "description": "Verified recorder session date. This is not a claim of frame UTC.", "schema": { "type": "string", "format": "date" } }, { "in": "query", "name": "limit", "required": false, "description": "Page size. Follow links.next or pass page.nextCursor as cursor; retain all filters and the same limit.", "schema": { "type": "integer", "minimum": 1, "maximum": 100, "default": 20 } }, { "in": "query", "name": "cursor", "required": false, "description": "Opaque signed cursor returned by the previous page. It is bound to the dataset revision, endpoint, filters, ordering and limit. Not an authentication credential.", "schema": { "type": "string", "maxLength": 2048 } } ], "responses": { "200": { "description": "Query result from recorded demo observations.", "headers": { "ETag": { "schema": { "type": "string" }, "description": "Strong response validator. Send If-None-Match to receive 304 when unchanged." }, "Link": { "schema": { "type": "string" }, "description": "Next page URL with rel=\"next\", when available." }, "X-Request-Id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/recordingsPage" }, "example": { "schemaVersion": "2.0.0", "datasetId": "pdigger-outdoors-v15", "demo": true, "sourceVersion": 15, "sourceCommit": "5f322b5ad3ecfce4aff5b5609456716099b28f62", "clock": "source_elapsed_seconds", "frameUtcVerified": false, "partialCoverage": true, "datasetRevision": "5318d837e37e1219e3ec72baf438cf1423a40fe7ea120f8567a8484c8527402f", "mode": "recorded_demo", "data": [ { "id": "recovered_native_elapsed", "label": "Bean receiving · recorder session 27 October 2026", "captureDateVerified": false, "captureStartISO": null, "sessionStartVerified": true, "sessionStartISO": "2026-10-27T05:59:06.889652+00:00", "sessionClock": "Recorder host UTC, not camera frame UTC", "sourceStartSec": 0, "sourceEndSec": 86161.848333, "captureComplete": false, "coverageNote": "One recovered recording. Session-start date is verified; footage is not UTC-aligned. Reviewed observations are partial coverage, not a complete daily census.", "provenance": { "csvClockNotUTC": true, "reviewedUTC": "2026-11-02T05:22:00Z" }, "cameraId": "camera-01", "elapsedClock": { "id": "recovered_native_elapsed", "startSec": 0, "durationSec": 86161.848333, "durationLabel": "23:56:01.848", "notUTC": true, "captureComplete": false, "sourceChunks": 1437, "sourceFrames": 375843, "meaning": "Recovered native-video elapsed clock; interrupted end. Not proven continuous24h.", "nativeTimelineSha256": "930ac833b400c22a1ec61fd590e0aa882d9fec0ddc1d53e3bbf6416203c53e87" } } ], "page": { "limit": 2, "returned": 1, "total": 1, "hasMore": false, "nextCursor": null }, "links": { "self": "/api/v1/recordings?limit=2", "next": null } } } } }, "304": { "description": "Response unchanged (If-None-Match). No body." }, "400": { "description": "Invalid parameter, range or cursor.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "example": { "error": { "code": "invalid_parameter", "message": "Invalid parameter, range or cursor.", "field": null, "requestId": "request-id" } } } } }, "404": { "description": "Resource or route does not exist.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "example": { "error": { "code": "not_found", "message": "Resource or route does not exist.", "field": null, "requestId": "request-id" } } } } }, "405": { "description": "This API supports GET, HEAD and OPTIONS.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "example": { "error": { "code": "method_not_allowed", "message": "This API supports GET, HEAD and OPTIONS.", "field": null, "requestId": "request-id" } } } } }, "409": { "description": "Dataset changed; restart without the cursor.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "example": { "error": { "code": "stale_cursor", "message": "Dataset changed; restart without the cursor.", "field": null, "requestId": "request-id" } } } } }, "500": { "description": "Request could not be completed.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "example": { "error": { "code": "internal_error", "message": "Request could not be completed.", "field": null, "requestId": "request-id" } } } } } }, "x-codeSamples": [ { "lang": "Shell", "label": "curl", "source": "curl -sS 'https://outdoors.pdigger.com/api/v1/recordings?limit=2'" } ] } }, "/recordings/{id}": { "get": { "operationId": "get_recordings_id_", "tags": [ "Observations" ], "summary": "Get one recording", "description": "Executed by the read-only API service against the versioned, fully merged demo dataset. Lists are ordered by source start time then ID (observations), sample time then ID (track samples), or ID (other collections). Time ranges are inclusive. No live inference or all-day identity claim.", "parameters": [ { "in": "path", "name": "id", "required": true, "schema": { "type": "string" }, "example": "recovered_native_elapsed" } ], "responses": { "200": { "description": "Query result from recorded demo observations.", "headers": { "ETag": { "schema": { "type": "string" }, "description": "Strong response validator. Send If-None-Match to receive 304 when unchanged." }, "Link": { "schema": { "type": "string" }, "description": "Next page URL with rel=\"next\", when available." }, "X-Request-Id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "type": "object", "required": [ "schemaVersion", "datasetId", "datasetRevision", "demo", "mode", "data" ], "properties": { "schemaVersion": { "type": "string", "enum": [ "2.0.0" ] }, "datasetId": { "type": "string" }, "datasetRevision": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "demo": { "type": "boolean", "enum": [ true ] }, "mode": { "type": "string", "enum": [ "recorded_demo" ] }, "sourceVersion": { "type": "integer" }, "sourceCommit": { "type": "string" }, "clock": { "type": "string", "enum": [ "source_elapsed_seconds" ] }, "frameUtcVerified": { "type": "boolean", "enum": [ false ] }, "partialCoverage": { "type": "boolean", "enum": [ true ] }, "data": { "$ref": "#/components/schemas/Recording" } } }, "example": { "schemaVersion": "2.0.0", "datasetId": "pdigger-outdoors-v15", "demo": true, "sourceVersion": 15, "sourceCommit": "5f322b5ad3ecfce4aff5b5609456716099b28f62", "clock": "source_elapsed_seconds", "frameUtcVerified": false, "partialCoverage": true, "datasetRevision": "5318d837e37e1219e3ec72baf438cf1423a40fe7ea120f8567a8484c8527402f", "mode": "recorded_demo", "data": { "id": "recovered_native_elapsed", "label": "Bean receiving · recorder session 27 October 2026", "captureDateVerified": false, "captureStartISO": null, "sessionStartVerified": true, "sessionStartISO": "2026-10-27T05:59:06.889652+00:00", "sessionClock": "Recorder host UTC, not camera frame UTC", "sourceStartSec": 0, "sourceEndSec": 86161.848333, "captureComplete": false, "coverageNote": "One recovered recording. Session-start date is verified; footage is not UTC-aligned. Reviewed observations are partial coverage, not a complete daily census.", "provenance": { "csvClockNotUTC": true, "reviewedUTC": "2026-11-02T05:22:00Z" }, "cameraId": "camera-01", "elapsedClock": { "id": "recovered_native_elapsed", "startSec": 0, "durationSec": 86161.848333, "durationLabel": "23:56:01.848", "notUTC": true, "captureComplete": false, "sourceChunks": 1437, "sourceFrames": 375843, "meaning": "Recovered native-video elapsed clock; interrupted end. Not proven continuous24h.", "nativeTimelineSha256": "930ac833b400c22a1ec61fd590e0aa882d9fec0ddc1d53e3bbf6416203c53e87" } } } } } }, "304": { "description": "Response unchanged (If-None-Match). No body." }, "400": { "description": "Invalid parameter, range or cursor.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "example": { "error": { "code": "invalid_parameter", "message": "Invalid parameter, range or cursor.", "field": null, "requestId": "request-id" } } } } }, "404": { "description": "Resource or route does not exist.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "example": { "error": { "code": "not_found", "message": "Resource or route does not exist.", "field": null, "requestId": "request-id" } } } } }, "405": { "description": "This API supports GET, HEAD and OPTIONS.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "example": { "error": { "code": "method_not_allowed", "message": "This API supports GET, HEAD and OPTIONS.", "field": null, "requestId": "request-id" } } } } }, "409": { "description": "Dataset changed; restart without the cursor.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "example": { "error": { "code": "stale_cursor", "message": "Dataset changed; restart without the cursor.", "field": null, "requestId": "request-id" } } } } }, "500": { "description": "Request could not be completed.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "example": { "error": { "code": "internal_error", "message": "Request could not be completed.", "field": null, "requestId": "request-id" } } } } } }, "x-codeSamples": [ { "lang": "Shell", "label": "curl", "source": "curl -sS 'https://outdoors.pdigger.com/api/v1/recordings/recovered_native_elapsed'" } ] } }, "/assets": { "get": { "operationId": "get_assets", "tags": [ "Scene & calendar" ], "summary": "Query assets with cursor pagination", "description": "Executed by the read-only API service against the versioned, fully merged demo dataset. Lists are ordered by source start time then ID (observations), sample time then ID (track samples), or ID (other collections). Time ranges are inclusive. No live inference or all-day identity claim.", "parameters": [ { "in": "query", "name": "kind", "required": false, "description": "Exact, case-sensitive match.", "schema": { "type": "string", "maxLength": 160 } }, { "in": "query", "name": "limit", "required": false, "description": "Page size. Follow links.next or pass page.nextCursor as cursor; retain all filters and the same limit.", "schema": { "type": "integer", "minimum": 1, "maximum": 100, "default": 20 } }, { "in": "query", "name": "cursor", "required": false, "description": "Opaque signed cursor returned by the previous page. It is bound to the dataset revision, endpoint, filters, ordering and limit. Not an authentication credential.", "schema": { "type": "string", "maxLength": 2048 } } ], "responses": { "200": { "description": "Query result from recorded demo observations.", "headers": { "ETag": { "schema": { "type": "string" }, "description": "Strong response validator. Send If-None-Match to receive 304 when unchanged." }, "Link": { "schema": { "type": "string" }, "description": "Next page URL with rel=\"next\", when available." }, "X-Request-Id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/assetsPage" }, "example": { "schemaVersion": "2.0.0", "datasetId": "pdigger-outdoors-v15", "demo": true, "sourceVersion": 15, "sourceCommit": "5f322b5ad3ecfce4aff5b5609456716099b28f62", "clock": "source_elapsed_seconds", "frameUtcVerified": false, "partialCoverage": true, "datasetRevision": "5318d837e37e1219e3ec72baf438cf1423a40fe7ea120f8567a8484c8527402f", "mode": "recorded_demo", "data": [ { "id": "assets/associations/near-camera/independent-qa.json", "url": "/demo/assets/associations/near-camera/independent-qa.json", "kind": "json", "bytes": 14499, "sha256": "c524d7a85be8d35059081ab3c2cf82f875a0ade83e4c119e9507a4cff9758b55" }, { "id": "assets/associations/near-camera/source-review.json", "url": "/demo/assets/associations/near-camera/source-review.json", "kind": "json", "bytes": 112395, "sha256": "c93b48c149cf571c949745cb9b17530e0c634641821cb6b2c93ea5f61fd2ad3d" } ], "page": { "limit": 2, "returned": 2, "total": 249, "hasMore": true, "nextCursor": "eyJ2IjoxLCJkIjoiNTMxOGQ4MzdlMzdlMTIxOWUzZWM3MmJhZjQzOGNmMTQyM2E0MGZlN2VhMTIwZjg1NjdhODQ4NGM4NTI3NDAyZiIsInEiOiIyYmYzYzY4ZDQ0NzNlNWVhYmNlOGY3NWM5MmNlOGRiMjdmMjc3MzE0MTBlMjllN2E4M2EyM2I1N2RlZWQzODIwIiwiayI6WyJhc3NldHMvYXNzb2NpYXRpb25zL25lYXItY2FtZXJhL3NvdXJjZS1yZXZpZXcuanNvbiJdfQ.NlMzuJ6EaHjByISmqRIbRyGlunu5t3GUL_tKm06h8KQ" }, "links": { "self": "/api/v1/assets?limit=2", "next": "/api/v1/assets?limit=2&cursor=eyJ2IjoxLCJkIjoiNTMxOGQ4MzdlMzdlMTIxOWUzZWM3MmJhZjQzOGNmMTQyM2E0MGZlN2VhMTIwZjg1NjdhODQ4NGM4NTI3NDAyZiIsInEiOiIyYmYzYzY4ZDQ0NzNlNWVhYmNlOGY3NWM5MmNlOGRiMjdmMjc3MzE0MTBlMjllN2E4M2EyM2I1N2RlZWQzODIwIiwiayI6WyJhc3NldHMvYXNzb2NpYXRpb25zL25lYXItY2FtZXJhL3NvdXJjZS1yZXZpZXcuanNvbiJdfQ.NlMzuJ6EaHjByISmqRIbRyGlunu5t3GUL_tKm06h8KQ" } } } } }, "304": { "description": "Response unchanged (If-None-Match). No body." }, "400": { "description": "Invalid parameter, range or cursor.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "example": { "error": { "code": "invalid_parameter", "message": "Invalid parameter, range or cursor.", "field": null, "requestId": "request-id" } } } } }, "404": { "description": "Resource or route does not exist.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "example": { "error": { "code": "not_found", "message": "Resource or route does not exist.", "field": null, "requestId": "request-id" } } } } }, "405": { "description": "This API supports GET, HEAD and OPTIONS.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "example": { "error": { "code": "method_not_allowed", "message": "This API supports GET, HEAD and OPTIONS.", "field": null, "requestId": "request-id" } } } } }, "409": { "description": "Dataset changed; restart without the cursor.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "example": { "error": { "code": "stale_cursor", "message": "Dataset changed; restart without the cursor.", "field": null, "requestId": "request-id" } } } } }, "500": { "description": "Request could not be completed.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "example": { "error": { "code": "internal_error", "message": "Request could not be completed.", "field": null, "requestId": "request-id" } } } } } }, "x-codeSamples": [ { "lang": "Shell", "label": "curl", "source": "curl -sS 'https://outdoors.pdigger.com/api/v1/assets?limit=2'" } ] } }, "/assets/{id}": { "get": { "operationId": "get_assets_id_", "tags": [ "Observations" ], "summary": "Get one asset", "description": "Executed by the read-only API service against the versioned, fully merged demo dataset. Lists are ordered by source start time then ID (observations), sample time then ID (track samples), or ID (other collections). Time ranges are inclusive. No live inference or all-day identity claim.", "parameters": [ { "in": "path", "name": "id", "required": true, "schema": { "type": "string" }, "example": "assets/associations/near-camera/independent-qa.json" } ], "responses": { "200": { "description": "Query result from recorded demo observations.", "headers": { "ETag": { "schema": { "type": "string" }, "description": "Strong response validator. Send If-None-Match to receive 304 when unchanged." }, "Link": { "schema": { "type": "string" }, "description": "Next page URL with rel=\"next\", when available." }, "X-Request-Id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "type": "object", "required": [ "schemaVersion", "datasetId", "datasetRevision", "demo", "mode", "data" ], "properties": { "schemaVersion": { "type": "string", "enum": [ "2.0.0" ] }, "datasetId": { "type": "string" }, "datasetRevision": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "demo": { "type": "boolean", "enum": [ true ] }, "mode": { "type": "string", "enum": [ "recorded_demo" ] }, "sourceVersion": { "type": "integer" }, "sourceCommit": { "type": "string" }, "clock": { "type": "string", "enum": [ "source_elapsed_seconds" ] }, "frameUtcVerified": { "type": "boolean", "enum": [ false ] }, "partialCoverage": { "type": "boolean", "enum": [ true ] }, "data": { "$ref": "#/components/schemas/Asset" } } }, "example": { "schemaVersion": "2.0.0", "datasetId": "pdigger-outdoors-v15", "demo": true, "sourceVersion": 15, "sourceCommit": "5f322b5ad3ecfce4aff5b5609456716099b28f62", "clock": "source_elapsed_seconds", "frameUtcVerified": false, "partialCoverage": true, "datasetRevision": "5318d837e37e1219e3ec72baf438cf1423a40fe7ea120f8567a8484c8527402f", "mode": "recorded_demo", "data": { "id": "assets/associations/near-camera/independent-qa.json", "url": "/demo/assets/associations/near-camera/independent-qa.json", "kind": "json", "bytes": 14499, "sha256": "c524d7a85be8d35059081ab3c2cf82f875a0ade83e4c119e9507a4cff9758b55" } } } } }, "304": { "description": "Response unchanged (If-None-Match). No body." }, "400": { "description": "Invalid parameter, range or cursor.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "example": { "error": { "code": "invalid_parameter", "message": "Invalid parameter, range or cursor.", "field": null, "requestId": "request-id" } } } } }, "404": { "description": "Resource or route does not exist.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "example": { "error": { "code": "not_found", "message": "Resource or route does not exist.", "field": null, "requestId": "request-id" } } } } }, "405": { "description": "This API supports GET, HEAD and OPTIONS.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "example": { "error": { "code": "method_not_allowed", "message": "This API supports GET, HEAD and OPTIONS.", "field": null, "requestId": "request-id" } } } } }, "409": { "description": "Dataset changed; restart without the cursor.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "example": { "error": { "code": "stale_cursor", "message": "Dataset changed; restart without the cursor.", "field": null, "requestId": "request-id" } } } } }, "500": { "description": "Request could not be completed.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "example": { "error": { "code": "internal_error", "message": "Request could not be completed.", "field": null, "requestId": "request-id" } } } } } }, "x-codeSamples": [ { "lang": "Shell", "label": "curl", "source": "curl -sS 'https://outdoors.pdigger.com/api/v1/assets/assets%2Fassociations%2Fnear-camera%2Findependent-qa.json'" } ] } }, "/calendar": { "get": { "operationId": "get_calendar", "tags": [ "Scene & calendar" ], "summary": "Get calendar", "description": "Executed by the read-only API service against the versioned, fully merged demo dataset. Lists are ordered by source start time then ID (observations), sample time then ID (track samples), or ID (other collections). Time ranges are inclusive. No live inference or all-day identity claim.", "parameters": [], "responses": { "200": { "description": "Query result from recorded demo observations.", "headers": { "ETag": { "schema": { "type": "string" }, "description": "Strong response validator. Send If-None-Match to receive 304 when unchanged." }, "Link": { "schema": { "type": "string" }, "description": "Next page URL with rel=\"next\", when available." }, "X-Request-Id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "type": "object", "required": [ "schemaVersion", "datasetId", "datasetRevision", "demo", "mode", "data" ], "properties": { "schemaVersion": { "type": "string", "enum": [ "2.0.0" ] }, "datasetId": { "type": "string" }, "datasetRevision": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "demo": { "type": "boolean", "enum": [ true ] }, "mode": { "type": "string", "enum": [ "recorded_demo" ] }, "sourceVersion": { "type": "integer" }, "sourceCommit": { "type": "string" }, "clock": { "type": "string", "enum": [ "source_elapsed_seconds" ] }, "frameUtcVerified": { "type": "boolean", "enum": [ false ] }, "partialCoverage": { "type": "boolean", "enum": [ true ] }, "data": { "type": "object", "properties": { "schema": { "type": "string" }, "recordings": { "type": "array", "items": { "$ref": "#/components/schemas/Recording" } }, "anchorStatus": { "type": "string" } }, "required": [ "recordings", "anchorStatus" ] } } }, "example": { "schemaVersion": "2.0.0", "datasetId": "pdigger-outdoors-v15", "demo": true, "sourceVersion": 15, "sourceCommit": "5f322b5ad3ecfce4aff5b5609456716099b28f62", "clock": "source_elapsed_seconds", "frameUtcVerified": false, "partialCoverage": true, "datasetRevision": "5318d837e37e1219e3ec72baf438cf1423a40fe7ea120f8567a8484c8527402f", "mode": "recorded_demo", "data": { "schema": "bean.recording_calendar.v1", "recordings": [ { "id": "recovered_native_elapsed", "label": "Bean receiving · recorder session 27 October 2026", "captureDateVerified": false, "captureStartISO": null, "sessionStartVerified": true, "sessionStartISO": "2026-10-27T05:59:06.889652+00:00", "sessionClock": "Recorder host UTC, not camera frame UTC", "sourceStartSec": 0, "sourceEndSec": 86161.848333, "captureComplete": false, "coverageNote": "One recovered recording. Session-start date is verified; footage is not UTC-aligned. Reviewed observations are partial coverage, not a complete daily census.", "provenance": { "csvClockNotUTC": true, "reviewedUTC": "2026-11-02T05:22:00Z" } } ], "anchorStatus": "verified_recorder_session_date_only_frame_clock_unaligned" } } } } }, "304": { "description": "Response unchanged (If-None-Match). No body." }, "400": { "description": "Invalid parameter, range or cursor.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "example": { "error": { "code": "invalid_parameter", "message": "Invalid parameter, range or cursor.", "field": null, "requestId": "request-id" } } } } }, "404": { "description": "Resource or route does not exist.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "example": { "error": { "code": "not_found", "message": "Resource or route does not exist.", "field": null, "requestId": "request-id" } } } } }, "405": { "description": "This API supports GET, HEAD and OPTIONS.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "example": { "error": { "code": "method_not_allowed", "message": "This API supports GET, HEAD and OPTIONS.", "field": null, "requestId": "request-id" } } } } }, "409": { "description": "Dataset changed; restart without the cursor.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "example": { "error": { "code": "stale_cursor", "message": "Dataset changed; restart without the cursor.", "field": null, "requestId": "request-id" } } } } }, "500": { "description": "Request could not be completed.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "example": { "error": { "code": "internal_error", "message": "Request could not be completed.", "field": null, "requestId": "request-id" } } } } } }, "x-codeSamples": [ { "lang": "Shell", "label": "curl", "source": "curl -sS 'https://outdoors.pdigger.com/api/v1/calendar'" } ] } }, "/summary": { "get": { "operationId": "get_summary", "tags": [ "Overview" ], "summary": "Query activity counts and coverage", "description": "Executed by the read-only API service against the versioned, fully merged demo dataset. Lists are ordered by source start time then ID (observations), sample time then ID (track samples), or ID (other collections). Time ranges are inclusive. No live inference or all-day identity claim.", "parameters": [ { "in": "query", "name": "cameraId", "required": false, "description": "Exact, case-sensitive match.", "schema": { "type": "string", "maxLength": 160 } }, { "in": "query", "name": "recordingId", "required": false, "description": "Exact, case-sensitive match.", "schema": { "type": "string", "maxLength": 160 } }, { "in": "query", "name": "typeId", "required": false, "description": "Exact, case-sensitive match.", "schema": { "type": "string", "enum": [ "skid_steer", "utv", "human", "semi_trailer", "pickup", "wheel_loader" ] } }, { "in": "query", "name": "categoryId", "required": false, "description": "Exact, case-sensitive match.", "schema": { "type": "string", "enum": [ "mobile_machinery", "person", "road_vehicle", "light_vehicles" ] } }, { "in": "query", "name": "actionId", "required": false, "description": "Exact, case-sensitive match.", "schema": { "type": "string", "maxLength": 160 } }, { "in": "query", "name": "recordKind", "required": false, "description": "Use reviewed_event for reviewed activity counts; other records are contextual or isolated observations.", "schema": { "type": "string", "enum": [ "reviewed_event", "context", "isolated_observation" ] } }, { "in": "query", "name": "loadState", "required": false, "description": "Exact, case-sensitive match.", "schema": { "type": "string", "enum": [ "loaded", "empty", "not_established" ] } }, { "in": "query", "name": "cameraDirection", "required": false, "description": "Exact, case-sensitive match.", "schema": { "type": "string", "maxLength": 160 } }, { "in": "query", "name": "fromSec", "required": false, "description": "Inclusive source elapsed seconds. Event queries match intervals overlapping this bound; sample queries match sample times.", "schema": { "type": "number", "minimum": 0 } }, { "in": "query", "name": "toSec", "required": false, "description": "Inclusive source elapsed seconds. Must be at least fromSec.", "schema": { "type": "number", "minimum": 0 } } ], "responses": { "200": { "description": "Query result from recorded demo observations.", "headers": { "ETag": { "schema": { "type": "string" }, "description": "Strong response validator. Send If-None-Match to receive 304 when unchanged." }, "Link": { "schema": { "type": "string" }, "description": "Next page URL with rel=\"next\", when available." }, "X-Request-Id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "type": "object", "required": [ "schemaVersion", "datasetId", "datasetRevision", "demo", "mode", "data" ], "properties": { "schemaVersion": { "type": "string", "enum": [ "2.0.0" ] }, "datasetId": { "type": "string" }, "datasetRevision": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "demo": { "type": "boolean", "enum": [ true ] }, "mode": { "type": "string", "enum": [ "recorded_demo" ] }, "sourceVersion": { "type": "integer" }, "sourceCommit": { "type": "string" }, "clock": { "type": "string", "enum": [ "source_elapsed_seconds" ] }, "frameUtcVerified": { "type": "boolean", "enum": [ false ] }, "partialCoverage": { "type": "boolean", "enum": [ true ] }, "data": { "type": "object", "required": [ "acceptedEvents", "displayRecords", "coverage" ], "properties": { "acceptedEvents": { "type": "integer" }, "roadVehicleEvents": { "type": "integer" }, "machineryEvents": { "type": "integer" }, "humanEvents": { "type": "integer" }, "displayRecords": { "type": "integer" }, "uniqueVehicleCount": { "type": "number", "nullable": true }, "uniqueHumanCount": { "type": "number", "nullable": true }, "coverage": { "type": "object", "additionalProperties": true }, "durationSec": { "type": "number" } } } } }, "example": { "schemaVersion": "2.0.0", "datasetId": "pdigger-outdoors-v15", "demo": true, "sourceVersion": 15, "sourceCommit": "5f322b5ad3ecfce4aff5b5609456716099b28f62", "clock": "source_elapsed_seconds", "frameUtcVerified": false, "partialCoverage": true, "datasetRevision": "5318d837e37e1219e3ec72baf438cf1423a40fe7ea120f8567a8484c8527402f", "mode": "recorded_demo", "data": { "acceptedEvents": 38, "roadVehicleEvents": 17, "machineryEvents": 15, "humanEvents": 6, "displayRecords": 50, "uniqueVehicleCount": null, "uniqueHumanCount": null, "coverage": { "acceptedEvents": 38, "roadEvents": 17, "machineryEvents": 15, "humanEvents": 6, "sampledPathEvents": 20, "markerOnlyEvents": 14, "noCoordinateEvents": 4, "coordinateObservations": 879, "bboxObservations": 871, "manualLandmarkObservations": 8, "fullDayRecall": "not established", "uniqueObjects": "not established", "isolatedMeshObservationCount": 3 }, "durationSec": 86161.848333, "appliedFilters": {} } } } } }, "304": { "description": "Response unchanged (If-None-Match). No body." }, "400": { "description": "Invalid parameter, range or cursor.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "example": { "error": { "code": "invalid_parameter", "message": "Invalid parameter, range or cursor.", "field": null, "requestId": "request-id" } } } } }, "404": { "description": "Resource or route does not exist.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "example": { "error": { "code": "not_found", "message": "Resource or route does not exist.", "field": null, "requestId": "request-id" } } } } }, "405": { "description": "This API supports GET, HEAD and OPTIONS.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "example": { "error": { "code": "method_not_allowed", "message": "This API supports GET, HEAD and OPTIONS.", "field": null, "requestId": "request-id" } } } } }, "409": { "description": "Dataset changed; restart without the cursor.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "example": { "error": { "code": "stale_cursor", "message": "Dataset changed; restart without the cursor.", "field": null, "requestId": "request-id" } } } } }, "500": { "description": "Request could not be completed.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "example": { "error": { "code": "internal_error", "message": "Request could not be completed.", "field": null, "requestId": "request-id" } } } } } }, "x-codeSamples": [ { "lang": "Shell", "label": "curl", "source": "curl -sS 'https://outdoors.pdigger.com/api/v1/summary'" } ] } }, "/scene": { "get": { "operationId": "get_scene", "tags": [ "Scene & calendar" ], "summary": "Get scene", "description": "Executed by the read-only API service against the versioned, fully merged demo dataset. Lists are ordered by source start time then ID (observations), sample time then ID (track samples), or ID (other collections). Time ranges are inclusive. No live inference or all-day identity claim.", "parameters": [], "responses": { "200": { "description": "Query result from recorded demo observations.", "headers": { "ETag": { "schema": { "type": "string" }, "description": "Strong response validator. Send If-None-Match to receive 304 when unchanged." }, "Link": { "schema": { "type": "string" }, "description": "Next page URL with rel=\"next\", when available." }, "X-Request-Id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "type": "object", "required": [ "schemaVersion", "datasetId", "datasetRevision", "demo", "mode", "data" ], "properties": { "schemaVersion": { "type": "string", "enum": [ "2.0.0" ] }, "datasetId": { "type": "string" }, "datasetRevision": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "demo": { "type": "boolean", "enum": [ true ] }, "mode": { "type": "string", "enum": [ "recorded_demo" ] }, "sourceVersion": { "type": "integer" }, "sourceCommit": { "type": "string" }, "clock": { "type": "string", "enum": [ "source_elapsed_seconds" ] }, "frameUtcVerified": { "type": "boolean", "enum": [ false ] }, "partialCoverage": { "type": "boolean", "enum": [ true ] }, "data": { "type": "object", "additionalProperties": true } } }, "example": { "schemaVersion": "2.0.0", "datasetId": "pdigger-outdoors-v15", "demo": true, "sourceVersion": 15, "sourceCommit": "5f322b5ad3ecfce4aff5b5609456716099b28f62", "clock": "source_elapsed_seconds", "frameUtcVerified": false, "partialCoverage": true, "datasetRevision": "5318d837e37e1219e3ec72baf438cf1423a40fe7ea120f8567a8484c8527402f", "mode": "recorded_demo", "data": { "cameraId": "camera-01", "world": { "schema": "bean.static-world.refined.release_v4", "status": "complete_inferred_relative_geometry_with_perspective_refinement", "source": { "schema": "bean.empty_static_frame.v1", "selection": "single observed frame, not temporal composite", "source_chunk": "attempt_00001/chunk_000661.mp4", "source_sha256": "8c93c30c3411c8ca4bb0cf716365f8b564c7700bce78666abf48e5ffd43074c2", "source_frame_zero_based": 80, "source_local_pts_seconds": 18.407, "native_joined_offset_seconds": 39660.198, "native_joined_elapsed_seconds": 39678.605, "native_joined_elapsed_hms": "11:01:18.605", "clock": "elapsed source media time; not UTC", "width": 1280, "height": 720, "frame_sha256": "5f35e17c5d5708b689283dab53014d4032cb4f7d9795b78087df0f5fbf420020", "visual_review": "No visible active road vehicles or pedestrians; stationary railcars and silos remain. Single frame manually reviewed at1280x720. Not a semantic guarantee for distant subpixel objects.", "image_manipulation": "Unchanged ffmpeg decode from actual frame. No inpainting, generative editing, blending or resampling.", "portable_reproduction_command": "ffmpeg -i chunk_000661.mp4 -vf \"select='eq(n,80)'\" -vsync 0 -frames:v 1 empty_world.png" }, "model": { "schema": "bean.marigold-v2.inference.v1", "status": "complete", "started_utc": "2026-10-29T00:16:21Z", "source_sha256": "5f35e17c5d5708b689283dab53014d4032cb4f7d9795b78087df0f5fbf420020", "input_dimensions": [ 1280, 720 ], "official_repository": "https://github.com/huawei-bayerlab/marigold-v2", "code_commit": "9926d93b0780de5f64bee20895b25a56a98ffbf8", "model_revisions": { "Qwen/Qwen-Image-Edit-2509": "d3968ef930e841f4c73640fb8afa3b306a78167e", "huawei-bayerlab/marigold-v2-0": "cdf9810fb690886391a63aec012b5f501064fb0d" }, "python": "3.13.16 (main, Oct 1 2026, 15:40:24) [GCC 13.3.0]", "torch": "2.11.0+cu130", "cuda": "13.0", "gpu": "NVIDIA RTX PRO 6000 Blackwell Server Edition", "seed": 2025, "modalities": { "depth": { "command": [ "/content/bean_world_marigold/venv/bin/python", "scripts/infer.py", "--modality", "depth", "--image_dir", "/content/bean_world_marigold/input", "--output_dir", "/content/bean_world_outputs/depth", "--seed", "2025" ], "seconds": 33.861048460006714, "prediction": "depth/images/predictions_npy/empty_world.npy", "sha256": "852b2198004b7196672a6019b68a3d548eac836234765e0dafe3f4b44a6a23f3", "shape": [ 720, 1280 ], "min": -1, "max": 1 }, "normals": { "command": [ "/content/bean_world_marigold/venv/bin/python", "scripts/infer.py", "--modality", "normals", "--image_dir", "/content/bean_world_marigold/input", "--output_dir", "/content/bean_world_outputs/normals", "--seed", "2025" ], "seconds": 17.661229848861694, "prediction": "normals/images/predictions_npy/empty_world.npy", "sha256": "35c0cd2e167dc4a05e2e7c2db91885e1cbb0abcf9551cf46d085a524abcc00e6", "shape": [ 3, 720, 1280 ], "min": -0.99609375, "max": 1, "unit_norm_mean": 1.0000156164169312 } }, "depth_semantics": "Affine-invariant log depth, not meters or linear z. not established multiplicative scale and additive shift in log-depth parameterization.", "normal_semantics": "Camera-space unit vectors, official MarigoldV2 normals checkpoint.", "input_semantics": "Single unchanged observed source frame, no moving foreground visible; parked railcars remain.", "completed_utc": "2026-10-29T00:19:18Z" }, "assets": { "mesh": "world.glb", "texture": "texture.jpg", "reference": "reference.png", "camera": "camera.json", "projection": "projection.json", "track_projection": "projected_tracks.json", "depth_preview": "depth_relative_log_16.png", "normals_preview": "normals_camera.png", "surface_mask": "valid_surface_mask.png", "road_mask": "road_fit_mask.png" }, "mesh": { "vertices": 51671, "triangles": 100530, "grid_stride_pixels": 4, "depth_jump_threshold_fraction": 0.12, "normal_jump_threshold_degrees": 55, "normal_jump_requires_depth_jump_fraction": 0.03, "unobserved_surfaces_completed": false, "texture": "Actual unchanged observed frame saved asJPEG, perspectiveUV; no generated colors", "mesh_bounds_relative": { "min": [ -33.75295639038086, -4.0260090827941895, -310.92950439453125 ], "max": [ 52.85633087158203, 116.03277587890625, -2.5961616039276123 ] } }, "camera": { "schema": "bean.camera.relative.v1", "coordinate_system": "+X image right, +Y image up, -Z camera forward; camera atorigin", "position": [ 0, 0, 0 ], "target": [ 0, 0, -1 ], "up": [ 0, 1, 0 ], "orbit_up": [ -0.09011274034171156, 0.9391225629783461, 0.3315546798540018 ], "orbit_target": [ 1.9229033279991516, -0.7047745229318159, -12.100791613544434 ], "orbit_position": [ 6.922903327999151, 2.2952254770681844, -1.100791613544434 ], "image_width": 1280, "image_height": 720, "fx": 695.3742571593541, "fy": 695.3742571593541, "cx": 639.5, "cy": 359.5, "fov_y_degrees": 54.74182223336583, "aspect": 1.7777777777777777, "near": 0.05, "far": 1000, "estimated": true, "calibrated": false, "lens_model": "approximate pinhole; visible wide-angle barrel distortion NOT calibrated or rectified", "lens_distortion": { "coefficients": null, "calibrated": false, "wide_angle_barrel_distortion_visible": true }, "source_orientation_estimate": { "image_up_clockwise_tilt_degrees": -5.480989409980479, "downward_pitch_degrees": 19.36316541907975, "height_above_estimated_road_relative_units": 4.847221834004483, "source": "image-perspective road-plane refinement, not surveyed camera pose" }, "physical_camera_pose": null, "physical_camera_height_m": null, "meters_per_unit": null, "log_depth_to_z": { "formula": "z=10*exp(alpha*(raw_log_depth-center))", "alpha": 1.1742178226598412, "center": -0.0419921875, "median_road_z_relative_units": 10, "arbitrary_similarity_scale": true }, "fit": { "method": "robust angular consistency between Marigold depth gradients and independently predicted Marigold camera normals", "pixel_count": 20000, "median_angle_degrees": 9.205952891135224, "p90_angle_degrees": 26.25030723119412, "focal_bound_pixels": [ 300, 1800 ], "not_independent_validation": true, "bound_limited": false, "parameter_intervals_are_not_statistical_confidence": true }, "ground_plane": { "normal": [ -0.09011274034171156, 0.9391225629783461, 0.3315546798540018 ], "constant": 4.847221834004483, "equation": "dot(normal, point) + constant = 0", "fit_roi": "road_fit_mask.png", "estimated": true, "units": "relative", "rms_relative_units": null, "median_abs_relative_units": null, "normal_model_median": [ -0.054290124250490235, 0.747742978162053, 0.661765079932607 ], "source": "robust untruncated same-event apparent-height constraints + observed road horizon; explicit plane approximation", "plane_support_points": 32530 }, "warnings": [ "Single-image reconstruction is a 2.5D visible-surface mesh, not a full surveyed scene.", "Depth is affine-invariant in logspace; chosen transform and size units are estimates, not physical dimensions.", "No known dimension or camera metadata available: metric sizes and height cannot be recovered.", "Wide-angle lens distortion is visible and uncalibrated; road positions and camera intrinsics are approximate.", "Occluded backsides and sky remain missing; do not close holes or bridge depth discontinuities.", "Derived road-plane refinement replaces inconsistent monocular depth perspective; structures remain inferred and are not surveyed.", "Residual wide-angle distortion remains uncalibrated. Source-body alignment is approximate; camera-normal consistency is not survey calibration." ], "refinement": { "schema": "bean.world_refinement.v1", "method": "Reviewed road rays intersect one estimated horizon-consistent plane; nearest-road smooth log-depth correction extended to adjacent nonroad surfaces, preserving Marigold local shape and all source image UVs.", "horizonCenterPixels": 114, "horizonSlopePixelsPerXPixel": -0.0959541852087195, "horizonSensitivityRangePixels": [ 94, 134 ], "notStatisticalConfidence": true, "constraints": [ { "eventId": "V02", "unclippedSamples": 17, "robustHeightRegressionHorizonCenter": 111.22549805912243 }, { "eventId": "V09", "unclippedSamples": 33, "robustHeightRegressionHorizonCenter": 117.16127275141837 } ], "rejectedConstraint": { "eventId": "V08", "reason": "turning/full-vs-cab box aspect changes violate constant apparent-height assumption" }, "originalGroundPlane": { "normal": [ -0.07470200832793479, 0.7785174577371796, 0.6231614381123175 ], "constant": 7.2569284413026995, "equation": "dot(normal, point) + constant = 0", "fit_roi": "road_fit_mask.png", "estimated": true, "units": "relative", "rms_relative_units": 0.18039678578762114, "median_abs_relative_units": 0.12838913803128005, "normal_model_median": [ -0.054290124250490235, 0.747742978162053, 0.661765079932607 ], "source": "robust plane fit to inferred depth, orientation checked with predicted road normals", "plane_support_points": 32530 }, "gauge": "preserve original plane depth at source pixel(639.5,500); arbitrary relative units", "roadConstraintPixels": 522513, "normalConventionVerified": "+X image right,+Y image up,+Z viewer; no axes conversion bug", "normalConventionSource": "https://huggingface.co/docs/diffusers/main/en/using-diffusers/marigold_usage#surface-normals-estimation", "physicalCalibration": false, "silhouetteScaleFittingRequired": true, "release": "release_v4", "focalPrior": "Original approximate f695 retained after independent visible upright-line review rejected f306/raw-normal combination; not physical camera calibration.", "shapePrior": "Constant corrected articulated-truck total length/height <=7; bounded visual prior, not physical measurement.", "rejectedCandidates": [ "f306 with raw Marigold normal predicts vertical vanishing point near image bottom and contradicts observed upright stacks", "unbounded rear length fits with L/H about13 overfit source hull and are not physically credible" ] } }, "projected_tracks": { "valid": 602, "withheld": 271 }, "files": { "depth_refined_relative.npy": { "bytes": 3686528, "sha256": "a431ae984ac1f12cdd7f0d044e4d6245a2985d40d9ac9dec8b4762f201c1a2d0" }, "road_plane_constraint_mask.png": { "bytes": 4883, "sha256": "87ddee96b7e66119108c91ebe6c20d3dba8d7ba67e3667cc5924623faa107f14" }, "world.glb": { "bytes": 3065572, "sha256": "52d51e7bdbf3f39508d296183cf7fc7eb93efa2cddbf7a6d49dcec7f95f06109" }, "camera.json": { "bytes": 6299, "sha256": "00dd240ae45ffcaeaed6b71966c5c3833f4d3c9682820ec3658023f507110aca" }, "projection.json": { "bytes": 903819, "sha256": "0df7cd318c4f3c0906c1e5ab819c9b800059b54a83d669164bcbf092f6b8cf71" }, "reference.png": { "bytes": 924383, "sha256": "5f35e17c5d5708b689283dab53014d4032cb4f7d9795b78087df0f5fbf420020" }, "road_projection_mask.png": { "bytes": 4296, "sha256": "e087697a10996b958a52c9e5d88738fbf494f9777870490e725a4f66d6fc4c51" }, "valid_surface_mask.png": { "bytes": 3175, "sha256": "9900cac62884195b62c85ab99b70fa9709468befd89450b041ad043b50a4272b" } }, "limits": [ "Single-image reconstruction is a 2.5D visible-surface mesh, not a full surveyed scene.", "Depth is affine-invariant in logspace; chosen transform and size units are estimates, not physical dimensions.", "No known dimension or camera metadata available: metric sizes and height cannot be recovered.", "Wide-angle lens distortion is visible and uncalibrated; road positions and camera intrinsics are approximate.", "Occluded backsides and sky remain missing; do not close holes or bridge depth discontinuities." ], "visual_qa": "provenance/visual_qa.json", "license_files": [ "provenance/MARIGOLD_V2_LICENSE", "provenance/MARIGOLD_V2_NOTICE" ], "raw_predictions": { "depth": "depth_log.npy", "normals": "normals.npy" }, "geometry_refinement": { "schema": "bean.world_refinement.v1", "method": "Reviewed road rays intersect one estimated horizon-consistent plane; nearest-road smooth log-depth correction extended to adjacent nonroad surfaces, preserving Marigold local shape and all source image UVs.", "horizonCenterPixels": 114, "horizonSlopePixelsPerXPixel": -0.0959541852087195, "horizonSensitivityRangePixels": [ 94, 134 ], "notStatisticalConfidence": true, "constraints": [ { "eventId": "V02", "unclippedSamples": 17, "robustHeightRegressionHorizonCenter": 111.22549805912243 }, { "eventId": "V09", "unclippedSamples": 33, "robustHeightRegressionHorizonCenter": 117.16127275141837 } ], "rejectedConstraint": { "eventId": "V08", "reason": "turning/full-vs-cab box aspect changes violate constant apparent-height assumption" }, "originalGroundPlane": { "normal": [ -0.07470200832793479, 0.7785174577371796, 0.6231614381123175 ], "constant": 7.2569284413026995, "equation": "dot(normal, point) + constant = 0", "fit_roi": "road_fit_mask.png", "estimated": true, "units": "relative", "rms_relative_units": 0.18039678578762114, "median_abs_relative_units": 0.12838913803128005, "normal_model_median": [ -0.054290124250490235, 0.747742978162053, 0.661765079932607 ], "source": "robust plane fit to inferred depth, orientation checked with predicted road normals", "plane_support_points": 32530 }, "gauge": "preserve original plane depth at source pixel(639.5,500); arbitrary relative units", "roadConstraintPixels": 522513, "normalConventionVerified": "+X image right,+Y image up,+Z viewer; no axes conversion bug", "normalConventionSource": "https://huggingface.co/docs/diffusers/main/en/using-diffusers/marigold_usage#surface-normals-estimation", "physicalCalibration": false, "silhouetteScaleFittingRequired": true, "release": "release_v4", "focalPrior": "Original approximate f695 retained after independent visible upright-line review rejected f306/raw-normal combination; not physical camera calibration.", "shapePrior": "Constant corrected articulated-truck total length/height <=7; bounded visual prior, not physical measurement.", "rejectedCandidates": [ "f306 with raw Marigold normal predicts vertical vanishing point near image bottom and contradicts observed upright stacks", "unbounded rear length fits with L/H about13 overfit source hull and are not physically credible" ] }, "original_world_sha256": "58abbc2a31427cddc1e5b089d945662247425b5482d206ab479ec0818bf162d7", "method": "Actual Marigold V2 geometry, refined with a horizon-consistent estimated road plane and fixed-object image perspective constraints. Not metric calibration.", "release": "release_v4" }, "projection": { "status": "attached_refined_world_release_v4", "physicalUnits": false, "coordinateConvention": "Three.js camera-centered: +X image-right,+Y image-up,-Z forward; arbitrary units", "inputAnchor": "bbox_bottom_center", "manualLandmarksProjected": false, "worldSourceResultsSha256": "b854c7f676a17715a06fb32e1d005506f7a6ac33fb10e1839843a0e6d132f4c3", "projectedTrackSamples": 600, "withheldBBoxSamples": 271, "manualLandmarksWithoutGroundPosition": 8, "renderRule": "Use worldSegments/worldMarkers. Never reconnect filtered nulls.", "uncertainty": "Perspective-consistency refinement, not independent survey/calibration; no metric dimensions, true camera pose or measured tire/foot contact.", "sourcePathEventsWithAnyProjection": 20, "eventsWithConnectedWorldRun": 19, "sourcePathEventsWithOnlySingletons": [ "V06" ], "discreteGateEventsWithProjection": 11, "isolatedMeshObservationsProjected": 2, "sourceReference": { "schema": "bean.empty_static_frame.v1", "selection": "single observed frame, not temporal composite", "source_chunk": "attempt_00001/chunk_000661.mp4", "source_sha256": "8c93c30c3411c8ca4bb0cf716365f8b564c7700bce78666abf48e5ffd43074c2", "source_frame_zero_based": 80, "source_local_pts_seconds": 18.407, "native_joined_offset_seconds": 39660.198, "native_joined_elapsed_seconds": 39678.605, "native_joined_elapsed_hms": "11:01:18.605", "clock": "elapsed source media time; not UTC", "width": 1280, "height": 720, "frame_sha256": "5f35e17c5d5708b689283dab53014d4032cb4f7d9795b78087df0f5fbf420020", "visual_review": "No visible active road vehicles or pedestrians; stationary railcars and silos remain. Single frame manually reviewed at1280x720. Not a semantic guarantee for distant subpixel objects.", "image_manipulation": "Unchanged ffmpeg decode from actual frame. No inpainting, generative editing, blending or resampling.", "portable_reproduction_command": "ffmpeg -i chunk_000661.mp4 -vf \"select='eq(n,80)'\" -vsync 0 -frames:v 1 empty_world.png" }, "worldVersion": "camera_world_release_v4", "worldProjectionSha256": "0df7cd318c4f3c0906c1e5ab819c9b800059b54a83d669164bcbf092f6b8cf71", "worldCameraSha256": "00dd240ae45ffcaeaed6b71966c5c3833f4d3c9682820ec3658023f507110aca", "sourceResultsSha256": "07b88c578aa3e7b1073c62ab1a59ebc7d6d64b0585cf129feebfe757b1b2df90", "contactWithholdingUnchanged": true, "sourceUvAndTimesUnchanged": true, "oldCoordinatesRetained": "samples[].priorWorld; original input files also unchanged" }, "models": [ { "id": "741_f43", "name": "Articulated truck · 741_f43", "type": "Articulated truck", "url": "/demo/assets/models/camera/741_f43.glb", "sha256": "8c0e393b6d3c2dc4309499201fcfabcc0f5e34d2d8d0233992c4e8a14ba2bb1e", "bytes": 2326276, "units": "arbitrary inferred model units; normalize for display, never label metres", "qualityNote": "Same local vehicle as 741_f61", "eventId": null }, { "id": "741_f61", "name": "Articulated truck · 741_f61", "type": "Articulated truck", "url": "/demo/assets/models/camera/741_f61.glb", "sha256": "3c5a73b10d29eb7164940013565e5f9ef636efca49bd0d848d157d1d05d42482", "bytes": 2052116, "units": "arbitrary inferred model units; normalize for display, never label metres", "qualityNote": "Same local vehicle as 741_f43", "eventId": null }, { "id": "513", "name": "Articulated truck · 513", "type": "Articulated truck", "url": "/demo/assets/models/camera/513.glb", "sha256": "30bcdd4eb41ce005e0f46362b1830577cff683fb667e67aecf3b232f483b67bb", "bytes": 2868580, "units": "arbitrary inferred model units; normalize for display, never label metres", "qualityNote": "Cab / axle details unverified", "eventId": "V02" }, { "id": "716", "name": "Articulated truck · 716", "type": "Articulated truck", "url": "/demo/assets/models/camera/716.glb", "sha256": "14b18326be55d75487dfb10be403d78b677b030cf79d8a27c75d839172faf4fc", "bytes": 2035604, "units": "arbitrary inferred model units; normalize for display, never label metres", "qualityNote": "Articulated topology not faithful", "eventId": "V09" }, { "id": "207", "name": "Compact loader · 207", "type": "Compact loader", "url": "/demo/assets/models/camera/207.glb", "sha256": "78bfd026d5bfacc8f3926aac6499dbbbe00f1840167defff13f098ca9111246c", "bytes": 4308820, "units": "arbitrary inferred model units; normalize for display, never label metres", "qualityNote": "Glare-derived shape; six-tire artifact", "eventId": "M05" }, { "id": "125", "name": "Compact loader · 125", "type": "Compact loader", "url": "/demo/assets/models/camera/125.glb", "sha256": "d3cc1c6eb475df109cd01bf2b1452e3508df6ed09a2752dddcdfbf201b62974a", "bytes": 4308584, "units": "arbitrary inferred model units; normalize for display, never label metres", "qualityNote": "Four major tire regions; fused front hubs", "eventId": null }, { "id": "proxy_semi", "name": "Semi · illustrative type exemplar", "type": "semi", "url": "/demo/assets/proxies/models/proxy_semi.glb", "sha256": "39e5f773047ddada12cf536fd2c7f6c751fad918bd9d1a297af33880895a89bc", "units": "arbitrary illustrative proportions, not measured metres", "qualityNote": "Not an observation-specific reconstruction; geometry and internal capacity are illustrative.", "eventId": null }, { "id": "proxy_pickup", "name": "Pickup · Kenney type exemplar", "type": "pickup", "url": "/demo/assets/proxies/models/proxy_pickup.glb", "sha256": "2a8dfd865eb956e2be2e15304554712e49f86e2341bb42176e6eba0397dd8e4c", "qualityNote": "CC0 Kenney pickup, not a source-identity reconstruction.", "eventId": null }, { "id": "proxy_utv", "name": "Utv · illustrative type exemplar", "type": "utv", "url": "/demo/assets/proxies/models/proxy_utv.glb", "sha256": "f742a61a90a759d4f3cd54e57342a42657d420f0fef663124757f8428a60ab91", "units": "arbitrary illustrative proportions, not measured metres", "qualityNote": "Not an observation-specific reconstruction; geometry and internal capacity are illustrative.", "eventId": null }, { "id": "proxy_skid", "name": "Skid · illustrative type exemplar", "type": "skid", "url": "/demo/assets/proxies/models/proxy_skid.glb", "sha256": "787ddc0bdbcf75796ba810be823374b9bc4d1586d22d9acb2faa353392b6f421", "units": "arbitrary illustrative proportions, not measured metres", "qualityNote": "Not an observation-specific reconstruction; geometry and internal capacity are illustrative.", "eventId": null }, { "id": "proxy_wheel_loader", "name": "Wheel Loader · illustrative type exemplar", "type": "wheel_loader", "url": "/demo/assets/proxies/models/proxy_wheel_loader.glb", "sha256": "c1f3189e1ccf1ad9f303121139e416a52e924d04ffe4765966fe21e1d4c3c1af", "units": "arbitrary illustrative proportions, not measured metres", "qualityNote": "Not an observation-specific reconstruction; geometry and internal capacity are illustrative.", "eventId": null }, { "id": "proxy_human", "name": "Human · animated type exemplar", "type": "human", "url": "/demo/assets/proxies/models/proxy_human.glb", "sha256": "98f106c28dfde5ed3671700c7dbc6aea59cdbf66d383136ed3e7db139132f152", "qualityNote": "No identity/appearance reconstruction. Generic animation only while moving.", "eventId": null }, { "id": "sam_body_000661_f5", "name": "SAM3D Body · chunk_000661 f5", "type": "Person · actual SAM3D Body inferred pose", "url": "/demo/assets/sam3d/models/human/sam_body_000661_f5.glb", "sha256": "7943d27683c115fe7f63d54ae5eecf5edfc13c0b9838ed87611237f0db590265", "bytes": 1181552, "qualityNote": "Gross pose only. Fine hands unavailable; lower legs/feet unreliable. No identity, appearance, calibrated scale or clean mocap claim.", "eventId": null }, { "id": "sam_body_000661_f10", "name": "SAM3D Body · chunk_000661 f10", "type": "Person · actual SAM3D Body inferred pose", "url": "/demo/assets/sam3d/models/human/sam_body_000661_f10.glb", "sha256": "8a005b9b0a896857df1da8adfce2498854d0c69f2c113a55f7fc11d6ce425b0e", "bytes": 1181552, "qualityNote": "Gross pose only. Fine hands unavailable; lower legs/feet unreliable. No identity, appearance, calibrated scale or clean mocap claim.", "eventId": null }, { "id": "sam_body_001393_f81", "name": "SAM3D Body · chunk_001393 f81", "type": "Person · actual SAM3D Body inferred pose", "url": "/demo/assets/sam3d/models/human/sam_body_001393_f81.glb", "sha256": "445fe9ee65b364d8d4323790092eb1c28475f45fd5d4af5e7679c313f1ffff1b", "bytes": 1181552, "qualityNote": "Gross pose only. Fine hands unavailable; lower legs/feet unreliable. No identity, appearance, calibrated scale or clean mocap claim.", "eventId": "H06" }, { "id": "sam_body_001393_f82", "name": "SAM3D Body · chunk_001393 f82", "type": "Person · actual SAM3D Body inferred pose", "url": "/demo/assets/sam3d/models/human/sam_body_001393_f82.glb", "sha256": "5d00592b9b7b7aaf96b51db540f33cf4d15c7fa59c29de88cc75887e524a3e28", "bytes": 1181552, "qualityNote": "Gross pose only. Fine hands unavailable; lower legs/feet unreliable. No identity, appearance, calibrated scale or clean mocap claim.", "eventId": "H06" }, { "id": "sam_body_001393_f83", "name": "SAM3D Body · chunk_001393 f83", "type": "Person · actual SAM3D Body inferred pose", "url": "/demo/assets/sam3d/models/human/sam_body_001393_f83.glb", "sha256": "4669487385293d18d7b974ac497559f1fba2d2b76600546ff3a8123a1ee7595d", "bytes": 1181544, "qualityNote": "Gross pose only. Fine hands unavailable; lower legs/feet unreliable. No identity, appearance, calibrated scale or clean mocap claim.", "eventId": "H06" }, { "id": "sam_body_001393_f85", "name": "SAM3D Body · chunk_001393 f85", "type": "Person · actual SAM3D Body inferred pose", "url": "/demo/assets/sam3d/models/human/sam_body_001393_f85.glb", "sha256": "a702bfd1502ed4090117c88bc8d065cf3f95eaad17ea51d0b9d836f891f03483", "bytes": 1181552, "qualityNote": "Gross pose only. Fine hands unavailable; lower legs/feet unreliable. No identity, appearance, calibrated scale or clean mocap claim.", "eventId": "H06" }, { "id": "sam_body_001393_f86", "name": "SAM3D Body · chunk_001393 f86", "type": "Person · actual SAM3D Body inferred pose", "url": "/demo/assets/sam3d/models/human/sam_body_001393_f86.glb", "sha256": "a81e981d91a059309c75f5a415446c310d9c44d00462f5eab71371411c7a65fa", "bytes": 1181552, "qualityNote": "Gross pose only. Fine hands unavailable; lower legs/feet unreliable. No identity, appearance, calibrated scale or clean mocap claim.", "eventId": "H06" }, { "id": "sam_body_001393_f87", "name": "SAM3D Body · chunk_001393 f87", "type": "Person · actual SAM3D Body inferred pose", "url": "/demo/assets/sam3d/models/human/sam_body_001393_f87.glb", "sha256": "e63ce194b93d902945a5394189be72304f5af8055893872bf7bc9d0ffbe02663", "bytes": 1181552, "qualityNote": "Gross pose only. Fine hands unavailable; lower legs/feet unreliable. No identity, appearance, calibrated scale or clean mocap claim.", "eventId": "H06" }, { "id": "sam_body_001393_f88", "name": "SAM3D Body · chunk_001393 f88", "type": "Person · actual SAM3D Body inferred pose", "url": "/demo/assets/sam3d/models/human/sam_body_001393_f88.glb", "sha256": "1277457bdb022ddbf3e0aa1a2d66769bf3f7bca2c17f7bff6303dec1407c87c4", "bytes": 1181548, "qualityNote": "Gross pose only. Fine hands unavailable; lower legs/feet unreliable. No identity, appearance, calibrated scale or clean mocap claim.", "eventId": "H06" }, { "id": "sam_body_001393_f89", "name": "SAM3D Body · chunk_001393 f89", "type": "Person · actual SAM3D Body inferred pose", "url": "/demo/assets/sam3d/models/human/sam_body_001393_f89.glb", "sha256": "ae6bbe1f3148f60ded0a1badcb684c2d19d45b79efb4930d69ecf9a064d8fe70", "bytes": 1181552, "qualityNote": "Gross pose only. Fine hands unavailable; lower legs/feet unreliable. No identity, appearance, calibrated scale or clean mocap claim.", "eventId": "H06" }, { "id": "sam_body_001393_f90", "name": "SAM3D Body · chunk_001393 f90", "type": "Person · actual SAM3D Body inferred pose", "url": "/demo/assets/sam3d/models/human/sam_body_001393_f90.glb", "sha256": "e8f200325d485d4bbf2ae91097660a0b9e4eebe2230bbe7e6a4d1054300a929b", "bytes": 1181552, "qualityNote": "Gross pose only. Fine hands unavailable; lower legs/feet unreliable. No identity, appearance, calibrated scale or clean mocap claim.", "eventId": "H06" }, { "id": "sam_body_001393_f91", "name": "SAM3D Body · chunk_001393 f91", "type": "Person · actual SAM3D Body inferred pose", "url": "/demo/assets/sam3d/models/human/sam_body_001393_f91.glb", "sha256": "1237870c92286b9a99c4c0804237a553f51346614268bca56b4ff7ea8e05f5ff", "bytes": 1181552, "qualityNote": "Gross pose only. Fine hands unavailable; lower legs/feet unreliable. No identity, appearance, calibrated scale or clean mocap claim.", "eventId": "H06" }, { "id": "sam_body_001393_f92", "name": "SAM3D Body · chunk_001393 f92", "type": "Person · actual SAM3D Body inferred pose", "url": "/demo/assets/sam3d/models/human/sam_body_001393_f92.glb", "sha256": "0be42f1c42cd397cb7c52dc596b942be5cc6c07789553f74375fa08e751efbaf", "bytes": 1181544, "qualityNote": "Gross pose only. Fine hands unavailable; lower legs/feet unreliable. No identity, appearance, calibrated scale or clean mocap claim.", "eventId": "H06" }, { "id": "sam_body_001393_f93", "name": "SAM3D Body · chunk_001393 f93", "type": "Person · actual SAM3D Body inferred pose", "url": "/demo/assets/sam3d/models/human/sam_body_001393_f93.glb", "sha256": "89ab75f25c222c96f900805960d923b2b485b41a00ea25c6cace99c43a374de1", "bytes": 1181552, "qualityNote": "Gross pose only. Fine hands unavailable; lower legs/feet unreliable. No identity, appearance, calibrated scale or clean mocap claim.", "eventId": "H06" }, { "id": "sam_body_001393_f94", "name": "SAM3D Body · chunk_001393 f94", "type": "Person · actual SAM3D Body inferred pose", "url": "/demo/assets/sam3d/models/human/sam_body_001393_f94.glb", "sha256": "21df138a8607713a86f0a1a15ba46a3cc8a80d0284ef78bf348a0b6c7d7430ab", "bytes": 1181552, "qualityNote": "Gross pose only. Fine hands unavailable; lower legs/feet unreliable. No identity, appearance, calibrated scale or clean mocap claim.", "eventId": "H06" }, { "id": "sam_body_001393_f95", "name": "SAM3D Body · chunk_001393 f95", "type": "Person · actual SAM3D Body inferred pose", "url": "/demo/assets/sam3d/models/human/sam_body_001393_f95.glb", "sha256": "9149bdce95109620a2dd02b848b6da9a8ceafb7919167a3d3f4664045d1cb4e5", "bytes": 1181548, "qualityNote": "Gross pose only. Fine hands unavailable; lower legs/feet unreliable. No identity, appearance, calibrated scale or clean mocap claim.", "eventId": "H06" }, { "id": "sam_body_001393_f96", "name": "SAM3D Body · chunk_001393 f96", "type": "Person · actual SAM3D Body inferred pose", "url": "/demo/assets/sam3d/models/human/sam_body_001393_f96.glb", "sha256": "cd36a323002ed2dd142d2a009a825d4c8112e82728d2702ea8a8a0ead49f2307", "bytes": 1181548, "qualityNote": "Gross pose only. Fine hands unavailable; lower legs/feet unreliable. No identity, appearance, calibrated scale or clean mocap claim.", "eventId": "H06" }, { "id": "sam_body_001393_f97", "name": "SAM3D Body · chunk_001393 f97", "type": "Person · actual SAM3D Body inferred pose", "url": "/demo/assets/sam3d/models/human/sam_body_001393_f97.glb", "sha256": "875bfaedd095a99c773332339cfbb7d35fd975738b0e06d0998d8679ffc95a99", "bytes": 1181552, "qualityNote": "Gross pose only. Fine hands unavailable; lower legs/feet unreliable. No identity, appearance, calibrated scale or clean mocap claim.", "eventId": "H06" }, { "id": "sam_body_001393_f98", "name": "SAM3D Body · chunk_001393 f98", "type": "Person · actual SAM3D Body inferred pose", "url": "/demo/assets/sam3d/models/human/sam_body_001393_f98.glb", "sha256": "eb20f6e87963a4f9c2e325f03e031812b9e60da547e440ed4ed463a85e2e8f1f", "bytes": 1181544, "qualityNote": "Gross pose only. Fine hands unavailable; lower legs/feet unreliable. No identity, appearance, calibrated scale or clean mocap claim.", "eventId": "H06" }, { "id": "sam_body_001393_f99", "name": "SAM3D Body · chunk_001393 f99", "type": "Person · actual SAM3D Body inferred pose", "url": "/demo/assets/sam3d/models/human/sam_body_001393_f99.glb", "sha256": "d92a16fff285ed08309692a583af10623e68bb1bff70079a93e56cf37dc0adc5", "bytes": 1181548, "qualityNote": "Gross pose only. Fine hands unavailable; lower legs/feet unreliable. No identity, appearance, calibrated scale or clean mocap claim.", "eventId": "H06" }, { "id": "sam_body_001393_f100", "name": "SAM3D Body · chunk_001393 f100", "type": "Person · actual SAM3D Body inferred pose", "url": "/demo/assets/sam3d/models/human/sam_body_001393_f100.glb", "sha256": "1987cc73701ff929cedb82341151db5598be8bebffcd111ca22f6379ac0a9349", "bytes": 1181552, "qualityNote": "Gross pose only. Fine hands unavailable; lower legs/feet unreliable. No identity, appearance, calibrated scale or clean mocap claim.", "eventId": "H06" }, { "id": "sam_body_001393_f101", "name": "SAM3D Body · chunk_001393 f101", "type": "Person · actual SAM3D Body inferred pose", "url": "/demo/assets/sam3d/models/human/sam_body_001393_f101.glb", "sha256": "82628222b1b251db7404eea74057348d0cc8e54c0248387d03ab7c78631bb4fd", "bytes": 1181552, "qualityNote": "Gross pose only. Fine hands unavailable; lower legs/feet unreliable. No identity, appearance, calibrated scale or clean mocap claim.", "eventId": "H06" }, { "id": "sam_body_000402_f160", "name": "SAM3D Body · chunk_000402 f160", "type": "Person · actual SAM3D Body inferred pose", "url": "/demo/assets/sam3d/models/human/sam_body_000402_f160.glb", "sha256": "e752e528da18c676e5d2a3929d710fcaa72d9da78cfab00400e73362ed06f8c3", "bytes": 1181552, "qualityNote": "Gross pose only. Fine hands unavailable; lower legs/feet unreliable. No identity, appearance, calibrated scale or clean mocap claim.", "eventId": "H04" }, { "id": "sam_body_000402_f162", "name": "SAM3D Body · chunk_000402 f162", "type": "Person · actual SAM3D Body inferred pose", "url": "/demo/assets/sam3d/models/human/sam_body_000402_f162.glb", "sha256": "a0572bc9e1077b83bc741cf8319187ac3b027a4ea268306d1210a7fa293f47ac", "bytes": 1181552, "qualityNote": "Gross pose only. Fine hands unavailable; lower legs/feet unreliable. No identity, appearance, calibrated scale or clean mocap claim.", "eventId": "H04" }, { "id": "sam_body_000402_f165", "name": "SAM3D Body · chunk_000402 f165", "type": "Person · actual SAM3D Body inferred pose", "url": "/demo/assets/sam3d/models/human/sam_body_000402_f165.glb", "sha256": "21a8a700b238826b2bb6beb0a9635dd4f35b45a6640c660d55e64fc44fced0df", "bytes": 1181556, "qualityNote": "Gross pose only. Fine hands unavailable; lower legs/feet unreliable. No identity, appearance, calibrated scale or clean mocap claim.", "eventId": "H04" }, { "id": "sam_body_000402_f167", "name": "SAM3D Body · chunk_000402 f167", "type": "Person · actual SAM3D Body inferred pose", "url": "/demo/assets/sam3d/models/human/sam_body_000402_f167.glb", "sha256": "a210b42cb93bf0b67172f2ee8fd179332f17f57a4630a5e2f659ec3809b84601", "bytes": 1181552, "qualityNote": "Gross pose only. Fine hands unavailable; lower legs/feet unreliable. No identity, appearance, calibrated scale or clean mocap claim.", "eventId": "H04" }, { "id": "sam_body_000402_f168", "name": "SAM3D Body · chunk_000402 f168", "type": "Person · actual SAM3D Body inferred pose", "url": "/demo/assets/sam3d/models/human/sam_body_000402_f168.glb", "sha256": "03aa4e11d6f15532b89154e3bc28df9ce2863aecd96889789bc05c273a99605a", "bytes": 1181552, "qualityNote": "Gross pose only. Fine hands unavailable; lower legs/feet unreliable. No identity, appearance, calibrated scale or clean mocap claim.", "eventId": "H04" }, { "id": "sam_body_000402_f169", "name": "SAM3D Body · chunk_000402 f169", "type": "Person · actual SAM3D Body inferred pose", "url": "/demo/assets/sam3d/models/human/sam_body_000402_f169.glb", "sha256": "03087b704911786d5e92419a9abf4c2b03e4294f66f66b20fcfa3aff1992806b", "bytes": 1181556, "qualityNote": "Gross pose only. Fine hands unavailable; lower legs/feet unreliable. No identity, appearance, calibrated scale or clean mocap claim.", "eventId": "H04" }, { "id": "sam_body_000402_f170", "name": "SAM3D Body · chunk_000402 f170", "type": "Person · actual SAM3D Body inferred pose", "url": "/demo/assets/sam3d/models/human/sam_body_000402_f170.glb", "sha256": "954da3b11e63d41f0fd598188533625034a3ebaf89729e422cbf2f5fbd91949b", "bytes": 1181548, "qualityNote": "Gross pose only. Fine hands unavailable; lower legs/feet unreliable. No identity, appearance, calibrated scale or clean mocap claim.", "eventId": "H04" }, { "id": "sam_body_000402_f171", "name": "SAM3D Body · chunk_000402 f171", "type": "Person · actual SAM3D Body inferred pose", "url": "/demo/assets/sam3d/models/human/sam_body_000402_f171.glb", "sha256": "41812025a854a251e1ee9dfc0ee60bad3846b87be023f25bccacc6c2e10ed3fb", "bytes": 1181552, "qualityNote": "Gross pose only. Fine hands unavailable; lower legs/feet unreliable. No identity, appearance, calibrated scale or clean mocap claim.", "eventId": "H04" }, { "id": "sam_body_000402_f172", "name": "SAM3D Body · chunk_000402 f172", "type": "Person · actual SAM3D Body inferred pose", "url": "/demo/assets/sam3d/models/human/sam_body_000402_f172.glb", "sha256": "414c7adf7569cd2a3537960d30ed9b8cd57168f24d3efd6c5a568a078d9f2b95", "bytes": 1181552, "qualityNote": "Gross pose only. Fine hands unavailable; lower legs/feet unreliable. No identity, appearance, calibrated scale or clean mocap claim.", "eventId": "H04" }, { "id": "sam_body_000402_f173", "name": "SAM3D Body · chunk_000402 f173", "type": "Person · actual SAM3D Body inferred pose", "url": "/demo/assets/sam3d/models/human/sam_body_000402_f173.glb", "sha256": "8321bc11ea547e8a96956a1c1a30731ce2a462fe20fa35668e175e2f8977534d", "bytes": 1181556, "qualityNote": "Gross pose only. Fine hands unavailable; lower legs/feet unreliable. No identity, appearance, calibrated scale or clean mocap claim.", "eventId": "H04" }, { "id": "sam_body_000402_f174", "name": "SAM3D Body · chunk_000402 f174", "type": "Person · actual SAM3D Body inferred pose", "url": "/demo/assets/sam3d/models/human/sam_body_000402_f174.glb", "sha256": "7a691e90e81010e9b176faf5ad5640f23ba79635caec99532d4bce0d7481ddbf", "bytes": 1181552, "qualityNote": "Gross pose only. Fine hands unavailable; lower legs/feet unreliable. No identity, appearance, calibrated scale or clean mocap claim.", "eventId": "H04" }, { "id": "sam_body_000402_f175", "name": "SAM3D Body · chunk_000402 f175", "type": "Person · actual SAM3D Body inferred pose", "url": "/demo/assets/sam3d/models/human/sam_body_000402_f175.glb", "sha256": "8c3340841e961c0c708898453d67fe9a6cb6c4ed4d4e1b3de47f6019bd07d268", "bytes": 1181556, "qualityNote": "Gross pose only. Fine hands unavailable; lower legs/feet unreliable. No identity, appearance, calibrated scale or clean mocap claim.", "eventId": "H04" }, { "id": "sam_body_000402_f176", "name": "SAM3D Body · chunk_000402 f176", "type": "Person · actual SAM3D Body inferred pose", "url": "/demo/assets/sam3d/models/human/sam_body_000402_f176.glb", "sha256": "bde04ea1799b5e67158d9517900f3eeb5f7d36a25c61d4c9e1e5c4fd2890f90d", "bytes": 1181556, "qualityNote": "Gross pose only. Fine hands unavailable; lower legs/feet unreliable. No identity, appearance, calibrated scale or clean mocap claim.", "eventId": "H04" }, { "id": "sam_body_000402_f177", "name": "SAM3D Body · chunk_000402 f177", "type": "Person · actual SAM3D Body inferred pose", "url": "/demo/assets/sam3d/models/human/sam_body_000402_f177.glb", "sha256": "b9a0877b3f832279ce9465b6f650e609ca5a7e74363ee1e89e9c5f644178af00", "bytes": 1181556, "qualityNote": "Gross pose only. Fine hands unavailable; lower legs/feet unreliable. No identity, appearance, calibrated scale or clean mocap claim.", "eventId": "H04" }, { "id": "sam_body_000402_f178", "name": "SAM3D Body · chunk_000402 f178", "type": "Person · actual SAM3D Body inferred pose", "url": "/demo/assets/sam3d/models/human/sam_body_000402_f178.glb", "sha256": "50a4d8a0ab2a275a2064e9afa1ec762bd5f8ff70bbbb90558635235317d4690b", "bytes": 1181556, "qualityNote": "Gross pose only. Fine hands unavailable; lower legs/feet unreliable. No identity, appearance, calibrated scale or clean mocap claim.", "eventId": "H04" }, { "id": "sam_body_000402_f179", "name": "SAM3D Body · chunk_000402 f179", "type": "Person · actual SAM3D Body inferred pose", "url": "/demo/assets/sam3d/models/human/sam_body_000402_f179.glb", "sha256": "76861b515ce16aa5a2e2173ed8257f93c0384ec73287929b1c53452523e2decf", "bytes": 1181552, "qualityNote": "Gross pose only. Fine hands unavailable; lower legs/feet unreliable. No identity, appearance, calibrated scale or clean mocap claim.", "eventId": "H04" }, { "id": "sam_body_000957_f246", "name": "SAM3D Body · chunk_000957 f246", "type": "Person · actual SAM3D Body inferred pose", "url": "/demo/assets/sam3d/models/human/sam_body_000957_f246.glb", "sha256": "aba3d6f64083220db63e68dddb530c23077a8a81da2e584d06eb30c4e4b96f93", "bytes": 1181548, "qualityNote": "Gross pose only. Fine hands unavailable; lower legs/feet unreliable. No identity, appearance, calibrated scale or clean mocap claim.", "eventId": "H05" }, { "id": "sam_body_000957_f249", "name": "SAM3D Body · chunk_000957 f249", "type": "Person · actual SAM3D Body inferred pose", "url": "/demo/assets/sam3d/models/human/sam_body_000957_f249.glb", "sha256": "a28330432b4e85ffa6fbc1d0efe83bae226264e17fef0e16c659f7d594f382d0", "bytes": 1181552, "qualityNote": "Gross pose only. Fine hands unavailable; lower legs/feet unreliable. No identity, appearance, calibrated scale or clean mocap claim.", "eventId": "H05" }, { "id": "sam_body_000957_f250", "name": "SAM3D Body · chunk_000957 f250", "type": "Person · actual SAM3D Body inferred pose", "url": "/demo/assets/sam3d/models/human/sam_body_000957_f250.glb", "sha256": "366ca4ebd83a45e21156daa06e1e24dd952cb084c58a93f459162286a76b7cfd", "bytes": 1181552, "qualityNote": "Gross pose only. Fine hands unavailable; lower legs/feet unreliable. No identity, appearance, calibrated scale or clean mocap claim.", "eventId": "H05" }, { "id": "sam_body_000957_f251", "name": "SAM3D Body · chunk_000957 f251", "type": "Person · actual SAM3D Body inferred pose", "url": "/demo/assets/sam3d/models/human/sam_body_000957_f251.glb", "sha256": "399795be4c7178a812b477e26a321d31201f4f2eb3b5bab42f757febe93530b8", "bytes": 1181548, "qualityNote": "Gross pose only. Fine hands unavailable; lower legs/feet unreliable. No identity, appearance, calibrated scale or clean mocap claim.", "eventId": "H05" }, { "id": "sam_body_000957_f252", "name": "SAM3D Body · chunk_000957 f252", "type": "Person · actual SAM3D Body inferred pose", "url": "/demo/assets/sam3d/models/human/sam_body_000957_f252.glb", "sha256": "603acfabd45c3ef0cb18ff787f08e4292fb234c6ddb919513f34441c0c61072e", "bytes": 1181556, "qualityNote": "Gross pose only. Fine hands unavailable; lower legs/feet unreliable. No identity, appearance, calibrated scale or clean mocap claim.", "eventId": "H05" }, { "id": "sam_body_000957_f253", "name": "SAM3D Body · chunk_000957 f253", "type": "Person · actual SAM3D Body inferred pose", "url": "/demo/assets/sam3d/models/human/sam_body_000957_f253.glb", "sha256": "75267d62ea6335640a119928e11ae415ae194955876435fad2bb0ed191ae664a", "bytes": 1181556, "qualityNote": "Gross pose only. Fine hands unavailable; lower legs/feet unreliable. No identity, appearance, calibrated scale or clean mocap claim.", "eventId": "H05" }, { "id": "sam_body_000957_f254", "name": "SAM3D Body · chunk_000957 f254", "type": "Person · actual SAM3D Body inferred pose", "url": "/demo/assets/sam3d/models/human/sam_body_000957_f254.glb", "sha256": "00aa6c4ed31327dfc57071814178f007e050d7ce77fc1278aa917edfb2b477b3", "bytes": 1181552, "qualityNote": "Gross pose only. Fine hands unavailable; lower legs/feet unreliable. No identity, appearance, calibrated scale or clean mocap claim.", "eventId": "H05" }, { "id": "sam_body_000957_f255", "name": "SAM3D Body · chunk_000957 f255", "type": "Person · actual SAM3D Body inferred pose", "url": "/demo/assets/sam3d/models/human/sam_body_000957_f255.glb", "sha256": "1244f01e5d2b2f72e5c2f331d55a2d562b9295c7169b455191db18ed0c853fad", "bytes": 1181556, "qualityNote": "Gross pose only. Fine hands unavailable; lower legs/feet unreliable. No identity, appearance, calibrated scale or clean mocap claim.", "eventId": "H05" }, { "id": "sam_body_000957_f256", "name": "SAM3D Body · chunk_000957 f256", "type": "Person · actual SAM3D Body inferred pose", "url": "/demo/assets/sam3d/models/human/sam_body_000957_f256.glb", "sha256": "50c6b78745dd39f0ec90da35a1f55a98abd0c88c63a7c469590b044db075abef", "bytes": 1181552, "qualityNote": "Gross pose only. Fine hands unavailable; lower legs/feet unreliable. No identity, appearance, calibrated scale or clean mocap claim.", "eventId": "H05" }, { "id": "sam_body_000957_f257", "name": "SAM3D Body · chunk_000957 f257", "type": "Person · actual SAM3D Body inferred pose", "url": "/demo/assets/sam3d/models/human/sam_body_000957_f257.glb", "sha256": "ccadf47f4faafc56e9c2cdfb4e3efa71e04e4af0dcd1a7326eb6fdf01ce31ebe", "bytes": 1181552, "qualityNote": "Gross pose only. Fine hands unavailable; lower legs/feet unreliable. No identity, appearance, calibrated scale or clean mocap claim.", "eventId": "H05" }, { "id": "sam_body_000957_f258", "name": "SAM3D Body · chunk_000957 f258", "type": "Person · actual SAM3D Body inferred pose", "url": "/demo/assets/sam3d/models/human/sam_body_000957_f258.glb", "sha256": "263ae054171109862dd989e0c6a34890f81fe0225712d4697e939fb821070023", "bytes": 1181548, "qualityNote": "Gross pose only. Fine hands unavailable; lower legs/feet unreliable. No identity, appearance, calibrated scale or clean mocap claim.", "eventId": "H05" } ], "loadPolicy": { "schema": "bean.load_observation_policy.v1", "measured_percentages_available": false, "estimated_numeric_ranges_available": false, "reason": "Single uncalibrated images do not establish container interior geometry, occluded material depth or volumetric capacity. Visible heap height is not volume fraction.", "default_numeric_percent": null, "null_is_not_zero": true, "what_if": { "enabled_by_default": false, "min_percent": 0, "max_percent": 125, "percent_meaning": "Synthetic proxy internal volume;100%level at rim;125%includes a pyramid-like heap above rim", "must_label": "Illustrative what-if — not measured", "fill_module": "fill-volume.mjs" }, "observations": [ { "source_chunk": "attempt_00001/chunk_000670.mp4", "container": "trailer", "state": "visible_heap_present", "observed_percent": null, "material_identity": null, "event_assignment": "Do not attach to an accepted event without exact source correspondence" }, { "source_chunk": "attempt_00001/chunk_000716.mp4", "event_id": "V09", "container": "trailer", "state": "visible_heap_present", "observed_percent": null, "material_identity": null, "source_model_limit": "716 reconstructed topology is poor; its geometry cannot measure capacity" }, { "source_chunk": "attempt_00001/chunk_001386.mp4", "event_id": "M15", "container": "loader_bucket", "state": "visible_heap_present", "observed_percent": null, "material_identity": null, "position_limit": "Use only separately supplied observation-specific reviewed anchor/pose contract; without that contract, isolated proxy study only. No inferred full trajectory from a single pose." }, { "source_chunk": "attempt_00001/chunk_000513.mp4", "event_id": "V02", "container": "trailer", "state": "covered_contents_not_established", "observed_percent": null, "material_identity": null }, { "source_chunk": "attempt_00001/chunk_000207.mp4", "event_id": "M05", "container": "loader_bucket", "state": "no_heap_visible_not_confirmed_empty", "observed_percent": null, "material_identity": null, "visibility": "headlight glare and occlusion" } ], "default_visualization": "Show nonnumeric observation state/badge. A qualitative heap symbol may indicate presence but must not encode or display a percentage. Quantified fill geometry only after the user enables what-if mode.", "source": "Root-provided reviewed observation findings; no new material classification or load inference performed." }, "assetManifestUrl": "/api/v1/assets?kind=json&limit=100", "completeSceneSnapshotUrl": "/demo/api/v1/scene.json", "coordinateNote": "Camera-relative geometry and illustrative model dimensions; not surveyed metres." } } } } }, "304": { "description": "Response unchanged (If-None-Match). No body." }, "400": { "description": "Invalid parameter, range or cursor.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "example": { "error": { "code": "invalid_parameter", "message": "Invalid parameter, range or cursor.", "field": null, "requestId": "request-id" } } } } }, "404": { "description": "Resource or route does not exist.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "example": { "error": { "code": "not_found", "message": "Resource or route does not exist.", "field": null, "requestId": "request-id" } } } } }, "405": { "description": "This API supports GET, HEAD and OPTIONS.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "example": { "error": { "code": "method_not_allowed", "message": "This API supports GET, HEAD and OPTIONS.", "field": null, "requestId": "request-id" } } } } }, "409": { "description": "Dataset changed; restart without the cursor.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "example": { "error": { "code": "stale_cursor", "message": "Dataset changed; restart without the cursor.", "field": null, "requestId": "request-id" } } } } }, "500": { "description": "Request could not be completed.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "example": { "error": { "code": "internal_error", "message": "Request could not be completed.", "field": null, "requestId": "request-id" } } } } } }, "x-codeSamples": [ { "lang": "Shell", "label": "curl", "source": "curl -sS 'https://outdoors.pdigger.com/api/v1/scene'" } ] } }, "/taxonomy": { "get": { "operationId": "get_taxonomy", "tags": [ "Overview" ], "summary": "Get taxonomy", "description": "Executed by the read-only API service against the versioned, fully merged demo dataset. Lists are ordered by source start time then ID (observations), sample time then ID (track samples), or ID (other collections). Time ranges are inclusive. No live inference or all-day identity claim.", "parameters": [], "responses": { "200": { "description": "Query result from recorded demo observations.", "headers": { "ETag": { "schema": { "type": "string" }, "description": "Strong response validator. Send If-None-Match to receive 304 when unchanged." }, "Link": { "schema": { "type": "string" }, "description": "Next page URL with rel=\"next\", when available." }, "X-Request-Id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "type": "object", "required": [ "schemaVersion", "datasetId", "datasetRevision", "demo", "mode", "data" ], "properties": { "schemaVersion": { "type": "string", "enum": [ "2.0.0" ] }, "datasetId": { "type": "string" }, "datasetRevision": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "demo": { "type": "boolean", "enum": [ true ] }, "mode": { "type": "string", "enum": [ "recorded_demo" ] }, "sourceVersion": { "type": "integer" }, "sourceCommit": { "type": "string" }, "clock": { "type": "string", "enum": [ "source_elapsed_seconds" ] }, "frameUtcVerified": { "type": "boolean", "enum": [ false ] }, "partialCoverage": { "type": "boolean", "enum": [ true ] }, "data": { "type": "object", "additionalProperties": true } } }, "example": { "schemaVersion": "2.0.0", "datasetId": "pdigger-outdoors-v15", "demo": true, "sourceVersion": 15, "sourceCommit": "5f322b5ad3ecfce4aff5b5609456716099b28f62", "clock": "source_elapsed_seconds", "frameUtcVerified": false, "partialCoverage": true, "datasetRevision": "5318d837e37e1219e3ec72baf438cf1423a40fe7ea120f8567a8484c8527402f", "mode": "recorded_demo", "data": { "types": [ { "id": "semi_trailer", "label": "Semi + trailer(s)", "categoryId": "road_vehicle", "color": "#37DAFF" }, { "id": "pickup", "label": "Pickup truck", "categoryId": "road_vehicle", "color": "#FF725E" }, { "id": "utv", "label": "UTV", "categoryId": "mobile_machinery", "color": "#FFCA55" }, { "id": "skid_steer", "label": "Skid-steer", "categoryId": "mobile_machinery", "color": "#B7F05D" }, { "id": "wheel_loader", "label": "Wheel loader", "categoryId": "mobile_machinery", "color": "#AF91FF" }, { "id": "human", "label": "Human", "categoryId": "person", "color": "#FF83D6" } ], "categories": [ { "id": "road_vehicle", "label": "Road vehicles" }, { "id": "mobile_machinery", "label": "Utility & machinery" }, { "id": "person", "label": "Humans" } ], "actions": [ { "id": "gate_crossing", "label": "Gate crossing" }, { "id": "approach", "label": "Approach" }, { "id": "pause", "label": "Pause" }, { "id": "reverse", "label": "Reverse" }, { "id": "turn", "label": "Turn" }, { "id": "walking", "label": "Walking" } ], "cameraDirections": [ { "id": "toward_top", "label": "Up camera" }, { "id": "toward_bottom", "label": "Down camera" } ], "facilityDirections": [ "incoming", "outgoing", "waiting", null ], "materialTypeExamples": [ "beans", "sand", "gravel", null ], "facilityLaneMapping": { "status": "awaiting_user_confirmation", "left_silo_side": null, "right_parked_trailer_side": null, "basis": "Original source-camera image; never inferred from load or camera travel direction." } } } } } }, "304": { "description": "Response unchanged (If-None-Match). No body." }, "400": { "description": "Invalid parameter, range or cursor.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "example": { "error": { "code": "invalid_parameter", "message": "Invalid parameter, range or cursor.", "field": null, "requestId": "request-id" } } } } }, "404": { "description": "Resource or route does not exist.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "example": { "error": { "code": "not_found", "message": "Resource or route does not exist.", "field": null, "requestId": "request-id" } } } } }, "405": { "description": "This API supports GET, HEAD and OPTIONS.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "example": { "error": { "code": "method_not_allowed", "message": "This API supports GET, HEAD and OPTIONS.", "field": null, "requestId": "request-id" } } } } }, "409": { "description": "Dataset changed; restart without the cursor.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "example": { "error": { "code": "stale_cursor", "message": "Dataset changed; restart without the cursor.", "field": null, "requestId": "request-id" } } } } }, "500": { "description": "Request could not be completed.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "example": { "error": { "code": "internal_error", "message": "Request could not be completed.", "field": null, "requestId": "request-id" } } } } } }, "x-codeSamples": [ { "lang": "Shell", "label": "curl", "source": "curl -sS 'https://outdoors.pdigger.com/api/v1/taxonomy'" } ] } }, "/tracks/{eventId}": { "get": { "operationId": "get_tracks_eventId_", "tags": [ "Tracks" ], "summary": "Get coordinate conventions and sample links", "description": "Executed by the read-only API service against the versioned, fully merged demo dataset. Lists are ordered by source start time then ID (observations), sample time then ID (track samples), or ID (other collections). Time ranges are inclusive. No live inference or all-day identity claim.", "parameters": [ { "in": "path", "name": "eventId", "required": true, "schema": { "type": "string" }, "example": "V05", "description": "Observation ID; obtain it from events or the track manifest." } ], "responses": { "200": { "description": "Query result from recorded demo observations.", "headers": { "ETag": { "schema": { "type": "string" }, "description": "Strong response validator. Send If-None-Match to receive 304 when unchanged." }, "Link": { "schema": { "type": "string" }, "description": "Next page URL with rel=\"next\", when available." }, "X-Request-Id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "type": "object", "required": [ "schemaVersion", "datasetId", "datasetRevision", "demo", "mode", "data" ], "properties": { "schemaVersion": { "type": "string", "enum": [ "2.0.0" ] }, "datasetId": { "type": "string" }, "datasetRevision": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "demo": { "type": "boolean", "enum": [ true ] }, "mode": { "type": "string", "enum": [ "recorded_demo" ] }, "sourceVersion": { "type": "integer" }, "sourceCommit": { "type": "string" }, "clock": { "type": "string", "enum": [ "source_elapsed_seconds" ] }, "frameUtcVerified": { "type": "boolean", "enum": [ false ] }, "partialCoverage": { "type": "boolean", "enum": [ true ] }, "data": { "$ref": "#/components/schemas/TrackMetadata" } } }, "example": { "schemaVersion": "2.0.0", "datasetId": "pdigger-outdoors-v15", "demo": true, "sourceVersion": 15, "sourceCommit": "5f322b5ad3ecfce4aff5b5609456716099b28f62", "clock": "source_elapsed_seconds", "frameUtcVerified": false, "partialCoverage": true, "datasetRevision": "5318d837e37e1219e3ec72baf438cf1423a40fe7ea120f8567a8484c8527402f", "mode": "recorded_demo", "data": { "id": "track-V05", "eventId": "V05", "recordingId": "recovered_native_elapsed", "imageCoordinates": "normalized_uv_u_right_v_down", "worldCoordinates": "camera_relative_x_right_y_up_negative_z_forward", "worldUnits": "relative", "source": { "evidenceKind": "manual_landmarks_only", "sourceChunk": "attempt_00001/chunk_000560.mp4", "sourceSha256": "d248662ee43ff9d08e765ca79dd099e999aaff7c26ba59fa262f57351f9a28c6", "limitations": [ "No claim about crossing in chunk559 or across not established chunk gap.; No full-vehicle bounding box centre timing is asserted. Timestamp refers only to the manually identified rear trailer wheel landmark.; Cab and coupling become occluded; no unseen cab motion is reconstructed.; Review ends at10s bound, last native frame9.785; no later source footage inspected." ] }, "samplesUrl": "/api/v1/tracks/V05/samples", "availableChannels": [ "image", "world", "model", "presence", "stub", "sourceMarker" ], "snapshotUrl": "/demo/api/v1/tracks/V05.json" } } } } }, "304": { "description": "Response unchanged (If-None-Match). No body." }, "400": { "description": "Invalid parameter, range or cursor.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "example": { "error": { "code": "invalid_parameter", "message": "Invalid parameter, range or cursor.", "field": null, "requestId": "request-id" } } } } }, "404": { "description": "Resource or route does not exist.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "example": { "error": { "code": "not_found", "message": "Resource or route does not exist.", "field": null, "requestId": "request-id" } } } } }, "405": { "description": "This API supports GET, HEAD and OPTIONS.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "example": { "error": { "code": "method_not_allowed", "message": "This API supports GET, HEAD and OPTIONS.", "field": null, "requestId": "request-id" } } } } }, "409": { "description": "Dataset changed; restart without the cursor.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "example": { "error": { "code": "stale_cursor", "message": "Dataset changed; restart without the cursor.", "field": null, "requestId": "request-id" } } } } }, "500": { "description": "Request could not be completed.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "example": { "error": { "code": "internal_error", "message": "Request could not be completed.", "field": null, "requestId": "request-id" } } } } } }, "x-codeSamples": [ { "lang": "Shell", "label": "curl", "source": "curl -sS 'https://outdoors.pdigger.com/api/v1/tracks/V05'" } ] } }, "/tracks/{eventId}/samples": { "get": { "operationId": "get_tracks_eventId_samples", "tags": [ "Tracks" ], "summary": "Query track samples by channel and elapsed time", "description": "Executed by the read-only API service against the versioned, fully merged demo dataset. Lists are ordered by source start time then ID (observations), sample time then ID (track samples), or ID (other collections). Time ranges are inclusive. No live inference or all-day identity claim.", "parameters": [ { "in": "path", "name": "eventId", "required": true, "schema": { "type": "string" }, "example": "V05", "description": "Observation ID; obtain it from events or the track manifest." }, { "in": "query", "name": "channel", "required": false, "description": "Select one coordinate/support channel. Samples from separate channels are never silently merged.", "schema": { "type": "string", "enum": [ "image", "world", "model", "presence", "stub", "sourceMarker" ], "default": "world" } }, { "in": "query", "name": "fromSec", "required": false, "description": "Inclusive source elapsed seconds. Event queries match intervals overlapping this bound; sample queries match sample times.", "schema": { "type": "number", "minimum": 0 } }, { "in": "query", "name": "toSec", "required": false, "description": "Inclusive source elapsed seconds. Must be at least fromSec.", "schema": { "type": "number", "minimum": 0 } }, { "in": "query", "name": "limit", "required": false, "description": "Page size. Follow links.next or pass page.nextCursor as cursor; retain all filters and the same limit.", "schema": { "type": "integer", "minimum": 1, "maximum": 500, "default": 20 } }, { "in": "query", "name": "cursor", "required": false, "description": "Opaque signed cursor returned by the previous page. It is bound to the dataset revision, endpoint, filters, ordering and limit. Not an authentication credential.", "schema": { "type": "string", "maxLength": 2048 } } ], "responses": { "200": { "description": "Query result from recorded demo observations.", "headers": { "ETag": { "schema": { "type": "string" }, "description": "Strong response validator. Send If-None-Match to receive 304 when unchanged." }, "Link": { "schema": { "type": "string" }, "description": "Next page URL with rel=\"next\", when available." }, "X-Request-Id": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "type": "object", "required": [ "schemaVersion", "datasetId", "datasetRevision", "demo", "mode", "data", "page", "links" ], "properties": { "schemaVersion": { "type": "string", "enum": [ "2.0.0" ] }, "datasetId": { "type": "string" }, "datasetRevision": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "demo": { "type": "boolean", "enum": [ true ] }, "mode": { "type": "string", "enum": [ "recorded_demo" ] }, "sourceVersion": { "type": "integer" }, "sourceCommit": { "type": "string" }, "clock": { "type": "string", "enum": [ "source_elapsed_seconds" ] }, "frameUtcVerified": { "type": "boolean", "enum": [ false ] }, "partialCoverage": { "type": "boolean", "enum": [ true ] }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/TrackSample" } }, "page": { "$ref": "#/components/schemas/Page" }, "links": { "$ref": "#/components/schemas/Links" } } }, "example": { "schemaVersion": "2.0.0", "datasetId": "pdigger-outdoors-v15", "demo": true, "sourceVersion": 15, "sourceCommit": "5f322b5ad3ecfce4aff5b5609456716099b28f62", "clock": "source_elapsed_seconds", "frameUtcVerified": false, "partialCoverage": true, "datasetRevision": "5318d837e37e1219e3ec72baf438cf1423a40fe7ea120f8567a8484c8527402f", "mode": "recorded_demo", "data": [ { "id": "V05:model:s0:0", "elapsedSec": 33600.028, "frameUtc": null, "sourceFrame": 0, "imageBox": null, "imagePosition": null, "relativePosition": [ -3.6546375534130213, -0.4912493353753353, -14.221509122041283 ], "coordinateStatus": "derived_model_pose_separate_from_detector_ground", "evidenceStatus": "estimated", "flags": [ "estimated_model_pose", "same_type_SAM_exemplar_not_identity", "manual_image_anchor_not_ground_measurement" ], "source": { "chunk": "attempt_00001/chunk_000560.mp4", "ptsSec": 0, "sha256": "d248662ee43ff9d08e765ca79dd099e999aaff7c26ba59fa262f57351f9a28c6", "anchorKind": "reviewed_image_body_landmark_for_model_pose", "coordinateReason": null }, "segmentId": "V05:presence:model_pose:0", "channel": "model" }, { "id": "V05:model:s0:1", "elapsedSec": 33602.824, "frameUtc": null, "sourceFrame": 12, "imageBox": null, "imagePosition": null, "relativePosition": [ -5.861235813341528, -3.982321587916724, -4.932838828893933 ], "coordinateStatus": "derived_model_pose_separate_from_detector_ground", "evidenceStatus": "estimated", "flags": [ "estimated_model_pose", "same_type_SAM_exemplar_not_identity", "manual_image_anchor_not_ground_measurement" ], "source": { "chunk": "attempt_00001/chunk_000560.mp4", "ptsSec": 2.796, "sha256": "d248662ee43ff9d08e765ca79dd099e999aaff7c26ba59fa262f57351f9a28c6", "anchorKind": "reviewed_image_body_landmark_for_model_pose", "coordinateReason": null }, "segmentId": "V05:presence:model_pose:0", "channel": "model" } ], "page": { "limit": 2, "returned": 2, "total": 4, "hasMore": true, "nextCursor": "eyJ2IjoxLCJkIjoiNTMxOGQ4MzdlMzdlMTIxOWUzZWM3MmJhZjQzOGNmMTQyM2E0MGZlN2VhMTIwZjg1NjdhODQ4NGM4NTI3NDAyZiIsInEiOiJiYzYzMzE2OTExOTlhZTVkZDc3ODI1YjJjYWE1ZmFhZDk4OTNhODUwNTBhNGNiNGNjYjgxZDZlMWY4ZDVkOWJjIiwiayI6WzMzNjAyLjgyNCwiVjA1Om1vZGVsOnMwOjEiXX0.8SvVyPKJGN8BJCcQeeP7K6gELfjWwanG-fXUfKW7cuk" }, "links": { "self": "/api/v1/tracks/V05/samples?channel=model&fromSec=33600&toSec=33610&limit=2", "next": "/api/v1/tracks/V05/samples?channel=model&fromSec=33600&toSec=33610&limit=2&cursor=eyJ2IjoxLCJkIjoiNTMxOGQ4MzdlMzdlMTIxOWUzZWM3MmJhZjQzOGNmMTQyM2E0MGZlN2VhMTIwZjg1NjdhODQ4NGM4NTI3NDAyZiIsInEiOiJiYzYzMzE2OTExOTlhZTVkZDc3ODI1YjJjYWE1ZmFhZDk4OTNhODUwNTBhNGNiNGNjYjgxZDZlMWY4ZDVkOWJjIiwiayI6WzMzNjAyLjgyNCwiVjA1Om1vZGVsOnMwOjEiXX0.8SvVyPKJGN8BJCcQeeP7K6gELfjWwanG-fXUfKW7cuk" }, "coordinates": { "image": "normalized_uv_u_right_v_down", "world": "camera_relative_x_right_y_up_negative_z_forward", "worldUnits": "relative" } } } } }, "304": { "description": "Response unchanged (If-None-Match). No body." }, "400": { "description": "Invalid parameter, range or cursor.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "example": { "error": { "code": "invalid_parameter", "message": "Invalid parameter, range or cursor.", "field": null, "requestId": "request-id" } } } } }, "404": { "description": "Resource or route does not exist.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "example": { "error": { "code": "not_found", "message": "Resource or route does not exist.", "field": null, "requestId": "request-id" } } } } }, "405": { "description": "This API supports GET, HEAD and OPTIONS.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "example": { "error": { "code": "method_not_allowed", "message": "This API supports GET, HEAD and OPTIONS.", "field": null, "requestId": "request-id" } } } } }, "409": { "description": "Dataset changed; restart without the cursor.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "example": { "error": { "code": "stale_cursor", "message": "Dataset changed; restart without the cursor.", "field": null, "requestId": "request-id" } } } } }, "500": { "description": "Request could not be completed.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "example": { "error": { "code": "internal_error", "message": "Request could not be completed.", "field": null, "requestId": "request-id" } } } } } }, "x-codeSamples": [ { "lang": "Shell", "label": "curl", "source": "curl -sS 'https://outdoors.pdigger.com/api/v1/tracks/V05/samples?channel=model&fromSec=33600&toSec=33610&limit=2'" } ] } } }, "components": { "schemas": { "Event": { "type": "object", "required": [ "id", "recordingId", "cameraId", "typeId", "categoryId", "recordKind", "countsAsAcceptedPassage", "uniqueAllDayIdentityVerified", "startSec", "endSec", "startUtc", "endUtc", "movement", "loadId", "detailUrl", "tracksUrl" ], "properties": { "id": { "type": "string" }, "recordingId": { "type": "string" }, "cameraId": { "type": "string" }, "typeId": { "type": "string", "nullable": true }, "typeLabel": { "type": "string" }, "categoryId": { "type": "string", "nullable": true }, "recordKind": { "type": "string", "enum": [ "reviewed_event", "context", "isolated_observation" ] }, "countsAsAcceptedPassage": { "type": "boolean" }, "uniqueAllDayIdentityVerified": { "type": "boolean", "enum": [ false ] }, "startSec": { "type": "number", "nullable": true }, "endSec": { "type": "number", "nullable": true }, "startUtc": { "type": "string", "nullable": true, "description": "Null: footage is not aligned to UTC." }, "endUtc": { "type": "string", "nullable": true }, "supportedPresence": { "type": "array", "items": { "type": "object", "additionalProperties": true } }, "actions": { "type": "array", "items": { "type": "object", "additionalProperties": true } }, "actionIds": { "type": "array", "items": { "type": "string" } }, "movement": { "$ref": "#/components/schemas/Movement" }, "loadId": { "type": "string", "nullable": true }, "localAssociation": { "type": "object", "additionalProperties": true, "nullable": true }, "limitations": { "type": "array", "items": { "type": "string" } }, "evidenceKind": { "type": "string", "nullable": true }, "detailUrl": { "type": "string" }, "tracksUrl": { "type": "string" } } }, "Movement": { "type": "object", "required": [ "cameraDirection", "facilityDirection", "motionState", "imageLane" ], "properties": { "cameraDirection": { "type": "string", "nullable": true }, "facilityDirection": { "type": "string", "nullable": true, "enum": [ "incoming", "outgoing", "waiting", null ], "description": "Null when entry/exit is not established; camera-frame direction is independent." }, "motionState": { "type": "string", "nullable": true }, "imageLane": { "type": "string", "nullable": true } } }, "Sample": { "type": "object", "required": [ "id", "elapsedSec", "frameUtc", "relativePosition", "imageBox", "imagePosition", "evidenceStatus" ], "properties": { "id": { "type": "string" }, "elapsedSec": { "type": "number", "nullable": true }, "frameUtc": { "type": "string", "nullable": true }, "sourceFrame": { "type": "number", "nullable": true }, "imageBox": { "type": "array", "items": { "type": "number" }, "minItems": 4, "maxItems": 4, "nullable": true, "description": "[left, top, right, bottom], normalized source image coordinates." }, "imagePosition": { "type": "array", "items": { "type": "number" }, "minItems": 2, "maxItems": 2, "nullable": true }, "relativePosition": { "type": "array", "items": { "type": "number" }, "minItems": 3, "maxItems": 3, "nullable": true, "description": "Arbitrary relative scene units, not metres." }, "coordinateStatus": { "type": "string", "nullable": true }, "evidenceStatus": { "type": "string", "enum": [ "estimated", "source_observation" ] }, "flags": { "type": "array", "items": { "type": "string" } }, "source": { "type": "object", "additionalProperties": true } } }, "Segment": { "type": "object", "required": [ "id", "startSec", "endSec", "samples" ], "properties": { "id": { "type": "string" }, "startSec": { "type": "number", "nullable": true }, "endSec": { "type": "number", "nullable": true }, "interpolation": { "type": "string", "nullable": true }, "samples": { "type": "array", "items": { "$ref": "#/components/schemas/Sample" } } } }, "TrackSummary": { "type": "object", "required": [ "id", "eventId", "recordingId", "imageSegmentCount", "worldSegmentCount", "imageSampleCount", "worldSampleCount", "markerCount", "detailUrl" ], "properties": { "id": { "type": "string" }, "eventId": { "type": "string" }, "recordingId": { "type": "string" }, "imageSegmentCount": { "type": "integer" }, "worldSegmentCount": { "type": "integer" }, "imageSampleCount": { "type": "integer" }, "worldSampleCount": { "type": "integer" }, "markerCount": { "type": "integer" }, "detailUrl": { "type": "string" } } }, "Track": { "type": "object", "required": [ "id", "eventId", "recordingId", "imageSegments", "worldSegments", "markers", "worldMarkers", "displaySupport", "source" ], "properties": { "id": { "type": "string" }, "eventId": { "type": "string" }, "recordingId": { "type": "string" }, "imageCoordinates": { "type": "string" }, "worldCoordinates": { "type": "string" }, "worldUnits": { "type": "string", "enum": [ "relative" ] }, "imageSegments": { "type": "array", "items": { "$ref": "#/components/schemas/Segment" } }, "worldSegments": { "type": "array", "items": { "$ref": "#/components/schemas/Segment" } }, "markers": { "type": "array", "items": { "$ref": "#/components/schemas/Sample" } }, "worldMarkers": { "type": "array", "items": { "$ref": "#/components/schemas/Sample" } }, "displaySupport": { "type": "object", "additionalProperties": true }, "source": { "type": "object", "additionalProperties": true } } }, "Load": { "type": "object", "required": [ "id", "sourceObservationId", "eventIds", "state", "material", "visibleFillPercent", "measurementBasis", "massKg", "volumeM3", "movement" ], "properties": { "id": { "type": "string" }, "sourceObservationId": { "type": "string" }, "eventIds": { "type": "array", "items": { "type": "string" } }, "state": { "type": "string", "nullable": true, "enum": [ "loaded", "empty", null ] }, "observedState": { "type": "string" }, "material": { "type": "object", "required": [ "type", "identityVerified" ], "properties": { "type": { "type": "string", "nullable": true, "description": "Open material vocabulary, e.g. beans, sand and gravel. Null when material identity has not been verified." }, "visualDescription": { "type": "string", "nullable": true }, "identityVerified": { "type": "boolean" } } }, "visibleFillPercent": { "type": "array", "items": { "type": "number" }, "minItems": 2, "maxItems": 2, "nullable": true, "description": "Coarse apparent fullness range. Neither a calibrated volume nor a statistical confidence interval." }, "measurementBasis": { "type": "string", "enum": [ "visual_estimate" ] }, "volumeM3": { "type": "number", "nullable": true }, "massKg": { "type": "number", "nullable": true }, "confidence": { "type": "string", "nullable": true }, "trailerCount": { "type": "number", "nullable": true }, "trailers": { "type": "array", "items": { "type": "object", "additionalProperties": true } }, "movement": { "$ref": "#/components/schemas/Movement" }, "evidence": { "type": "array", "items": { "type": "object", "additionalProperties": true } }, "notes": { "type": "string", "nullable": true } } }, "Recording": { "type": "object", "required": [ "id", "sessionStartISO", "sessionStartVerified", "captureStartISO", "captureDateVerified", "sourceStartSec", "sourceEndSec" ], "properties": { "id": { "type": "string" }, "cameraId": { "type": "string" }, "label": { "type": "string" }, "sessionStartISO": { "type": "string", "format": "date-time", "description": "Verified recorder-host session start. Not the UTC of video frame zero." }, "sessionStartVerified": { "type": "boolean" }, "captureStartISO": { "type": "string", "nullable": true }, "captureDateVerified": { "type": "boolean" }, "sessionClock": { "type": "string" }, "sourceStartSec": { "type": "number" }, "sourceEndSec": { "type": "number" }, "captureComplete": { "type": "boolean" }, "coverageNote": { "type": "string" }, "provenance": { "type": "object", "additionalProperties": true }, "elapsedClock": { "type": "object", "additionalProperties": true } } }, "Camera": { "type": "object", "required": [ "id", "recordingIds", "intrinsicsAndPose" ], "properties": { "id": { "type": "string" }, "name": { "type": "string" }, "recordingIds": { "type": "array", "items": { "type": "string" } }, "intrinsicsAndPose": { "type": "object", "additionalProperties": true }, "image": { "type": "object", "additionalProperties": true } } }, "Asset": { "type": "object", "required": [ "id", "url", "kind", "bytes", "sha256" ], "properties": { "id": { "type": "string" }, "url": { "type": "string" }, "kind": { "type": "string" }, "bytes": { "type": "integer", "minimum": 0 }, "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" } } }, "CalendarResponse": { "type": "object", "required": [ "schemaVersion", "datasetId", "demo", "sourceVersion", "sourceCommit", "clock", "frameUtcVerified", "partialCoverage", "data" ], "properties": { "schemaVersion": { "type": "string" }, "datasetId": { "type": "string" }, "demo": { "type": "boolean", "enum": [ true ] }, "sourceVersion": { "type": "integer" }, "sourceCommit": { "type": "string" }, "clock": { "type": "string", "enum": [ "source_elapsed_seconds" ] }, "frameUtcVerified": { "type": "boolean", "enum": [ false ] }, "partialCoverage": { "type": "boolean", "enum": [ true ] }, "data": { "type": "object", "properties": { "schema": { "type": "string" }, "recordings": { "type": "array", "items": { "$ref": "#/components/schemas/Recording" } }, "anchorStatus": { "type": "string" } }, "required": [ "recordings", "anchorStatus" ] } } }, "RecordingsResponse": { "type": "object", "required": [ "schemaVersion", "datasetId", "demo", "sourceVersion", "sourceCommit", "clock", "frameUtcVerified", "partialCoverage", "data" ], "properties": { "schemaVersion": { "type": "string" }, "datasetId": { "type": "string" }, "demo": { "type": "boolean", "enum": [ true ] }, "sourceVersion": { "type": "integer" }, "sourceCommit": { "type": "string" }, "clock": { "type": "string", "enum": [ "source_elapsed_seconds" ] }, "frameUtcVerified": { "type": "boolean", "enum": [ false ] }, "partialCoverage": { "type": "boolean", "enum": [ true ] }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/Recording" } } } }, "CamerasResponse": { "type": "object", "required": [ "schemaVersion", "datasetId", "demo", "sourceVersion", "sourceCommit", "clock", "frameUtcVerified", "partialCoverage", "data" ], "properties": { "schemaVersion": { "type": "string" }, "datasetId": { "type": "string" }, "demo": { "type": "boolean", "enum": [ true ] }, "sourceVersion": { "type": "integer" }, "sourceCommit": { "type": "string" }, "clock": { "type": "string", "enum": [ "source_elapsed_seconds" ] }, "frameUtcVerified": { "type": "boolean", "enum": [ false ] }, "partialCoverage": { "type": "boolean", "enum": [ true ] }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/Camera" } } } }, "SummaryResponse": { "type": "object", "required": [ "schemaVersion", "datasetId", "demo", "sourceVersion", "sourceCommit", "clock", "frameUtcVerified", "partialCoverage", "data" ], "properties": { "schemaVersion": { "type": "string" }, "datasetId": { "type": "string" }, "demo": { "type": "boolean", "enum": [ true ] }, "sourceVersion": { "type": "integer" }, "sourceCommit": { "type": "string" }, "clock": { "type": "string", "enum": [ "source_elapsed_seconds" ] }, "frameUtcVerified": { "type": "boolean", "enum": [ false ] }, "partialCoverage": { "type": "boolean", "enum": [ true ] }, "data": { "type": "object", "required": [ "acceptedEvents", "displayRecords", "coverage" ], "properties": { "acceptedEvents": { "type": "integer" }, "roadVehicleEvents": { "type": "integer" }, "machineryEvents": { "type": "integer" }, "humanEvents": { "type": "integer" }, "displayRecords": { "type": "integer" }, "uniqueVehicleCount": { "type": "number", "nullable": true }, "uniqueHumanCount": { "type": "number", "nullable": true }, "coverage": { "type": "object", "additionalProperties": true }, "durationSec": { "type": "number" } } } } }, "TaxonomyResponse": { "type": "object", "required": [ "schemaVersion", "datasetId", "demo", "sourceVersion", "sourceCommit", "clock", "frameUtcVerified", "partialCoverage", "data" ], "properties": { "schemaVersion": { "type": "string" }, "datasetId": { "type": "string" }, "demo": { "type": "boolean", "enum": [ true ] }, "sourceVersion": { "type": "integer" }, "sourceCommit": { "type": "string" }, "clock": { "type": "string", "enum": [ "source_elapsed_seconds" ] }, "frameUtcVerified": { "type": "boolean", "enum": [ false ] }, "partialCoverage": { "type": "boolean", "enum": [ true ] }, "data": { "type": "object", "additionalProperties": true } } }, "EventsResponse": { "type": "object", "required": [ "schemaVersion", "datasetId", "demo", "sourceVersion", "sourceCommit", "clock", "frameUtcVerified", "partialCoverage", "data" ], "properties": { "schemaVersion": { "type": "string" }, "datasetId": { "type": "string" }, "demo": { "type": "boolean", "enum": [ true ] }, "sourceVersion": { "type": "integer" }, "sourceCommit": { "type": "string" }, "clock": { "type": "string", "enum": [ "source_elapsed_seconds" ] }, "frameUtcVerified": { "type": "boolean", "enum": [ false ] }, "partialCoverage": { "type": "boolean", "enum": [ true ] }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/Event" } } } }, "VehiclesResponse": { "type": "object", "required": [ "schemaVersion", "datasetId", "demo", "sourceVersion", "sourceCommit", "clock", "frameUtcVerified", "partialCoverage", "data" ], "properties": { "schemaVersion": { "type": "string" }, "datasetId": { "type": "string" }, "demo": { "type": "boolean", "enum": [ true ] }, "sourceVersion": { "type": "integer" }, "sourceCommit": { "type": "string" }, "clock": { "type": "string", "enum": [ "source_elapsed_seconds" ] }, "frameUtcVerified": { "type": "boolean", "enum": [ false ] }, "partialCoverage": { "type": "boolean", "enum": [ true ] }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/Event" } } } }, "HumansResponse": { "type": "object", "required": [ "schemaVersion", "datasetId", "demo", "sourceVersion", "sourceCommit", "clock", "frameUtcVerified", "partialCoverage", "data" ], "properties": { "schemaVersion": { "type": "string" }, "datasetId": { "type": "string" }, "demo": { "type": "boolean", "enum": [ true ] }, "sourceVersion": { "type": "integer" }, "sourceCommit": { "type": "string" }, "clock": { "type": "string", "enum": [ "source_elapsed_seconds" ] }, "frameUtcVerified": { "type": "boolean", "enum": [ false ] }, "partialCoverage": { "type": "boolean", "enum": [ true ] }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/Event" } } } }, "TracksResponse": { "type": "object", "required": [ "schemaVersion", "datasetId", "demo", "sourceVersion", "sourceCommit", "clock", "frameUtcVerified", "partialCoverage", "data" ], "properties": { "schemaVersion": { "type": "string" }, "datasetId": { "type": "string" }, "demo": { "type": "boolean", "enum": [ true ] }, "sourceVersion": { "type": "integer" }, "sourceCommit": { "type": "string" }, "clock": { "type": "string", "enum": [ "source_elapsed_seconds" ] }, "frameUtcVerified": { "type": "boolean", "enum": [ false ] }, "partialCoverage": { "type": "boolean", "enum": [ true ] }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/TrackSummary" } } } }, "LoadsResponse": { "type": "object", "required": [ "schemaVersion", "datasetId", "demo", "sourceVersion", "sourceCommit", "clock", "frameUtcVerified", "partialCoverage", "data" ], "properties": { "schemaVersion": { "type": "string" }, "datasetId": { "type": "string" }, "demo": { "type": "boolean", "enum": [ true ] }, "sourceVersion": { "type": "integer" }, "sourceCommit": { "type": "string" }, "clock": { "type": "string", "enum": [ "source_elapsed_seconds" ] }, "frameUtcVerified": { "type": "boolean", "enum": [ false ] }, "partialCoverage": { "type": "boolean", "enum": [ true ] }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/Load" } } } }, "SceneResponse": { "type": "object", "required": [ "schemaVersion", "datasetId", "demo", "sourceVersion", "sourceCommit", "clock", "frameUtcVerified", "partialCoverage", "data" ], "properties": { "schemaVersion": { "type": "string" }, "datasetId": { "type": "string" }, "demo": { "type": "boolean", "enum": [ true ] }, "sourceVersion": { "type": "integer" }, "sourceCommit": { "type": "string" }, "clock": { "type": "string", "enum": [ "source_elapsed_seconds" ] }, "frameUtcVerified": { "type": "boolean", "enum": [ false ] }, "partialCoverage": { "type": "boolean", "enum": [ true ] }, "data": { "type": "object", "additionalProperties": true } } }, "AssetsResponse": { "type": "object", "required": [ "schemaVersion", "datasetId", "demo", "sourceVersion", "sourceCommit", "clock", "frameUtcVerified", "partialCoverage", "data" ], "properties": { "schemaVersion": { "type": "string" }, "datasetId": { "type": "string" }, "demo": { "type": "boolean", "enum": [ true ] }, "sourceVersion": { "type": "integer" }, "sourceCommit": { "type": "string" }, "clock": { "type": "string", "enum": [ "source_elapsed_seconds" ] }, "frameUtcVerified": { "type": "boolean", "enum": [ false ] }, "partialCoverage": { "type": "boolean", "enum": [ true ] }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/Asset" } } } }, "EventResponse": { "type": "object", "required": [ "schemaVersion", "datasetId", "demo", "sourceVersion", "sourceCommit", "clock", "frameUtcVerified", "partialCoverage", "data" ], "properties": { "schemaVersion": { "type": "string" }, "datasetId": { "type": "string" }, "demo": { "type": "boolean", "enum": [ true ] }, "sourceVersion": { "type": "integer" }, "sourceCommit": { "type": "string" }, "clock": { "type": "string", "enum": [ "source_elapsed_seconds" ] }, "frameUtcVerified": { "type": "boolean", "enum": [ false ] }, "partialCoverage": { "type": "boolean", "enum": [ true ] }, "data": { "$ref": "#/components/schemas/Event" } } }, "TrackResponse": { "type": "object", "required": [ "schemaVersion", "datasetId", "demo", "sourceVersion", "sourceCommit", "clock", "frameUtcVerified", "partialCoverage", "data" ], "properties": { "schemaVersion": { "type": "string" }, "datasetId": { "type": "string" }, "demo": { "type": "boolean", "enum": [ true ] }, "sourceVersion": { "type": "integer" }, "sourceCommit": { "type": "string" }, "clock": { "type": "string", "enum": [ "source_elapsed_seconds" ] }, "frameUtcVerified": { "type": "boolean", "enum": [ false ] }, "partialCoverage": { "type": "boolean", "enum": [ true ] }, "data": { "$ref": "#/components/schemas/Track" } } }, "Page": { "type": "object", "required": [ "limit", "returned", "total", "hasMore", "nextCursor" ], "properties": { "limit": { "type": "integer" }, "returned": { "type": "integer" }, "total": { "type": "integer", "description": "Matching records in this fixed dataset; not a count of unique people or vehicles." }, "hasMore": { "type": "boolean" }, "nextCursor": { "type": "string", "nullable": true, "description": "Opaque signed continuation token. Keep endpoint, filters and limit unchanged." } } }, "Links": { "type": "object", "required": [ "self", "next" ], "properties": { "self": { "type": "string" }, "next": { "type": "string", "nullable": true } } }, "Error": { "type": "object", "required": [ "error" ], "properties": { "error": { "type": "object", "required": [ "code", "message", "field", "requestId" ], "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "field": { "type": "string", "nullable": true }, "requestId": { "type": "string" } } } } }, "TrackMetadata": { "type": "object", "required": [ "id", "eventId", "samplesUrl", "availableChannels" ], "properties": { "id": { "type": "string" }, "eventId": { "type": "string" }, "recordingId": { "type": "string" }, "imageCoordinates": { "type": "string" }, "worldCoordinates": { "type": "string" }, "worldUnits": { "type": "string", "enum": [ "relative" ] }, "source": { "type": "object", "additionalProperties": true }, "samplesUrl": { "type": "string" }, "availableChannels": { "type": "array", "items": { "type": "string" } }, "snapshotUrl": { "type": "string" } } }, "TrackSample": { "allOf": [ { "$ref": "#/components/schemas/Sample" }, { "type": "object", "required": [ "channel", "segmentId" ], "properties": { "channel": { "type": "string" }, "segmentId": { "type": "string", "nullable": true } } } ] }, "eventsPage": { "type": "object", "required": [ "schemaVersion", "datasetId", "datasetRevision", "demo", "mode", "data", "page", "links" ], "properties": { "schemaVersion": { "type": "string", "enum": [ "2.0.0" ] }, "datasetId": { "type": "string" }, "datasetRevision": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "demo": { "type": "boolean", "enum": [ true ] }, "mode": { "type": "string", "enum": [ "recorded_demo" ] }, "sourceVersion": { "type": "integer" }, "sourceCommit": { "type": "string" }, "clock": { "type": "string", "enum": [ "source_elapsed_seconds" ] }, "frameUtcVerified": { "type": "boolean", "enum": [ false ] }, "partialCoverage": { "type": "boolean", "enum": [ true ] }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/Event" } }, "page": { "$ref": "#/components/schemas/Page" }, "links": { "$ref": "#/components/schemas/Links" } } }, "vehiclesPage": { "type": "object", "required": [ "schemaVersion", "datasetId", "datasetRevision", "demo", "mode", "data", "page", "links" ], "properties": { "schemaVersion": { "type": "string", "enum": [ "2.0.0" ] }, "datasetId": { "type": "string" }, "datasetRevision": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "demo": { "type": "boolean", "enum": [ true ] }, "mode": { "type": "string", "enum": [ "recorded_demo" ] }, "sourceVersion": { "type": "integer" }, "sourceCommit": { "type": "string" }, "clock": { "type": "string", "enum": [ "source_elapsed_seconds" ] }, "frameUtcVerified": { "type": "boolean", "enum": [ false ] }, "partialCoverage": { "type": "boolean", "enum": [ true ] }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/Event" } }, "page": { "$ref": "#/components/schemas/Page" }, "links": { "$ref": "#/components/schemas/Links" } } }, "humansPage": { "type": "object", "required": [ "schemaVersion", "datasetId", "datasetRevision", "demo", "mode", "data", "page", "links" ], "properties": { "schemaVersion": { "type": "string", "enum": [ "2.0.0" ] }, "datasetId": { "type": "string" }, "datasetRevision": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "demo": { "type": "boolean", "enum": [ true ] }, "mode": { "type": "string", "enum": [ "recorded_demo" ] }, "sourceVersion": { "type": "integer" }, "sourceCommit": { "type": "string" }, "clock": { "type": "string", "enum": [ "source_elapsed_seconds" ] }, "frameUtcVerified": { "type": "boolean", "enum": [ false ] }, "partialCoverage": { "type": "boolean", "enum": [ true ] }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/Event" } }, "page": { "$ref": "#/components/schemas/Page" }, "links": { "$ref": "#/components/schemas/Links" } } }, "loadsPage": { "type": "object", "required": [ "schemaVersion", "datasetId", "datasetRevision", "demo", "mode", "data", "page", "links" ], "properties": { "schemaVersion": { "type": "string", "enum": [ "2.0.0" ] }, "datasetId": { "type": "string" }, "datasetRevision": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "demo": { "type": "boolean", "enum": [ true ] }, "mode": { "type": "string", "enum": [ "recorded_demo" ] }, "sourceVersion": { "type": "integer" }, "sourceCommit": { "type": "string" }, "clock": { "type": "string", "enum": [ "source_elapsed_seconds" ] }, "frameUtcVerified": { "type": "boolean", "enum": [ false ] }, "partialCoverage": { "type": "boolean", "enum": [ true ] }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/Load" } }, "page": { "$ref": "#/components/schemas/Page" }, "links": { "$ref": "#/components/schemas/Links" } } }, "tracksPage": { "type": "object", "required": [ "schemaVersion", "datasetId", "datasetRevision", "demo", "mode", "data", "page", "links" ], "properties": { "schemaVersion": { "type": "string", "enum": [ "2.0.0" ] }, "datasetId": { "type": "string" }, "datasetRevision": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "demo": { "type": "boolean", "enum": [ true ] }, "mode": { "type": "string", "enum": [ "recorded_demo" ] }, "sourceVersion": { "type": "integer" }, "sourceCommit": { "type": "string" }, "clock": { "type": "string", "enum": [ "source_elapsed_seconds" ] }, "frameUtcVerified": { "type": "boolean", "enum": [ false ] }, "partialCoverage": { "type": "boolean", "enum": [ true ] }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/TrackSummary" } }, "page": { "$ref": "#/components/schemas/Page" }, "links": { "$ref": "#/components/schemas/Links" } } }, "camerasPage": { "type": "object", "required": [ "schemaVersion", "datasetId", "datasetRevision", "demo", "mode", "data", "page", "links" ], "properties": { "schemaVersion": { "type": "string", "enum": [ "2.0.0" ] }, "datasetId": { "type": "string" }, "datasetRevision": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "demo": { "type": "boolean", "enum": [ true ] }, "mode": { "type": "string", "enum": [ "recorded_demo" ] }, "sourceVersion": { "type": "integer" }, "sourceCommit": { "type": "string" }, "clock": { "type": "string", "enum": [ "source_elapsed_seconds" ] }, "frameUtcVerified": { "type": "boolean", "enum": [ false ] }, "partialCoverage": { "type": "boolean", "enum": [ true ] }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/Camera" } }, "page": { "$ref": "#/components/schemas/Page" }, "links": { "$ref": "#/components/schemas/Links" } } }, "recordingsPage": { "type": "object", "required": [ "schemaVersion", "datasetId", "datasetRevision", "demo", "mode", "data", "page", "links" ], "properties": { "schemaVersion": { "type": "string", "enum": [ "2.0.0" ] }, "datasetId": { "type": "string" }, "datasetRevision": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "demo": { "type": "boolean", "enum": [ true ] }, "mode": { "type": "string", "enum": [ "recorded_demo" ] }, "sourceVersion": { "type": "integer" }, "sourceCommit": { "type": "string" }, "clock": { "type": "string", "enum": [ "source_elapsed_seconds" ] }, "frameUtcVerified": { "type": "boolean", "enum": [ false ] }, "partialCoverage": { "type": "boolean", "enum": [ true ] }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/Recording" } }, "page": { "$ref": "#/components/schemas/Page" }, "links": { "$ref": "#/components/schemas/Links" } } }, "assetsPage": { "type": "object", "required": [ "schemaVersion", "datasetId", "datasetRevision", "demo", "mode", "data", "page", "links" ], "properties": { "schemaVersion": { "type": "string", "enum": [ "2.0.0" ] }, "datasetId": { "type": "string" }, "datasetRevision": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "demo": { "type": "boolean", "enum": [ true ] }, "mode": { "type": "string", "enum": [ "recorded_demo" ] }, "sourceVersion": { "type": "integer" }, "sourceCommit": { "type": "string" }, "clock": { "type": "string", "enum": [ "source_elapsed_seconds" ] }, "frameUtcVerified": { "type": "boolean", "enum": [ false ] }, "partialCoverage": { "type": "boolean", "enum": [ true ] }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/Asset" } }, "page": { "$ref": "#/components/schemas/Page" }, "links": { "$ref": "#/components/schemas/Links" } } } } } }