Learn Mappls by shipping something real.

Quick starts for first contact, production patterns for growing teams, and full stateful journeys for systems that run real operations.

Beginner

Make it work

Your first successful integration, with the concepts made clear.

01
Web

Put your first Mappls map on the web

Create a key, restrict it to localhost, load Web Maps JS, and add a marker.

You’ll buildA responsive map with a styled point of interest.
10 minMaps
02
WebREST

Build address autocomplete that users trust

Debounce input, apply bias, handle keyboard selection, and retain the Mappls Pin.

You’ll buildAn accessible, resilient delivery-address field.
20 minSearch & Places
03
Android

Add Mappls to an Android app

Configure the repository and BoM, initialize the SDK, and manage MapView lifecycle.

You’ll buildA native Kotlin map screen with lifecycle-safe setup.
25 minMaps
04
iOS

Add Mappls to an iOS app with Swift Package Manager

Select distribution packages, configure credentials, and render the native map.

You’ll buildA native Swift map screen.
25 minMaps
05
Deep links

Create a zero-SDK location campaign

Build safe place links, add fallback behavior, instrument hand-offs, and test every device.

You’ll buildA campaign that opens a useful Mappls experience everywhere.
15 minApp Widgets & Deep Links
06
REST

Build a server-side geocoding boundary

Resolve addresses on a trusted server, retain provider identity, and return a narrow application contract.

You’ll buildA credential-safe geocoding service with typed errors and provenance.
25 minSearch & Places
07
REST

Turn a device fix into a trustworthy check-in

Reverse geocode accuracy-bearing coordinates, preserve consent, and distinguish evidence from an address label.

You’ll buildA privacy-aware check-in that retains both raw evidence and human-readable context.
30 minSearch & Places · Capture & Feedback
08
REST

Generate static maps for receipts and notifications

Render bounded server-side map imagery with safe markers, caching, attribution, and fallback text.

You’ll buildA deterministic map image pipeline for non-interactive surfaces.
20 minMaps
09
WidgetsWeb

Embed a place picker widget

Mount a bounded widget, synchronize selection with your form, and preserve the selected Mappls Pin.

You’ll buildAn accessible embedded place picker with explicit host-page ownership.
25 minApp Widgets & Deep Links · Search & Places
10
Deep links

Hand off to navigation with a resilient deep link

Encode a known place, protect campaign parameters, and provide browser and store fallbacks.

You’ll buildA tested app-to-navigation hand-off across installed and uninstalled states.
20 minApp Widgets & Deep Links · Routes & Navigation
Intermediate

Make it useful

Compose products into a polished user experience.

01
WebREST

Build a route preview with alternatives

Resolve endpoints, request alternatives, decode geometry, and explain toll/time trade-offs.

You’ll buildA production-pattern route comparison view.
35 minRoutes & Navigation · Maps
02
Web

Create a nearby discovery experience

Combine category search, viewport updates, result cards, and map selection.

You’ll buildA map-and-list place explorer.
40 minSearch & Places · Maps
03
MCP

Give an AI agent grounded Mappls tools

Run the MCP server, scope credentials, call search and routing tools, and inspect provenance.

You’ll buildAn agent that can reason about real places without inventing APIs.
30 minAI & Location · Search & Places · Routes & Navigation
04
REST

Call Mappls safely from a trusted server

Exchange OAuth client credentials, keep tokens in bearer headers, call typed Search and Route operations, preserve provenance, and bound retry.

You’ll buildA credential-safe live server boundary with typed errors, timeout, retry, and provider provenance.
35 minSearch & Places · Routes & Navigation · InTouch Telematics
05
React Native

Build a cross-platform React Native map

Install the native wrapper, configure both platforms, add annotations, and handle cleanup.

You’ll buildOne map experience across Android and iOS.
45 minMaps
06
Flutter

Build a Flutter map and place picker

Configure native keys, render the map, and return a validated place to your form.

You’ll buildA reusable cross-platform location field.
45 minMaps · Search & Places
07
Cordova

Ship a Mappls map in Cordova and Ionic

Separate web and native configuration, wait for device readiness, and clean up plugin state safely.

You’ll buildA hybrid map screen with lifecycle-safe native bridge handling.
50 minMaps · Search & Places
08
Xamarin

Integrate Mappls into a Xamarin application

Configure platform projects, isolate credentials, bridge native lifecycle, and preserve location identity in shared code.

You’ll buildA shared-code location feature backed by correctly owned native map views.
55 minMaps · Search & Places
09
REST

Rank responders with a distance matrix

Batch eligible origins, interpret unreachable pairs, apply deterministic tie-breaks, and keep dispatch explainable.

You’ll buildAn explainable ETA-based dispatch shortlist rather than a straight-line guess.
45 minRoutes & Navigation · Search & Places
10
WebREST

Build a traffic-aware commute assistant

Compare departure choices, refresh bounded route alternatives, and explain when an ETA becomes stale.

You’ll buildA route comparison experience that communicates freshness and uncertainty.
50 minRoutes & Navigation · Maps
11
Web

Render a governed GeoJSON operations layer

Validate geometry, assign stable feature IDs, style deterministically, and synchronize map and table selection.

You’ll buildAn accessible map layer whose visual state is reproducible from source data.
55 minMaps · GIS & Analytics
Advanced

Make it dependable

Operate state, scale, failure, and security in production.

01
RESTWeb

