[Mappls Map SDK]()

This repository contains a sample project of an app built for iOS, which is based on Mappls's Map and other differennt SDKs.

Welcome to the Mappls iOS SDK

Explore the largest directory of APIs & SDKs for maps, routes and search.

Mappls's APIs, SDKs, and live updating map data available for 238 nations give developers tools to build better mapping, navigation, and search experiences across platforms.

In this section you will find documentation for :-

• Detailed information about integration of Vector iOS Map. - REST APIs module is a custom module for developers to consume our RESTful APIs within their applications, easily, and without having to develop such functionality from scratch. - Detailed information related to how to integrate Mappls Widgets.

MapplsMap is a SDK to display map, mark locations, enhance with custom data and even draw routes or other shapes on top.

Mappls's Map SDK for iOS lets you easily add Mappls Map and web services to your own iOS app. Mappls's Map SDK for iOS supports iOS SDK 9.0 and above and Xcode 10.1 or later. You can have a look at the map and features you will get in your own app by using the Mappls's Maps app for iOS. The SDK handles map tiles download and their display along with a bunch of controls and native gestures.

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.

This library depends upon MapplsAPICore, MapplsAPIKit. All dependent libraries will be automatically.

• For iOS9 or later, make this change to your info.plist (Project target > info.plist > Add row and set keys NSLocationAlwaysAndWhenInUseUsageDescription, NSLocationWhenInUseUsageDescription, NSLocationAlwaysUsageDescription). As follows

Message should be appropriate, according to use of your application.

A class MapplsMapAuthenticator can be used to authorize the Map.

It is recommended to call this method before initilizing MapplsMapView.

Note: Although authorization of Map is done internally on initilizing MapplsMapView, Using this in advance will reduce map loading time

Map View on view controller can be added either using interface builder or programmatically.

In a storyboard, add a view to your View Controller. In the Identity inspector, change its class to MapplsMapView. Note :- Map style url need to be set at the time of load map

To add map on view Controller create an instance of MapplsMapView. and add this to view of ViewController.

Note Also to handle app transport security exception add NSAppTransportSecurity in Info.plist of your project. As follows:

Set zoom to 4 for country level display and 18 for house number display.

To set Center of map reference code is below:

To show user's current location on map, use property .showsUserLocation. and set its value to true.

To get current location, use property .userLocation. its of type MGLUserLocation which contains location property.

To move map with user location change use property userTrackingMode. Its an enum property of type .MGLUserTrackingMode.. You can set any value from following:

• followWithCourse - followWithHeading - none

The Map object should implement the methods of the MapplsMapViewDelegate protocol corresponding to the events you wish it to receive. This delegate can also be used to detect map overlays selection. Delegate handles gesture events, tap on annotation (marker) and map center coordinates.

This delegate function will be called whenever authorization process of map completed. It gives either sucess or error

Tells the delegate that the map view will begin to load.

This method is called whenever the map view starts loading, including when a new style has been set and the map must reload.

Tells the delegate that the map view has finished loading.

This method is called whenever the map view finishes loading, either after the initial load or after a style change has forced a reload.

Tells the delegate that the map view was unable to load data needed for displaying the map.

This method may be called for a variety of reasons, including a network connection failure or a failure to fetch the style from the server. You can use the given error message to notify the user that map data is unavailable.

Tells the delegate that the map view is about to redraw.

This method is called any time the map view needs to redraw due to a change in the viewpoint or style property transition. This method may be called very frequently. Therefore, your implementation of this method should be as lightweight as possible to avoid affecting performance.

Tells the delegate that the map view has just redrawn.

This method is called any time the map view needs to redraw due to a change in the viewpoint or style property transition. This method may be called very frequently. Therefore, your implementation of this method should be as lightweight as possible to avoid affecting performance.

Tells the delegate that the map view is entering an idle state, and no more drawing will be necessary until new data is loaded or there is some interaction with the map.

Tells the delegate that the map has just finished loading a style.

This method is called during the initialization of the map view and after any subsequent loading of a new style.