diff --git a/libraries/map-custom/README.md b/libraries/map-custom/README.md
index e69de29bb2..a12d71eef6 100644
--- a/libraries/map-custom/README.md
+++ b/libraries/map-custom/README.md
@@ -0,0 +1,1251 @@
+# SDK API
+[toc]
+
+## 一.地图相关
+
+### 1.显示地图
+
+
+#### 1.1添加依赖
+```
+implementation 'com.zhidaoauto.machine:map:1.0.0-vr-8.5.79'
+或者引入相关aar包 mapmodule-release-1.0.0_1.aar
+
+
+//本库依赖于koltin以及协程进行开发，请引入以下 版本请参考ext.kotlin_version = '1.3.50' ext.kotlinCoroutinesVersion = '1.3.3'
+implementation "org.jetbrains.kotlinx:kotlinx-coroutines-android:${kotlinCoroutinesVersion}"
+implementation "org.jetbrains.kotlinx:kotlinx-coroutines-core:${kotlinCoroutinesVersion}"
+implementation "org.jetbrains.kotlin:kotlin-stdlib-jdk7:$kotlin_version"
+implementation 'com.alibaba:fastjson:1.2.73'
+implementation 'com.amap.api:location:5.3.1'
+```
+
+#### 1.2申明权限
+
+使用地图SDK之前，需要在 AndroidManifest.xml 文件中进行相关权限设置，确保地图功能可以正常使用。
+```
+
+
+
+
+
+
+
+
+
+
+
+
+
+```
+
+#### 1.3初始化
+
+(1)、初始化 默认配置在Application的onCreate()中添加
+```
+val mapParams = MapParams.init()
+ .setCoordinateType(MapParams.COORDINATETYPE_GCJ02)
+ .setPerspectiveMode(MapParams.MAP_PERSPECTIVE_2D)
+ .setStyleMode(MapParams.MAP_STYLE_NIGHT)
+ .setAutoLocation(true) //是否开启定位 true 开启 false 不开启
+ .setDataFileSource(0) //设置获取文件是从本地还是redis 0 redis 1本地
+ .setDataRedisFileSource(0) //设置redis是开发环境还是正式环境 0 正式 1 测试
+ .setQzoneFilterArray(tileFilter)
+ .setCarPosition(3f)
+MapAutoApi.init(this,mapParams)
+```
+(2)、地图配置相关参数MapParams
+
+名称 | 说明
+---- | -----
+setDebugMode(debug: Boolean): MapParams | 设置是否为deBug模式
+setCoordinateType(coordinateType: Int): MapParams | 设置坐标类型 GPS(WGS84) 0 ;GCJ-02(高德) 1; BD09(百度) 2;
+setStyleDir(stylePath: String): MapParams | 设置地图样式路径
+setCachePath(cachePath: String): MapParams | 设置地图缓存路径
+setHdmapPath(hdmapPath: String): MapParams | 设置高精数据路径
+setZoom(zoom: Int): MapParams | 设置地图默认显示层级
+setPointToCenter(offsetX: Float, offsetY: Float): MapParams | 设置地图中心偏移 参数去做 0-1
+setStyleMode(styleMode: Int): MapParams | 设置地图模式 type MapAutoApi.MAP_STYLE_DAY 日间模式 MapAutoApi.MAP_STYLE_NIGHT 夜间模式 MapAutoApi.MAP_STYLE_VR VR模式
+setPerspectiveMode(perspectiveMode: Int): MapParams | 设置地图视图模式 MapParams.MAP_PERSPECTIVE_2D-- 2D模式， MapParams.MAP_PERSPECTIVE_3D-- 3D模式 MapParams.MAP_PERSPECTIVE_UP_CAR-- 车头向上模式 MapParams.MAP_PERSPECTIVE_UP_NORTH-- 正北向上模式
+setAutoSwitch(isAutoSwitch: Boolean): MapParams | 设置是否自动切换日夜模式
+setAutoLocation(isAutoLocation: Boolean): MapParams | 设置是否自动定位
+setDataFileSource(dataFileSource: Int): MapParams | 设置获取数据方式 1,本地文件。非1，redis获取
+setQzoneFilterArray(filter: IntArray): MapParams | 设置可选择数据区域加载功能 （北京 1101 衡阳 4304 武汉 4201 鄂州 4207）
+setCarPosition(offset: Float): MapParams | 设置自车位置 offset 1.0-6.0， <4.0车向上，>4.0车向下
+
+(3)、初始化地图容器
+布局添加
+```
+
+
+```
+
+#### 1.4周期方法
+```
+
+class StandardActivity: Activity() {
+
+ override fun onCreate(savedInstanceState: Bundle?) {
+ super.onCreate(savedInstanceState)
+ setContentView(R.layout.layout_main)
+ mapAutoView.onCreate(savedInstanceState)
+ initView()
+ }
+
+ private fun initView() {
+ }
+
+
+ override fun onResume() {
+ super.onResume()
+ mapAutoView.onResume()
+ }
+
+ override fun onPause() {
+ super.onPause()
+ mapAutoView.onPause()
+ }
+
+ override fun onDestroy() {
+ super.onDestroy()
+ mapAutoView.onDestroy()
+ }
+}
+```
+#### 1.5地图事件
+
+(1)、地图点击事件
+
+```
+实现接口OnMapClickListener
+interface OnMapClickListener {
+ fun onMapClick(lonLatPoint: LonLatPoint) //lonLatPoint 点击位置坐标
+}
+设置监听
+mapAutoView.setOnMapClickListener(onMapClickListener:OnMapClickListener)
+```
+
+(2)、地图触摸事件
+
+```
+实现接口OnMapTouchListener
+interface OnMapTouchListener {
+ fun onTouch(event: MotionEvent?):Boolean
+}
+设置监听
+mapAutoView.setOnMapTouchListener(onMapTouchListener:OnMapTouchListener)
+```
+(3)、地图加载完成事件
+
+```
+实现接口OnMapLoadedListener
+interface OnMapLoadedListener {
+ fun onMapLoaded() //地图加载完成
+ fun onRoadLoaded(roadInfo:String?)//道路加载完成 roadInfo 道路信息
+}
+设置监听
+mapAutoView.setOnMapLoadedListener(onMapLoadedListener: OnMapLoadedListener?)
+```
+(4)、地图状态变化事件
+
+```
+实现接口OnCameraChangeListener
+interface OnCameraChangeListener {
+ //type: 变化类型 MapAutoApi.LISTENER_TYPE_ZOOM 缩放 MapAutoApi.LISTENER_TYPE_ROTATE 旋转 MapAutoApi.LISTENER_TYPE_3D 视角 MapAutoApi.LISTENER_TYPE_FOCUS 移动 value： 具体值
+ fun onCameraChange(type:Int,value:Int)
+ //地图状态变化结束回调 position： 位置信息
+ fun onCameraChangeFinish(position: CameraPosition?)
+}
+设置监听
+mapAutoView.setOnCameraChangeListener(onCameraChangeListener: OnCameraChangeListener?)
+```
+(5)、地图截屏事件
+
+```
+实现接口MapScreenListener
+interface MapScreenListener : OnMapScreenShotListener {
+ override fun onMapScreenShot(bitmap: Bitmap?) //bitmap 截屏图片
+}
+设置监听
+mapAutoView.registerScreenListener(mapScreenListener: OnMapScreenShotListener?)
+```
+(6)、地图模式监听事件
+
+```
+实现接口OnMapStyleListener
+interface OnMapStyleListener {
+ //type MapAutoApi.MAP_STYLE_DAY 日间模式 MapAutoApi.MAP_STYLE_NIGHT 夜间模式 MapAutoApi.MAP_STYLE_VR VR模式
+ fun onChangeMapStyle(style: Int)
+}
+设置监听
+mapAutoView.setOnMapStyleListener(onMapStyleListener: OnMapStyleListener?)
+```
+
+(7)、地图视角切换监听事件
+
+```
+实现接口OnMapViewVisualAngleChangeListener
+interface OnMapViewVisualAngleChangeListener {
+ //type MapAutoApi.MAP_STYLE_VR_ANGLE_NEAR 近视角 MapAutoApi.MAP_STYLE_VR_ANGLE_MIDDLE 中视角 MapAutoApi.MAP_STYLE_VR_ANGLE_FAR 远视角
+ fun onMapViewVisualAngleChange(type: Int)
+}
+设置监听
+mapAutoView.setOnMapViewVisualAngleChangeListener(onMapViewVisualAngleChangeListener: OnMapViewVisualAngleChangeListener?)
+```
+
+(8)、地图滑动监听事件
+
+```
+实现接口OnScrollListener
+interface OnScrollListener{
+ fun scrollBy(x:Double,y:Double) //x: X轴滑动距离 y:Y轴滑动距离
+ }
+设置监听
+mapAutoView.registerScrollListener(lis: OnScrollListener?)
+```
+
+(9)、地图渲染监听事件
+
+```
+实现接口OnRenderListener
+interface OnRenderListener {
+ fun renderTime(time:Long) //time 渲染时间
+}
+设置监听
+mapAutoView.registerRenderListener(renderListener: OnRenderListener?)
+```
+
+### 2.定位相关
+
+(1)、定位
+```
+var locationClient: LocationClient = LocationClient(this)
+
+
+ fun startLocation() {
+ locationClient?.registerListener(this)
+ locationClient?.start()
+ }
+
+ fun unRegisterListener() {
+ locationClient?.unRegisterListener(this)
+ }
+```
+
+(2)、实现LocationClient.LocationListener接口处理返回数据
+```
+fun onLocationChanged(location: Location){}
+
+```
+(3)、使用外部数据相关
+```
+mapAutoView.getLocationClient().setIsUseExtraGPSData(true)//设置是否外部数据
+mapAutoView.getLocationClient().setExtraSelfGPSData(currentLocation.copy())//使用外部数据 参数 外部数据坐标
+```
+使用外部数据模拟移动相关示例
+```
+mapAutoView.getLocationClient().setIsUseExtraGPSData(true)
+mapAutoView.getLocationClient().rtkEnable(true)
+mTrackJob?.cancel()
+try {
+ inputStream?.close()
+} catch (e: Exception) {
+
+}
+mTrackJob = GlobalScope.launch(Dispatchers.Default) {
+ while (loopFlag) {
+ mapAutoView.getLocationClient().reset()
+ var inputreader: InputStreamReader? = null
+ var buffreader: BufferedReader? = null
+ try {
+ inputStream
+ = this@VrActivity.getAssets().open("heng_20210722.csv")
+ inputreader = InputStreamReader(inputStream)
+ buffreader = BufferedReader(inputreader)
+ var line: String? = null
+ var duration: Long = 3
+ var lastTime: Long = 0
+ var currentLocation :MogoLocation? = null
+ var location = MogoLocation()
+ //分行读取
+ while (buffreader != null && buffreader?.readLine()
+ .also({line = it }) != null) {
+ if (!stepFlag) {
+ loopFlag = false
+ break
+ }
+ val lines = line!!.split(",")
+ location.provider = "GPS_SELF"
+ val time = lines[0].trim().toLong()
+ location.lon = lines[1].trim().toDouble()
+ location.lat = lines[2].trim().toDouble()
+ location.distance = lines[6].trim().toDouble()
+ location.speed = 1f
+ var angle = lines[4].trim().toFloat()
+ if(currentLocation == null){
+ currentLocation = location
+ lastTime = time
+ continue
+ }else{
+ currentLocation.duration =
+ currentLocation.duration+ time - lastTime
+ lastTime = time
+ if(currentLocation.duration <= 10){
+ continue
+ }
+ }
+ if(currentLocation.duration > 1000){
+ currentLocation.duration= 300
+ }
+ //初始值
+ var heading = angle
+ if (heading == -100f) {
+ if (mLastHeading != 400f) {
+ heading = mLastHeading
+ } else {
+ heading = 0f
+ }
+ }
+ currentLocation.heading = heading
+ step++
+ if (step >= 1) {
+ step = 0
+ now = System.currentTimeMillis()
+ start = now
+ var realDuration = currentLocation.duration
+ currentLocation.duration = realDuration
+ mapAutoView.getLocationClient()
+ .setExtraSelfGPSData(currentLocation.copy())
+ delay(realDuration)
+ location.duration = 0
+ }
+ currentLocation.lon = location.lon
+ currentLocation.lat = location.lat
+ currentLocation.heading = location.heading
+ currentLocation.distance = location.distance
+ currentLocation.duration = 0
+ }
+ } catch (e: IOException) {
+ e.printStackTrace()
+ } finally {
+ buffreader?.close()
+ inputreader?.close()
+ inputStream?.close()
+ }
+ }
+}
+```
+
+### 3.自车相关
+
+(1)、获取自车锚点
+```
+mapAutoView?.getMapAutoViewHelper()?.getMyLocationStyle()?
+.getSelfMarker()
+```
+(2)、设置自车锚点图片或模型
+```
+mapAutoView?.getMapAutoViewHelper()?.getMyLocationStyle()?
+.myLocationIcon(R.raw.other_car, true)//第一个参数： 自车图片或模型 第二个参数：true : 3D模型 false: 2D
+```
+(3)、显示自车
+```
+mapAutoView?.getMapAutoViewHelper()?.getMyLocationStyle()?.showCar()
+```
+(4)、隐藏自车
+```
+mapAutoView?.getMapAutoViewHelper()?.getMyLocationStyle()?.hideCar()
+```
+(5)、设置自车角度
+```
+mapAutoView?.getMapAutoViewHelper()?.getMyLocationStyle()?
+.setRotateAngle(angle: Float)//angle: 角度
+```
+
+
+### 4.地图样式相关
+
+(1)、获取当前图层类型
+```
+mapAutoView.getMapAutoViewHelper()?.getMapStyle()
+```
+图层 | Value
+-------- | --------
+日间模式 | MapAutoApi.MAP_STYLE_DAY
+夜间模式 | MapAutoApi.MAP_STYLE_NIGHT
+VR模式 | MapAutoApi.MAP_STYLE_VR
+(2)、设置图层类型
+
+```
+mapAutoView.getMapAutoViewHelper()?
+.setMapStyle(MapAutoApi.MAP_STYLE_NIGHT)
+```
+(3)、切换地图视角
+```
+setMapViewVisualAngle(type: Int) //type : MapAutoApi.MAP_STYLE_VR_ANGLE_NEAR 近视角 MapAutoApi.MAP_STYLE_VR_ANGLE_MIDDLE 中视角 MapAutoApi.MAP_STYLE_VR_ANGLE_FAR 远视角
+
+示例代码
+mapAutoView.getMapAutoViewHelper()?.setMapViewVisualAngle(0)
+
+切换近景视角
+mapAutoView.getMapAutoViewHelper()?
+.setNearViewAnglePosition(lonLatPoint: LonLatPoint, isGps: Boolean) //lonLatPoint: 近视角显示的位置坐标 isGPS true gps坐标 false 高德坐标
+```
+详细参考以下代码
+```
+var mMapStyle = mapAutoView.getMapAutoViewHelper()?.getMapStyle()
+when (mMapStyle){
+ MapAutoApi.MAP_STYLE_DAY ->{
+ mapAutoView.getMapAutoViewHelper()?
+ .setMapStyle(MapAutoApi.MAP_STYLE_NIGHT)
+ btn_style.setText("夜间模式")
+ }
+ MapAutoApi.MAP_STYLE_NIGHT ->{
+ mapAutoView.getMapAutoViewHelper()?
+ .setMapStyle(MapAutoApi.MAP_STYLE_DAY)
+ btn_style.setText("日间模式")
+ }
+}
+```
+(4)、自定义地图模版改变底图颜色和样式，实现可视化的编辑和控制显示地图元素。
+
+实现代码如下
+```
+MapParams.init().setStyleDir("/sdcard/shmdata_asset/style")//参数 样式文件路径
+```
+
+## 二.地图交互相关
+
+### 1.控件交互
+
+(1)、定位按钮
+```
+//显示
+mapAutoView.getMapAutoViewHelper()?.showLocation()
+//隐藏
+mapAutoView.getMapAutoViewHelper()?.hiddenLocation()
+//位置
+mapAutoView.getMapAutoViewHelper()?.setLocationPosition(Gravity.TOP, 10, 0, 10, 10)//第一个参数：按钮显示位置 第二个参数：按钮显示距顶部距离 第三个参数：按钮显示距底部距离 第四个参数：按钮显示距左距离 第五个参数： 按钮显示距右距离
+```
+(2)、缩放按钮
+```
+//显示
+mapAutoView.getMapAutoViewHelper()?.showZoom()
+//隐藏
+mapAutoView.getMapAutoViewHelper()?.hiddenZoom()
+//位置
+mapAutoView.getMapAutoViewHelper()?.setZoomPosition(Gravity.TOP, 10, 0, 10, 10)//参数同定位按钮
+```
+(3)、比例尺
+```
+//显示
+mapAutoView.getMapAutoViewHelper()?.showScale()
+//隐藏
+mapAutoView.getMapAutoViewHelper()?.hiddenScale()
+//位置
+mapAutoView.getMapAutoViewHelper()?.setScalePosition(Gravity.TOP, 10, 0, 10, 10)//参数同定位按钮
+```
+(4)、Logo
+```
+//显示
+mapAutoView.getMapAutoViewHelper()?.showLogo()
+//隐藏
+mapAutoView.getMapAutoViewHelper()?.hiddenLogo()
+//位置
+mapAutoView.getMapAutoViewHelper()?.setLogoPosition(Gravity.TOP, 10, 0, 10, 10)//参数同定位按钮
+```
+(5)、指南针
+```
+//显示
+mapAutoView.getMapAutoViewHelper()?.showDirection()
+//隐藏
+mapAutoView.getMapAutoViewHelper()?.hiddenDirection()
+//位置
+mapAutoView.getMapAutoViewHelper()?.setDirectionPosition(Gravity.TOP, 10, 0, 10, 10)//参数同定位按钮
+```
+
+### 2.手势交互
+
+(1)、缩放手势开关
+```
+mapAutoView.getMapAutoViewHelper()?.setZoomGesturesEnabled(isCanZoom)//设置手势是否可以缩放 isCanZoom true 可缩放 false 不可缩放
+mapAutoView.getMapAutoViewHelper()?.isZoomGesturesEnabled()// 获取开关状态 返回值 true 可缩放 false 不可缩放
+```
+
+(2)、滑动手势开关
+```
+mapAutoView.getMapAutoViewHelper()?.setScrollGesturesEnabled(isCanScroll)//设置手势是否可以滑动 isCanScroll true 可滑动 false 不可滑动
+mapAutoView.getMapAutoViewHelper()?.isScrollGesturesEnabled()//获取是否可滑动 返回值 true 可滑动 false 不可滑动
+```
+
+(3)、旋转手势开关
+```
+mapAutoView.getMapAutoViewHelper()?.setRotateGesturesEnabled(isCanRotate)//设置手势是否可以旋转 isCanRotate true 可旋转 false 不可旋转
+mapAutoView.getMapAutoViewHelper()?.isRotateGesturesEnabled()//获取是否可以旋转 返回值 true 可旋转 false 不可旋转
+```
+
+(4)、倾斜手势开关
+```
+mapAutoView.getMapAutoViewHelper()?.setTiltGesturesEnabled(isCanTitl)//设置手势是否可以斜滑 isCanTitl true 可斜滑 false 不可斜滑
+mapAutoView.getMapAutoViewHelper()?.isTiltGesturesEnabled()//获取是否可以斜滑 返回值 true 可斜滑 false 不可斜滑
+```
+
+(5)、手势总开关
+```
+mapAutoView.getMapAutoViewHelper()?.setAllGesturesEnabled(isCanTitl)//参数 true 所有手势都可以 false 所有手势都不可以
+```
+
+
+### 3.调用方法交互
+
+地图交互的核心方法均依赖 MapAutoViewHelper类 使用mapAutoView.getMapAutoViewHelper()获取
+
+名称 | 说明
+---- | -----
+setRenderFrequency(enableSync: Boolean,renderTimePer:Int) | 设置地图同步渲染事件 enableSync: 是否同步， renderTimePer：同步时间
+setLocation(lonLatPoint: LonLatPoint) | 设置当前定位点 非锁车模式有效 即setLockMode(false) lonLatPoint：坐标
+setCenter(lonLatPoint: LonLatPoint) | 设置当前中心点 非锁车模式有效 即setLockMode(false) lonLatPoint：坐标
+getCenter(): LonLatPoint | 获取当前中心点 返回值当前中心点
+getLastKnownLocation(): MogoLocation | 获取最后一次定位点 返回最后一次定位点
+setOffset(left: Int, top: Int) | 设置地图中心偏移量 left: 屏幕横X轴偏移量 top：屏幕Y轴偏移量
+zoomIn() | 地图放大
+zoomOut() | 地图缩小
+zoomIn(cx: Float, cy: Float) | 地图放大 cx：横向比例 cy： 竖向比例
+getZoom(): Int | 获取地图当前缩放值
+setZoom(zoomIndex: Int) | 设置地图缩放值
+setMapViewAngle(angle: Float) | 设置地图视角（带动画） angle:地图视角
+setVrEyeHeight(eyeHeight: Float) | 设置地图视点高度（带动画） eyeHeight： 视点高度
+animateTo(lon: Double,lat: Double,rotateAngle: Float, isGPS: Boolean) | 设置地图移动(带动画) lon, lat地图移动到的位置 rotateAngel 地图移动结束的旋转角度 isGps 是否是GPS坐标
+animateTo(lon: Double,lat: Double, zoom: Float,rotateAngle: Float,overlookAngle: Float,eyeHeight: Float,mDuration:Int,isGPS: Boolean) | 设置地图移动 地图移动结束的缩放值， overlookAngle 地图移动结束的视角，eyeHeight 地图移动结束的视点高度， mDuration 移动动画时长， 其余参数同上
+animateTo(lon: Double,lat: Double,rotateAngle: Float, mDuration:Int, isGPS: Boolean) | 设置地图移动 同上
+animateTo(zoom: Float, overlookAngle: Float, eyeHeight: Float, mDuration:Int) | 设置地图移动 同上
+setMapDAngle(angle: Float) | 设置地图视角 angle：地图视角
+getMapDAngle(): Float | 获取地图视角 返回地图视角
+setMapViewRotateAngle(rotateAngle: Float) | 设置地图旋转角度（带动画） rotateAngle：旋转角度
+setMapViewRotation(rotation: Float) | 设置地图旋转角度 rotation：旋转角度
+getMapViewRotation(): Float | 获取地图旋转角度 返回值 旋转角度
+setMapViewPerspective(mapPerspective: Int) | 设置地图视图模式 MapAutoApi.MAP_PERSPECTIVE_2D 2D模式， MapAutoApi.MAP_PERSPECTIVE_3D 3D模式 MapAutoApi.MAP_PERSPECTIVE_UP_CAR 车头向上模式 MapAutoApi.MAP_PERSPECTIVE_UP_NORTH 正北向上模式
+getMapViewPerspective(): Float | 获取地图视图模式 返回值 地图试图模式 1： 2D模式 2： 3D模式 3:车头向上 4:正北模式
+getRulerInfo(): Float | 获取地图比例 返回值 地图比例
+setMapStyle(stylemode: Int) | 设置地图模式 MapAutoApi.MAP_STYLE_DAY 日间模式 MapAutoApi.MAP_STYLE_NIGHT 夜间模式 MapAutoApi.MAP_STYLE_VR VR模式
+getMapStyle(): Int | 获取地图模式 返回值 地图模式 1，夜间模式 2， 日间模式 5，VR模式
+setMyLocationStyle(myLocationStyle: MyLocationStyle) | 设置定位类型 LOCATION_TYPE_SHOW： 指定为一次 LOCATION_TYPE_LOCATE：定位一次，且将视角移动到地图中心点 setMyLocationStyle(myLocationStyle: MyLocationStyle) | 设置定位类型 LOCATION_TYPE_SHOW： 指定为一次 LOCATION_TYPE_LOCATE：定位一次，且将视角移动到地图中心点 LOCATION_TYPE_FOLLOW： 连续定位、且将视角移动到地图中心点，定位蓝点跟随设备移动。（1秒1次定位） 默认执行此种模式 LOCATION_TYPE_FOLLOW_NO_CENTER： 连续定位、蓝点不会移动到地图中心点，并且蓝点会跟随设备移动。
+getMyLocationStyle(): MyLocationStyle | 获取定位定位类型
+moveCamera(cameraUpdate: CameraUpdate) | 地图移动 不带动画
+clearPel(): Boolean | 清除所以图元
+setRenderFps(fps: Int) | 设置刷新帧率 fps 刷新帧率
+getRenderFps(): Int | 获取刷新帧率
+setPointToCenter(x: Float, y: Float) | 设置屏幕上的某个像素点为地图中心点。 x: x轴偏移量（0-1），y:y轴偏移量（0-1）
+setAutoSwitchStyle(isAutoSwitch: Boolean) | 设置是否自动切换日语模式 isAutoSwitch：是否自动切换
+setIsUseExtraGPSData(isUseExtraGPSData: Boolean) | 设置是否使用外部数据 isUseExtraGPSData： 是否使用外部数据
+getIsUseExtraGPSData(): Boolean | 获取是否允许传入外部数据 返回值 是否允许传入外部数据
+showBuildings(enabled: Boolean) | 设置是否显示3D建筑物 enabled： 是否显示建筑物 true 显示 false 不显示
+setLockMode(enabled: Boolean) | 设置是否为锁车模式 enable: 是否为锁车模式 true 是 false 否
+getLockMode(): Boolean | 获取是否为锁车模式 返回值 是否为锁车模式 true 是 false 否
+getScalePerPixel(): Float | 获取当前缩放级别下，地图上1像素点对应的长度，单位米
+getCameraPosition(): CameraPosition | 获取当前位置信息
+clearAllMarkers() | 删除所有锚点
+setAnchorRate(rate: Float) | 设置3D锚点比例 rate: 锚点缩放比例
+getEyeHeight() | 获取视点高度
+setEyeHeight(eyeHeight: Float) | 设置视点高度 eyeHeight: 视点高度
+setVerticalViewFieldAngle(r: Float) | 设置视域角 r: 视域角
+getVerticalViewFieldAngle(): Float | 获取视域角
+setSwitchViewAngle(isSwitchViewAngle: Boolean) | 设置双击屏幕视角切换是否打开 isSwitchViewAngle： true：双击屏幕可以切换视角 false 双击屏幕不可以切换视角
+isSwitchViewAngle(): Boolean | 获取视角切换是否打开
+setMapViewVisualAngle(type: Int) | 设置远近视角 type: 视角类型 type MapAutoApi.MAP_STYLE_VR_ANGLE_NEAR 近视角 MapAutoApi.MAP_STYLE_VR_ANGLE_MIDDLE 中视角 MapAutoApi.MAP_STYLE_VR_ANGLE_FAR 远视角
+setScaleVRMode(isScaleVr: Boolean) | 设置能否由VR模式缩放到普通模式 true不能由VR模式缩小到普通模式 false 可以
+setNearViewAnglePosition(lonLatPoint: LonLatPoint, isGps: Boolean) | 切换到近视角 lonLatPoint:切换到近视角显示的位置 isGps true 是GPS坐标 false 不是GPS坐标
+toScreen() | 地图截屏
+setSelfCarPosition(param:Float) | 设置自车相对屏幕的大概位置 param 默认为4.0，范围1.0-6.0
+
+
+### 4.相关示例
+地图截屏示例如下
+
+mapAutoView.getMapAutoViewHelper()?.toScreen()
+mapview.addScreenShotListener(new OnMapScreenShotListener() {
+
+ @Override
+ public void onMapScreenShot(Bitmap bitmap) {
+
+ SimpleDateFormat sdf = new SimpleDateFormat("yyyyMMddHHmmss");
+
+ if(null == bitmap){
+
+ return;
+
+ }
+ try {
+
+ FileOutputStream fos = new FileOutputStream(
+ Environment.getExternalStorageDirectory() + "/test_"
+ + sdf.format(new Date()) + ".png");
+ boolean b = bitmap.compress(CompressFormat.PNG, 100, fos);
+ try {
+ fos.flush();
+ } catch (IOException e) {
+ e.printStackTrace();
+ }
+ try {
+ fos.close();
+ } catch (IOException e) {
+ e.printStackTrace();
+ }
+
+ handler.post({
+ if (b){
+ Toast.makeText(context,"截屏成功",Toast.LENGTH_SHORT).show()
+ }else{
+ Toast.makeText(context,"截屏失败",Toast.LENGTH_SHORT).show()
+
+ }
+ })
+ } catch (FileNotFoundException e) {
+ e.printStackTrace();
+ }
+ }
+});
+## 三.绘制相关
+
+### 1.绘制点标记
+
+(1)、默认绘制Marker
+```
+var markerOptions = MarkerOptions()
+ .position(lonLatPoint)
+ .title("infotitle")
+ .snippet("content")
+ .isGps(true)
+ .markerIcon(BitmapFactory.decodeResource(this.resources, R.mipmap.mk_car))
+ .anchor(0.5f, 0.5f)
+ .scale(0.5f)
+ .controlAngle(true)
+ .rotateAngle(30f)
+var marker = MarkerHelper.addMarker(markerOptions)
+```
+(2)、删除全部锚点
+```
+mapAutoView.getMapAutoViewHelper()?.clearAllMarkers()
+```
+(3)、Marker类方法包括以下
+
+名称 | 说明
+---- | -----
+setMarkerOptions(markerPtions: MarkerOptions) | 设置markerOption markerPtions：锚点参数
+getMarkeOptions(): MarkerOptions | 获取markerOption
+setClickable(clickable: Boolean) | 锚点是否可点击 clickable: true 可点击， false: 不可点击
+getClickable(): Boolean | 获取锚点是否可点击 返回值 clickable: true 可点击， false: 不可点击
+setScale(scale: Float) | 设置锚点缩放值 scale：缩放值
+setPosition(latLng: LonLatPoint) | 设置锚点位置 latLng 锚点位置
+getPosition(): LonLatPoint | 获取锚点位置 返回值 锚点位置
+remove() | 删除单个锚点
+setTitle(title: String) | 设置infowindow标题 title： infowindow标题
+setTitle(title: String) | 获取infowindow标题 返回值： infowindow标题
+setSnippet(snippet: String) | 设置infowindow内容 snippet：
+getSnippet(): String | 获取infowindow内容 返回值 infowindow内容
+setInfoWindowEnable(isEnable: Boolean) | 设置Marker覆盖物的InfoWindow是否允许显示,默认为false isEnable： true,允许显示 false 不允许显示
+setIcon(bitmap: Bitmap) | 设置锚点图片 bitmap: 锚点图片
+setIcon(view: View) | 设置锚点图片 view: 锚点图片
+marker3DIcon(resId: Int) | 设置3D锚点图片 resId:3D锚点模型资源文件
+setAnchor(anchorU: Float, anchorV: Float) | 设置锚点中心点 anchorU(0-1), anchorV(0-1)
+showInfoWindow() | 显示锚点infoWindow
+hideInfoWindow() | 隐藏锚点infoWindow
+isInfoWindowShown(): Boolean | 返回Marker覆盖物的信息窗口是否显示，true: 显示，false: 不显示。
+setVisible(visible: Boolean) | 设置锚点是否可见 visible true可见 false 不可见
+isVisible(): Boolean | 获取锚点是否可见 返回值 true可见 false 不可见
+setRotateAngle(rotageAngle: Float) | 设置锚点角度 rotageAngle角度
+getRotateAngle(): Float | 获取锚点角度
+setPeriod(period: Int) | 设置多少帧刷新一次图片资源，Marker动画的间隔时间，值越小动画越快。 period：间隔时间
+setInfoWindowOffset(offsetX: Int, offsetY: Int) | 设置infowindow偏移量 offsetX: x轴偏移量 offsetY: Y轴偏移量
+setInfoWindowView(infoView: View) | 设置锚点infoWindow图片 infoView：infowindow对应view
+setToTop() | 设置锚点置顶
+setUnTop() | 取消锚点置顶
+setZIndex(zIndex: Int) | 设置锚点Z值
+setAnchorColor(color: String) | 设置3D锚点颜色 color:3D锚点颜色 "#RRGGBBAA" 示例marker.setAnchorColor("#FF0000FF")
+setDraggable(isDraggable: Boolean) | 设置锚点是否可以拖拽 isDraggable true 可以拖拽 false 不可拖拽
+getDraggable(): Boolean | 获取锚点是否可拖拽 返回值： true 可以拖拽 false 不可拖拽
+setControlAngle(enable: Boolean) | 设置锚点方向是设置方向 enable： true 可以设置方向 false 不可设置方向
+setIcons(icons: ArrayList<*>) | 设置动画锚点图片 icons 动画锚点资源文件
+addDynamicAnchorPostion(lonLatPoint: LonLatPoint, current: Long, duration: Int) | 锚点动态平移 lonLatPoint： 锚点移动到的点 lonLatPoint：当前时间 duration：动画时长
+setTranslateAnimation(animation: MarkerTranslateAnimation) | 设置锚点平移动画 animation： 平移动画
+setMarkerScaleAnimation(animation: MarkerScaleAnimation) | 设置锚点缩放动画 animation：缩放动画
+setRotateAnimation(animation: MarkerRotateAnimation) | 设置锚点旋转动画 animation： 旋转动画
+
+
+(4)、Marker属性操作集中在 MarkerOptions 类
+
+名称 | 说明
+---- | -----
+id | 锚点id
+anchorColor | 3D锚点颜色 "#RRGGBBAA"
+position | 在地图上标记位置的经纬度值。必填参数
+title | 点标记的标题
+snippet | 点标记的内容
+draggable | 点标记是否可拖拽
+visible | 点标记是否可见
+anchor | 锚点中心点
+controlAngle | 锚点角度是否可控制
+rotateAngle | 点标记图标的旋转角度
+zIndex | 点标记的Z坐标
+clickable | 点标记是否可点击
+markerIcon | 点标记的图标
+infoWindowEnable | 锚点是否允许InfoWindow显示
+scale | 设置锚点缩放值
+period | gif锚点刷新图标的时间
+icons | 点标记的图标集合 ArrayList 3D动画 ArrayList 2D动画
+setInfoWindowOffset | 设置infowindow偏移量
+marker3DIcon | 设置3D锚点图标
+isGPS | 锚点坐标是否是gps坐标 默认false
+
+(5)、绘制Marker动画效果
+
+动画目前包含缩放（MarkerScaleAnimation）平移（MarkerTranslateAnimation）旋转（MarkerRotateAnimation）
+
+缩放动画示例代码
+```
+var animation = MarkerScaleAnimation(0f, 1f)
+animation.setDuration(5000)
+animation.setAnimationListener(object : MarkerAnimationListener)
+marker?.setMarkerScaleAnimation(animation)
+marker?.startAnimation()
+```
+平移动画示例代码
+```
+var animation = MarkerTranslateAnimation(lonLatPoints)
+animation.setAnimationListener(object : MarkerAnimationListener)
+animation.setDuration(duration)
+marker?.setTranslateAnimation(animation)
+marker?.startAnimation()
+```
+旋转动画示例代码
+```
+var animation = MarkerRotateAnimation(0f, 360f)
+animation.setAnimationListener(object : MarkerAnimationListener)
+animation.setDuration(1000)
+marker?.setRotateAnimation(animation)
+marker?.startAnimation()
+```
+动态平移示例代码
+```
+val animation = DynamicTranslateAnimation(lonLatPoint)
+animation.setCurrent(System.currentTimeMillis())
+animation.setDuration(5000)
+animation.setAnimationListener(object: MarkerAnimationListener)
+marker?.addDynamicAnchorPostion(animation)
+```
+动画监听事件
+```
+interface MarkerAnimationListener {
+ fun onAnimationStart(animation: Animation)//开始动画
+
+ fun onAnimationEnd(animation: Animation)//结束动画
+
+ fun onAnimationRepeat(animation: Animation)//暂未实现
+}
+设置监听
+animation.setAnimationListener(object : MarkerAnimationListener)
+```
+添加动态锚点示例代码如下
+
+```
+fun addDymicMarker(lonLatPoint1: LonLatPoint, duration: Long) {
+ val lonLatPoint = LonLatPoint(lonLatPoint1.longitude + 0.00005, lonLatPoint1.latitude + 0.00009,lonLatPoint1.angle)
+ if(dymicMarker == null){
+ var markerOptions = MarkerOptions()
+ .position(lonLatPoint)
+ .title("title center").zIndex(100)
+ .snippet("content center")
+ .setGps(true)
+ .marker3DIcon(R.raw.daba)//.anchorColor("#FF0000FF")
+ .controlAngle(true)
+ .rotateAngle(lonLatPoint1.angle)
+ dymicMarker = MarkerHelper.addMarker(markerOptions)
+ dymicMarker?.setOnMarkClickListener(this)
+ }else{
+ dymicMarker?.addDynamicAnchorPostion(lonLatPoint,System.currentTimeMillis(),duration.toInt())
+ }
+}
+```
+(6)、绘制动画锚点
+
+2D动画锚点 示例代码
+```
+val marker = MarkerHelper.addMarker(MarkerOptions().position(lonLatPoint).period(500))
+var list: ArrayList = ArrayList()
+list.add(BitmapDescriptor(BitmapFactory.decodeResource(resources, R.drawable.icon_tts_000)))
+list.add(BitmapDescriptor(BitmapFactory.decodeResource(resources, R.drawable.icon_tts_001)))
+list.add(BitmapDescriptor(BitmapFactory.decodeResource(resources, R.drawable.icon_tts_002)))
+marker?.setIcons(list)
+```
+绘制3D动画锚点 最多支持10个模型 示例代码
+```
+marker = MarkerHelper.addMarker(MarkerOptions().marker3DIcon(R.raw.gq_1).position(lonLatPoint).period(100))
+iconList.add(R.raw.gq_1)
+iconList.add(R.raw.gq_2)
+iconList.add(R.raw.gq_3)
+iconList.add(R.raw.gq_4)
+···
+marker?.setIcons(iconList)
+```
+(7)、绘制海量点
+```
+mapAutoView.getMapAutoViewHelper()?.addMarkers(multiPointOverlayOptions)
+```
+示例代码如下
+```
+
+var multiPointOverlayOptions = MultiPointOverlayOptions()
+multiPointOverlayOptions.setMarkerIcon(R.mipmap.icon_map_marker_car_gray)
+for (lonlat in lonlatpoints) {
+ markerOptions = MarkerOptions().position(lonlat).setMarkerIconName(multiPointOverlayOptions.markerIconName)
+ list.add(markerOptions)
+}
+multiPointOverlayOptions.setMarkerData(list)
+markersController = mapAutoView.getMapAutoViewHelper()?.addMarkers(multiPointOverlayOptions)
+
+```
+(8)、锚点事件
+
+Marker点击事件
+```
+marker?.setOnMarkClickListener(object : OnMarkClickListener{
+ override fun onMarkClick(marker: Marker) {
+
+ }
+})
+```
+Marker拖拽事件
+```
+marker?.setOnMarkerDragListener(object : OnMarkerDragListener{
+ override fun onMarkerDragStart(var1: Marker?) {
+ TODO("Not yet implemented")
+ }
+
+ override fun onMarkerDrag(var1: Marker?) {
+ TODO("Not yet implemented")
+ }
+
+ override fun onMarkerDragEnd(var1: Marker?) {
+ TODO("Not yet implemented")
+ }
+})
+```
+(9)、绘制infoWindow
+
+默认的 Infowindow 只显示 Marker 对象的两个属性，一个是 title 和另一个 snippet。
+SDK 为用户提供了默认的 InfoWindow 样式，调用 Marker 类的 showInfoWindow() 和 hideInfoWindow() 方法可以
+控制显示和隐藏。调用setTitle() 与 setSnippet()可以改变Marker的title以及snippet。
+
+绘制自定义 InfoWindow
+
+InfoWindowAdapter是一个接口，其中有两个方法需要实现，依次来看一下:
+
+```
+interface InfoWindowAdapter{
+ fun getInfoWindow(marker: Marker?): View?
+ fun getInfoContents(marker: Marker?):View?
+}
+```
+当实现getInfoWindow()方法并返回有效值时（返回值不为空，则视为有效）,SDK 将不会使用默认的样式，而采用此方法返回的样式（即 View）。
+
+```
+MapAutoApi.setInfoWindowAdapter(object : InfoWindowAdapter {
+ override fun getInfoContents(marker: Marker?): View? {
+ return null
+ }
+
+ override fun getInfoWindow(marker: Marker?): View? {
+ view = LayoutInflater.from(this).inflate(R.layout.layout_info_window, null, false)
+ tv_title = view?.findViewById(R.id.info_title) as TextView
+ tv_snippet = view?.findViewById(R.id.info_content) as TextView
+ tv_title?.text = marker?.getTitle()
+ tv_snippet?.text = marker?.getSnippet()
+ return view
+ }
+})
+```
+（10）、批量更新锚点位置
+updateBatchMarkerPositon(list:ArrayList?,current:Long)
+示例
+```
+private fun addMarkerOptions(otherCar: OtherCar,duration:Long) {
+ var markerOptions : MarkerOptions? = markerOptionsMap.get(otherCar.id)
+ val lonLatPoint = LonLatPoint(otherCar.lon, otherCar.lat,otherCar.angle.toFloat())
+ val mode = getModelRes(otherCar.type)
+ if(markerOptions == null){
+ markerOptions = MarkerOptions("${otherCar.id}")
+ .setGps(true)
+ .position(lonLatPoint)
+ .title("title center").zIndex(100)
+ .snippet("content center")
+ .marker3DIcon(mode)//.anchorColor("#FF0000FF")
+ .controlAngle(true)
+ .rotateAngle(otherCar.angle.toFloat())
+ .duration(duration.toInt())
+ markerOptionsMap.put(otherCar.id,markerOptions)
+ }else{
+ markerOptions = markerOptions.position(lonLatPoint)
+ .marker3DIcon(mode)
+ .controlAngle(true)
+ .rotateAngle(otherCar.angle.toFloat())
+ .duration(duration.toInt())
+ }
+ optionsList.add(markerOptions)
+ }
+
+val currentMarkerList = ArrayList()
+for(car in others) {
+ addMarkerOptions(car,duration)
+ currentMarkerList.add(car.id)
+}
+MarkerHelper.updateBatchMarkerPositon(optionsList,System.currentTimeMillis())
+optionsList.clear()
+
+for(key in markerOptionsMap.keys){
+ if(!currentMarkerList.contains(key)){
+ delelteMarkerList.add(key)
+ }
+}
+
+for(value in delelteMarkerList){
+ val marker = markerOptionsMap.remove(value)
+ marker?.let{
+ MarkerHelper.removeMarker(it.getId())
+ }
+}
+delelteMarkerList.clear()
+```
+
+
+### 2.绘制线
+(1)、绘制线是由 Polyline 类定义实现的，线由一组经纬度点连接而成，绘制一条线与点标记一样，Polyline 的属性操作集中在 PolylineOptions 类中，添加一条线的示例如下：
+```
+val lons = java.util.ArrayList()
+lons.add(LonLatPoint(116.414571,39.969015))
+lons.add(LonLatPoint(116.416695,39.96908))
+lons.add(LonLatPoint(116.417988,39.969093))
+lons.add(LonLatPoint(116.417961,39.96973))
+poline = mapAutoView.getMapAutoViewHelper()?.drawThickLine(PolylineOptions().Color(Color.argb(255, 255, 0, 0)).lonLatPoints(lons).setLineWidth(5f))
+
+```
+(2)、绘制渐变示例 渐变线颜色不能比点数量多
+```
+val lons = java.util.ArrayList()
+lons.add(LonLatPoint(116.414971, 39.965015))
+lons.add(LonLatPoint(116.414971, 39.96608))
+lons.add(LonLatPoint(116.414971, 39.967093))
+lons.add(LonLatPoint(116.414971, 39.96873))
+var valuesArr = arrayListOf()
+valuesArr.add(Color.argb(255, 255, 0, 0))
+valuesArr.add(Color.argb(255, 0, 255, 0))
+valuesArr.add(Color.argb(255, 255, 0, 0))
+valuesArr.add(Color.argb(255, 0, 0, 255))
+mapAutoView.getMapAutoViewHelper()?.drawThickLine(PolylineOptions().lonLatPoints(lons).lineWidth(10f).colorValues(valuesArr).useGradient(true))
+```
+(3)、绘制多彩线示例 多彩线颜色要比点少
+```
+val lons = java.util.ArrayList()
+lons.add(LonLatPoint(116.414571, 39.965015))
+lons.add(LonLatPoint(116.414571, 39.96608))
+lons.add(LonLatPoint(116.414571, 39.967093))
+lons.add(LonLatPoint(116.414571, 39.96873))
+var valuesArr = arrayListOf()
+valuesArr.add(Color.argb(100, 255, 0, 0))
+valuesArr.add(Color.argb(100, 0, 255, 0))
+valuesArr.add(Color.argb(100, 0, 0, 255))
+mapAutoView.getMapAutoViewHelper()?.drawThickLine(PolylineOptions().useColorful(true).lonLatPoints(lons).lineWidth(5f).colorValues(valuesArr))
+
+```
+(4)、绘制线常用方法，这些方法在PolylineOptions类实现
+
+名称 | 说明
+---- | -----
+lonLatPoints | 设置线的位置
+lineWidth(float lineWidth) | 设置线宽 lineWidth: 线宽
+color(int color) | 线的颜色 color 颜色
+colorValues(List mColorValues) | 多彩线或渐变线的颜色 多彩线颜色要比点少 渐变线颜色不能比点数量多
+dottedLine(boolean dottedLine) | 设置是否画虚线，默认为false，画实线。 dottedLine true 虚线 false 实线
+dottedLineType(int type) | 设置虚线的类型 DOT_LINE_TYPE_SHORT_LINE //空隙长 DOT_LINE_TYPE_LONG_LINE 实线长
+useGradient(boolean isGradient) | 设置是否使用渐变色 isGradient true 渐变线 false 不是渐变线 默认 false
+useColorful | 设置是否是多彩线
+setGps | 是否是GPS坐标
+
+(5)、Polyline类
+
+名称 | 说明
+---- | -----
+setWidth(float lineWidth) | 设置线宽 lineWidth: 线宽
+setColor(int color) | 线的颜色 color： 颜色
+setZIndex(float zIndex) | 设置线段Z轴的值 zIndex： Z值
+setVisible(boolean visible) | 设置线段的可见性 visible： 是否可见 true: 可见 false: 不可见
+setPoints(List lonLatPoints) | 设置线段位置 lonLatPoints： 线的位置
+remove() | 删除单个线
+setDottedLine(boolean dottedLine) | 设置是否虚线 dottedLine true 是虚线 false 实线
+isDottedLine() | 获取是否虚线 返回值 true 是虚线 false 实线
+setOption(PolylineOptions option) | 设置属性
+
+
+
+### 3.绘制面
+(1)、绘制圆形
+```
+val lons = java.util.ArrayList()
+lons.add(LonLatPoint(116.407317, 39.970309))
+lons.add(LonLatPoint(116.413539, 39.968924))
+var circleOptions = CircleOptions().setRadius(100).setColor(Color.argb(100, 0, 255, 0)).setLineWidth(10).setLonLatPoints(lons)
+circleController = mapAutoView.getMapAutoViewHelper()?.drawCircle(circleOptions)
+```
+(2)、绘制矩形
+```
+val lons = java.util.ArrayList()
+lons.add(LonLatPoint(116.401539, 39.968924))
+lons.add(LonLatPoint(116.407539, 39.968924))
+lons.add(LonLatPoint(116.401539, 39.967000))
+lons.add(LonLatPoint(116.407539, 39.967000))
+var polylineOptions = PolylineOptions().setColor(Color.argb(100, 0, 100, 255)).setLineWidth(10f).setLonLatPoints(lons)
+rectController = mapAutoView.getMapAutoViewHelper()?.drawRect(polylineOptions)
+```
+(3)、绘制椭圆
+```
+val lons = java.util.ArrayList()
+lons.add(LonLatPoint(116.407539, 39.968924))
+lons.add(LonLatPoint(116.407539, 39.975024))
+lons.add(LonLatPoint(116.401639, 39.969000))
+lons.add(LonLatPoint(116.405665, 39.967924))
+var polylineOptions = PolylineOptions().setColor(Color.argb(100, 0, 255, 255)).setLineWidth(10f).setLonLatPoints(lons)
+ellipseController = mapAutoView.getMapAutoViewHelper()?.drawEllipse(polylineOptions)
+```
+(4)、绘制多边形
+```
+val lons = java.util.ArrayList()
+lons.add(LonLatPoint(116.39764, 39.968437))
+lons.add(LonLatPoint(116.407768, 39.969062))
+lons.add(LonLatPoint(116.408369, 39.959359))
+lons.add(LonLatPoint(116.398113, 39.959096))
+var polylineOptions = PolylineOptions().setColor(Color.argb(255, 255, 0, 255)).setLineWidth(10f).setLonLatPoints(lons)
+polygonController = mapAutoView.getMapAutoViewHelper()?.drawPolygon(polylineOptions)
+```
+
+
+## 四.地图数据相关
+
+### 1.获取POI数据
+
+>POI（Point of Interest，兴趣点）。在地图表达中，一个 POI 可代表一栋大厦、一家商铺、一处景点等等。通过POI搜索，完成找餐馆、找景点、找厕所等等的功能。地图 SDK 的搜索功能提供多种获取 POI 数据的接口，下文将逐一介绍。
+
+#### 1.1关键字检索POI
+
+根据关键字检索适用于在某个城市搜索某个名称相关的POI，例如：查找北京市的“肯德基”。
+
+注意：
+
+(1)、关键字未设置城市信息（默认为全国搜索）时，如果涉及多个城市数据返回，仅会返回建议城市，请根据APP需求，选取城市进行搜索。
+
+(2)、不设置POI的类别，默认返回“餐饮服务”、“商务住宅”、“生活服务”这三种类别的POI，下方提供了POI分类码表，请按照列表内容设置希望检索的POI类型。（建议使用POI类型的代码进行检索）
+
+#### 1.2实现关键字检索的步骤如下：
+(1)、继承 OnPoiSearchListener 监听。
+
+(2)、构造 Query 对象，通过 Query(keyword: String, city: String, category: String) 设置搜索条件。
+
+```
+query = new Query(keyWord, "", "");
+//keyWord表示搜索字符串，
+//第二个参数表示POI搜索区域，
+//category，搜索类型
+query.setPageSize(10);// 设置每页最多返回多少条poiitem
+query.setPageNum(currentPage);//设置查询页码
+```
+
+
+#### 1.3、构造 PoiSearch 对象，并设置监听。
+```
+poiSearch = new PoiSearch(this, query);
+poiSearch.setOnPoiSearchListener(this);
+```
+#### 1.4、调用 PoiSearch 的 searchPOIAsyn() 方法发送请求。
+```
+poiSearch.searchPOIAsyn();
+```
+#### 1.5、通过回调接口 onPoiSearched 解析返回的结果，将查询到的 POI 以绘制点的方式显示在地图上。
+#### 1.6、说明：
+1）可以在回调中解析poiSearchResults，获取POI信息。
+
+2）poiSearchResults.getItems()可以获取到PoiItem列表，Poi详细信息可参考PoiItem类。
+
+
+
+
+
+5）返回结果成功或者失败的响应码。0为成功，其他为失败
+
+```
+public void onPoiSearched(poiSearchResults: PoiSearchResults?, code: Int)
+ //解析poiSearchResults获取POI信息
+}
+```
+
+### 2. ID检索POI
+
+通过关键字检索、周边检索以及多边形检索，可通过ID检索来获取POI完整详细信息。
+
+实现步骤如下：
+
+(1)、继承 OnPoiSearchListener 监听。
+
+(2)、构造 PoiSearch 对象，并设置监听。对于ID检索，query参数设置成 null。
+
+```
+poiSearch = new PoiSearch(this, null);
+poiSearch.setOnPoiSearchListener(this);
+```
+(3)、调用 PoiSearch 的 searchPOIIdAsyn(java.lang.String poiID) 方法发送请求。
+```
+poiSearch.searchPOIIdAsyn(ID);// 异步搜索
+```
+(4)、通过回调接口 onPoiItemSearched 解析返回的结果。由于是检索具体的某一个POI，直接回调该POI对象 PoiItem。
+```
+@Override
+public void onPoiItemSearched(PoiItem item, int rCode) {
+ //获取PoiItem获取POI的详细信息
+}
+```
+
+### 3.输入内容自动提示
+
+输入提示是指根据用户输入的关键词，给出相应的提示信息，将最有可能的搜索词呈现给用户，以减少用户输入信息，提升用户体验。如：输入“方恒”，提示“方恒国际中心A座”，“方恒购物中心”等。
+
+实现输入提示的步骤如下：
+
+(1)、继承 InputtipsListener 监听。
+(2)、构造 InputtipsQuery 对象，通过 InputtipsQuery(java.lang.String keyword, java.lang.String city) 设置搜索条件。
+```
+//第二个参数传入null或者“”代表在全国进行检索，否则按照传入的city进行检索
+InputtipsQuery inputquery = new InputtipsQuery(newText, city);
+```
+(3)、构造 Inputtips 对象，并设置监听。
+```
+Inputtips inputTips = new Inputtips(this, inputquery);
+inputTips.setInputtipsListener(this);
+```
+(4)、调用 PoiSearch 的 requestInputtipsAsyn() 方法发送请求。
+```
+ inputTips.requestInputtipsAsyn();
+```
+(5)、通过回调接口 onGetInputtips 解析返回的结果，获取输入提示返回的信息。
+
+(6)、说明：
+
+a.在回调中解析 tipList，获取输入提示词的相关信息。
+
+b.tipList 数组中的对象是 Tip ，Tip 类中包含 PoiID、Adcode、District、Name 等信息。
+
+
+### 4.POI 分类
+id | 说明
+---- | -----
+4 | 引导参照点
+5 | 汽车维修
+6 | 加油站
+7 | 租车
+8 | 洗车
+9 | 汽车销售
+10 | 摩托车销售
+12 | 室内停车场
+13 | 露天停车场
+14 | 休息区
+16 | 野营
+21 | 宾馆/汽车旅馆
+22 | 饭店
+24 | 咖啡店
+25 | 酒吧
+26 | 电影院
+27 | 博物馆
+28 | 剧场
+29 | 图书馆
+30 | 医院
+32 | 牙科诊所
+33 | 药房
+34 | 宠物诊所
+35 | 警察局
+36 | 邮局
+37 | 市政府
+38 | 大使馆
+39 | 法院
+40 | 政府机构
+41 | 社区活动中心
+42 | 购物中心
+43 | 商店
+44 | 银行
+45 | ATM
+46 | 货币兑换
+47 | 旅游服务处
+48 | 旅行社
+49 | 旅游景点
+50 | 历史遗迹
+54 | 动物园
+55 | 游乐园
+57 | 露天体育场
+58 | 体育中心
+59 | 娱乐活动
+60 | 溜冰场
+61 | 游泳池
+62 | 高尔夫球场
+63 | 码头
+66 | 商业设施
+67 | 展览馆
+68 | 火车站
+69 | 公交车站
+71 | 飞机场
+75 | 紧急医疗服务
+77 | 消防队
+78 | 礼拜场所
+79 | 教育
+83 | 公共休息区/公厕
+
+### 5.地图相关数据
+地图数据获取在MapDataApi类中
+
+id | 说明
+---- | -----
+getRouteInfo(centerLon: Float,centerLat: Float, coor: Int, type: Int) | 获取道路信息 * coor 坐标系，0 GPS ,1 gcj
+getMatchRoadInfo(lonLatPoints: List,bGetAllPoints: Boolean): List? | 获取道路关键点数据
+getRouteAngle(startLonLat: LonLatPoint, endLonLat: LonLatPoint): Float | 获取行车方向
+getSinglePointMatchRoad(lon: Double, lat: Double, angle: Float, isGps: Boolean, isRTK: Boolean)： SinglePointRoadInfo | 获取匹配道路数据 isGps 是否是GPS数据 isRTK 是否是高精数据
+getLaneInfo(tileId: Long, routeId: Int): ArrayList | 获取车道中心线数据
+GetDisFromPointToLine( ptOrg:LonLatPoint, pLine:ArrayList, ptMatch:LonLatPoint, nSegmentOrder:Int):Double | 获取点到线的距离
+getOffRoadDistance(lon: Double, lat: Double, angle: Float): Double | 获取点与道路边界的距离
+
+
+
+## 五.地图计算工具
+### 1.坐标转换
+(1)、屏幕坐标转换为地图坐标
+ ```
+ MapTools.fromScreenLocation(android.graphics.Point paramPoint)//paramPoint 屏幕坐标点
+ ```
+(2)、地图坐标转换为屏幕坐标
+ ```
+ MapTools.toScreenLocation(latLonPoint: LatLonPoint)//latLonPoint: 地图坐标点
+ ```
+(3)、批量经纬度转屏幕坐标
+ ```
+ MapTools.toScreenLocations(data: List): List//data: 批量地图坐标点 返回值： 批量屏幕坐标点
+ ```
+(4)、批量屏幕坐标转纬度
+ ```
+ MapTools.fromScreenLocations(data: List): List//data: 批量屏幕坐标点 返回值： 批量地图坐标点
+ ```
+### 2.获取屏幕可见区域
+
+(1)、返回一个在屏幕坐标与地理经纬度坐标之间的可见区域
+```
+MapTools.getVisibleRegion(): VisibleRegion//返回值 屏幕可见区域
+```
+(2)、获取两点间距离
+```
+MapTools.distance(x1: Double, y1: Double, x2: Double, y2: Double): Double//x1:第一个点的x轴坐标 y1:第一个点的y轴坐标 x2:第二个点的x轴坐标 y2:第二个点的y轴坐标
+```