Skip to content

Android (Java) sample map application based on Neshan Maps Platform Android SDK.

Notifications You must be signed in to change notification settings

NeshanMaps/android-neshan-maps-sample

Repository files navigation

Android Neshan Maps Sample

An Android sample application based on Neshan Maps Android SDK.

Getting started with Neshan Maps SDK

0) Get neshan.licence file

To create a licence file you need :

  • Package Name : The package name of the application you want to use SDK in.
  • SH1 fingerprint : SH1 fingerprints from your required apk sign keys. (Release key, debug key, etc)

REGISTER

1) Installing SDK

Add maven repository to your project level build.gradle

repositories {
    //add maven repo here
    maven { url "https://maven.neshan.org/artifactory/public-maven" }
}

Add to build.gradle module app

dependencies {
    //Neshan sdk library
    implementation 'neshan-android-sdk:mobile-sdk:0.9.7'
}

2) Define INTERNET permission for the app in your AndroidManifest.xml

<uses-permission android:name="android.permission.INTERNET"/>

3) Create a raw Android resource directory and put your neshan.licence file there.

4) Define your application layout

Define main layout as res/layout/activity_main.xml, so that it contains org.neshan.ui.MapView element:

<?xml version="1.0" encoding="utf-8"?>
<android.support.constraint.ConstraintLayout
    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">

<org.rajman.ui.MapView
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:id="@+id/map"/>

</android.support.constraint.ConstraintLayout>

5) In your app code connect to the MapView object and add a basemap layer

Java Code :

public class MainActivity extends AppCompatActivity {
    private MapView map;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        map = findViewById(R.id.map);
        //set map focus position
        LngLat focalPoint = new LngLat(53.529929, 35.164676);
        map.setFocalPointPosition(focalPoint, 0f);
        map.setZoom(14f);
        //add basemap layer
        map.getLayers().add(NeshanServices.createBaseMap(NeshanMapStyle.STANDARD_DAY));
    }
}

Kotlin Code :

class MainActivity : AppCompatActivity() {

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_main)
        //set map focus position
        map.setFocalPointPosition(LngLat(53.529929, 35.164676), 0f)
        map.setZoom(14f)
        //add basemap layer
        map.layers.add(NeshanServices.createBaseMap(NeshanMapStyle.STANDARD_DAY))
    }
}

6) Run the Android app with smile :)