From 2f0d724d6034cfda8a448e0790f0d1a3d4ea2fed Mon Sep 17 00:00:00 2001 From: donghongyu Date: Tue, 16 Nov 2021 11:34:48 +0800 Subject: [PATCH] =?UTF-8?q?[Add]=E6=B7=BB=E5=8A=A0=E5=9C=B0=E5=9B=BE?= =?UTF-8?q?=E8=AF=B4=E6=98=8E?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: donghongyu --- libraries/map-custom/README.md | 1251 ++++++++++++++++++++++++++++++++ 1 file changed, 1251 insertions(+) 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轴坐标 +```