Introduction

The Tracking backend is a fast and flexible IoT location platform that makes it quick and easy to add location awareness to your products.

The Tracking backend exposes a set of REST APIs as the Tracking API. The Tracking API together with Tracking client libraries, which are build upon the Tracking API, enable location tracking and geofencing for a variety of device form-factors including small-footprint (small memory and processing power) devices.

The Tracking platform consists of the backend component (accessible via the Tracking API) and two frontend components: Asset Tracking and Shipment Tracking web applications to be used as reference apps to demonstrate the product capabilities.

For more information on:

• The terms and conditions covering this documentation, see the HERE Documentation License.
• How HERE is committed to respecting your privacy and to complying with applicable data protection and privacy laws, see the HERE Privacy Charter.

Why Use the Tracking API

The Tracking API provides resources to address the following high-level use cases:

Features

The Tracking API builds upon a set of objects and backend capabilities that facilitate working with IoT devices in an open and flexible manner. Here's a summary of the main features:

Devices

Add devices to the cloud and configure in detail how they report their geolocation and environmental data.

Positioning

Use WLAN, Cell and Bluetooth LE to determine position on devices without GPS or in areas where GPS is unavailable.

Shadows

Manage the configuration for your devices and access their reported geolocation and environmental data.

Traces

Access current and historical data that a device collected.

Geofences

Create geofences that generate events and trigger notifications when a device enters or exits a geofence.

Sensors

Create sensor rules that generate events and notifications when get triggered by a reported device sensor reading.

Rules

Create rules that generate events and notifications when get triggered by a device behaviour.

Associations

Manage associations between devices and rules, geofences and sensor rules.

Events

View event history.

Notifications

Receive notifications via email or webhook when an interesting event gets triggered.

Reports

Collect and analyze historical data of all the devices of the project.

Aliases, Metadata and Labels

Associate external IDs or additional descriptive data with the Tracking API resources.

Cloud to Cloud Connections

Ingest data from third-party clouds using Virtual Devices.

Shipments

Create and manage shipments to track multimodal logistics journeys.

Locations

Create and manage locations that are geographical building blocks for shipments.

Shipment reports

Create a shipment report on successfully completed shipments.

Shipment times (ETA/ETD)

Create and manage the estimated time of departure and estimated time of arrival for shipments and segments.