2GIS iOS SDK allows you to add a 2GIS map to your iOS application. It can be used to display the map in your layout, add custom markers to it, draw geometric shapes, calculate and display routes, get information about map objects, control the camera movement, and so on.
Geodata complies with OGC standards.
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 or get extra information about map objects, you will need a separate key - a Directory API key.
To obtain either of these API keys, fill in the form at dev.2gis.com.
- Xcode 12+
- iOS 13.0+ / iPadOS 13.0+ (this SDK uses SwiftUI)
You can also use xcframework to build your project for iOS 12.
To install this SDK, you need to add a package dependency to your project. See the official documentation for more information on using Swift packages.
2GIS iOS SDK is distributed in two versions: full and lite. The lite version does not include the routes and navigation functionality.
Specify one of the following URLs when adding a dependency to install the SDK:
https://github.com/2gis/mobile-sdk-map-swift-package- to get the lite version.https://github.com/2gis/mobile-sdk-full-swift-package- to get the full version.
To run the demo app, do the following:
-
Clone this repository.
-
Open the
app.xcodeprojproject and add the key filedgissdk.keyto the application root. -
Set
Bundle Identifierof demo app toapp_idvalue of your key file. -
Wait for Swift Package Manager to finish installing all dependencies (this could take a while).
You won't be able to build the project until the dependencies are installed.
-
Build and run the project (⌘+R).
Full documentation, including usage examples and API reference with detailed descriptions of all classes and methods, can be found at docs.2gis.com.
The demo application is licensed under the BSD 2-Clause "Simplified" License. See the LICENSE file for more information.