Track a delivery with a trustworthy ETA

Join asset telemetry, map matching, route progress, ETA refresh, and customer visibility.

You’ll buildA stateful live-delivery journey with recovery and replay.
90 minInTouch Telematics · Routes & Navigation
02
RESTAndroid

Automate a complete Workmate task lifecycle

Provision workers, dispatch jobs, consume transitions, enforce proof, and reconcile closure.

You’ll buildAn idempotent field-service integration.
2 hrWorkmate
03
RESTWeb

Build fleet geofence operations

Create zones, process enter/exit events, suppress noise, and power an exception queue.

You’ll buildAn operations-ready geofence monitor.
75 minInTouch Telematics · Maps
04
RESTWeb

Build a reproducible site-selection model

Publish layers, generate catchments, join signals, score candidates, and share results.

You’ll buildA governed retail expansion analysis.
2 hrGIS & Analytics
05
AutomotiveLinux

Design an interruption-safe offline map update

Verify packages, stage data, check compatibility, switch atomically, and roll back.

You’ll buildA resilient embedded update state machine.
90 minOffline & Automotive
06
MCP

Provision and validate a remote MCP client

Approve exact authority, deliver a signed pre-registration event, inspect discovery, validate PKCE and resource binding, then revoke without transporting a token or secret.

You’ll buildA replay-safe client identity journey with durable registration, request checks, revocation, and audit evidence.
55 minAI & Location
07
REST

Consume Mappls events exactly once in effect

Verify signatures, deduplicate deliveries, order per aggregate, retry, and replay safely.

You’ll buildA production webhook ingestion pipeline.
55 minInTouch Telematics · Workmate · GIS & Analytics
08
LinuxAutomotive

Operate a Mappls client on embedded Linux

Separate runtime and map-data compatibility, stage updates, survive power loss, and expose health signals.

You’ll buildAn embedded map runtime with atomic data activation and rollback evidence.
2 hrOffline & Automotive · Maps
09
RESTWeb

Reconcile a complete InTouch trip lifecycle

Create provider identity, consume event-time telemetry, own exceptions, and close only after provider acknowledgement.

You’ll buildA restart-safe connected trip with replay, late evidence, and closure reconciliation.
2 hrInTouch Telematics · Routes & Navigation
10
RESTAndroid

Build proof review and rework for field jobs

Capture purpose-bound evidence, route weak submissions to review, request rework, and preserve decision history.

You’ll buildAn auditable proof workflow that cannot silently overwrite rejected evidence.
90 minWorkmate · Capture & Feedback
11
Cordova

Qualify a Cordova location release

Pin bridge and native dependencies, prove lifecycle disposal, automate both release builds, and operate a browser fallback.

You’ll buildA versioned hybrid release with reproducible native builds, safe teardown, and rollback.
80 minMaps · Search & Places · Routes & Navigation
12
Deep links

Operate deep links across every hand-off

Govern destination identity, universal-link association, privacy-safe attribution, fallback, expiry, and campaign retirement.

You’ll buildA measurable zero-SDK journey that never confuses a click with arrival.
70 minApp Widgets & Deep Links · Routes & Navigation · Search & Places
13
Flutter

Production-harden a Flutter location feature

Lock Dart/native compatibility, control rebuilds and streams, test process recovery, and qualify Android and iOS independently.

You’ll buildA cross-platform feature with stable identity, bounded bridge traffic, and deterministic disposal.
90 minMaps · Search & Places · Routes & Navigation · Capture & Feedback
14
iOS

Qualify an iOS Mappls release

Resolve package authority, bind credentials and entitlements, own controller generations, test privacy and background behavior, and prove rollback.

You’ll buildA clean-device iOS qualification record spanning SDK, widget, tracking, and distribution boundaries.
2 hrMaps · Search & Places · Routes & Navigation · InTouch Telematics · Workmate · Capture & Feedback · App Widgets & Deep Links · Offline & Automotive · AI & Location
15
iOS

Build restart-safe iOS direction and geofence handoffs

Own native editor generations, validate route and geometry candidates, provide an exact navigation-link fallback, separate target acknowledgement and application review, and recover safely after restart.

You’ll buildTwo tested, durable iOS handoff journeys with explicit provider and application evidence boundaries.
95 minApp Widgets & Deep Links · Routes & Navigation · InTouch Telematics
16
React Native

Qualify React Native native parity

Freeze wrapper/native versions, normalize cross-platform results, constrain bridge traffic, recover process death, and release both native targets.

You’ll buildOne JavaScript contract backed by independently qualified Android and iOS behavior.
100 minMaps · Search & Places · Routes & Navigation · InTouch Telematics · Workmate · Capture & Feedback
17
Widgets

Operate widgets as untrusted lifecycle surfaces

Validate origin and schema, separate candidate from commit, recover blocked embeds, preserve accessibility, and retire safely.

You’ll buildA restart-safe host journey with exact-origin validation and a complete non-widget fallback.
85 minApp Widgets & Deep Links · Search & Places · Routes & Navigation · InTouch Telematics · Capture & Feedback
18
Xamarin

Harden and migrate a Xamarin location feature

Inventory native dependencies, isolate shared state, qualify each renderer, add rollback, and prepare a controlled successor migration.

You’ll buildA supportable existing integration with explicit compatibility, teardown, and migration evidence.
2 hrMaps · Search & Places · Routes & Navigation