MapRenderer (JNaviCore SDK Documentation)

java.lang.Object
- com.mapbar.map.MapRenderer

```
public class MapRenderer
extends java.lang.Object
```
地图渲染引擎
地图的所有绘制效果均由此渲染引擎控制

Notice:

注意：1. 除了draw()()在绘图线程中调用外，其他函数必须在主线程中调用，且不能同时在多个线程中调用同一个函数。
2. 所有以Nds结尾的函数的坐标为Nds坐标，调用NdsPoint.NdsPoint(Point)和NdsPoint.toPoint()转换
3. 初始化地图时，若数据目录下存在base.db,使用新的地图数据和渲染引擎，否则，使用旧数据及旧引擎

嵌套类概要

嵌套类
限定符和类型	类和说明
`class`	`MapRenderer.Animation` 地图摄像机动画
`class`	`MapRenderer.CameraSetting` 地图摄像机设置参数
`static interface`	`MapRenderer.DrawTransaction` 绘图事务接口所有的对`MapRenderer`的操作都将在下一帧同时生效，相当于是一次事务操作。
`static class`	`MapRenderer.FocusedObjType` 当前用户焦点所在的类型
`static class`	`MapRenderer.FpsCounter` 统计的帧率，帧率简单的看成一秒内绘制的帧数
`static class`	`MapRenderer.LevelCase` 缩放级别
`static interface`	`MapRenderer.Listener` 监听地图状态修改的接口
`static class`	`MapRenderer.MapLayerType` 加载的图层瓦片数据类型
`static class`	`MapRenderer.OptionalGesture` 手势
`class`	`MapRenderer.PoiType` 是否显示POI的一些选项可以用位或操作同时设置多个POI类型是否显示
`static class`	`MapRenderer.RenderConfig` 配置选项
`static class`	`MapRenderer.RenderMode` `MapRenderer`的渲染模式，目前只有两种，导航模式和地图模式主要用来对应不同模式下的渲染控制，如：不同模式下的POI显示类型`MapRenderer.PoiType`
`static class`	`MapRenderer.RenderQuality` 控制绘图质量高质量模式下，所有的元素都会渲染中质量模式和低质量模式下，会尽量的节省内存，中质量会显示重要元素，具体细节如下：复杂多边形轮廓较小的粗模建筑物精模建筑物粗模建筑物的屋顶轮廓高质量显示显示显示显示中质量不显示当缩放等级>0.5时不显示显示显示低质量不显示不显示不显示不显示
`static class`	`MapRenderer.SatelliteImageSource` 新框架卫星图显示资源种类不同的项目可根据需求选择
`class`	`MapRenderer.SatellitePicProvider` 卫星图供应商选择，默认使用`MapRenderer.SatellitePicProvider.Default`
`class`	`MapRenderer.TextSizeLevel` 文字大小
`class`	`MapRenderer.TouchUpType` 点击类型
`static class`	`MapRenderer.URasterArea` 用户栅格区域
`static class`	`MapRenderer.URasterData` 用户栅格数据
`static class`	`MapRenderer.URasterState` 用户栅格区域数据状态，说明`MapRenderer.URasterData.areas`中栅格区域数组中内容。
`class`	`MapRenderer.UrlType` 数据URL类型用来标识所设置是哪部分数据的URL前缀

构造器概要

构造器
构造器和说明

MapRenderer(MapRenderer.Listener listener)

构造器
构造器和说明
`MapRenderer(MapRenderer.Listener listener)`

方法概要

所有方法静态方法实例方法具体方法
限定符和类型	方法和说明
`void`	`addAnnotation(Annotation annotation)` 添加Annotation到MapRenderer对象
`void`	`addListener(MapRenderer.Listener listener)` 添加绘制事件监听
`void`	`addOverlay(Overlay overlay)` 添加Overlay到MapRenderer对象
`void`	`beginAnimations()` 以动画效果来改变地图摄像机参数配合`commitAnimations(int, int)`和`cancelAnimations()`实现动画效果
`void`	`bringOverlayToTop(Overlay overlay)` 将指定的`Overlay`提到所有`Overlay`最顶端
`void`	`cancelAnimations()` 取消动画当动画进行中，想要打断动画，那么可以使用此函数
`void`	`clearAll()` 释放绘图占用资源,例如叠加层`Overlay`和弹出气泡`Annotation`等
`void`	`clearCache()` 建议当系统内存资源紧缺时使用此函数清理释放内存
`void`	`commitAnimations(int duration, int type)` 提交并开始动画
`void`	`commitDrawTransaction(MapRenderer.DrawTransaction transaction)` 与`commitDrawTransaction(DrawTransaction, Object)` 功能相同，只是在回调 `MapRenderer.DrawTransaction.doTransaction(MapRenderer, Object)` 时，第二个参数为空。
`void`	`commitDrawTransaction(MapRenderer.DrawTransaction transaction, java.lang.Object userData)` 提交绘图事务详细说明参看`MapRenderer.DrawTransaction`
`void`	`compactCache()` 建议在程序切到后台或者接收到操作系统内存紧缺的信号时使用此函数精简内存使用
`void`	`copyMapState(MapRenderer renderer)` 同步地图状态
`void`	`detachAnnotation(Annotation annotation)` 从MapRenderer中返回Annotation，与`removeAnnotation(Annotation)`类似，不同的是，不会释放Annotation资源，可再次添加到MapRenderer
`void`	`detachOverlay(Overlay overlay)` 从MapRenderer中返回Overlay，与`removeOverlay(Overlay)`类似，不同的时，不会释放Overlay资源，可再次添加到MapRenderer
`void`	`draw()` 绘制地图的方法
`void`	`enableBackground(boolean enable)` 设置地图渲染时是否清屏，默认：清屏
`void`	`enableBasicMap(boolean enable)` 开启/关闭地图底图
`void`	`enableBuilding(boolean enable)` 是否显示建筑物默认是：true
`void`	`enableCameraEvents(boolean enableOnCameraChanged, boolean enableOnNeedsDisplay)` 禁止`setWorldCenter(Point)`、`setViewport(Rect)`等改变地图状态时引发的 `MapRenderer.Listener.onCameraChanged(int)`和 `MapRenderer.Listener.onNeedsDisplay()` 回调
`void`	`enableMapLayer(int layerId, boolean enable)` 打开/关闭指定的图层
`void`	`enableMaskDraw(boolean enabled)` 开启蒙版绘制模式，需设置绘制使用的蒙版`MapRenderer#setMaskDrawer()`
`void`	`enableOptionalGesture(int gesture, boolean enable)` 打开/关闭特定的手势
`void`	`enableSatelliteLayer(boolean enable)` 开/关新卫星图
`void`	`enableTmc(boolean enable)` TMC开关函数，必须运行于主线程
`void`	`exchangeOverlayIndices(Overlay overlayL, Overlay overlayR)` 交换两个`Overlay`的层次顺序
`void`	`fitWorldArea(android.graphics.Rect area)` 将地图的中心和比例尺设置为合适的大小以便能完整地显示区域的内容。
`void`	`fitWorldAreaToRect(android.graphics.Rect area, android.graphics.Rect fitToRect)` 将制定的地图上的矩形区域显示到指定的屏幕矩形区域中
`void`	`fitWorldAreaToRectNds(android.graphics.Rect area, android.graphics.Rect fitToRect)` 将指定的地图上的矩形区域显示到指定的屏幕矩形区域中
`android.graphics.Rect`	`getBoundArea()` 获取地图的边界范围
`float`	`getDpiFactor()` 获取屏幕DPI大小
`float`	`getElevation()` 获取仰角，用于3D模式下的摄像机操作
`MapRenderer.FpsCounter`	`getFpsCounter()` 获取统计的帧率
`float`	`getHeading()` 获取地图当前方向角
`float`	`getHighestBuildingZoom()` 获取绘制建筑物的最大缩放级别
`int`	`getLanguage()` 获取地图文字显示语言
`MapState`	`getMapState()` 获取当前地图状态，包括摄像机状态，用于动态恢复地图状态
`int`	`getRenderQuality()` 获取当前渲染地图的质量
`float`	`getScale()` 获取绘图标尺
`int`	`getSkyBottomPosition()` 获取天空盒底部位置，单位：像素
`float`	`getSkyFactor()` 获取天空盒比例
`java.lang.String`	`getStyleClass()` 获取地图的样式类
`int`	`getTmcRefreshInterval()` 获取当前实时交通(TMC)数据刷新时间
`float`	`getTraditionalMapScale()` 获取当前地图实际比例尺，单位：米。
`float`	`getTraditionalMapScaleOf(float zoomLevel)` 获取特定zoomLevel对应的地图实际比例尺，单位：米。
`android.graphics.Rect`	`getViewport()` 获取当前地图的大小(矩形表示)
`float`	`getViewShift()` 获取当前屏幕的相对位置偏移Y方向的百分比
`Vector2DF`	`getViewShiftXY()` 获取地图中心点所在屏幕的相对位置偏移量，使用`Vector2DF`来表示，其中`Vector2DF.getX()`所获取的是X方向的偏移量百分比，`Vector2DF.getY()`所获取的位Y方向的偏移量百分比范围：[-1.0, 1.0]
`android.graphics.Point`	`getWorldCenter()` 获取当前地图中心点坐标
`NdsPoint`	`getWorldCenterNds()` 获取当前地图中心点的NDS坐标
`android.graphics.Rect`	`getWorldRect()` 获取当前屏幕所覆盖的真实地理包络盒的大小
`NdsRect`	`getWorldRectNds()` 获取当前屏幕所覆盖的真实地理包络盒的大小
`float`	`getZoomLevel()` 获取当前地图缩放级别
`static float`	`getZoomLevelOf(int levelCase)` 获取某些特定情景下的缩放值
`Vector2DF`	`getZoomLevelRange()` 获取缩放等级范围。
`static void`	`glReadPixels(int x, int y, int width, int height, int format, int type)` 一般用于将显存的内容读到PBO，由于GLES30.glReadPixels只有在API level 24后才支持，在低版本的手机上，需要调用封装的接口读
`Annotation[]`	`hitTestAnnotations(android.graphics.Point clickPoint)` 给定一个点，返回此位置可点击到的所有`Annotation`。
`void`	`insertOverlayAtIndex(Overlay overlay, int index)` 在指定层次插入Overlay，不同层次会出现压盖关系
`boolean`	`isBackgroundEnabled()` 判断当前是否为开启清屏的模式
`boolean`	`isBasicMapEnabled()` 判断当前是否开启了地图底图
`boolean`	`isBuildingEnabled()` 判断当前是否为现实建筑的状态
`boolean`	`isInAnimation()` 判断当前是否正在执行动画的过程中
`boolean`	`isMapLayerEnabled(int layerId)` 判断指定的图层是否打开
`boolean`	`isOptionalGestureEnabled(int gesture)` 判断特定的手势是否有效
`boolean`	`isPointVisible(android.graphics.Point point)` 判断指定的点是否在地图的可见范围内
`boolean`	`isPointVisibleNds(NdsPoint point)` 判断指定的点是否在地图的可见范围内
`boolean`	`isRectVisible(android.graphics.Rect rect)` 判断指定的矩形是否在地图的可见范围内所谓可见，就是指定矩形与屏幕矩形有相交
`boolean`	`isRectVisibleNds(NdsRect rect)` 判断指定的矩形是否在地图的可见范围内所谓可见，就是指定矩形与屏幕矩形有相交
`boolean`	`isSatelliteLayerEnabled()` 获取是否开启了新卫星图
`boolean`	`isTmcEnabled()` TMC是否开启
`boolean`	`loadStyleSheet(java.lang.String filePath)` 加载样式表文件 `MapRenderer`对象被创建时, 将加载包中的默认样式表文件NaviCoreUtil.buildPathInPacket("map3_style_sheet.json"), 鹰眼地图创建时, 将加载默认样式文件res/small_map3_style_sheet.json
`int`	`meter2Pixel(int lenInMeter)` 计算实际距离映射到屏幕中的大小
`void`	`monitorDataReadiness()` 监测数据准备状态。
`void`	`moveAnnotations(MapRenderer renderer)` 将其他MapRenderer中所有`Annotation`移动到当前MapRenderer
`void`	`moveOverlays(MapRenderer renderer)` 将其他MapRenderer中所有`Overlay`移动到当前MapRenderer
`void`	`onTap(android.graphics.Point touchPoint)` 屏幕点击的点
`void`	`onTouchCancelled(int touchCount, int[] touchIds, int[] touchXs, int[] touchYs)` 取消屏幕的按下，抬起，拖动等事件
`void`	`onTouchClicked(android.graphics.Point pos)` 发生单击，在单击事件里，会判断是否点击到POI、Overlay、Annotation等，若点击到，会触发Selected、 DeSelected、*Clicked回调
`void`	`onTouchDoubleClicked(android.graphics.Point pos)` 双击，在点击点的位置放大地图，使zoomLevel减一
`boolean`	`onTouchDown(int touchCount, int[] touchIds, int[] touchXs, int[] touchYs)` 获取屏幕按下事件
`void`	`onTouchMove(int touchCount, int[] touchIds, int[] touchXs, int[] touchYs)` 获取屏幕的拖动事件
`void`	`onTouchUp(int touchCount, int[] touchIds, int[] touchXs, int[] touchYs)` 获取屏幕上点击时的抬起事件
`void`	`pan(android.graphics.Point offset)` 平移地图到指定的点(跳跃)
`void`	`panTo(android.graphics.Point position)` 平移地图到指定的点
`static int`	`registerCustomIcon(android.graphics.Bitmap icon)` 为图标分配唯一的ID，图标ID可用于`Annotation`和`PointsOverlay` 中。
`static int`	`registerCustomIcon(java.lang.String iconPath)` 为图标分配唯一的ID，图标ID可用于`Annotation`和`PointsOverlay` 中。
`void`	`reload()` 重新载入绘图数据可以在下载完新数据的时候使用此函数来刷新本地数据避免了下载新数据必须要重启系统的麻烦
`void`	`reloadIfNeeded()` 重新加载地图在新离线数据安装后，用于主动刷新地图。
`void`	`removeAllAnnotations()` 移除所有添加到MapRenderer中的`Annotation`
`void`	`removeAllOverlays()` 删除所有添加到MapRenderer中的`Overlay`
`void`	`removeAnnotation(Annotation annotation)` 移除MapRenderer对象中的`Annotation`
`void`	`removeListener(MapRenderer.Listener listener)` 删除绘制事件监听
`void`	`removeOverlay(Overlay overlay)` 移除MapRenderer中的Overlay对象，释放Overlay对应的Native资源
`void`	`resetTouch()` 设置内部维护的触摸状态为none-touch-down，即无点击状态
`static float`	`scale2ZoomLevel(float scale)` 根据给定的绘图标尺获取对应的缩放级别,返回值取决于当前使用的数据是旧格式还是新格式
`android.graphics.Point`	`screen2World(android.graphics.PointF position)` 将屏幕坐标转换为对应的世界坐标
`NdsPoint`	`screen2WorldNds(android.graphics.PointF position)` 将屏幕坐标转换为对应的世界坐标
`void`	`selectAnnotation(Annotation annotation)` 设置选中地图中指定的Annotation
`void`	`sendOverlayToBack(Overlay overlay)` 将指定的`Overlay`放入所有`Overlay`最下方
`void`	`setBoundArea(android.graphics.Rect area)` 设置地图边界范围，设置后，地图只能在限制的范围内拖动。
`void`	`setClipRect(android.graphics.Rect clipRect)` 设置裁剪区域（相对于屏幕），只在设置的区域内绘制地图
`void`	`setConfigBoolean(int configType, boolean value)` 设置配置选项，包括： `MapRenderer.RenderConfig.orderAnnotDynamically` `MapRenderer.RenderConfig.keepCurPoiInRefreshingDraw` `MapRenderer.RenderConfig.enableAnnotationDrop`
`void`	`setConfigInt(int configType, int value)` 设置配置选项，包括： `MapRenderer.RenderConfig.annotationDropFrameNum` `MapRenderer.RenderConfig.annotationDropInterval` `MapRenderer.RenderConfig.forceRefreshPoiTime`
`void`	`setConfigInt(int configType, int value1, int value2)` 设置配置选项，包括： `MapRenderer.RenderConfig.maxCustomIconSize` `MapRenderer.RenderConfig.textTextureSize`
`void`	`setDpiFactor(float factor)` 设置屏幕DPI大小
`void`	`setElevation(float elevation)` 设置仰角角度，单位：度，范围：(MIN_ELEVATION, 90] 不同比例尺的仰角范围是不同的，但上限相同，比例尺越小，仰角范围的最小值越小
`void`	`setHeading(float heading)` 设置地图的朝向
`void`	`setHighestBuildingZoom(float highestZoomLevel)` 设置绘制建筑物的最大缩放级别，即当缩放级别不超过设置的值时才绘制建筑物，默认值：3.0f
`void`	`setLanguage(int lang)` 设置地图文字显示语言，需要相关数据支持.
`void`	`setMapState(MapState state)` 设置地图状态，用于恢复地图状态使用
`void`	`setMaskDrawer(MaskDrawer maskDrawer)` 设置渲染地图的蒙版，开启mask后绘制`enableMaskDraw(boolean)`
`void`	`setRenderQuality(int quality)` 设置当前地图渲染的质量
`void`	`setRenderTarget(Texture texture)` 设置渲染目标
`void`	`setSatelliteImageType(int sourceType)` 设置卫星图资源类型，仅适用于新框架卫星图的显示
`void`	`setScale(float scale)` 设置绘图标尺单位：米/50个像素，默认范围：[20, 1000000]
`void`	`setSkyFactor(float sizeRatioToCenter)` 设置天空盒比例
`boolean`	`setStyleClass(java.lang.String styleClass)` 设置地图的样式, 样式类中地图的节点名称为"map", 对地图样式的设置不影响其他对象的样式, 例如`RouteOverlay`
`void`	`setTmcRefreshInterval(int interval)` 设置当前实时交通(TMC)数据刷新时间, 单位: ms 也就是如果要设置为10秒钟刷新，那么应该是10 * 1000 同理两分钟刷新就是2 * 60 * 1000 必须运行于主线程
`void`	`setViewport(android.graphics.Rect rct)` 重置绘制区域
`void`	`setViewport(android.graphics.Rect rct, boolean resetRenderSystem)` 此方法同`setViewport(Rect)`，但是允许仅修改地图渲染位置，而不修改画布大小，如设置`MapView`中SmallMapRenderer的位置。
`void`	`setViewShift(float ratioBelowCenter)` 设置地图中心点所在屏幕屏幕的相对位置Y方向的百分比，将中心移动至世界中心 - (ratioBelowCenter * 屏幕高度 / 2)像素的位置范围：[-1.0, 1.0]
`void`	`setViewShiftXY(float ratioRightToCenter, float ratioBelowCenter)` 设置地图中心点所在屏幕的相对位置偏移量，相当于百分比将中心移动至世界中心 - (ratioRightToCenter * 屏幕高度 / 2)和世界中心 - (ratioBelowCenter * 屏幕高度 / 2)像素的位置范围：[-1.0, 1.0] 超出范围会设置无效，不做任何改变
`void`	`setWorldCenter(android.graphics.Point center)` 设置地图中心点位置
`void`	`setWorldCenterNds(NdsPoint center)` 设置地图中心位置，坐标为NDS坐标
`void`	`setZoomLevel(float zoomLevel)` 设置地图缩放级别，值越大，显示的地图越详细。
`void`	`setZoomLevelAtPoint(float level, android.graphics.Point screenPos)` 设置缩放级别，保持缩放过程中保持屏幕中某一点的位置不变
`void`	`setZoomLevelRange(Vector2DF range)` 设置缩放等级范围。
`void`	`switchToBackground()` 切换到后台切换到后台后，会停止不必要的数据下载，绘图相关的接口能正常调用，且某些必要设置，例如 `#setDataUrlPrefix(int, String)`仍会请求网络
`void`	`switchToForeground()` 从后台恢复到正常模式
`float`	`unitScreen2World(float unit)` 将屏幕坐标下的长度映射到世界坐标系下
`float`	`unitScreen2WorldNds(float unit)` 将屏幕坐标下的长度映射到NDS坐标表示世界坐标系下世界坐标系下经纬度表示的长度和NDS坐标表示的长度间可通过`NaviCoreUtil.len2NdsLen(float)`和 `NaviCoreUtil.ndsLen2Len(float)`转换
`float`	`unitWorld2Screen(float worldUnit)` 将世界坐标系下的经纬度表示的长度转换为屏幕坐标系下的长度一般来说，此方法配合`unitScreen2World(float)`使用，来绘制用于显示的比例尺在3D情况下，即，仰角小于90的情况下，计算结果仅在世界中心坐标附近时是准确的两个尺寸的计算公式如下： screenLength = worldLength / (scaleInMeter / METER_PER_LAT_UNIT / dpiFactor) * 50.0f
`float`	`unitWorld2ScreenNds(float worldUnit)` 将世界坐标系下的NDS表示的长度转换为屏幕坐标系下的长度一般来说，此方法配合`unitScreen2WorldNds(float)`使用在3D情况下，即，仰角小于90的情况下，计算结果尽在世界中心坐标附近时是准确的世界坐标系下经纬度表示的长度和NDS坐标表示的长度间可通过`NaviCoreUtil.len2NdsLen(float)`和 `NaviCoreUtil.ndsLen2Len(float)`转换
`static void`	`unregisterCustomIcon(int iconId)` 释放图标ID及其对应的资源。
`android.graphics.PointF`	`world2screen(android.graphics.Point position)` 将世界坐标转换为对应的屏幕坐标。
`android.graphics.PointF`	`world2screenNds(NdsPoint position)` 将世界坐标转换为对应的屏幕坐标。
`void`	`zoomIn(float zoomLevel)` 放大地图
`float`	`zoomLevel2MinElevation(float zoomLevel)` 计算给定缩放比例尺对应的最小仰角;返回值因地图数据是新格式或旧格式而异
`static float`	`zoomLevel2Scale(float zoomLevel)` 根据给定的缩放级别获取对应的放大级别,返回值取决于当前使用的数据是旧格式还是新格式
`void`	`zoomOut(float zoomLevel)` 缩小地图

