GuidesAPI Reference
Guides
  1. Tracking API Dev Guide
  2. Concepts
  3. Third-party integrations

Sensos integration

Sensos is a third‑party tracking device manufacturer. They provide single-use trackers called Sensos Labels. For more information, see Sensos Label.

HERE Tracking service can integrate with Sensos Label devices. Each physical Sensos Label appears as a virtual device in HERE Tracking. To use a Sensos Label, peel off the adhesive paper and attach the device to the package you want to track. A virtual device is automatically created in your HERE Tracking project when the Sensos Label sends its first telemetry (first ingestion).

To enable Sensos integration for your project, please contact us.

Device ingestion

On the first ingestion from a Sensos Label, a matching virtual device is created in your project. The Sensos Label's IMEI (printed on the device) becomes the virtual device's externalId. Subsequent ingestions update the virtual device's shadow and trace.

Each ingestion from a Sensos Label can include (trace + reported shadow):

  • payload.partNumber: Device part number (printed on the Sensos Label as “Part number”).
  • payload.shock.counter: Shock event counter for this ingestion.
  • payload.shock.duration: Duration of detected shock (ms).
  • payload.shock.durationThreshold: Configured duration threshold for shock detection (ms).
  • payload.shock.magnitudeThreshold: Configured magnitude threshold for shock detection (mg).
  • payload.trigger.list: List of all triggers relevant to the ingestion; any of: "Activation", "Heartbeat", "Landing", "LightArm", "LightBreach", "Movement", "RegainNetwork", "SavedReport", "SealApplied", "Shock", "StartMovement", "Static", "Takeoff", "Tampering", "TemperatureBreach", "TemperatureBackInRange", "TemperatureAlert".
  • payload.trigger.main: Primary trigger cause.
  • position: The device's current position.
  • system.client.accelerometerSensorRange: Always [ 16 ].
  • system.client.hasAccelerometerSensor: Always true.
  • system.client.hasTamperSensor: Always true.
  • system.client.hasTemperatureSensor: Always true.
  • system.client.manufacturer: Always "Sensos".
  • system.client.version: The device's software version.
  • system.mode: Device mode. "flight" when in flight mode, "normal" when out of flight mode. Initial value: "unknown".
  • system.reportedSensorData.accelerationG: Acceleration (shock) magnitude as g-force (0–16 g).
  • system.reportedSensorData.batteryLevel: Battery percentage: 100, 75, 50, 25.
  • system.reportedSensorData.deviceIsStationary: true if stationary, false if moving.
  • system.reportedSensorData.deviceIsTampered: true if the seal is open, false if not.
  • system.reportedSensorData.temperatureC: Temperature in degrees Celsius (−30 °C to +70 °C).
  • system.reportedSensorData.relativeHumidity: Relative humidity as a percentage if supported (0–100 %).
  • timestamp: Time when the device telemetry data was generated.

For more details on each property, see reported shadow schema at HERE Tracking Shadows API reference.

Device configuration

Configure a Sensos Label via the desired shadow of its virtual device. For details how to configure the desired shadow, see HERE Tracking Shadows API reference.

Supported desired shadow configuration properties:

  • payload.deviceSettings.positioningMethods: Array of positioning methods to use; any of "GNSS", "WLAN". Default: [ "WLAN" ]. Cellular is always enabled.
  • payload.sensos.temperatureAlertReportInterval: Ingestion interval (minutes) while temperature stays outside of configured sensor rule bounds (10–1440 minutes).
  • payload.sensos.shockDurationThreshold: Shock detection duration threshold (0-120 ms). Default: 80.
  • payload.sensos.wifiOnLowCellularLocationAccuracyCountries: true to force-enable WLAN positioning (regardless of state of payload.deviceSettings.positioningMethods) in countries with low cellular location accuracy.
  • payload.sensos.wifiOnPredefinedReportTriggers: true to force-enable WLAN positioning (regardless of state of payload.deviceSettings.positioningMethods) when triggered by one of: "Landing", "RegainNetwork", "Tampering", "Shock", "LightBreach".
  • payload.sensos.gpsOnLowCellularLocationAccuracyCountries: true to force-enable GNSS positioning (regardless of state of payload.deviceSettings.positioningMethods) in countries with low cellular location accuracy.
  • payload.sensos.gpsOnPredefinedReportTriggers: true to force-enable GNSS positioning (regardless of state of payload.deviceSettings.positioningMethods) when triggered by one of: "Landing", "RegainNetwork", "Tampering", "Shock", "LightBreach".
  • payload.sensos.movementSensitivity: Movement detection sensitivity: "Low", "Mid", "High". Default: "Low".
  • system.rate.sendMs: Ingestion interval while moving (600000-172800000 ms). Default: 3600000.
  • system.powerSave.sendMs: Ingestion interval while stationary (600000-691200000 ms). Default: value of system.rate.sendMs if set; otherwise 86400000.

HERE Tracking Shadows API accepts also other properties not listed above, but those do not have effect on Sensos Label devices.

Rules configuration

Sensor rules that apply to Sensos Labels:

  • battery: You may define 0–100%, but the device reports only 25, 50, 75, 100.
  • humidity: Has effect only if the device supports humidity measurements.
  • temperature: You may define −70 °C to +100 °C, but the device reports only −30 °C to +70 °C. When measured temperature is outside the configured range, the device sends an additional ingestion. It continues to ingest at the interval set by payload.sensos.temperatureAlertReportInterval while still out of range.
  • tamper: Triggers when the device seal is opened.
  • acceleration: You may define 2–100 g, but the device reports only 2–16 g. If a measured value is outside the configured range, a separate shock ingestion is sent.

Sensor rules pressure and attach are not supported. For more on sensor rules, see HERE Tracking Sensors API reference.

Updated last month