SDKstatefuldeprecated

MapmyIndia Intouch iOS SDK

mapmyindia-intouch-ios-sdk

A Mappls sdk for maps, tracking telematics, workforce, gis analytics, identity platform across iOS.

Integration notice

This source is classified as deprecated. Use it for migration context and verify the supported replacement before new development.

Migration plan available

This source is covered by a gated upgrade journey with candidate evidence, compatibility checks, parity proof, production acceptance, and rollback. Open InTouch iOS SDK lineage

What this surface enables

A Mappls sdk for maps, tracking telematics, workforce, gis analytics, identity platform across iOS.

Why this source is classified stateful

The source identity names a provider-backed durable operations family whose records or lifecycle survive a single request or screen.

Authority: Source Identity · Evidence: intouch
Platforms

iOS

Product areas

MapsTracking TelematicsWorkforceGis AnalyticsIdentity Platform

Languages found

Text

Authentication signals

Oauth2

Prepare the integration

  1. An iOS project with Xcode and the package manager required by the source release
  2. OAuth client credentials issued for the intended Mappls project
Production guardrailsPin package versions and record the source fingerprint.Keep server credentials out of client binaries and logs.Test failures, timeouts, quota limits, upgrades, and rollback.Validate legacy examples against current authentication contracts.

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.

mapmyindia-intouch-ios-sdk examples
Drag and Drop the SampleTest-Bridging.h file (which is provided in the project) to your Briding Header in Build Setting of the project.

Operate the whole lifecycle

This operational model supplements the repository-level setup instructions. Adapt its resource names and transitions to the owning product contract.

1
Provision

Create the owning project, enable entitlements, restrict credentials, and record the resource owner.

2
Initialize

Create the SDK, session, asset, task, workspace, or other durable aggregate exactly once.

3
Operate

Persist provider and application identifiers and transitions; make commands idempotent and observations replayable.

4
Recover

Reconcile restarts, delayed events, expired credentials, partial sync, and version changes against durable evidence.

5
Retire

Revoke access and release runtime resources while preserving required history and audit evidence.

Topics documented by the source

01Introduction

MapmyIndia Intouch will enable the live tracking functionality in your mobile app and allows you to get the powerful features from Intouch IoT platform for your telematics devices. Inotuch SDK for iOS lets you easily add MapmyIndia Telematics cloud services to your own iOS application.

Using this SDK, Your app shall fetch the live location from the end user mobile phone at the predefined condition, It could be based on the movement of the user, or fixed time interval or the combination of both. You can customize the data polling conditions. Along with that you can get the details about your other telematics device live locaion and analytics around that.

You will get seemless location benifits which caterted to different domains like logistics, delivery tracking , Employee tracking , live location sharing etc.

• Publishable Key Get your Publishable Key please contact from apiSupport url (https://apisupport@mapmyindia.com)

• Quickstart Start with a ready-to-go app

• Integrate the SDK Integrate the SDK into your app

02Get your Publishable Key.

We use your Publishable key to identify your account details and assign all your users device under single account.

After getting the publishable key, you can start with the IntouchDemo app, or Integrate the Intouch SDK in your app.

03Setup a Project

This guide allows you to add a live location tracking to an iOS app.

Xcode IDE recommended Xcode 11.0 only.

Step 1. Download the IntouchDemo App.

to download the IntouchDemo App Project. And then open this project.

NOTE:- This is only applicable in Demo app

Step 2. Set your Publishable key / Project Initiation

04IOS13 LOCATION PERMISSION

For Privacy Policy of Location

Location Permission Map Prompt(Always allow)

For apps granted Always Allow location permissions, iOS 13 will periodically display a “map prompt” The “map prompt” displays the location points collected by the app. In testing, we’ve identified that this prompt will be triggered after 3 consecutive days of background location use, and will continue to appear periodically with continued use.

Add Location permission into your plist file

requestAlwaysAuthorization requestWhenInUseAuthorization

1. Add transport security settings Into your plist file.

05Setup a project

1. Open Xcode Project. 2. Create a new project as follows: - Create New Application - Select Single Application - Select Next

3. Enter your app name, project location,Bundle Indentifier language(Swift) and minimum API version as prompted. Then click Next.

After this Xcode will contain two files viewcontroller& Appdelegate, Setting , StartBeacon

4. Create Setting and Start Beacon Screen Through Storyboard(Reference demo app for this.)

5. Go to framework and libraries option in General Settings of the project click on embeded and sign-in.

6. In capabilities go to background mode it should be enabled background fetch,& location updates.

06Add following compulsory lines to your applications for Upload app on Store

Add below function for fetch background data

07Initialize InTouch SDK

Initialize the SDK with your Publishable Key

08Add your Publisher key in client Id and Client Secret and add deviceName.

Client ID and Client Secret it will contain the Publisher Key. After Successful get the token we hit the api for create device. after this you get the traking code // set your device name for tracking this device name will be show on Intouch panel.

09Create device

After successful API confirmation we get tracking code for Track the location.

You cannot use the MapmyIndia Intouch SDK without these function calls. You will find your keys in your API Dashboard.

There are option to add vehicle Type and Tracking Mode without choose these option tracking will not start.

Location Permission

Add these lines into your Controller file

10Call the below method to Stop Track your app user's phone live location.

We put these lines for stop beacon tracking and sensors like gyro, aceelerometer., barometer , motion detectors.

Set Vehicle type and Priority configration from below code.

README.md Displaying README.md.

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/MapmyIndiahttps://intouch.mapmyindia.com/nextgen/#/home/dashboardhttps://www.mapmyindia.com/api/login?appmyindia-dashboardhttps://github.com/MapmyIndia/mapmyindia-intouch-ios-sdkhttps://intouch.mapmyindia.com/nextgen