Journey-scoped identities keep shared event names unambiguous.
Facts your application can trust, replay, and explain.
A journey-scoped event catalog derived from every published lifecycle transition. Each contract includes a strict common envelope, producer rules, JSON Schema, deterministic examples, four consumer languages, and explicit delivery recovery—without pretending to define a Mappls provider payload.
Every command-to-state fact is accounted for.
Stateful and hybrid application blueprints.
The catalog stays honest about the evidence boundary.
Application-owned by design.
These events are implementation blueprints for the durable business aggregates described by this developer platform. They are not Mappls webhooks, message-bus topics, or claimed provider response shapes. Source guides and normalized API contracts explain the adjacent provider interaction; your application owns the event transport and event-specific data schema.
Start with the aggregate you operate
Open any fact for its producers, envelope, schema, example, language adapters, and replay policy.
Create, assign, accept, travel, prove, approve, and close a field job without losing actor, retry, or evidence history.
Provision an observable trip, follow live vehicle state, explain exceptions, close deliberately, and retain a replayable operational record.
Create a governed zone, evaluate vehicle activity, suppress noise, raise an actionable case, and retire the rule safely.
Resolve an incident location, select a capable available responder, route and observe the unit, adapt to hazards, establish arrival, resolve with evidence, and review every decision.
Move from route intent through preview, guidance, reroute, arrival, and cleanup while surviving process, sensor, and network interruption.
Ingest versioned data, validate and publish it, execute reproducible analysis, review lineage, and share a governed decision layer.
Discover provider-backed places, preserve their Mappls Pins in a versioned itinerary, preview the exact ordered route, invalidate stale plans on edits, and retain visit or skip progress through completion.
Normalize a declared service address, capture purpose-bound device evidence, apply an explainable versioned policy, require human review where evidence is weak, and retire precise data without erasing accountability.
address_verification.enteredenter_verificationaddress_verification.normalizednormalize_addressaddress_verification.capture_authorizedauthorize_captureaddress_verification.consent_revokedrevoke_consentaddress_verification.evidence_capturedcapture_evidenceaddress_verification.comparedcompareaddress_verification.verifiedverify · review_verifyaddress_verification.rejectedreject · review_rejectaddress_verification.review_requireddeferTurn a natural-language spatial objective into an inspectable plan, obtain an exact least-privilege approval, execute allow-listed Mappls tools, and cite provider evidence without exposing credentials to the model.
Manufacture, activate, install, operate, update, recover, and retire a navigation runtime and map-data release as one compatible system.
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.
Own route intent and revisions in the host app, present MapplsDirectionUI for editing and calculation, validate the selected route callback, and hand off to navigation without confusing a UI request with a started or completed trip.
route_plan.createdcreate_planroute_plan.editor_openedopen_direction_uiroute_plan.calculation_requestedrequest_routesroute_plan.candidates_receivedreceive_routesroute_plan.route_selectedselect_routeroute_plan.navigation_requestedrequest_navigationroute_plan.navigation_handed_offconfirm_handoffroute_plan.cancelledcancel_planPresent 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.
Open one feedback UI generation, normalize a bounded report candidate, commit an application submission, reconcile provider acknowledgement separately, review evidence, and close only with an attributable resolution.
feedback_report.createdcreate_reportfeedback_report.ui_openedopen_feedback_uifeedback_report.candidate_receivedreceive_candidatefeedback_report.submittedcommit_submissionfeedback_report.provider_requestedrequest_provider_submissionfeedback_report.review_queuedqueue_reviewfeedback_report.resolvedresolve_reportfeedback_report.rejectedreject_reportfeedback_report.cancelledcancel_reportInitialize and configure an entitled Location Capture SDK, acquire a bounded single or subscribed fix, preserve accuracy and timing as evidence, review weak results, and stop every native resource deterministically.
location_capture.attempt_createdcreate_attemptlocation_capture.permission_requestedrequest_permissionlocation_capture.sdk_readyprepare_sdklocation_capture.acquisition_startedstart_acquisitionlocation_capture.candidate_receivedreceive_locationlocation_capture.review_queuedqueue_reviewlocation_capture.evidence_acceptedaccept_evidencelocation_capture.weak_evidence_approvedapprove_weak_evidencelocation_capture.attempt_cancelledcancel_attemptEmbed the credential-free Add a Place surface, record what the user reports, reconcile independently, and call a place published only when durable provider-backed evidence exists.
place_contribution.createdcreate_contributionplace_contribution.widget_openedopen_widgetplace_contribution.submission_reportedreport_submissionplace_contribution.reconciliation_queuedqueue_reconciliationplace_contribution.publishedconfirm_publicationplace_contribution.rejectedrejectplace_contribution.retriedretryplace_contribution.withdrawnwithdrawQualify 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.
realview_inspection.createdcreate_inspectionrealview_inspection.entitlement_requestedrequest_entitlementrealview_inspection.entitlement_confirmedconfirm_entitlementrealview_inspection.viewer_openedopen_viewerrealview_inspection.coverage_unavailablerecord_no_coveragerealview_inspection.observation_recordedrecord_observationrealview_inspection.review_requestedsubmit_reviewrealview_inspection.acceptedacceptrealview_inspection.rework_requestedrequest_reworkrealview_inspection.entitlement_expiredrecord_entitlement_expiredrealview_inspection.cancelledcancelLock an entitled model to an immutable asset identity, call the documented synchronous prediction boundary, validate geometry and confidence, require independent review, and redact derived detections on schedule.