Reference/Distribution
Distributionstatelessdistribution

Mappls Nearby Search Widget for iOS

mappls-nearby-ui-ios-distribution

Mappls Nearby UI Native for iOS distributed via the SPM (Swift Package Manager).

Integration notice

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

Mappls Nearby UI Native for iOS distributed via the SPM (Swift Package Manager).

Why this source is classified stateless

No durable provider record or application workflow contract was established from the source identity or bounded document evidence; view, camera, callback, and authentication sessions alone do not make a source stateful.

Authority: Conservative Default · No durable-state signal promoted from incidental vocabulary
Platforms

iOS

Product areas

MapsSearch PlacesTracking TelematicsWidgets Deep LinksCapture FeedbackIdentity Platform

Languages found

SwiftText

Authentication signals

No explicit authentication signal detected

Prepare the integration

  1. An iOS project with Xcode and the package manager required by the source release
  2. The corresponding product entitlement enabled for the developer application
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.

mappls-nearby-ui-ios-distribution examples
let nearbyUI = MapplsNearbyCategoriesViewController()
self.navigationController?.pushViewController(nearbyUI, animated: false)

Topics documented by the source

01Introduction

The MapplsNearbyUI makes it easy to integrate a widget with your iOS application. The Nearby Search widget provided as a means to enable radially search for Nearby Places on Mappls Map.

The widget offers the following basic functionalities:

• Ability to search for nearby places directly with Mappls Map visual interface.

• A single method to initiate nearby search across all categories of places available on Mappls.

• Ability to get information from Mappls Nearby Search widget through a callback.

02Widget Preview

This can be done by following simple steps.

03Installation

To add a package dependency to your Xcode project, select File > Swift Packages > Add Package Dependency and enter its repository URL. See Adding Package Dependencies to Your App.

04Dependencies

This library depends upon several Mappls's own libraries. All dependent libraries will be automatically installed using CocoaPods.

Below are list of dependencies which are required to run this SDK:

• MapplsAPICore - MapplsAPIKit - MapplsMap - MapplsUIWidgets

05Authorization

##### MapplsAPICore It is required to set Mappls keys to use any Mappls SDK. Please refer the documentation here.

06MapplsNearbyCategoriesViewController

MapplsNearbyCategoriesViewController is type of UIViewController which is entry ViewController for MapplsNearbyUI SDK.

Thats all ! you are now ready with the MapplsNearbyUI widget within your app.

To enhance further and making UI as per your own requirements, refer to the section below:

07Properties of MapplsNearbyCategoriesViewController

• nearbyCategories: - An array of an object of type MapplsNearbyCategories which will help to make your own custom categories to show on MapplsNearbyCategoriesViewController.

It can be used as follows.

• nearbyCategoryConfiguration:- A object of type MapplsNearbyCategoryConfiguration which will be required to set the UI Configuration of MapplsNearbyCategoriesViewController

• nearbyConfiguration:- A object of type MapplsNearbyConfiguration which will be required in MapplsNearbyMapViewController to configure the UI components and nearby request parametes.

• delegate:- A delegate object of type MapplsNearbyCategoriesViewControllerDelegate to provide different callbacks as per different actions of MapplsNearbyUI.

08MapplsNearbyCategoriesViewControllerDelegate

It is a protocol class that will be used for callback methods as shown below:

09Our many happy customers:

For any queries and support, please contact:

Email us at apisupport@mappls.com

Support Need support? contact us!

[](https://about.mappls.com/blog/)[](https://github.com/mappls-api)

[](https://twitter.com/mappls)[](https://www.linkedin.com/company/mappls/)[](https://www.youtube.com/channel/UCAWvWsh-dZLLeUU7J9HiOA)

@ Copyright 2022 CE Info Systems Pvt. Ltd. All Rights Reserved.

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://www.mapmyindia.com/apihttps://developer.apple.com/documentation/xcode/adding-package-dependencies-to-your-app).https://github.com/mappls-api/mappls-ios-sdk/docs/v1.0.0/MapplsAPICore.mdhttps://github.com/mappls-api/mappls-ios-sdk/docs/v1.0.0/MapplsAPIKit.mdhttps://github.com/mappls-api/mappls-ios-sdk/docs/v1.0.0/MapplsMap.mdhttps://github.com/mappls-api/mappls-ios-sdk/docs/v1.0.0/MapplsUIWidgets.mdhttps://github.com/mappls-api/mappls-ios-sdk/docs/v1.0.0/MapplsAPICore.md).https://www.mapmyindia.com/api/img/logos1/PhonePe.png)![](https://www.mapmyindia.com/api/img/logos1/Arya-Omnitalk.png)![](https://www.mapmyindia.com/api/img/logos1/delhivery.png)![](https://www.mapmyindia.com/api/img/logos1/hdfc.png)![](https://www.mapmyindia.com/api/img/logos1/TVS.png)![](https://www.mapmyindia.com/api/img/logos1/Paytm.png)![](https://www.mapmyindia.com/api/img/logos1/FastTrackz.png)![](https://www.mapmyindia.com/api/img/logos1/ICICI-Pru.png)![](https://www.mapmyindia.com/api/ihttps://about.mappls.com/api/https://about.mappls.com/contact/https://stackoverflow.com/questions/tagged/mappls-api)[![](https://www.mapmyindia.com/api/img/icons/blog.png)](https://about.mappls.com/blog/)[![](https://www.mapmyindia.com/api/img/icons/gethub.png)](https://github.com/mappls-api)[https://www.npmjs.com/org/mapmyindiahttps://www.facebook.com/Mapplsofficial)[![](https://www.mapmyindia.com/june-newsletter/icon2.png)](https://twitter.com/mappls)[![](https://www.mapmyindia.com/newsletter/2017/aug/llinkedin.png)](https://www.linkedin.com/company/mappls/)[![](https://www.mapmyindia.com/june-newsletter/icon3.png)](https://www.youtube.com/channel/UCAWvWsh-dZLLeUU7_J9HiOAhttps://about.mappls.com/api/terms-&-conditionshttps://www.mappls.com/about/privacy-policyhttps://www.mappls.com/pdf/mappls-sustainability-policy-healt-labour-rules-supplir-sustainability.pdf