InTouch Telematics
Live tracking, trips, devices, vehicles, events, geofences, and fleet intelligence.
Connect vehicles, phones, and IoT devices to a longitudinal operational model. InTouch combines ingestion, identity, asset assignment, trip construction, event detection, live state, historical playback, and reporting. Integrations should model provisioning and lifecycle transitions explicitly.
Capabilities
Available platforms
Keep business identifiers and server-side policy portable; use the native surface where device integration or long-lived state matters.
OAuth bearer with project and asset entitlement
Generate a time-bound InTouch bearer token from the subscribed project's client credentials. Separate provisioning identities from data-plane tracking tokens and rotate device credentials independently.
- Use separate projects for development, staging, and production.
- Apply the narrowest domain, IP, platform, product, and resource scopes available.
- Never ship a server secret in a browser bundle, mobile binary, prompt, or public repository.
Quickstart
Replace placeholders with credentials from the developer console. Examples include the lifecycle and failure-handling context that short snippets usually omit.
type AssetEvent = {
id: string;
assetId: string;
occurredAt: string;
type: "position" | "ignition" | "geofence.entered" | "geofence.exited";
position?: { latitude: number; longitude: number; speedKph?: number };
};
export async function handleAssetEvent(event: AssetEvent) {
// Idempotency matters: delivery may be retried.
if (await events.exists(event.id)) return;
await events.transaction(async () => {
await events.record(event);
await assets.apply(event.assetId, event);
});
}Vehicle from activation to daily operations
The complete fleet journey spans control-plane and data-plane state.
provisionedProvision
Create the organization, project, asset, device, and entitlements.
asset.createdactiveActivate
Securely bind the physical device or mobile SDK to the asset.
device.activatedonlineIngest
Accept ordered and delayed telemetry while tracking connection health.
position.receivedin_tripOperate
Build trips, evaluate geofences, notify operators, and power live views.
trip.startedmaintenanceMaintain
Diagnose gaps, replace devices, transfer assets, and preserve history.
device.replacedretiredRetire
Revoke credentials and detach hardware without deleting audit history.
asset.retiredOperate the complete lifecycle
These blueprints name every state, actor, command, event, invariant, durable record, retry boundary, failure recovery, source contract, and operational signal.
Connected fleet trip
Provision an observable trip, follow live vehicle state, explain exceptions, close deliberately, and retain a replayable operational record.
statefulFleet geofence exception
Create a governed zone, evaluate vehicle activity, suppress noise, raise an actionable case, and retire the rule safely.
hybridiOS geofence draft and publication boundary
Present the Mappls geofence editor, normalize circle or polygon output into a versioned application draft, validate geometry and policy, and stop at a review-ready artifact until a separately documented provider publication contract is selected.
Source repositories
Reference content is reconciled against these public and private source families. Version, authentication generation, and maturity are recorded before content is promoted.
mappls-intouch-rest-apisREST API · current →mappls-intouch-android-sdkSDK · current →mappls-intouch-ios-sdkSDK · current →mappls-react-native-intouch-sdkSDK · current →