从类继承的方法 java.lang.Object
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

构造器详细资料

MapRenderer

public MapRenderer(MapRenderer.Listener listener)
            throws java.lang.Exception

抛出:: java.lang.Exception

方法详细资料

enableMaskDraw
```
public void enableMaskDraw(boolean enabled)
```
开启蒙版绘制模式，需设置绘制使用的蒙版MapRenderer#setMaskDrawer()

setMaskDrawer
```
public void setMaskDrawer(MaskDrawer maskDrawer)
```
设置渲染地图的蒙版，开启mask后绘制enableMaskDraw(boolean)

参数:

stencil - 要设置的MaskDrawer实例

clearAll
```
public void clearAll()
```
释放绘图占用资源,例如叠加层Overlay和
弹出气泡Annotation等

enableMapLayer
```
public void enableMapLayer(int layerId,
                           boolean enable)
```
打开/关闭指定的图层

参数:

layerId - 图层IDMapRenderer.MapLayerType

enable - true时打开图层，false时关闭图层

另请参阅:

isMapLayerEnabled(int)

isMapLayerEnabled
```
public boolean isMapLayerEnabled(int layerId)
```
判断指定的图层是否打开

参数:

layerId - 图层IDMapRenderer.MapLayerType

返回:

返回true时图层已打开，false时关闭

另请参阅:

enableMapLayer(int, boolean)

enableSatelliteLayer
```
public void enableSatelliteLayer(boolean enable)
```
开/关新卫星图

参数:

enable - true为开启，false为关闭，默认：false

isSatelliteLayerEnabled
```
public boolean isSatelliteLayerEnabled()
```
获取是否开启了新卫星图

返回:

true为开启，false为关闭

setSatelliteImageType
```
public void setSatelliteImageType(int sourceType)
```
设置卫星图资源类型，仅适用于新框架卫星图的显示

