Skip to main content

PhotoOut

Response item for GET /devices/{uuid}/sessions/{session_id}/photos (Phase 120-04, D-16).

Lat/lon are derived per D-07:

  • Nearest DeviceLocation within ±60s of captured_at, OR
  • ST_LineInterpolatePoint on session.track_geometry (closed sessions only), OR
  • None when neither path produces a result (D-09 — entry still appears in the listing).

session_id added in Phase 122-01 (D-03) so the dashboard popup can deep-link to the session detail panel. Backward-compatible addition: SDK consumers that do not read session_id continue to work; consumers that need it (Phase 122 frontend popup) can read it directly from this listing.

idstring<uuid>required
file_keyFile Key (string)required
original_nameOriginal Name (string)required
content_typeContent Type (string)required
size_bytesSize Bytes (integer)required
latitude object
anyOf
number
longitude object
anyOf
number
download_urlDownload Url (string)required
device_uuidstring<uuid>required
device_nameDevice Name (string)required
session_idstring<uuid>required
captured_atstring<date-time>required
PhotoOut
{
  "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "file_key": "string",
  "original_name": "string",
  "content_type": "string",
  "size_bytes": 0,
  "latitude": 0,
  "longitude": 0,
  "download_url": "string",
  "device_uuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "device_name": "string",
  "session_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "captured_at": "2024-07-29T15:51:28.071Z"
}