Adding Mappls Map

There are two ways to add the Mappls Map to your Android project. Following options are the way to include Mappls Map in your project: - Using MapView - Using SupportMapFragment

Using MapView

Add the Map In your layout

<com.mappls.sdk.maps.MapView
    android:id="@+id/map_view"
    android:layout_width="match_parent"
    android:layout_height="match_parent" />

Handle the Lifecycle of Activity/Fragment

Kotlin

override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)
    //...
    mBinding.mapView.onCreate(savedInstanceState)
    //...
}

override fun onStart() {
    super.onStart()
    mBinding.mapView.onStart()
}

override fun onResume() {
    super.onResume()
    mBinding.mapView.onResume()
}

override fun onSaveInstanceState(outState: Bundle) {
    super.onSaveInstanceState(outState)
    mBinding.mapView.onSaveInstanceState(outState)
}

override fun onPause() {
    super.onPause()
    mBinding.mapView.onPause()
}

override fun onStop() {
    super.onStop()
    mBinding.mapView.onStop()
}

override fun onDestroy() {
    super.onDestroy()
    mBinding.mapView.onDestroy()
}

Java

@Override
protected void onCreate(Bundle savedInstanceState) {
    //..
    mBinding.mapView.onCreate(savedInstanceState);
    //..
}

@Override
protected void onStart() {
    super.onStart();
    mBinding.mapView.onStart();
}

@Override
protected void onResume() {
    super.onResume();
    mBinding.mapView.onResume();
}

@Override
protected void onSaveInstanceState(@NonNull Bundle outState) {
    super.onSaveInstanceState(outState);
    mBinding.mapView.onSaveInstanceState(outState);
}

@Override
protected void onPause() {
    super.onPause();
    mBinding.mapView.onPause();
}

@Override
protected void onStop() {
    super.onStop();
    mBinding.mapView.onStop();
}

@Override
protected void onDestroy() {
    super.onDestroy();
    mBinding.mapView.onDestroy();
}

Note: In case of Fragment call mBinding.mapView.onDestroy() in onDestroyView() callback insted of onDestroy()

Add the Map Initialization event callback

Kotlin

mBinding.mapView.getMapAsync(object: OnMapReadyCallback {
    override fun onMapReady(mapplsMap: MapplsMap) {
        //Map Initialise Successfully
    }

    override fun onMapError(code: Int, message: String?) {
        //Error in Initialising Map 
    }
})

Java

mBinding.mapView.getMapAsync(new OnMapReadyCallback() {
    @Override
    public void onMapReady(@NonNull MapplsMap mapplsMap) {
        //Map Initialise Successfully  
    }
    @Override
    public void onMapError(int i, String s) {
        //Error in Initialising Map
    }
});

Using Support Map Fragment

Add Map Fragment in Layout

<androidx.fragment.app.FragmentContainerView
    android:id="@+id/support_map_fragment"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:name="com.mappls.sdk.maps.SupportMapFragment" />

Add the Map Initialization event callback

Kotlin

mBinding.supportMapFragment.getFragment<SupportMapFragment>().getMapAsync(object: OnMapReadyCallback {
    override fun onMapReady(mapplsMap: MapplsMap) {
        //Map Initialise Successfully  
    }

    override fun onMapError(code: Int, message: String?) {
        //Error in Initialising Map        
    }
})

Java

((SupportMapFragment)mBinding.supportMapFragment.getFragment()).getMapAsync(new OnMapReadyCallback() {
    @Override
    public void onMapReady(@NonNull MapplsMap mapplsMap) {
        //Map Initialise Successfully      
    }

    @Override
    public void onMapError(int i, String s) {
        //Error in Initialising Map
    }
});