参数:

sourceType - 卫星图资源类型 MapRenderer.SatelliteImageSource

draw
```
public void draw()
```
绘制地图的方法

另请参阅:

#drawWithRefreshingPOI()

setRenderTarget
```
public void setRenderTarget(Texture texture)
```
设置渲染目标

参数:

texture - 渲染目标，如果不为null，会渲染到对应的纹理里，为null时渲染到屏幕

switchToBackground
```
public void switchToBackground()
```
切换到后台
切换到后台后，会停止不必要的数据下载，绘图相关的接口能正常调用，且某些必要设置，例如 #setDataUrlPrefix(int, String)仍会请求网络

另请参阅:

switchToForeground()

Notice:

在MapView.onPause()中调用

switchToForeground
```
public void switchToForeground()
```
从后台恢复到正常模式

另请参阅:

switchToBackground()

Notice:

在MapView.onResume()中调用

enableCameraEvents
```
public void enableCameraEvents(boolean enableOnCameraChanged,
                               boolean enableOnNeedsDisplay)
```
禁止setWorldCenter(Point)、setViewport(Rect)等改变地图状态时引发的 MapRenderer.Listener.onCameraChanged(int)和 MapRenderer.Listener.onNeedsDisplay() 回调

参数:

enableOnCameraChanged - true时触发MapRenderer.Listener.onCameraChanged(int)回调，false时禁止回调，默认：true

enableOnNeedsDisplay - true时触发MapRenderer.Listener.onCameraChanged(int)回调，false时禁止回调，默认：true

loadStyleSheet
```
public boolean loadStyleSheet(java.lang.String filePath)
```
加载样式表文件
MapRenderer对象被创建时, 将加载包中的默认样式表文件NaviCoreUtil.buildPathInPacket("map3_style_sheet.json"), 鹰眼地图创建时, 将加载默认样式文件res/small_map3_style_sheet.json

参数:

filePath - 样式表文件路径

返回:

样式表文件存在时返回true，否则返回false

从以下版本开始:

4.11.x

Notice:

样式表文件采用JSON格式：顶层节点形如"class-CNAME", "CNAME"为样式类, 样式类的孩子节点为样式对象,例如 "map"表示地图样式, "route"表示RouteOverlay样式. 每个样式表文件中都包含一个默认样式类"DEFAULT", 包含了样式对象的所有属性, 其他样式类可只定义部分属性, 缺少的属性将采用默认属性 "class-DEFAULT": { "map": { "textSizeFactor": 1.0, "color": { "background": "ffd0d0d0", "backgroundLines": "ffa0a0a0", "lines": { "minor": "fff0f0f0", "local": "fffff8a4", "water": "ff94bee5" }, ...... }, "lineWidth": { "minor": 0.7, ...... }, ...... }, "route":{ "width": { "normal": 8.0, "tmc" : 8.0, "tmcWeaker": 8.0 } } }

setStyleClass
```
public boolean setStyleClass(java.lang.String styleClass)
```
设置地图的样式, 样式类中地图的节点名称为"map", 对地图样式的设置不影响其他对象的样式, 例如RouteOverlay

参数:

styleClass - 样式类名称

返回:

样式类中未定义地图的样式时, 返回false, 否则返回true

从以下版本开始:

4.11.x

另请参阅:

getStyleClass()

Notice:

在以后的版本中，将通过设置样式类切换白天/黑夜, 导航/非导航模式等，在默认样式表文件:NaviCoreUtil.buildPathInPacket("map3_style_sheet.json")

getStyleClass
```
public java.lang.String getStyleClass()
```
获取地图的样式类

返回:

样式类名称, 为"DEFAULT"时说明采用默认样式类

从以下版本开始:

4.11.x

另请参阅:

setStyleClass(String)

setViewport
```
public void setViewport(android.graphics.Rect rct)
```
重置绘制区域

参数:

rct - 设置画布及渲染区域视图大小及位置

Notice:

注意：
1、此方法调用时所影响的是相对于当前窗口的，比如设置rct的位置为, (10，10，100，100)，那么相当于将地图画布设置到了相对于应用程序窗口(10, 10, 100, 100)的区域中绘制。
这个方法同时对地图和全景图产生影响。
2、此方法会修改OpenGL底层渲染系统的画布大小，所以一般调用时应该仅针对主MapRenderer调用，MapView中存在的子地图(SmallMapRenderer)不应该调用此方法。

setViewport
```
public void setViewport(android.graphics.Rect rct,
                        boolean resetRenderSystem)
```
此方法同setViewport(Rect)，但是允许仅修改地图渲染位置，而不修改画布大小，如设置MapView中SmallMapRenderer的位置。

参数:

rct - 设置绘图区域的位置

resetRenderSystem - 是否同时设置画布大小

getViewport
```
public android.graphics.Rect getViewport()
```
获取当前地图的大小(矩形表示)

返回:

当前地图大小的矩形

Notice:

注意：这个方法同时对地图和全景图产生效果

pan
```
public void pan(android.graphics.Point offset)
```
平移地图到指定的点(跳跃)

参数:

offset - 平移时x,y方向的偏移量，屏幕坐标

panTo
```
public void panTo(android.graphics.Point position)
```
平移地图到指定的点

参数:

position - 欲平移到的点，屏幕坐标

setDpiFactor
```
public void setDpiFactor(float factor)
```
设置屏幕DPI大小

参数:

factor - DPI的值

getDpiFactor
```
public float getDpiFactor()
```
获取屏幕DPI大小

返回:

屏幕DPI大小

setWorldCenter
```
public void setWorldCenter(android.graphics.Point center)
```
设置地图中心点位置

参数:

center - 欲设置的中心点

getWorldCenter
```
public android.graphics.Point getWorldCenter()
```
获取当前地图中心点坐标

返回:

返回当前地图中心点

setWorldCenterNds
```
public void setWorldCenterNds(NdsPoint center)
```
设置地图中心位置，坐标为NDS坐标

参数:

center - 地图中心

另请参阅:

getWorldCenterNds()

Notice:

注意：坐标类型为NDS坐标

getWorldCenterNds
```
public NdsPoint getWorldCenterNds()
```
获取当前地图中心点的NDS坐标

返回:

返回当前地图中心点

另请参阅:

setWorldCenterNds(NdsPoint)

Notice:

注意：坐标类型为NDS坐标

setBoundArea
```
public void setBoundArea(android.graphics.Rect area)
```
设置地图边界范围，设置后，地图只能在限制的范围内拖动。默认：无限制

参数:

area - 经纬度范围

getBoundArea
```
public android.graphics.Rect getBoundArea()
```
获取地图的边界范围

返回:

范围

setScale
```
public void setScale(float scale)
```
设置绘图标尺单位：米/50个像素，默认范围：[20, 1000000]

参数:

scale -

另请参阅:

setDpiFactor(float)

Notice:

注意：最终的绘制尺寸会除以DPI因子

getScale
```
public float getScale()
```
获取绘图标尺

返回:

返回当前的绘图标尺，默认范围: [20, 1000000]

getZoomLevel
```
public float getZoomLevel()
```
获取当前地图缩放级别

返回:

返回缩放级别

另请参阅:

setZoomLevel(float)

setZoomLevel

public void setZoomLevel(float zoomLevel)

设置地图缩放级别，值越大，显示的地图越详细。若为浮点数，引擎会根据相邻两个缩放级别的比例尺插值
旧地图数据比例尺等级对应表：

等级	scale(米)
0.0	1000000
1.0	500000
2.0	200000
3.0	100000
4.0	50000
5.0	20000
6.0	10000
7.0	5000
8.0	2000
9.0	1000
10.0	500
11.0	200
12.0	100
13.0	50
14.0	20
----以下应当在室内图模式下使用----
15.0	10
16.0	5
17.0	2

新地图数据比例尺等级对应表：比例尺随等级增加减半

等级	scale(米)
0.0	1048576
1.0	524288
2.0	262144
3.0	131072
4.0	65536
5.0	32768
6.0	16384
7.0	8192
8.0	4096
9.0	2048
10.0	1024
11.0	512
12.0	256
13.0	128
14.0	64
15.0	32
16.0	16
----以下应当在室内图模式下使用----
17.0	8
18.0	4
19.0	2

