MapmyIndiaDirectionsUI SDK provides the UI components to quickly integrate MapmyIndiaDirections framework in iOS application.It offers the following basic functionalities:
- Takes support of MapmyIndia Place search for searching locations of origin, destinations and via points.
- It allows to use origin and destinations in MapmyIndia's digital address (semicolon separated) eLoc or WGS 84 geographical coordinates both.
- The ability to set the vehicle profile like driving, and biking.
- Easily set the resource for traffic and ETA information.
For details, please contact apisupport@mapmyindia.com.
This plugin can be installed using CocoaPods. It is available with name MapmyIndiaDirectionsUI.
To install the MapmyIndiaDirectionsUI using CocoaPods:
Create a Podfile with the following specification:
pod 'MapmyIndiaDirectionsUI', '0.0.3'
Run pod repo update && pod install and open the resulting Xcode workspace.
This library depends upon several MapmyIndia's own and third party libraries. All dependent libraries will be automatically installed using CocoaPods.
Below are list of dependcies which are required to run this SDK:
- MapmyIndiaAPIKit
- MapmyIndiaMaps
- MapmyIndiaUIWidgets
- MapmyIndiaDirections
- Polyline(A third party library)
| Version | Dated | Description |
|---|---|---|
0.1.0 |
28 Mar 2022 | Added support Xcode 13+ |
0.0.8 |
01 Feb 2022 | Added support for POI Along the route. |
0.0.7 |
27 Dec, 2021 | Added support for xcode 13.2.1 |
0.0.6 |
27 Dec, 2021 | Added support for xcode 13 |
0.0.5 |
30 May, 2021 | Added support for xcode 12.5 |
0.0.4 |
01 March, 2021 | Added current location button and UI improvements. And added some new properties |
0.0.3 |
28 Jan, 2021 | Added support for xcode 12.2 and eLoc Strategy. |
0.0.2 |
26 Oct, 2020 | Initial version. |
The MapmyIndiaDirectionsUI makes it easy to integrate MapmyIndiaDirections SDK to your iOS application. It gives you all the tools you need to add Directions related UI components to your application.
MapmyIndiaDirectionsViewController is type of UIViewController which you can use to show screen for getting input from user to choose origin and destination and show routes after that.
let directionVC = MapmyIndiaDirectionsViewController(for: [MapmyIndiaDirectionsLocation]())
self.navigationController?.pushViewController(directionVC, animated: false)As from above code you can see it requires an array of object type MapmyIndiaDirectionsLocation. It can be an blank array to launch screen without any chosen locations.
Also you can pass fixed locations and launch instnace of MapmyIndiaDirectionsViewController, as shown in below code:
var locationModels = [MapmyIndiaDirectionsLocation]()
let source = MapmyIndiaDirectionsLocation(location: "77.2639,28.5354", displayName: "Govindpuri", displayAddress: "", locationType: .suggestion)
let viaPoint = MapmyIndiaDirectionsLocation(location: "12269L", displayName: "Sitamarhi", displayAddress: "", locationType: .suggestion)
let destination = MapmyIndiaDirectionsLocation(location: "1T182A", displayName: "Majorganj", displayAddress: "", locationType: .suggestion)
self.locationModels.append(source)
self.locationModels.append(viaPoint)
self.locationModels.append(destination)
let directionVC = MapmyIndiaDirectionsViewController(for: self.locationModels)
directionVC.profileIdentifier = .driving
directionVC.attributationOptions = [.congestionLevel]
directionVC.resourceIdentifier = .routeETA
self.navigationController?.pushViewController(directionVC, animated: false)Here are the properties use to configure MapmyIndiaDirectionsViewController route.
It is instance of enum DirectionsProfileIdentifier which can accepts values driving, walking, biking, trucking. By default its value is driving.
It is instance of enum DirectionsResourceIdentifier which can accepts values routeAdv, routeETA. By default its value is routeAdv.
Note: To use RouteETA ‘resourceIdentifier’ should be routeETA and ‘profileIdentifier’ should be driving. In response of RouteETA a unique identifier to that request will be received which can be get using parameter routeIdentifier of object Route.
AttributeOptions for the route. Any combination of AttributeOptions can be specified.
By default, no attribute options are specified.
A Boolean value indicating whether alternative routes should be included in the response.
The default value of this property is true.
MapmyIndiaAutocompleteViewController provides an interface that displays a table of autocomplete predictions that updates as the user enters text. Place selections made by the user are returned to the app via the MapmyIndiaAutocompleteViewControllerResultsDelegate.
AutocompleteAttributionSetting allow to change the appearance of the logo in MapmyIndiaAutocompleteViewController
This property represents a set of restrictions that may be applied to autocomplete requests. This allows customization of autocomplete suggestions to only those places that are of interest.
A routeShapeResolution indicates the level of detail in a route’s shape, or whether the shape is present at all its default value is .full
A Boolean value indicating whether MBRouteStep objects should be included in the response. its default value is true.
To show the Start Navigation button if the origin is current location.
MapmyIndiaDirectionsViewController is created using several UI components whose appearance can be changed according to user requirements. Some of them are listed as below:
MapmyIndiaDirectionsTopBannerViewMapmyIndiaDirectionsBottomBannerView
It is a protocol class which will be used for callback methods as shown below:
/// This meathod will be called when back button is clicked in `TopBannerView`
1. didRequestForGoBack(for view: MapmyIndiaDirectionsTopBannerView)/// The meathod will be called when add viapoint button will clicked in `TopBannerView`.
2. didRequestForAddViapoint(_ sender: UIButton,for isEditMode: Bool)/// The meathod will be called when Directions button will clicked in `BottomBannerView`.
3. didRequestDirections()//The meathod will be called when start button will clicked in `BottomBannerView`.
4. didRequestForStartNavigation(for routes: [Route], locations: [MapmyIndiaDirectionsLocation], selectedRouteIndex: Int, error: NSError)MapmyIndiaDirectionsTopBannerView is type of UIView which show the source, destination and viapoint locations at the top of MapmyIndiaDirectionsViewController
This class accepts array of MapmyIndiaDirectionsLocation from which it set value of source, destination and viapoint.
MapmyIndiaDirectionsBottomBannerView is class of type UIView, it used for showing the route information i.e ArivalTime, DistanceRemening, TimeRemening.
To use this class it takes we need to call a function updateBottomBanner which accepts three parameters i.e route, selectedRoute, locationModel.
- route: It is an array of the Routes which is required to update bottom banner view.
- selectedRoute: If you have multiple routes then it will give the selected route in
Integer - locationModel: LocationModel is an array of the type
MapmyIndiaDirectionsLocationwhich is required to manage bottom banner view.
For any queries and support, please contact:
Email us at apisupport@mapmyindia.com
© Copyright 2020. CE Info Systems Pvt. Ltd. All Rights Reserved. | Terms & Conditions