Mappls Search Widget

Getting started

npm install mappls-search-widgets-react-native --save

• Install peerDependencies

npm  i  mappls-map-react-native react-native-simple-toast @react-native-community/netinfo

• If using React-native<0.60 react-native link mappls-search-widgets-react-native

Installation

Android

• Add followling line in android/build.gradle file:-

1allprojects {
2	repositories {
3		mavenLocal()
4		maven {
5		   // All of React Native (JS, Obj-C sources, Android binaries) is installed from npm
6		   url("$rootDir/../node_modules/react-native/android")
7
8		}
9		maven {
10			// Android JSC is installed from npm
11			url("$rootDir/../node_modules/jsc-android/dist")
12		}
13+ maven { url 'https://maven.mappls.com/repository/mappls/'}
14		google()
15		jcenter()
16		maven { url 'https://www.jitpack.io' }
17	}
18}

• Add followling line in android/app/build.gradle file:-

1defaultConfig {
2	applicationId "com.example"
3	minSdkVersion rootProject.ext.minSdkVersion
4	targetSdkVersion rootProject.ext.targetSdkVersion
5	versionCode 1
6	versionName "1.0"
7+ multiDexEnabled true
8}

ios

• run pod install from ios folder

Usage

Step 1: Import

1import  MapplsUIWidgets  from  'mappls-search-widgets-react-native'
2import  MapplsGL  from  'mappls-map-react-native';

Step 2. Initialization

Initialize the SDK with your keys.

1// for map sdk
2MapplsGL.setMapSDKKey(mapSDKKey);//place your mapsdkKey
3MapplsGL.setRestAPIKey(restAPIKey);//your restApiKey
4MapplsGL.setAtlasClientId(atlasClientId);//your atlasClientId key
5MapplsGL.setAtlasClientSecret(atlasClientSecret); //your atlasClientSecret key

Step 3: Use MapplsUIWidgets.PlacePicker

1<MapplsUIWidgets.PlacePicker
2	center={plcePickerCenter}
3	zoom={10}
4	searchWidgetProps={{backgroundColor:'#F0FFF0'}}
5	resultCallback={(res) =>
6
7	}
8/>

Request Props

1. center :(number) place picker center coordinate(optional) note- if center is not provided map will zoom to current location of user.

2. zoom:(number) place picker map zoom level (optional)

3. pickerImage :place picker marker image. You can use static images or image urls.(optional)

4. searchWidgetProps :(object) custom configuration for search widget props inside place picker.(optional)

5. resultCallback:(function) returns result of place picker

Step 4. Use MapplsUIWidgets.searchWidget

1try{
2	const  res = await  MapplsUIWidgets.searchWidget({toolbarColor:'#F5F5F5'});
3	//Do something with result
4}catch(e){
5	//error logs
6	console.log(e);
7}

Search Widget Request Properties

1. location(Array): set location around which your search will appear. Ex. [77.56,28.34]

2. 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")

3. historyCount(number): Maximum number of history results appear. (Android )

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

5. saveHistory(Boolean): If it sets to true it shows the history selected data. (Android )

6. 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

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

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

8. backgroundColor(HexColor): to set the background color of the widget

9. toolbarColor(HexColor): to set the toolbar color of the widget.

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

For any queries and support, please contact:

Support Need support? contact us!