参数:: zoomLevel - 缩放级别
另请参阅:: getZoomLevel()

zoomIn
```
public void zoomIn(float zoomLevel)
```
放大地图

参数:

zoomLevel - 放大级别，即在当前getZoomLevel()上放大zoomLevel级

另请参阅:

zoomOut(float)

zoomOut
```
public void zoomOut(float zoomLevel)
```
缩小地图

参数:

zoomLevel - 缩小级别，即在当前getZoomLevel()上缩小zoomLevel级

另请参阅:

zoomIn(float)

getZoomLevelOf
```
public static float getZoomLevelOf(int levelCase)
```
获取某些特定情景下的缩放值

参数:

levelCase - 指定的情景 MapRenderer.LevelCase

返回:

该情景对应的缩放值

Notice:

目前 MapRenderer.LevelCase.maxMap 对应的缩放值在使用老数据时为14,新数据时为16; MapRenderer.LevelCase.highest 的缩放值在新老数据中均为0

zoomLevel2Scale
```
public static float zoomLevel2Scale(float zoomLevel)
```
根据给定的缩放级别获取对应的放大级别,返回值取决于当前使用的数据是旧格式还是新格式

参数:

zoomLevel - 获取该缩放级别,该值必须位于 getZoomLevelOf(int)取值为 [MapRenderer.LevelCase.highest,MapRenderer.LevelCase.maxIndoor]的返回值之间
否则将会被截入该区间

返回:

对应的放大级别

另请参阅:

scale2ZoomLevel(float)

scale2ZoomLevel
```
public static float scale2ZoomLevel(float scale)
```
根据给定的绘图标尺获取对应的缩放级别,返回值取决于当前使用的数据是旧格式还是新格式

参数:

scale - 绘图标尺

返回:

对应的缩放级别

另请参阅:

zoomLevel2Scale(float)

setZoomLevelRange
```
public void setZoomLevelRange(Vector2DF range)
```
设置缩放等级范围。旧地图数据下默认缩放范围为[0, 14]，新数据默认范围为[0, 16]

参数:

range - 缩放范围

另请参阅:

getZoomLevelRange()

getZoomLevelRange
```
public Vector2DF getZoomLevelRange()
```
获取缩放等级范围。旧地图数据下默认缩放范围为[0, 14]，新数据默认范围为[0, 16]

返回:

等级范围

另请参阅:

setZoomLevelRange(Vector2DF)

setZoomLevelAtPoint
```
public void setZoomLevelAtPoint(float level,
                                android.graphics.Point screenPos)
```
设置缩放级别，保持缩放过程中保持屏幕中某一点的位置不变

参数:

level - 缩放级别

screenPos - 屏幕中固定点位置，缩放前后此位置在屏幕中的位置不变。

另请参阅:

setZoomLevel(float)

Notice:

此函数会打断当前动画

getElevation
```
public float getElevation()
```
获取仰角，用于3D模式下的摄像机操作

返回:

返回仰角角度，单位：度，范围：(MIN_ELEVATION, 90]
不同比例尺的仰角范围是不同的，但上限相同，比例尺越小，仰角范围的最小值越小

setElevation
```
public void setElevation(float elevation)
```
设置仰角角度，单位：度，范围：(MIN_ELEVATION, 90]
不同比例尺的仰角范围是不同的，但上限相同，比例尺越小，仰角范围的最小值越小

参数:

elevation - 仰角角度

getHeading
```
public float getHeading()
```
获取地图当前方向角

返回:

返回地图当前方向角，正北为0度，取值范围[0, 360)

setHeading
```
public void setHeading(float heading)
```
设置地图的朝向

参数:

heading - 方向角，正北为0，取值范围是[0, 360)

zoomLevel2MinElevation
```
public float zoomLevel2MinElevation(float zoomLevel)
```
计算给定缩放比例尺对应的最小仰角;返回值因地图数据是新格式或旧格式而异

参数:

zoomLevel - 当前缩放比例;该值必须位于 getZoomLevelOf(int)取值为 [MapRenderer.LevelCase.highest,MapRenderer.LevelCase.maxIndoor]的返回值之间

返回:

最小仰角

fitWorldArea
```
public void fitWorldArea(android.graphics.Rect area)
```
将地图的中心和比例尺设置为合适的大小以便能完整地显示区域的内容。

参数:

area - 需要显示的区域

fitWorldAreaToRectNds
```
public void fitWorldAreaToRectNds(android.graphics.Rect area,
                                  android.graphics.Rect fitToRect)
```
将指定的地图上的矩形区域显示到指定的屏幕矩形区域中

参数:

area - 地图上的矩形区域，为Nds坐标

fitToRect - 需要显示的屏幕上的矩形区域

Notice:

注意：地图矩形区域的坐标为NDS坐标

fitWorldAreaToRect
```
public void fitWorldAreaToRect(android.graphics.Rect area,
                               android.graphics.Rect fitToRect)
```
将制定的地图上的矩形区域显示到指定的屏幕矩形区域中

参数:

area - 地图上的矩形区域

fitToRect - 需要显示的屏幕上的矩形区域

setViewShift
```
public void setViewShift(float ratioBelowCenter)
```
设置地图中心点所在屏幕屏幕的相对位置Y方向的百分比，将中心移动至世界中心 - (ratioBelowCenter * 屏幕高度 / 2)像素的位置范围：[-1.0, 1.0]

参数:

ratioBelowCenter - 比率

getViewShift
```
public float getViewShift()
```
获取当前屏幕的相对位置偏移Y方向的百分比

返回:

相对偏移百分比

另请参阅:

setViewShift(float)

setViewShiftXY
```
public void setViewShiftXY(float ratioRightToCenter,
                           float ratioBelowCenter)
```
设置地图中心点所在屏幕的相对位置偏移量，相当于百分比将中心移动至世界中心 - (ratioRightToCenter * 屏幕高度 / 2)和世界中心 - (ratioBelowCenter * 屏幕高度 / 2)像素的位置范围：[-1.0, 1.0]
超出范围会设置无效，不做任何改变

参数:

ratioRightToCenter - 从屏幕横坐标一半的位置向右偏移的距离百分比，范围：[-1.0, 1.0]，0表示横轴中心，即，X方向中点，1表示右边缘，-1表示左边缘。

ratioBelowCenter - 从屏幕纵坐标一半的位置向下偏移的距离百分比，范围：[-1.0, 1.0]。0表示纵轴中心，即，Y方向中点，1表示下边缘，-1表示上边缘。

另请参阅:

setViewShift(float), getViewShiftXY()

getViewShiftXY
```
public Vector2DF getViewShiftXY()
```
获取地图中心点所在屏幕的相对位置偏移量，使用Vector2DF来表示，其中Vector2DF.getX()所获取的是X方向的偏移量百分比，Vector2DF.getY()所获取的位Y方向的偏移量百分比范围：[-1.0, 1.0]

返回:

以Vector2DF表示的屏幕相对位置偏移量百分比

另请参阅:

getViewShift(), setViewShiftXY(float, float)

getWorldRect
```
public android.graphics.Rect getWorldRect()
```
获取当前屏幕所覆盖的真实地理包络盒的大小

返回:

当前地图的区域范围

getWorldRectNds
```
public NdsRect getWorldRectNds()
```
获取当前屏幕所覆盖的真实地理包络盒的大小

返回:

当前地图的区域范围，用NDS坐标表示，right可能比left小

Notice:

注意：坐标类型为NDS坐标

getMapState
```
public MapState getMapState()
```
获取当前地图状态，包括摄像机状态，用于动态恢复地图状态

返回:

地图状态

另请参阅:

setMapState(MapState)

setMapState
```
public void setMapState(MapState state)
```
设置地图状态，用于恢复地图状态使用

参数:

state - 需要恢复的地图状态

另请参阅:

getMapState()

copyMapState
```
public void copyMapState(MapRenderer renderer)
```
同步地图状态

参数:

renderer - MapRenderer对象

beginAnimations

