App Widgets & Deep Links

Embeddable Mappls experiences for places, directions, 3D views, RealView, and app hand-off.

Use universal URLs and embeddable widgets when you need a polished Mappls experience without owning a full map or navigation integration. Most app widgets need no API credential, making them ideal for content, support, campaigns, and lightweight product surfaces.

What you can build

Capabilities

Place and map visualizationProduction guidance, platform support, examples, and operational considerations included.01

Directions and navigation hand-offProduction guidance, platform support, examples, and operational considerations included.02

Immersive 3D and RealView experiencesProduction guidance, platform support, examples, and operational considerations included.03

Cross-platform universal linksProduction guidance, platform support, examples, and operational considerations included.04

Low-code embedsProduction guidance, platform support, examples, and operational considerations included.05

Credential-free entry pointsProduction guidance, platform support, examples, and operational considerations included.06

Choose your surface

Available platforms

Keep business identifiers and server-side policy portable; use the native surface where device integration or long-lived state matters.

Widgets Deep links Web Android iOS

Authentication

Often credential-free

Use an API key only when the selected widget explicitly requires one; validate and encode all user-provided URL parameters.

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.

Copy, run, understand

Quickstart

Replace placeholders with credentials from the developer console. Examples include the lifecycle and failure-handling context that short snippets usually omit.

App Widgets & Deep Links quickstart

<a
  href="https://mappls.com/MMI000"
  target="_blank"
  rel="noopener noreferrer"
>
  Open this place in Mappls
</a>

Before productionRestrict and rotate credentialsHandle timeouts and typed errorsAdd tracing without logging secretsTest quota and degraded-mode behavior

Production state machines

Operate the complete lifecycle

These blueprints name every state, actor, command, event, invariant, durable record, retry boundary, failure recovery, source contract, and operational signal.

hybrid

Application-owned widget selection

Launch a Mappls widget, recover through a useful fallback, validate a narrow candidate, commit it deliberately, invalidate stale selection, and submit one durable business record.

stateful

Entitled RealView remote inspection

Qualify paid RealView entitlement, open one browser-visible-token viewer attempt, handle the documented no-imagery signal safely, and turn human observations into a reviewed business record without inventing panorama metadata.

Browse all stateful journey blueprints

Traceable documentation

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-app-widgetsDeep link · current →mappls-web-pluginsWidget · current →

Browse all 44 related integration guides