Как интегрировать карты MapmyIndia в Android?

Опубликовано: 22 Февраля, 2023

Мы увидим, что многие приложения для Android отображают карты в своих приложениях, чтобы отображать местоположение пользователя или местонахождение курьера в своем приложении. Мы увидим приложения, использующие карты Google или карты, предоставленные Maps My India. Map My India — это SDK, предоставляющий функциональные возможности для интеграции функций карт в наше приложение. В этой статье мы рассмотрим, как интегрировать Map My India SDK в приложение Android для отображения Карт.

Note: This Android article covered in both Java and Kotlin languages. 

Пошаговая реализация

Шаг 1. Создайте новый проект в Android Studio.

Чтобы создать новый проект в Android Studio, обратитесь к разделу «Как создать/запустить новый проект в Android Studio ».

Шаг 2. Загрузка SDK для Map My India

Перейдите по ссылке и загрузите jar-файл для Map My India SDK. После загрузки скопируйте файл, чтобы добавить его в наш проект. Перейдите в раздел «Проект» в своем проекте Android Studio. Затем перейдите в «Имя проекта» > «Приложение» > «Библиотеки». Щелкните его правой кнопкой мыши и просто вставьте загруженный файл jar в эту папку.

Шаг 3: Добавление зависимости в файл build.gradle

Перейдите к файлу app > build.gradle и добавьте к нему приведенную ниже зависимость в разделе зависимостей.

 implementation "com.google.code.gson:gson:2.3"
 implementation files("libs/map_sdk_2.1.jar")

После добавления зависимости просто синхронизируйте свой проект.

Шаг 4: Работа с файлом activity_main.xml

Перейдите к app > res > layout > activity_main.xml и добавьте в него приведенный ниже код. В код добавлены комментарии для более подробного ознакомления.

XML




<?xml version="1.0" encoding="utf-8"?>
<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:tools="http://schemas.android.com/tools"
    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>

Шаг 5. Добавление разрешений в файл AndroidManifest.xml

Перейдите к файлу app > AndroidManifest.xml и добавьте к нему указанные ниже разрешения.

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" />

Теперь добавьте приведенный ниже код в тег приложения в файле AndroidManifest.xml, чтобы использовать устаревшую библиотеку в нашем приложении.

XML




<uses-library
    android:name="org.apache.http.legacy"
    android:required="false" />

Шаг 6. Создание ключа API для использования Map My India SDK.

Перейдите по ссылке. Зарегистрируйтесь, указав свой адрес электронной почты и пароль, и вы увидите экран ниже. Внутри этого перейдите на вкладку учетных данных, чтобы увидеть свой ключ API. Скопируйте этот ключ API, который мы должны использовать в нашем проекте.

Шаг 7: Работа с файлом MainActivity

Перейдите к приложению > java > имени пакета вашего приложения > файлу MainActivity и добавьте в него приведенный ниже код. В код добавлены комментарии для более подробного ознакомления.

Kotlin




package com.gtappdevelopers.mapmyindiakotlin
  
import android.os.Bundle
import androidx.appcompat.app.AppCompatActivity
import com.mmi.LicenceManager
import com.mmi.MapmyIndiaMapView
import 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);
  
    }
}

Теперь запустите ваше приложение, чтобы увидеть результат.

Выход: