MapGL iOS API Overview | 2GIS Documentation


MapGL iOS API is a wrapper around MapGL API that allows you to add a 2GIS map to your iOS application.

Like the regular iOS SDK, it can be used to display the map in your interface and add various objects to it, but unlike iOS SDK, MapGL iOS API uses WebKit to render the map and is more limited in capabilities.

Usage of this SDK requires an API key to connect to 2GIS servers and retrieve the geographical data. This API key is unique to the SDK and cannot be used with other 2GIS SDKs.

Additionally, if you plan to draw routes on the map, you will need a separate key - a Directions API key - to calculate and display an optimal route.

To obtain either of these API keys, fill in the form at

MapGL iOS API is available through CocoaPods. To install it, add the following line to your Podfile:

pod 'MapGL'


After that, you should be good to go. Check the Examples section to see how to display the map in your application. Alternatively, check the API Reference to learn more about specific classes and methods.

Also, you could visit the GitHub repository to learn more about the SDK and get familiar with sample project.

MapGL iOS API is licensed under the BSD 2-Clause "Simplified" License. See the LICENSE file for more information.