Skip to content

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!




@ Copyright 2025 CE Info Systems Ltd. All Rights Reserved.