Skip to content

Add Mappls SDK

Installation

First install mappls-map-react-native:

npm install mappls-map-react-native

Android Setup

Add Mappls Repository

  • Add the Mappls repository to your settings.gradle or settings.gradle.kts file: #### Kotlin (settings.gradle.kts)
    dependencyResolutionManagement {
    repositories {
        google()
        mavenCentral()
        maven(url = "https://maven.mappls.com/repository/mappls/")
    }
    }

#### Groovy (settings.gradle)

    dependencyResolutionManagement {  
    repositories {  
            google()  
            mavenCentral()  
            maven {  
                url 'https://maven.mappls.com/repository/mappls/'  
            }  
    }  
    }

Adding Mappls Configuration file

  • Download Configuration files for your app (associated with Package Name and Signing Certificate SHA-256)
  • Add Configuration files (<appId>.a.olf and <appId>.a.conf) into the module app-level root directory of your app

IOS Setup

  • To initialize and authenticate any Mappls SDK, you must include IOS Configuration files(<appId>.i.olf and <appId>.i.conf) in your project bundle
  • On iOS it's necessary to add $MAPPLS_MAPS.post_install(installer) to the post_install block in the ios/Podfile is necessary:
    post_install do |installer|
    # Other post install hooks...
    + $MAPPLS_MAPS.post_install(installer)
    end
  • Run pod install in ios folder

Getting Started

The Mappls Maps SDK for React Native empowers you to seamlessly integrate powerful, interactive maps and location services into your React Native applications. The SDK gives you access to a robust suite of mapping features and tools designed to deliver a smooth, responsive, and customizable user experience.

With support for custom map tiles, multiple layer options, and a rich set of controls and native gestures, you can build highly dynamic, map-based applications tailored to your users’ needs. The SDK efficiently manages the downloading and rendering of map tiles, letting you focus on crafting innovative and engaging solutions for our customers.

API Usage

To use the Mappls Maps SDK, you’ll need to obtain a valid set of license keys (available here) and adhere to the API Terms and Conditions. Please note that as per the terms, removing or obscuring the Mappls logo and copyright notice from your application is strictly prohibited.

Your SDK usage limits are detailed on your user dashboard, and are shared across all platforms. This means that API requests made from your web, Android, or iOS applications are counted collectively toward your daily usage quota.

Project Prerequisites

Make sure that your project meets these requirement: - React Native (v0.74.0 or later)[Lower Version Might Work] - Android Api level (v21 or later) - IOS 13 or later

Authentication

To initialize and authenticate any Mappls SDK, you must include a.conf and a.olf files in your project bundle:

You can download the required files from the Auth Console

How to create an app on Mappls Console

Mappls Console - How to create apps

How to download config files from App from Console

Mappls Console - How to create apps

For any queries and support, please contact:

Email us at apisupport@mappls.com

Support Need support? contact us!



@ Copyright 2025 CE Info Systems Ltd. All Rights Reserved.