public void beginAnimations()

以动画效果来改变地图摄像机参数
配合commitAnimations(int, int)和cancelAnimations()实现动画效果

另请参阅:

MapRenderer.Animation, commitAnimations(int, int), cancelAnimations(), isInAnimation()

Notice:

注意：要使用动画，那么地图状态的修改只能在beginAnimations()和commitAnimations(int, int)之间

Example:

 // 开始动画
 MapRenderer render = mapView.getMapRenderer();
 // 注意：要使用动画，那么地图状态的修改只能在beginAnimations和commintAnimations之间
 render.beiginAnimations();
 // 获取当前地图状态
 MapState state = render.getMapState();
 // 将地图角度逆时针旋转100度
 state.heading += 100;
 // 设置仰角为60度
 state.elevation = 60;
 // 设置地图中心点偏移
 state.worldCenter.x += 1000;
 state.worldCenter.y -= 1000;
 render.setMapState(state);
 // 提交并开始动画，动画间隔时间为500ms，动画类型为线性变化
 render.commintAnimations(500, MapRenderer.Animation.linear);

commitAnimations
```
public void commitAnimations(int duration,
                             int type)
```
提交并开始动画

参数:

duration - 动画进行时间，单位：毫秒(ms)，最小值不能小于100

type - 动画类型MapRenderer.Animation

另请参阅:

MapRenderer.Animation, beginAnimations(), cancelAnimations(), isInAnimation()

Notice:

注意：开始动画之后，如果不使用cancelAnimations()函数取消动画直到动画结束后的所有对摄像机的操作均无效

cancelAnimations
```
public void cancelAnimations()
```
取消动画当动画进行中，想要打断动画，那么可以使用此函数

另请参阅:

MapRenderer.Animation, beginAnimations(), commitAnimations(int, int), isInAnimation()

isInAnimation
```
public boolean isInAnimation()
```
判断当前是否正在执行动画的过程中

返回:

true表示正在动画过程中，否则返回false

另请参阅:

MapRenderer.Animation, beginAnimations(), commitAnimations(int, int), cancelAnimations()

onTouchDown
```
public boolean onTouchDown(int touchCount,
                           int[] touchIds,
                           int[] touchXs,
                           int[] touchYs)
```
获取屏幕按下事件

参数:

touchCount - 屏幕当前按下点的个数

touchIds - 屏幕按下的点的ID

touchXs - 屏幕按下的X方向坐标

touchYs - 屏幕按下的Y方向的坐标

返回:

是否按下时点击了Annotation弹出的气泡

onTouchMove
```
public void onTouchMove(int touchCount,
                        int[] touchIds,
                        int[] touchXs,
                        int[] touchYs)
```
获取屏幕的拖动事件

参数:

touchCount - 拖动的点个数

touchIds - 拖动点的ID

touchXs - 拖动点的X方向坐标

touchYs - 拖动点的Y方向的坐标

onTouchUp
```
public void onTouchUp(int touchCount,
                      int[] touchIds,
                      int[] touchXs,
                      int[] touchYs)
```
获取屏幕上点击时的抬起事件

参数:

touchCount - 抬起时点的个数

touchIds - 抬起时点的ID

touchXs - 抬起时点X方向坐标

touchYs - 抬起时点Y方向的坐标

onTouchCancelled
```
public void onTouchCancelled(int touchCount,
                             int[] touchIds,
                             int[] touchXs,
                             int[] touchYs)
```
取消屏幕的按下，抬起，拖动等事件

参数:

touchCount - 取消事件时点的个数

touchIds - 取消事件时点的ID

touchXs - 取消事件是点的X方向坐标

touchYs - 取消事件是点的Y方向坐标

onTap

public void onTap(android.graphics.Point touchPoint)

屏幕点击的点

参数:: touchPoint -

resetTouch
```
public void resetTouch()
```
设置内部维护的触摸状态为none-touch-down，即无点击状态

onTouchClicked
```
public void onTouchClicked(android.graphics.Point pos)
```
发生单击，在单击事件里，会判断是否点击到POI、Overlay、Annotation等，若点击到，会触发*Selected、* DeSelected、*Clicked回调

参数:

pos - 点击的屏幕位置

onTouchDoubleClicked
```
public void onTouchDoubleClicked(android.graphics.Point pos)
```
双击，在点击点的位置放大地图，使zoomLevel减一

参数:

pos - 点击的屏幕位置

enableOptionalGesture
```
public void enableOptionalGesture(int gesture,
                                  boolean enable)
```
打开/关闭特定的手势

参数:

gesture - 手势类型，见MapRenderer.OptionalGesture

enable - 手势开关，true表示打开手势，false关闭手势

isOptionalGestureEnabled
```
public boolean isOptionalGestureEnabled(int gesture)
```
判断特定的手势是否有效

参数:

gesture - 手势类型，见MapRenderer.OptionalGesture

返回:

手势是否打开

screen2World
```
public android.graphics.Point screen2World(android.graphics.PointF position)
```
将屏幕坐标转换为对应的世界坐标

参数:

position - 屏幕坐标

返回:

世界坐标

world2screen
```
public android.graphics.PointF world2screen(android.graphics.Point position)
```
将世界坐标转换为对应的屏幕坐标。如果坐标点不在屏幕内，转换的结果可能有较大误差。

参数:

position - 世界坐标

返回:

屏幕坐标

world2screenNds
```
public android.graphics.PointF world2screenNds(NdsPoint position)
```
将世界坐标转换为对应的屏幕坐标。如果坐标点不在屏幕内，转换的结果可能有较大误差。

参数:

position - 世界坐标，Nds坐标点

返回:

屏幕坐标

Notice:

注意：世界坐标类型为NDS坐标

screen2WorldNds
```
public NdsPoint screen2WorldNds(android.graphics.PointF position)
```
将屏幕坐标转换为对应的世界坐标

参数:

position - 屏幕坐标

返回:

世界坐标，Nds坐标点

Notice:

注意：世界坐标类型为NDS坐标

isPointVisible
```
public boolean isPointVisible(android.graphics.Point point)
```
判断指定的点是否在地图的可见范围内

参数:

point - 欲判断的点

返回:

可见则返回true，否则返回false

isRectVisible
```
public boolean isRectVisible(android.graphics.Rect rect)
```
判断指定的矩形是否在地图的可见范围内
所谓可见，就是指定矩形与屏幕矩形有相交

参数:

rect - 欲判断的矩形

返回:

可见则返回true，否则返回false

isPointVisibleNds
```
public boolean isPointVisibleNds(NdsPoint point)
```
判断指定的点是否在地图的可见范围内

参数:

point - 欲判断的点

返回:

可见则返回true，否则返回false

Notice:

注意：坐标类型为NDS坐标

isRectVisibleNds
```
public boolean isRectVisibleNds(NdsRect rect)
```
判断指定的矩形是否在地图的可见范围内
所谓可见，就是指定矩形与屏幕矩形有相交

参数:

rect - 欲判断的矩形，Nds坐标

返回:

可见则返回true，否则返回false

Notice:

注意：坐标类型为NDS坐标

unitWorld2Screen
```
public float unitWorld2Screen(float worldUnit)
```
将世界坐标系下的经纬度表示的长度转换为屏幕坐标系下的长度
一般来说，此方法配合unitScreen2World(float)使用，来绘制用于显示的比例尺
在3D情况下，即，仰角小于90的情况下，计算结果仅在世界中心坐标附近时是准确的
两个尺寸的计算公式如下：
screenLength = worldLength / (scaleInMeter / METER_PER_LAT_UNIT / dpiFactor) * 50.0f

参数:

worldUnit - 世界坐标系单位下的长度

返回:

返回世界坐标系下的指定长度大小映射到屏幕后的长度大小

从以下版本开始:

4.9.x

另请参阅:

unitScreen2World(float)

unitScreen2World
```
public float unitScreen2World(float unit)
```
将屏幕坐标下的长度映射到世界坐标系下

参数:

unit - 屏幕坐标系下的长度

返回:

映射后的世界坐标系下的长度

从以下版本开始:

4.9.x

另请参阅:

unitWorld2Screen(float)

unitWorld2ScreenNds
```
public float unitWorld2ScreenNds(float worldUnit)
```
将世界坐标系下的NDS表示的长度转换为屏幕坐标系下的长度
一般来说，此方法配合unitScreen2WorldNds(float)使用
在3D情况下，即，仰角小于90的情况下，计算结果尽在世界中心坐标附近时是准确的
世界坐标系下经纬度表示的长度和NDS坐标表示的长度间可通过NaviCoreUtil.len2NdsLen(float)和 NaviCoreUtil.ndsLen2Len(float)转换

参数:

worldUnit - 世界坐标系单位下的长度

返回:

返回世界坐标系下的指定长度大小映射到屏幕后的长度大小

另请参阅:

unitScreen2WorldNds(float)

Notice:

注意：长度为NDS坐标下的长度

unitScreen2WorldNds
```
public float unitScreen2WorldNds(float unit)
```
将屏幕坐标下的长度映射到NDS坐标表示世界坐标系下
世界坐标系下经纬度表示的长度和NDS坐标表示的长度间可通过NaviCoreUtil.len2NdsLen(float)和 NaviCoreUtil.ndsLen2Len(float)转换

参数:

unit - 屏幕坐标系下的长度

返回:

映射后的世界坐标系下的长度

另请参阅:

unitWorld2ScreenNds(float)

Notice:

注意：返回的长度为NDS坐标下的长度

meter2Pixel
```
public int meter2Pixel(int lenInMeter)
```
计算实际距离映射到屏幕中的大小

参数:

lenInMeter - 实际的距离，单位：米

返回:

映射到屏幕的尺寸大小，此结果跟屏幕比例尺和DPI设置有关

getTraditionalMapScale
```
public float getTraditionalMapScale()
```
获取当前地图实际比例尺，单位：米。

返回:

实际比例尺

getTraditionalMapScaleOf
```
public float getTraditionalMapScaleOf(float zoomLevel)
```
获取特定zoomLevel对应的地图实际比例尺，单位：米。

返回:

比例尺

addAnnotation
```
public void addAnnotation(Annotation annotation)
```
添加Annotation到MapRenderer对象

参数:

annotation -

removeAnnotation
```
public void removeAnnotation(Annotation annotation)
```
移除MapRenderer对象中的Annotation

参数:

annotation -

removeAllAnnotations
```
public void removeAllAnnotations()
```
移除所有添加到MapRenderer中的Annotation

detachAnnotation
```
public void detachAnnotation(Annotation annotation)
```
从MapRenderer中返回Annotation，与removeAnnotation(Annotation)类似，不同的是，不会释放Annotation资源，可再次添加到MapRenderer

moveAnnotations
```
public void moveAnnotations(MapRenderer renderer)
```
将其他MapRenderer中所有Annotation移动到当前MapRenderer

参数:

renderer - MapRenderer对象

moveOverlays
```
public void moveOverlays(MapRenderer renderer)
```
将其他MapRenderer中所有Overlay移动到当前MapRenderer

参数:

renderer - MapRenderer对象

selectAnnotation
```
public void selectAnnotation(Annotation annotation)
```
设置选中地图中指定的Annotation

参数:

annotation - 待选中的Annotation

hitTestAnnotations
```
public Annotation[] hitTestAnnotations(android.graphics.Point clickPoint)
```
给定一个点，返回此位置可点击到的所有Annotation。
一般在 MapRenderer.Listener.onAnnotationClicked(Annotation, int)里使用，获取所有可点击到的 Annotation

参数:

clickPoint - 点击位置，屏幕坐标

返回:

可点击到的所有Annotation

addOverlay
```
public void addOverlay(Overlay overlay)
```
添加Overlay到MapRenderer对象

参数:

overlay - 待添加的Overlay

Notice:

注意：调用addOverlay之后，会将Native的资源托管给MapRenderer
此时如果要删除相应的Overlay对象，那么应该调用 removeOverlay(Overlay)来清理删除对象
删除后的对象将不再可用，客户端需手动将对应的Java对象置空。

insertOverlayAtIndex
```
public void insertOverlayAtIndex(Overlay overlay,
                                 int index)
```
在指定层次插入Overlay，不同层次会出现压盖关系

参数:

overlay - 待插入的Overlay

index - 插入位置

另请参阅:

addOverlay(Overlay)

removeOverlay
```
public void removeOverlay(Overlay overlay)
```
移除MapRenderer中的Overlay对象，释放Overlay对应的Native资源

参数:

overlay - 需要移除的Overlay

Notice:

注意：此方法将释放Overlay对应的Native资源，此时Overlay已经失效，不可用，任何对其操作都将引起崩溃。 。

removeAllOverlays
```
public void removeAllOverlays()
```
删除所有添加到MapRenderer中的Overlay

detachOverlay
```
public void detachOverlay(Overlay overlay)
```
从MapRenderer中返回Overlay，与removeOverlay(Overlay)类似，不同的时，不会释放Overlay资源，可再次添加到MapRenderer

bringOverlayToTop
```
public void bringOverlayToTop(Overlay overlay)
```
将指定的Overlay提到所有Overlay最顶端

参数:

overlay - 待操作Overlay

sendOverlayToBack
```
public void sendOverlayToBack(Overlay overlay)
```
将指定的Overlay放入所有Overlay最下方

参数:

overlay - 需要设置的Overlay

exchangeOverlayIndices

public void exchangeOverlayIndices(Overlay overlayL,
                                   Overlay overlayR)

交换两个Overlay的层次顺序

参数:: overlayL - 待操作Overlay; overlayR - 待操作Overlay

reload
```
public void reload()
```
重新载入绘图数据可以在下载完新数据的时候使用此函数来刷新本地数据避免了下载新数据必须要重启系统的麻烦

clearCache
```
public void clearCache()
```
建议当系统内存资源紧缺时使用此函数清理释放内存

compactCache
```
public void compactCache()
```
建议在程序切到后台或者接收到操作系统内存紧缺的信号时使用此函数精简内存使用

enableBasicMap
```
public void enableBasicMap(boolean enable)
```
开启/关闭地图底图

参数:

enable - true表示开启，false表示关闭

另请参阅:

enableMapLayer(int, boolean)

isBasicMapEnabled
```
public boolean isBasicMapEnabled()
```
判断当前是否开启了地图底图

返回:

true为已开启，false为未开启

另请参阅:

isMapLayerEnabled(int)

enableTmc
```
public void enableTmc(boolean enable)
```
TMC开关函数，必须运行于主线程

参数:

enable - 如果为true表示打开TMC，否则为关闭TMC

另请参阅:

enableMapLayer(int, boolean)

isTmcEnabled
```
public boolean isTmcEnabled()
```
TMC是否开启

返回:

true则TMC已经开启，否则返回false

另请参阅:

isMapLayerEnabled(int)

setLanguage
```
public void setLanguage(int lang)
```
设置地图文字显示语言，需要相关数据支持. 默认：中文

参数:

lang - 语言编码NaviCore.LanguageType

getLanguage
```
public int getLanguage()
```
获取地图文字显示语言

返回:

语言编码NaviCore.LanguageType

addListener
```
public void addListener(MapRenderer.Listener listener)
```
添加绘制事件监听

参数:

listener - MapRenderer.Listener

removeListener
```
public void removeListener(MapRenderer.Listener listener)
```
删除绘制事件监听

参数:

listener - MapRenderer.Listener

setConfigInt
```
public void setConfigInt(int configType,
                         int value)
```
设置配置选项，包括：
MapRenderer.RenderConfig.annotationDropFrameNum
MapRenderer.RenderConfig.annotationDropInterval
MapRenderer.RenderConfig.forceRefreshPoiTime

参数:

configType - 配置类型MapRenderer.RenderConfig

value - 值

setConfigInt
```
public void setConfigInt(int configType,
                         int value1,
                         int value2)
```
设置配置选项，包括：
MapRenderer.RenderConfig.maxCustomIconSize
MapRenderer.RenderConfig.textTextureSize

参数:

configType - 配置类型MapRenderer.RenderConfig

value1 - 值1

value2 - 值2

