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轴坐标