Mappls Place Picker Widget

Introduction

Mappls Place Picker Plugin can be used to choose a specific location.

Add the dependency

Add below dependency in app level build.gradle file

Kotlin (build.gradle.kts)

// When using the BoM, you don't specify versions in Mappls library dependencies
implementation("com.mappls.sdk:place-widget")

//Or Add Dependency with Version
implementation("com.mappls.sdk:place-widget:3.0.1")

Groovy (build.gradle)

// When using the BoM, you don't specify versions in Mappls library dependencies
implementation 'com.mappls.sdk:place-widget'

//Or Add Dependency with Version
implementation("com.mappls.sdk:place-widget:3.0.1")

Add Place Picker

To add the place picker widget

java

   Intent intent = new PlacePicker.IntentBuilder()  
                .placeOptions(placePickerOptions).build(this);  
   startActivityForResult(intent, 101);

Kotlin

  val intent = PlacePicker.IntentBuilder()  
            .placeOptions(placePickerOptions).build(this)  

  startActivityForResult(intent, 101)

You can use PlacePickerOptions to set the following properties:

toolbarColor(Integer): To set the toolbar color of place widget
startingBounds(LatLngBounds): To open a map in a bound
statingCameraPosition(CameraPosition): To open a map that sets in camera poition you can set zoom, centre, bearing etc.,
includeDeviceLocationButton(Boolean): To enable/ disable current location functionality
marker(Integer): To change the marker image which is visible in the centre of a map
mapMaxZoom(Double): To set maximum zoom level of the map
mapMinZoom(Double): To set minimum zoom level of the map
includeSearch(Boolean): To provide opions for search locations
searchPlaceOption(PlaceOptions): To set all the properties of search widget

Premium Feature

The Place Picker widget has the capability to showcase certain premium features if they are provisioned within your project, like:

Highlighting a Building

If the selected point on the map falls within a building, then Mappls Place Picker can also highlight the said building on the map. This visualization's color palette is configurable within the Mappls Map SDK.

In order to access this feature, please contact API support as well as your Business relationship manager.

Also, you need to use below properties to use this feature:

buildingFootprintsEnabled(Boolean) : To display Building Foot Print of place picker area
buildingAppearanceFillColor(String): To set the footprint background color
buildingAppearanceFillOpacity(Double):To set the footprint background color opacity
buildingAppearanceStrokeOpacity(Double):To set the footprint Stroke opacity color
buildingAppearanceStrokeWidth(Integer): To set the footprint Stroke Width
buildingAppearanceStrokeColor(String): To set the footprint Line Stroke Color

Get Result

To get the pick place:

java

@Override  
protected void onActivityResult(int requestCode, int resultCode, @Nullable Intent data) {  
       super.onActivityResult(requestCode, resultCode, data);  
       if (requestCode == 101 && resultCode == RESULT_OK) {  
        Place place = PlacePicker.getPlace(data);  
  }  
}

Kotlin

override fun onActivityResult(requestCode: Int, resultCode: Int, data: Intent?) {  
      super.onActivityResult(requestCode, resultCode, data)  
      if(requestCode == 101 && resultCode == Activity.RESULT_OK) {  
            val place: Place? = PlacePicker.getPlace(data!!)            
    }  
}