We will get to see many android applications displaying maps within their applications to display user locations or delivery boy locations within their application. We will get to see the applications using google maps or maps provided by Maps My India. Map My India is an SDK that provided the functionality to integrate maps functionality within our application. In this article, we will take a look at How to integrate Map My India SDK in an Android application to display Maps.
Note: This Android article covered in both Java and Kotlin languages.
Step by Step Implementation
Step 1: Create a New Project in Android Studio
To create a new project in Android Studio please refer to How to Create/Start a New Project in Android Studio.
Step 2: Downloading SDK for Map My India
Navigate to the link and download the jar file for Map My India SDK. After downloading it copy the file to add it to our project. Navigate to the Project section in your android studio project. Then navigate to Project Name > app > libs. Right-click on it and simply paste the downloaded jar file into that folder.
Step 3: Adding dependency in build.gradle file
Navigate to app > build.gradle file and add the below dependency to it in the dependencies section.
implementation 'com.google.code.gson:gson:2.3'
implementation files('libs/map_sdk_2.1.jar')
After adding the dependency simply sync your project.
Step 4: Working with the activity_main.xml file
Navigate to app > res > layout > activity_main.xml and add the below code to it. Comments are added in the code to get to know in detail.
XML
<?xml version="1.0" encoding="utf-8"?> android:layout_width="match_parent" android:layout_height="match_parent" tools:context=".MainActivity"> <!--on below line we are creating a map view--> <com.mmi.MapmyIndiaMapView android:id="@+id/idMapView" android:layout_width="match_parent" android:layout_height="match_parent" /> </RelativeLayout> |
Step 5: Adding permissions in the AndroidManifest.xml file
Navigate to app > AndroidManifest.xml file and add the below permissions to it.
XML
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" /><uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" /><uses-permission android:name="android.permission.ACCESS_WIFI_STATE" /><uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" /><uses-permission android:name="android.permission.INTERNET" /><uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" /> |
Now add the below code in the application tag in the AndroidManifest.xml file to use the legacy library within our application.
XML
<uses-library android:name="org.apache.http.legacy" android:required="false" /> |
Step 6: Generating your API key for using Map My India SDK
Navigate to the link. Sign Up with your email and password and you will get to see the below screen. Inside that navigate to the credentials tab to see your API key. Copy that API key that we have to use in our project.
Step 7: Working with the MainActivity file
Navigate to app > java > your app’s package name > MainActivity file and add the below code to it. Comments are added in the code to get to know in detail.
Kotlin
package com.gtappdevelopers.mapmyindiakotlin import android.os.Bundleimport androidx.appcompat.app.AppCompatActivityimport com.mmi.LicenceManagerimport com.mmi.MapmyIndiaMapViewimport com.mmi.util.GeoPoint class MainActivity : AppCompatActivity() { override fun onCreate(savedInstanceState: Bundle?) { super.onCreate(savedInstanceState) setContentView(R.layout.activity_main) // on below line we are setting rest api key and map sdk key. LicenceManager.getInstance().restAPIKey = "Enter your API key" LicenceManager.getInstance().mapSDKKey = "Enter your API key" // on below line we are creating variables // for map view and initializing it. val mapmyIndiaMapView = findViewById<MapmyIndiaMapView>(R.id.idMapView) // on below line we are getting our map view. val mapView = mapmyIndiaMapView.mapView // on below line we are creating a // geo point for map view. val geoPoint = GeoPoint(48, 2, 2944) // on below line we are setting center // for our map view from geo point. mapView.setCenter(geoPoint) }} |
Java
package com.gtappdevelopers.mapmyindia; import android.os.Bundle; import androidx.appcompat.app.AppCompatActivity; import com.mmi.LicenceManager;import com.mmi.MapView;import com.mmi.MapmyIndiaMapView;import com.mmi.util.GeoPoint; public class MainActivity extends AppCompatActivity { @Override protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.activity_main); // on below line we are setting rest api key and map sdk key. LicenceManager.getInstance().setRestAPIKey("Enter your API key"); LicenceManager.getInstance().setMapSDKKey("Enter your API key"); // on below line we are creating variables // for map view and initializing it. MapmyIndiaMapView mapmyIndiaMapView = findViewById(R.id.idMapView); // on below line we are getting our map view. MapView mapView = mapmyIndiaMapView.getMapView(); // on below line we are creating a geo point for map view. GeoPoint geoPoint = new GeoPoint(48.8583, 2, 2944); // on below line we are setting center // for our map view from geo point. mapView.setCenter(geoPoint); }} |
Now run your application to see the output of it.
Output:
