Last updated on September 16th, 2024
All Explorer data can be retrieved on 2 different platforms:
- Insight: a ready-to-use platform configured by the Kinéis team, with maps and graphic charts
- External platform: retrieve Explorer data on any external platform
Insight platform
Platform usage
Access the platform
After the onboarding meeting, an email with a link to the Insight platform will be sent, along with user login and password. Click on the link in the email or on this one: https://insight-app.kineis.com/. Log in and update the password.
Select the Explorer device
Choose the device from the drop-down menu.
Device location
2 types of locations can be retrieved:
- the GNSS location acquired by your device
- the Kinéis native positioning computed from the Doppler location, called "Alternative Geolocation" on Insight (option available on request).
Widgets
The widgets display the latest data acquired by the device:
- Explorer status: ‘’On‘’, or ‘’Off‘’ if no message received from the device since more than 3 days
- Battery life: % of full charge
- Battery power supply status: powered or not
- Temperature (°C)
- Humidity level (%)
- Pressure (hPa)
Data acquisition date and time specified in each widget. More widgets may be configured on demand:
- Alarms
- Shock detection
- Dry contact: ‘’On‘’ or ‘’Off‘’
- Message type: regular, manual or alerting
Graphs
With the graphs, consult the data evolution:
- Temperature & pressure history
- Humidity history
- Shock detection history
- Battery level evolution
- Power supply status evolution
Zoom
To zoom on a graph, selects specific sections of interest with the cursor:
Download data
To download data from a graph, click on the bottom right button:
External platform
To retrieve data on an external platform (e.g., LiveObjects, ThingsBoard) or on a custom platform, configure data distribution settings via the Kinéis Services Portal.
Distribution formats for the Explorer
The data is processed, decoded and pushed to an endpoint in JSON format.
Standard processed format
Processed data with integrity check.
- DEVICE_ID: device identifier
- MSG_ID: message identifier
- MSG_DATE: message reception time in UTC
- CHECKED: message verification status
- SENSORS: decoded message data
Processed type basic - Explorer example
{
"TYPE":"DEVICE_PRC",
"MODE":"BASIC",
"VERSION":"1.1",
"DATA":[
{
"DEVICE_ID":86051,
"MSG_ID":"973974838647627776",
"MSG_DATE":"2022-04-01T18:20:02.449Z",
"CHECKED":"Y",
"SENSORS":{
"GPS_DATE":"2023-02-21T06:03:16Z",
"BATTERY_LOAD":1.0,
"LIGHT_LOW_FLAG":"Under Threshold",
"POS_ALERT_ZONE_IN_OUT":"Leaving",
"HUMIDITY":51,
"LIGHT_HIGH_FLAG":"Under Threshold",
"ACCELERO_FLAG":"Normal",
"MESSAGE_TYPE":"REGULAR",
"ALT":162.0,
"POS_ALERT_ZONE":"None",
"GPS_FAILED":false,
"PRESSURE":1002.5,
"BATTERY_STATUS":"Battery",
"TEMPERATURE":11.0,
"SUP_FREE_RAW_DATA":"000000000000",
"DRY_CONTACT_FLAG":"Off",
"BCH_STATUS":1,
"LAT":43.5498,
"CRC_OK":true,
"LONG":1.4855
}
}
]
}
Live Objects format
Live Objects compliant processed data with integrity check.
- streamId: streamId where the message is forwarded. Follows the format “urn:lo:nsid:x-kineis:{DeviceId}", where {DeviceId} is the device identifier
- timestamp: timestamp of message reception time at the satellite in UTC
- DEVICE_ID: device identifier
- MSG_ID: message identifier
Live Objects processed type basic - Explorer example
{
"streamId":"urn:lo:nsid:x-kineis:86051",
"timestamp":"2022-05-01T20:12:40.916Z",
“value”:[
"DEVICE_ID":86051,
"MSG_ID":"970418622231126016",
"GPS_DATE":"2023-02-06T09:49:30Z",
"BATTERY_LOAD":1.0,
"LIGHT_LOW_FLAG":"Under Threshold",
"POS_ALERT_ZONE_IN_OUT":"Leaving",
"HUMIDITY":37,
"LIGHT_HIGH_FLAG":"Under Threshold",
"ACCELERO_FLAG":"Normal",
"MESSAGE_TYPE":"REGULAR",
"ALT":34.0,
"POS_ALERT_ZONE":"None",
"GPS_FAILED":false,
"PRESSURE":1015.0,
"BATTERY_STATUS":"Battery",
"TEMPERATURE":23.5,
"SUP_FREE_RAW_DATA":"000000000000",
"DRY_CONTACT_FLAG":"Off",
"LAT":43.5495,
"CRC_OK":true,
"LONG":1.4848,
"CHECKED":"Y"
}
}
]
}
ThingsBoard format
ThingsBoard compliant processed data with integrity check.
- ts: timestamp of message reception time at the satellite (ms since 01/01/1970 UTC)
- device_id: device identifier
- msg_date: message reception time at the satellite in UTC
- msg_id: message identifier
ThingsBoard processed type basic - Explorer example
{
"ts":1633524783542,
"values":[
{
"device_id":51244,
"msg_date":"2021-10-06T12:53:03.542Z",
"msg_id":"966002314227916800",
"GPS_DATE":"2023-02-06T09:49:30Z",
"BATTERY_LOAD":1.0,
"LIGHT_LOW_FLAG":"Under Threshold",
"POS_ALERT_ZONE_IN_OUT":"Leaving",
"HUMIDITY":37,
"LIGHT_HIGH_FLAG":"Under Threshold",
"ACCELERO_FLAG":"Normal",
"MESSAGE_TYPE":"REGULAR",
"ALT":34.0,
"POS_ALERT_ZONE":"None",
"GPS_FAILED":false,
"PRESSURE":1015.0,
"BATTERY_STATUS":"Battery",
"TEMPERATURE":23.5,
"SUP_FREE_RAW_DATA":"000000000000",
"DRY_CONTACT_FLAG":"Off",
"LAT":43.5495,
"CRC_OK":true,
"LONG":1.4848,
"CHECKED":"Y"
}
]
}
Explorer data specifications
Data |
Description |
Details |
DEVICE_ID | Kinéis Device ID | |
MSG_ID | Kinéis message ID | |
CHECKED | Message decoding status | Y if CRC and BCH OK |
N if CRC KO and BCH KO or nil | ||
CRC_OK | CRC status | True or false |
BCH_STATUS | Optional – indicator about BCH correction | Expected values : -2, 0, 1, 2, 3, 4 |
GPS_DATE* | GPS date in UTCZ | Date + hour/min/sec |
CLOCK_FAILED* | Indicator about clock acquisition status | Expected values : true, false. |
LAT* | GNSS latitude | resolution GNSS LAT: 0.00001° (~1m) |
LONG* | GNSS longitude | resolution GNSS LONG: 0.00001° (~1m at the equator) |
ALT* | GNSS altitude | resolution GNSS ALT: 1m |
GPS_FAILED | Indicator about GNSS acquisition status | Expected values : true, false |
SPEED_OVER_GROUND* | Fixed value sent (will be implemented in the future) | Resolution : 1 Km/h |
COURSE_OVER_GROUND* | Fixed value sent (will be implemented in the future) | Resolution : 1 ° |
BATTERY_LOAD | Battery load | Expected values : 0.25, 0.5 , 0.75, 1 to translate in % |
BATTERY_STATUS | Battery status indicator | Expected values : Main, Battery |
HUMIDITY* | Humidity level in % | Resolution 1% |
PRESSURE* | Pressure in hPa | Resolution : 0.5 hPa |
TEMPERATURE* | Temperature in °C | Resolution : 0.5°C |
DRY_CONTACT_FLAG | Indicator about the dry contact | Expected values : On, Off |
MESSAGE_TYPE | Message type depending on the type of acquisition | Expected values : REGULAR, MANUAL, ALERTING |
LIGHT_LOW_FLAG | Light sensor crossing threshold | Expected values : Under Threshold, Under to Over, Over to Under, Over Threshold |
LIGHT_HIGH_FLAG | Light sensor crossing threshold | Expected values : Under Threshold, Under to Over, Over to Under, Over Threshold |
POS_ALERT_ZONE_IN_OUT | Alerting when entering or leaving a predefined zone | Expected values: Leaving, Entering |
POS_ALERT_ZONE | Alert when entering a predefined zone | Expected values: None, Zone 1, Zone 2, Zone 3 |
ACCELERO_FLAG | Shock detection when crossing predefined threshold | Expected values: Normal, Crossing |
SUP_FREE_RAW_DATA | Sup Binary Raw Data | 6 additional bytes - zero padding if not consumed |