PhotoOut

A session photo with where and when it was taken.

Placement uses t = taken_at when it falls within the shift (from 10 minutes before its start to 5 minutes after its end, or to now while it is open), else uploaded_at, when the upload finished. taken_at is returned as the phone sent it, except that a time ahead of the server when the upload began is stored as that time. Placement tries in order: the phone's capture fix when its accuracy is 100 m or better and taken_at, if sent, falls within the shift (capture); the nearest stored fix in the session within 60 s of t (fix); the latest stored fix at or before t in the session, else the first one after t (last_fix, approximate); interpolation along a closed session's track (track_estimate, approximate). A photo matching none of them has null coordinates and location_source.

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
• null

number

longitude object

anyOf

• number
• null

number

location_source object

anyOf

• string
• null

string

Possible values: [capture, fix, last_fix, track_estimate]

location_approximateLocation Approximate (boolean)required

True when the location is an estimate rather than a fix at the photo time.

download_urlDownload Url (string)required

device_uuidstring<uuid>required

device_nameDevice Name (string)required

session_idstring<uuid>required

captured_atstring<date-time>required

taken_at when the phone sent it, else uploaded_at.

taken_at object

When the phone says the photo was taken, or when the upload began if the phone's clock was ahead; null if it did not say.

anyOf

• string<date-time>
• null

string<date-time>

uploaded_atstring<date-time>required

When the upload finished.

PhotoOut

{
  "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "file_key": "string",
  "original_name": "string",
  "content_type": "string",
  "size_bytes": 0,
  "latitude": 0,
  "longitude": 0,
  "location_source": "capture",
  "location_approximate": true,
  "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",
  "taken_at": "2024-07-29T15:51:28.071Z",
  "uploaded_at": "2024-07-29T15:51:28.071Z"
}