Place Autocomplete Widget



Place Autocomplete Widget

Setup your project

Follow these steps to add the SDK to your project –

• Create a new project in Android Studio
• Add MapmyIndia repository in your project level build.gradle

 allprojects {  	
    repositories {  	
    	
        maven {  	
            url 'https://maven.mapmyindia.com/repository/mapmyindia/' 	
        }  	
    }  	
}	

• Add below dependency in your app-level build.gradle

    implementation 'com.mapmyindia.sdk:place-widget:1.3.0'	

Add your API keys to the SDK

Add your API keys to the SDK (in your application's onCreate() or before using map)

Java

MapmyIndiaAccountManager.getInstance().setRestAPIKey(getRestAPIKey());  	
MapmyIndiaAccountManager.getInstance().setMapSDKKey(getMapSDKKey());  		
MapmyIndiaAccountManager.getInstance().setAtlasClientId(getAtlasClientId());  	
MapmyIndiaAccountManager.getInstance().setAtlasClientSecret(getAtlasClientSecret());  	

Kotlin

MapmyIndiaAccountManager.getInstance().restAPIKey = getRestAPIKey()  	
MapmyIndiaAccountManager.getInstance().mapSDKKey = getMapSDKKey()  		
MapmyIndiaAccountManager.getInstance().atlasClientId = getAtlasClientId()  	
MapmyIndiaAccountManager.getInstance().atlasClientSecret = getAtlasClientSecret()	

Add PlaceAutocomplete Widget

There are two ways to implement PlaceAutocomplete widget:

• Using PlaceAutocompleteFragment
• Using PlaceAutocompleteActivity

PlaceAutocompleteFragment

Add PlaceAutocompleteFragment in your activity

Java

PlaceAutocompleteFragment placeAutocompleteFragment = PlaceAutocompleteFragment.newInstance();

getSupportFragmentManager().beginTransaction().add(R.id.fragment_container, placeAutocompleteFragment, PlaceAutocompleteFragment.class.getSimpleName())  
        .commit();

                            //OR
PlaceAutocompleteFragment placeAutocompleteFragment = PlaceAutocompleteFragment.newInstance(placeOptions);

getSupportFragmentManager().beginTransaction().add(R.id.fragment_container, placeAutocompleteFragment, PlaceAutocompleteFragment.class.getSimpleName())  
        .commit();

Kotlin

val placeAutocompleteFragment: PlaceAutocompleteFragment = PlaceAutocompleteFragment.newInstance(placeOptions)
supportFragmentManager.beginTransaction().add(R.id.fragment_container, placeAutocompleteFragment, PlaceAutocompleteFragment::class.java.simpleName)  
        .commit()
                               
                               //OR
val placeAutocompleteFragment: PlaceAutocompleteFragment = PlaceAutocompleteFragment.newInstance()
supportFragmentManager.beginTransaction().add(R.id.fragment_container, placeAutocompleteFragment, PlaceAutocompleteFragment::class.java.simpleName)  
        .commit()                               

You can use PlaceOptions to set the properties of the widget:

• location(Point): set location around which your search will appear

• filter(String): this parameter helps you restrict the result either by mentioning a bounded area or to certain eloc (6 digit code to any poi, locality, city, etc.), below mentioned are the both types:

  • filter = bounds: lat1, lng1; lat2, lng2 (latitude, longitude) {e.g. filter("bounds: 28.598882, 77.212407; 28.467375, 77.353513")
  • filter = cop: {eloc} (string) {e.g. filter("cop:YMCZ0J")

• historyCount(Integer): Maximum number of history results appear

• zoom(Double): takes the zoom level of the current scope of the map (min: 4, max: 18).

• saveHistory(Boolean): If it sets to true it shows the history selected data

• pod(String): 1. it takes in the place type code which helps in restricting the results to certain chosen type.Below mentioned are the codes for the pod

  • AutoSuggestCriteria.POD_SUB_LOCALITY
  • AutoSuggestCriteria.POD_LOCALITY
  • AutoSuggestCriteria.POD_CITY
  • AutoSuggestCriteria.POD_VILLAGE
  • AutoSuggestCriteria.POD_SUB_DISTRICT
  • AutoSuggestCriteria.POD_DISTRICT
  • AutoSuggestCriteria.POD_STATE
  • AutoSuggestCriteria.POD_SUB_SUB_LOCALITY

• tokenizeAddress(Boolean): provides the different address attributes in a structured object.

• backgroundColor(int): to set the background color of the widget

• toolbarColor(int): to set the toolbar color of the widget.

• hint(String): To set the hint on the Search view of the widget.

• attributionVerticalAlignment(int): To set the vertical alignment for attribution. Below mentioned are the values:

  • PlaceOptions.GRAVITY_LEFT
  • PlaceOptions.GRAVITY_CENTER
  • PlaceOptions.GRAVITY_RIGHT

• attributionHorizontalAlignment(int): To set the horizontal alignment for attribution. Below mentioned are the values:

  • PlaceOptions.GRAVITY_TOP
  • PlaceOptions.GRAVITY_BOTTOM'

• logoSize(int): To set the logo size. Below mentioned are the values:

  • PlaceOptions.SIZE_SMALL
  • PlaceOptions.SIZE_MEDIUM
  • PlaceOptions.SIZE_LARGE

Note: To set the view mode pass PlaceOptions.MODE_FULLSCREEN or PlaceOptions.MODE_CARDS in build(int) method of the PlaceOptions.Builder class

To set the selected place use PlaceSelectionListener interface:

Java

placeAutocompleteFragment.setOnPlaceSelectedListener(new PlaceSelectionListener() {  
    @Override  
    public void onPlaceSelected(ELocation eLocation) {  
       // Select place
    }  
  
    @Override  
    public void onCancel() {  
       //on click of back button
    }  
});

Kotlin

placeAutocompleteFragment.setOnPlaceSelectedListener(object : PlaceSelectionListener {  
    override fun onCancel() {  
          //on click of back button
    }  
  
    override fun onPlaceSelected(eLocation: ELocation?) {  
         // Select place
    }  
  
})

PlaceAutocompleteActivity

Add PlaceAutocompleteActivity in your activity:

Java

Intent placeAutocomplete = new PlaceAutocomplete.IntentBuilder()  
        .placeOptions(placeOptions)  
        .build(this);  
  
startActivityForResult(placeAutocomplete, REQUEST_CODE);

Kotlin

val placeAutocompleteActivity: Intent = PlaceAutocomplete.IntentBuilder()  
        .placeOptions(placeOptions)  
        .build(this)  
startActivityForResult(placeAutocompleteActivity, REQUEST_CODE)

To get the selected place:

Java

protected void onActivityResult(int requestCode, int resultCode, @Nullable Intent data) {  
    super.onActivityResult(requestCode, resultCode, data);  
    if(requestCode == REQUEST_CODE) {  
        if(resultCode == Activity.RESULT_OK) {  
            if(data != null) {  
                ELocation eLocation = new Gson().fromJson(data.getStringExtra(PlaceConstants.RETURNING_ELOCATION_DATA), ELocation.class);  
            }  
        }  
    }  
}

Kotlin

override fun onActivityResult(requestCode: Int, resultCode: Int, data: Intent?) {  
    super.onActivityResult(requestCode, resultCode, data)  
    if(requestCode == REQUEST_CODE) {  
        if(resultCode == Activity.RESULT_OK) {  
            val eLocation :ELocation = Gson().fromJson(data?.getStringExtra(PlaceConstants.RETURNING_ELOCATION_DATA), ELocation::class.java)
        }        
    }  
}

Email us at apisupport@mapmyindia.com

Stack Overflow Ask a question under the mapmyindia-api

Support Need support? contact us!

Blog Read about the latest updates & customer stories

© Copyright 2020. CE Info Systems Pvt. Ltd. All Rights Reserved. | Terms & Conditions.