Operation is used to compare a TV (CCTV) observation's duct-attribute fields against a snsewerduct object: the duct confirmed for the observation's inspection when there is one, otherwise the nearest snsewerduct within tolerance, auto-matched by GIS proximity. The confirmed link wins because it is the duct the apply endpoint writes to.
Form, material and dimension are compared, matched the way
/tv-inspection/apply-duct-diff/ resolves them: the form against the
duct's DuctProfile text, material and dimension against its duct type. The
other fields have no counterpart on the duct, so their keyaqua_value is
null and they never differ. A field the inspection left empty never
differs either: there is nothing to apply from it.
A confirmed link to a duct that has since been deleted compares against nothing: the apply endpoint refuses it, so a nearby duct would only invite a write that cannot happen.
status is what a duct graph colours the observation by:
disabled_from_update when a user disabled it (whatever the comparison
says); not_compared when no duct matched, or the observation records none
of form, material and dimension (most defect observations); needs_attention
when any field differs - also after a "Not update" review, which records a
decision rather than a match; and all_good otherwise.
Token issued for API consumer.
Maximum auto-match distance in meters. Defaults to 0.2 (20 cm).
Id of the TV observation to compare
Comparison result
Whether the two values disagree. Null when no verdict can be reached - the inspector recorded nothing, or the comparison returns a placeholder - so "not comparable" is never rendered as agreement.
Field name being compared
Value from the inspection record. FK fields are shown as a nested {id, txt} object.
Value from the matched KeyAqua network object. The connection comparison returns the duct's own value here; the inspection and observation comparisons still return a placeholder null.
Id of the snsewerduct compared against - the inspection's confirmed duct, else the nearest within tolerance. Null if none.
The observation's review state. Null if nobody has judged it.
What a duct graph colours the observation by
There was an error in request. Usually field validation failed.
Fields which failed validation
List of validation errors for this fieldname
Authentication credentials are missing or invalid
{
"details": "Authentication credentials were not provided"
}Standard error response payload
Detailed description of error
The user may not view this TV inspection or the sewer ducts it is compared against.
Object was not found
{
"details": "Not found."
}Standard error response payload
Detailed description of error