Returns the last recorded raw data value for all requested channels within the specified time range. Especially for digital or text channels that change infrequently, the returned samples may point to timestamps in the past. This means that the value of the channel has not changed within the specified time range and is still valid.
Message "GetLastRecordedChannelValueRequest"
|
Pos. |
Parameter |
Data type |
Meaning |
|---|---|---|---|
|
1 |
time_range_from |
int64 |
Unix time stamp in microseconds, which limits how far in the past the last recorded value should be searched for Leave 0 for maximum range |
|
2 |
time_range_to |
int64 |
Unix time stamp in microseconds, returns the last recorded value before this time stamp To retrieve the last value ever recorded, set time_range_to to a date in the future or an int64 max value. |
|
3 |
channel_ids |
string |
List of channel IDs in the format Example: |
Message "GetLastRecordedChannelValueResponse"
Returns a single raw data point or the ChannelValue message for each requested channel. If no measured value was found for a specific channel, the response does not contain any data for this channel. The message contains the following parameters.
|
Pos. |
Parameter |
Data type |
Meaning |
|---|---|---|---|
|
1 |
channel_id |
string |
Channel It in the format Example: |
|
2 |
timestamp |
int64 |
Unix time stamp in microseconds |
|
3 |
data_type |
enum(DataType) |
Data type of the returned value, see Enum "DataType". |
|
4 |
float_value |
float |
See Message "FloatValue". |
|
5 |
double_value |
double |
|
|
6 |
string_value |
string |
|
|
7 |
digital_value |
float |
Message "FloatValue"
|
Pos. |
Parameter |
Data type |
Meaning |
|---|---|---|---|
|
1 |
min_values |
float |
Optional: Minimum values of an aggregated channel Empty by default if not requested |
|
2 |
max_values |
float |
Optional: Maximum values of an aggregated channel Empty by default if not requested |
|
3 |
avg_values |
float |
Optional: Average values of an aggregated channel Empty by default if not requested |
Message "DoubleValue"
|
Pos. |
Parameter |
Data type |
Meaning |
|---|---|---|---|
|
1 |
min_values |
double |
Optional: Minimum values of an aggregated channel Empty by default if not requested |
|
2 |
max_values |
double |
Optional: Maximum values of an aggregated channel Empty by default if not requested |
|
3 |
avg_values |
double |
Optional: Average values of an aggregated channel Empty by default if not requested |
Message "StringValue"
|
Pos. |
Parameter |
Data type |
Meaning |
|---|---|---|---|
|
1 |
timestamp |
int64 |
Non-equidistant Unix time stamp in microseconds |
|
2 |
value |
value |
Non-equidistant string values |
Message "DigitalValue"
|
Pos. |
Parameter |
Data type |
Meaning |
|---|---|---|---|
|
1 |
timestamp |
int64 |
Non-equidistant Unix time stamps in microseconds |
|
2 |
value |
float |
Non-equidistant edge changes (0 or 1) or gaps (NaN) in the digital channel |
|
3 |
edgeCount |
float |
Non-equidistant edge counting of the digital channel. Indicates how often the signal value has changed in the aggregated time interval. |
|
4 |
min |
float |
Non-equidistant minimum value of the digital channel |
|
5 |
max |
float |
Non-equidistant maximum value of the digital channel |
Enum "DataType"
The following values are available for DataType.
|
Value |
Meaning |
|
|---|---|---|
|
0 |
DATA_TYPE_UNSPECIFIED |
Not specified |
|
1 |
DATA_TYPE_FLOAT_VALUES |
Value of type "float" |
|
2 |
DATA_TYPE_DOUBLE_VALUES |
Value of type "double" |
|
3 |
DATA_TYPE_STRING_VALUES |
Value of type "string" |
|
4 |
DATA_TYPE_DIGITAL_VALUES |
Digital value |
|
5 |
DATA_TYPE_NE_FLOAT_VALUES |
Value of type “float” that was stored non-equidistantly |
|
6 |
DATA_TYPE_NE_DOUBLE_VALUES |
Digital value that was stored non-equidistantly |
|
7 |
DATA_TYPE_DIGITAL_EDGE_VALUES |
Number of changes of a digital non-equidistant value |