Skip to navigation
System ComponentsMiddlewareAPI Gateway / MCPVideo Analytics APIVideo Analytics API Referencemetrics

Get average speed

View as Markdown

Calculate average object speed for a place or sensor over a time range, with optional filters for stationary and short-lived behaviors.

Query parameters

fromTimestampdatetimeRequired
toTimestampdatetimeRequired
placestringOptionalformat: "^.{0,10000}$"<=10000 characters
This parameter is incompatible with sensorId. Only one of them can exist in the query.
sensorIdstringOptionalformat: "^.{0,10000}$"<=10000 characters
This parameter is incompatible with place. Only one of them can exist in the query.
stationaryObjectMaxTimeIntervalThresholdInSeclongOptional1-900Defaults to 500
stationaryObjectMinDistanceThresholdInMeterslongOptional1-10Defaults to 5
shortLivedBehaviorMinTimeIntervalInSeclongOptional1-10Defaults to 3

Response headers

Access-Control-Allow-OriginstringOptionalformat: "^.{0,10000}$"<=10000 characters

CORS header to allow cross-origin requests.

X-RateLimit-LimitintegerOptional
The maximum number of requests allowed in the current time period.
X-RateLimit-RemainingintegerOptional
The number of requests remaining in the current time period.
X-RateLimit-ResetintegerOptional

The time when the rate limit will be reset (Unix timestamp).

Response

Successful Operation.
metricslist of objects
directionenum
Allowed values:
averageSpeedstringformat: "^.{0,10000}$"<=10000 characters

Errors

400
Bad Request Error
404
Not Found Error
422
Unprocessable Entity Error
500
Internal Server Error