Developer hub/Products/Location Runtime
Embedded software · integration blueprint

Build with Location Runtime.

Signed edge runtime, versioned IPC/C ABI, target adapters, content/configuration and diagnostic contracts. This page defines the public integration shape; exact endpoints, artifacts, signals, electronics, entitlement and release versions are program-specific.

Start with authority, context and capability.

The runtime owns its bounded edge state; vehicle ECUs, BMS, hardware security and cloud control planes retain their declared authority.

Modules6

Scopeable capability groups

Interfaces4

Adjacent integration domains

Delivery3

Program-selectable forms

Guardrails3

Evidence boundaries

Interfaces a production program must own.

Names describe the contract boundary. Current Mappls documentation and the signed OEM interface schedule remain authoritative for exact methods and formats.

01

Runtime API

C/C++/Rust ABI or IPC with schema/version negotiation, rate, backpressure and failure state.

02

Platform adapter

Target OS, hardware, sensor, vehicle bus, network, storage, clock, watchdog and power integration.

03

Artifact lifecycle

Signed runtime, content and configuration manifests with compatibility, activation, health and rollback.

04

Diagnostics

Bounded health, counters, reset reason, versions and policy-controlled replay evidence.

From scope to supported release.

01

Target

Freeze hardware/OS/compiler/resource/interface and vehicle/program compatibility envelope.

02

Simulate

Use deterministic adapters, golden inputs, replay and fault injection before vehicle access.

03

Integrate

Connect privileged platform sources through least-privilege adapters and negotiated IPC.

04

Qualify

Complete static, fuzz, timing/resource, SIL/HIL/vehicle, update/rollback and applicable process evidence.

Carry the evidence with the value.

The example is illustrative and intentionally product-neutral. It demonstrates version, freshness, quality and correlation behavior that remains stable across Mappls Auto domains.

  • GNSS/IMU and approved dead-reckoning sources
  • Map database and road/lane topology
  • Navigation, tracking, eHorizon and telemetry
  • Vehicle abstraction and diagnostics agent
consumer_contract.hpp
struct ObservedState {
  uint64_t monotonic_time_ns;
  Freshness freshness;
  Quality quality;
  Version source_version;
  std::optional<Value> value;
};

// Consumers must handle unavailable, stale and invalid explicitly.
Result<ObservedState, RuntimeError> read_state();

Use source-controlled contracts and generated clients for the selected release.

Turn scope into traceable interfaces.

Each enabled module receives a requirement, owner, contract, test environment, operational measure and lifecycle decision.

01

Sensor ingestion

Normalize GNSS, IMU, wheel/speed and approved vehicle inputs.

Contract · Test · Operate
02

Fusion & confidence

Estimate position, motion and uncertainty with source/quality state.

Contract · Test · Operate
03

Map matching

Associate position to road/lane candidates using vehicle/profile context.

Contract · Test · Operate
04

Route positioning

Locate progress on the active route without corrupting raw evidence.

Contract · Test · Operate
05

Recovery

Handle cold/warm start, signal loss, ambiguity and reacquisition.

Contract · Test · Operate
06

Replay & diagnostics

Record privacy-safe evidence for deterministic issue reproduction.

Contract · Test · Operate

Validate the failure path—not only the first success.

Production readiness is attached to the chosen platform, territory, data, vehicle, deployment and lifecycle.

  • ABI/schema and cross-platform conformance
  • Deterministic replay and golden truth sets
  • CPU, memory, storage, power and timing bounds
  • Sensor/bus/network/time/power fault injection
  • Secure boot, signed config/update and debug policy
  • Target HIL/vehicle and long-duration soak
OEM program workshop

Move Location Runtime from blueprint to integration plan.

Confirm the vehicle, users, territory, source systems, contracts, deployment, lifecycle and evidence. The result becomes a focused technical workshop.