setConfigBoolean
```
public void setConfigBoolean(int configType,
                             boolean value)
```
设置配置选项，包括：
MapRenderer.RenderConfig.orderAnnotDynamically
MapRenderer.RenderConfig.keepCurPoiInRefreshingDraw
MapRenderer.RenderConfig.enableAnnotationDrop

参数:

configType - 配置类型MapRenderer.RenderConfig

value - boolean值

getTmcRefreshInterval
```
public int getTmcRefreshInterval()
```
获取当前实时交通(TMC)数据刷新时间

返回:

实时交通(TMC)数据刷新时间

另请参阅:

setTmcRefreshInterval(int)

setTmcRefreshInterval
```
public void setTmcRefreshInterval(int interval)
```
设置当前实时交通(TMC)数据刷新时间, 单位: ms
也就是如果要设置为10秒钟刷新，那么应该是10 * 1000
同理两分钟刷新就是2 * 60 * 1000
必须运行于主线程

参数:

interval - 实时交通(TMC)数据刷新时间

另请参阅:

getTmcRefreshInterval()

enableBuilding
```
public void enableBuilding(boolean enable)
```
是否显示建筑物默认是：true

参数:

enable - true为显示，否则不显示

isBuildingEnabled
```
public boolean isBuildingEnabled()
```
判断当前是否为现实建筑的状态

返回:

true为显示，否则为不显示

getRenderQuality
```
public int getRenderQuality()
```
获取当前渲染地图的质量

返回:

渲染质量 MapRenderer.RenderQuality

另请参阅:

MapRenderer.RenderQuality

setRenderQuality
```
public void setRenderQuality(int quality)
```
设置当前地图渲染的质量

参数:

quality - 渲染质量 RenderQuality.*

另请参阅:

MapRenderer.RenderQuality

setHighestBuildingZoom
```
public void setHighestBuildingZoom(float highestZoomLevel)
```
设置绘制建筑物的最大缩放级别，即当缩放级别不超过设置的值时才绘制建筑物，默认值：3.0f

参数:

highestZoomLevel - 缩放级别

getHighestBuildingZoom
```
public float getHighestBuildingZoom()
```
获取绘制建筑物的最大缩放级别

返回:

缩放级别

另请参阅:

setHighestBuildingZoom(float)

getFpsCounter
```
public MapRenderer.FpsCounter getFpsCounter()
```
获取统计的帧率

返回:

统计的帧率MapRenderer.FpsCounter

setSkyFactor
```
public void setSkyFactor(float sizeRatioToCenter)
```
设置天空盒比例

参数:

sizeRatioToCenter - 天空盒在地图底层图层所占比例，即天空盒高度/地图顶部到地图中心，默认0.25,范围(0,1)

getSkyFactor
```
public float getSkyFactor()
```
获取天空盒比例

返回:

天空盒在地图底层图层所占比例

getSkyBottomPosition
```
public int getSkyBottomPosition()
```
获取天空盒底部位置，单位：像素

返回:

position 天空盒底部像素位置，由setSkyFactor(float)决定

enableBackground
```
public void enableBackground(boolean enable)
```
设置地图渲染时是否清屏，默认：清屏

参数:

enable - true为清屏，false为不清屏

isBackgroundEnabled
```
public boolean isBackgroundEnabled()
```
判断当前是否为开启清屏的模式

返回:

true时为清屏模式，false为不清屏模式

monitorDataReadiness
```
public void monitorDataReadiness()
```
监测数据准备状态。当前比例尺下某一层数据准备好时，会触发 MapRenderer.Listener.onLayerTilesReadyForDraw(int[])回调，所有层数据都准备好时，监测结束。

commitDrawTransaction
```
public void commitDrawTransaction(MapRenderer.DrawTransaction transaction,
                                  java.lang.Object userData)
```
提交绘图事务
详细说明参看MapRenderer.DrawTransaction

参数:

transaction - MapRenderer.DrawTransaction实例对象

userData - 用户自定义数据，用于 MapRenderer.DrawTransaction.doTransaction(MapRenderer, Object) 回调接口中使用

从以下版本开始:

4.10.x

commitDrawTransaction
```
public void commitDrawTransaction(MapRenderer.DrawTransaction transaction)
```
与commitDrawTransaction(DrawTransaction, Object) 功能相同，只是在回调 MapRenderer.DrawTransaction.doTransaction(MapRenderer, Object) 时，第二个参数为空。

参数:

transaction - MapRenderer.DrawTransaction实例对象

registerCustomIcon
```
public static int registerCustomIcon(android.graphics.Bitmap icon)
```
为图标分配唯一的ID，图标ID可用于Annotation和PointsOverlay 中。通过此方法最多可分配800个ID，范围为[200,1000)

参数:

icon - 图标，必须是Bitmap.Config.ARGB_8888格式的

返回:

分配的唯一ID，图标格式错误或没有ID可用时返回0

另请参阅:

registerCustomIcon(String)

registerCustomIcon
```
public static int registerCustomIcon(java.lang.String iconPath)
```
为图标分配唯一的ID，图标ID可用于Annotation和PointsOverlay 中。通过此方法最多可分配800个ID，范围为[200,1000)

参数:

iconPath - 图标路径

返回:

分配的唯一ID，文件不存在或没有ID可用时返回0

另请参阅:

registerCustomIcon(Bitmap)

unregisterCustomIcon
```
public static void unregisterCustomIcon(int iconId)
```
释放图标ID及其对应的资源。应确保客户端不再使用此图标时再释放，释放后的图标ID将不再可用。

参数:

iconId - 图标ID

另请参阅:

registerCustomIcon(Bitmap), registerCustomIcon(String)

setClipRect
```
public void setClipRect(android.graphics.Rect clipRect)
```
设置裁剪区域（相对于屏幕），只在设置的区域内绘制地图

参数:

clipRect - 裁剪区域（相对于屏幕）

glReadPixels
```
public static void glReadPixels(int x,
                                int y,
                                int width,
                                int height,
                                int format,
                                int type)
```
一般用于将显存的内容读到PBO，由于GLES30.glReadPixels只有在API level 24后才支持，在低版本的手机上，需要调用封装的接口读

参数:

x - 读像素起始位置的横坐标，左下为(0, 0)

y - 读像素起始位置的纵坐标，左下为(0, 0)

width - 读取区域的像素宽

height - 读取区域的像素高

format - 像素格式

type - 像素数据的类型

reloadIfNeeded
```
public void reloadIfNeeded()
```
重新加载地图
在新离线数据安装后，用于主动刷新地图。如果新离线数据安装，调用此方法不会重新加载地图

类 MapRenderer

嵌套类概要

构造器概要

方法概要

从类继承的方法 java.lang.Object

构造器详细资料

MapRenderer

方法详细资料

enableMaskDraw

setMaskDrawer

clearAll

enableMapLayer

isMapLayerEnabled

enableSatelliteLayer

isSatelliteLayerEnabled

setSatelliteImageType

draw

setRenderTarget

switchToBackground

switchToForeground

enableCameraEvents

loadStyleSheet

setStyleClass

getStyleClass

setViewport

setViewport

getViewport

pan

panTo

setDpiFactor

getDpiFactor

setWorldCenter

getWorldCenter

setWorldCenterNds

getWorldCenterNds

setBoundArea

getBoundArea

setScale

getScale

getZoomLevel

setZoomLevel

zoomIn

zoomOut

getZoomLevelOf

zoomLevel2Scale

scale2ZoomLevel

setZoomLevelRange

getZoomLevelRange

setZoomLevelAtPoint

getElevation

setElevation

getHeading

setHeading

zoomLevel2MinElevation

fitWorldArea

fitWorldAreaToRectNds

fitWorldAreaToRect

setViewShift

getViewShift

setViewShiftXY

getViewShiftXY

getWorldRect

getWorldRectNds

getMapState

setMapState

copyMapState

beginAnimations

commitAnimations

cancelAnimations

isInAnimation

onTouchDown

onTouchMove

onTouchUp

onTouchCancelled

onTap

resetTouch

onTouchClicked

onTouchDoubleClicked

enableOptionalGesture

isOptionalGestureEnabled