MoGoEagleEye/libraries/map-custom

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 文件中进行相关权限设置，确保地图功能可以正常使用。

<!--允许程序打开网络套接字-->
<uses-permission android:name="android.permission.INTERNET" />
<!--允许程序设置内置sd卡的写权限-->
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
<!--允许程序获取网络状态-->
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<!--允许程序访问WiFi网络信息-->
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
<!--允许程序读写手机状态和身份-->
<uses-permission android:name="android.permission.READ_PHONE_STATE" />
<!--允许程序访问CellID或WiFi热点来获取粗略的位置-->
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />

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)、初始化地图容器 布局添加

<com.zhidaoauto.map.sdk.open.view.MapAutoView
        android:id="@+id/mapAutoView"
        android:layout_width="match_parent"
        android:layout_height="match_parent" />

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)
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<BitmapDescriptor> = ArrayList<BitmapDescriptor>()
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<Int>()
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<LonLatPoint>()
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<LonLatPoint>()
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<Int>()
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<LonLatPoint>()
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<Int>()
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<LonLatPoint>()
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<LonLatPoint>()
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<LonLatPoint>()
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<LonLatPoint>()
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<LonLatPoint>): List<Point>//data: 批量地图坐标点  返回值： 批量屏幕坐标点

(4)、批量屏幕坐标转纬度

MapTools.fromScreenLocations(data: List<Point>): List<LonLatPoint>//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轴坐标