This repository distributes a package rather than defining the complete product contract. Pair it with the owning SDK or product guide.
What this surface enables
A versioned iOS distribution package used to integrate tracking telematics, workforce, capture feedback into an application.
The source identity names a capture, feedback, geofence, analysis, or guided-operation surface where provider calls and application-owned workflow state must be separated.
Authority: Source Identity · Evidence: location-captureiOS
Tracking TelematicsWorkforceCapture Feedback
XMLSwift
No explicit authentication signal detected
Prepare the integration
- An iOS project with Xcode and the package manager required by the source release
- The corresponding product entitlement enabled for the developer application
Setup and usage examples
These examples were extracted from the canonical public source document and sanitized for credential-like values. Check the source branch and package version before copying into a production application.
https://github.com/mappls-api/mappls-location-capture-sdk-ios-distribution.gitOperate the whole lifecycle
This operational model supplements the repository-level setup instructions. Adapt its resource names and transitions to the owning product contract.
Create a bounded application request or draft with purpose, policy, revision, and lifecycle owner before provider UI or capture begins.
Give one screen, controller, subscription, or callback generation explicit ownership of configuration, cancellation, timeout, and cleanup.
Treat provider output as a candidate; validate and copy a narrow portable value instead of persisting an opaque SDK or UI object.
Use application-owned versioning, idempotency, review, and audit when a candidate affects a durable business decision.
Stop listeners and native resources once, ignore late generations, and restore only application-owned state after restart.
Topics documented by the source
01Getting Started
A lightweight, on-demand location capture SDK for iOS that enables applications to fetch a user’s current location efficiently with accuracy limits, timeout control, and minimal battery usage.
The SDK supports single-shot and subscribed location fetching without continuous tracking.
02Key Capabilities
• One-time location capture with accuracy threshold - Subscribed mode until accuracy or timeout is reached - Automatic termination (no background tracking) - Accuracy, timeout, and retry limits - Mock location detection - Lightweight footprint suitable for KYC, attendance, onboarding, check-ins
03Add Mappls SDK (iOS)
Mappls iOS SDK is distributed via Swift Package Manager (SPM).
04Using Swift Package Manager (SPM)
Open Xcode → File → Add Packages → Enter:
Select MapplsLocationCapture and add it to your target.
05Permissions (Required)
Add the following key to your Info.plist:
06Initialization (Required)
Initialization must be completed before invoking any location fetch method. During initialization, the SDK:
• Validates location permissions - Fetches server-driven configuration (accuracy, timeout, retry mode) - Performs SDK readiness check - Optionally enables logging
07SDK Configuration (Optional)
After initialization, configuration can be customized if allowed by server policy:
081. Single-Shot Location Fetch
Fetches one valid location snapshot and terminates automatically.
092. Subscribed Location Fetch (Limited)
Continuously receives location updates until accuracy, timeout, or packet limit is reached. Then auto-unsubscribes.
10LocationCaptureConfig
| Parameter | Description | Default | | Interval | Preferred location update interval | 5 seconds | | Accuracy | Minimum acceptable accuracy (meters) | 15m | | Timeout | Maximum time SDK attempts location fetch | 60 seconds | | NumberofAttempts | Maximum location packets | 5 |
11MapplsLocationEngineRequest
| Parameter | Description | Default | | Priority | Location priority mode | HIGHACCURACY | | Displacement | Minimum movement required | 0 meters |
The SDK automatically stops once accuracy OR timeout/attempt limit is reached.
12Output Details
Each successful callback provides:
• Latitude & Longitude - Accuracy (meters) - Altitude, speed, heading (if available) - Timestamps (generated & received) - Acceptable accuracy flag - Mock location flag
13Error Handling
| Error | Description | | permissionDenied | Location permission denied | | sdkNotInitialized | SDK not initialized | | retryModeNotAllowed | Mode not allowed by server | | maxTimeExceeded | Maximum timeout reached | | maxPacketLimitReached | Packet limit exceeded | | mockLocationDetected | Mock / fake location detected | | network | Network failure | | decoding | API response decoding error |
14Notes
• No background tracking - Location updates stop automatically - Server controls retry mode & overrides - Mock locations are rejected
Service references found
URLs are sanitized during ingestion and may include documentation or legacy hosts. Use them to trace the source, not as a substitute for the current API contract.
https://github.com/mappls-api/mappls-location-capture-sdk-ios-distribution.git