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
        }
    });

For any queries and support, please contact:

Email us at apisupport@mappls.com

Support
Need support? contact us!