Mappls InTouch

Developer centre

Connect your first device.

Run a private node, send a timestamped burst, then open its timeline. Device and viewer credentials have separate scopes.

Local quickstart

In the repository root, generate credentials and start the API. Use the web-lab credential in the capture page and the viewer credential in the console. Both are in the local .env file.

python3 scripts/init-env.py
docker compose up -d --build
python3 examples/send-burst.py

The example creates a synthetic four-sample accelerometer burst and confirms the receipt in the viewer API.

Open browser capture ↗

Use the hosted API

Request a device credential from your platform operator. Set the SDK origin to https://intouchsi.mappls.ai. Use a viewer credential for the operator console. Each installation has its own keys.

Client libraries

Download the source packages for a local integration. SDKs use a common device-scoped HTTP contract.

Write a connected sensor adapter

import { InTouch } from '/sdk/intouch.js';
const device = await InTouch.open({token: deviceToken});
await device.recordBurst([{
  ts: Date.now(), kind: 'temperature',
  values: {celsius: 4.8, input: 'probe-1'}
}], 'manual');
await device.flush();

API and product design

Run python3 examples/application-recipes.py caravan to calculate group separation from synthetic fixes. The same file demonstrates expiring sharing grants, shift-scoped incident lists and available-driver shortlisting.