Schema & Types

The Telemetry API displays data in two aggregation types, FloatAggregation & StringAggregation. To specify for each aggregation type, you will need to provide an interval.

Interval String

Interval is the time span that is used for aggregating the data with. A duration string is a sequence of decimal numbers, each with optional fraction and a unit suffix, such as 300ms, -1.5h or 2h45m.

Valid Interval Units

ms	milliseconds
s	seconds
m	minutes
h	hours
d	days
w	weeks
y	years

FloatAggregationType

Aggregation type for floats.

AVG	Returns the average value from the dataset.
MAX	Returns the maximum value from the dataset.
MED	Returns the median value from the dataset.
MIN	Returns the minimum value from the dataset.
RAND	Returns a randomly-selected value from the dataset.

StringAggregationType

Aggregation type for strings.

RAND	Returns a randomly-selected value from the dataset.
TOP	Returns the most frequently occurring value in the dataset.
UNIQUE	Return a list of unique values in the dataset.

SignalFilter

The SignalFiler filters signals by source type, valid source types are described below:

Valid Source Input

autopi	Signals from AutoPi aftermarket device.
macaron	Signals from Macaron aftermarket device.
smartcar	Signals from Smartcar integration.
tesla	Signals from Tesla integration.