MapRenderer.Listener (JNaviCore SDK Documentation)

所有已知实现类:

BMMapView, MapView, NaviMapView, OffscreenSurface

封闭类:

MapRenderer
```
public static interface MapRenderer.Listener
```
监听地图状态修改的接口

Notice:

注意：除了 onTileLoadingFinished()及 onLayerTilesLoaded(int[])() 在绘图线程中回调， onCameraChanged(int) 可在主线程或绘图线程(某一时刻只能在一个线程)中回调外，其他回调均运行在在主线程中，可以用于更新UI

方法概要

所有方法实例方法抽象方法
限定符和类型	方法和说明
`void`	`onAnnotationClicked(Annotation annot, int area)` 点击`Annotation`时触发的回调此回调实际上运行于`MapRenderer.onTouchUp(int, int[], int[], int[])`方法中，在点击`Annotation`或其弹出气泡时被调用
`void`	`onAnnotationDeselected(Annotation annot)` 当`Annotation`未被选中时触发的回调此回调实际上运行于`MapRenderer.onTouchUp(int, int[], int[], int[])`方法中
`void`	`onAnnotationSelected(Annotation annot)` 当`Annotation`被选中时触发的回调此回调实际上运行于`MapRenderer.onTouchUp(int, int[], int[], int[])`方法中，当`Annotation`的图标被点击，但它的弹出气泡没有想显示的情况下出发此回调。
`void`	`onCameraAnimationEnded()` 摄像机变换动画结束后的回调函数
`void`	`onCameraChanged(int changeType)` 相机状态发生改变时触发的回调
`void`	`onFocusChanged(int prevFocusedType, int curFocusedType)` 新的`Annotation`,`Overlay`和POI被选中成为焦点时被触发
`void`	`onGestureAnimationEvent(boolean animStarted)` 手势动画开始和结束时的回调
`void`	`onLayerTilesLoaded(int[] layerTypes)` 在新的镜头视角下，至少一块地图分块数据加载完毕时触发，如，基础地图数据和TMC底图数据此方法是在`MapRenderer.draw()`中调用的，所以是在绘图线程中被调用
`void`	`onLayerTilesReadyForDraw(int[] layerTypes)` 监测状态中`MapRenderer.monitorDataReadiness()` ，当前比例尺下所有格子的某一图层数据准备好时触发，所有图层数据准备好时结束。
`void`	`onNeedsDisplay()` 刷新回调，每次刷新时都会回调此函数无特殊情况，不应在此函数中添加处理逻辑，会影响刷新速度
`void`	`onOnlineDataVersionChecked(boolean upgraded)` 在线地图数据版本升级检测回调
`void`	`onOverlayClicked(Overlay overlay, int area)` 点击`Overlay`时触发的回调此回调实际上运行于`MapRenderer.onTouchUp(int, int[], int[], int[])`方法中，在点击`Overlay`或其弹出气泡时被调用
`void`	`onOverlayDeselected(Overlay overlay)` 当`Overlay`由被选中状态到反选时触发此回调实际上运行于`MapRenderer.onTouchUp(int, int[], int[], int[])`方法中
`void`	`onOverlaySelected(Overlay overlay, android.graphics.Point grabbedPoint)` 当`Overlay`被选中是触发的回调此回调实际上运行于`MapRenderer.onTouchUp(int, int[], int[], int[])`方法中
`void`	`onOverlaySelectedNds(Overlay overlay, NdsPoint grabbedPoint)` 当`Overlay`被选中是触发的回调此回调实际上运行于`MapRenderer.onTouchUp(int, int[], int[], int[])`方法中
`void`	`onPoiClicked(java.lang.String name, android.graphics.Point pos)` 点击POI时触发的回调此回调实际上运行于`MapRenderer.onTouchUp(int, int[], int[], int[])`方法中
`void`	`onPoiDeselected(java.lang.String name, android.graphics.Point pos)` 反选POI时触发的回调此回调实际上运行于`MapRenderer.onTouchUp(int, int[], int[], int[])`方法中
`void`	`onPoiDeselectedNds(java.lang.String name, NdsPoint pos)` 反选POI时触发的回调此回调实际上运行于`MapRenderer.onTouchUp(int, int[], int[], int[])`方法中
`void`	`onPoiSelected(java.lang.String name, android.graphics.Point pos)` 选中POI时触发的回调此回调实际上运行于`MapRenderer.onTouchUp(int, int[], int[], int[])`方法中
`void`	`onPoiSelectedNds(java.lang.String name, NdsPoint pos)` 选中POI时触发的回调此回调实际上运行于`MapRenderer.onTouchUp(int, int[], int[], int[])`方法中
`void`	`onTileLoadingFinished()` 地图分块数据加载完毕时触发，如，基础地图数据和TMC底图数据此方法是在`MapRenderer.draw()`中调用的，所以是在绘图线程中被调用
`void`	`onUserRasterDataUpdated(int fromSource)` 用户栅格数据更新，调用`MapRenderer#setDataPreference(int)`和`MapRenderer#setDataUrlPrefix(int, String)` 时触发，说明读取栅格数据时的数据来源

- 方法详细资料
  - onNeedsDisplay
```
void onNeedsDisplay()
```
    刷新回调，每次刷新时都会回调此函数
    无特殊情况，不应在此函数中添加处理逻辑，会影响刷新速度
  - onAnnotationClicked
```
void onAnnotationClicked(Annotation annot,
                         int area)
```
    点击Annotation时触发的回调
    此回调实际上运行于MapRenderer.onTouchUp(int, int[], int[], int[])方法中，在点击Annotation或其弹出气泡时被调用
    
    参数:
    
    annot - 被点击的Annotation
    
    area - 被点击的区域Annotation.Area，如果area为Annotation.Area.icon，表示点击的是Annotation的图标本身
    
    另请参阅:
    
    Annotation, Annotation.Area
  - onAnnotationSelected
```
void onAnnotationSelected(Annotation annot)
```
    当Annotation被选中时触发的回调
    此回调实际上运行于MapRenderer.onTouchUp(int, int[], int[], int[])方法中，当Annotation的图标被点击，但它的弹出气泡没有想显示的情况下出发此回调。
    
    参数:
    
    annot - 当前被选中的Annotation
    
    另请参阅:
    
    Annotation
  - onAnnotationDeselected
```
void onAnnotationDeselected(Annotation annot)
```
    当Annotation未被选中时触发的回调此回调实际上运行于MapRenderer.onTouchUp(int, int[], int[], int[])方法中
    
    参数:
    
    annot - 当前取消选中状态的Annotation
    
    另请参阅:
    
    Annotation
  - onFocusChanged
```
void onFocusChanged(int prevFocusedType,
                    int curFocusedType)
```
    新的Annotation,Overlay和POI被选中成为焦点时被触发
    
    参数:
    
    prevFocusedType - 前一个焦点的类型 MapRenderer.FocusedObjType
    
    curFocusedType - 当前焦点类型MapRenderer.FocusedObjType,前后焦点所在的poi, annotation和overlay可以通过onxxSelected和onxxDeselected获取
  - onOverlayClicked
```
void onOverlayClicked(Overlay overlay,
                      int area)
```
    点击Overlay时触发的回调
    此回调实际上运行于MapRenderer.onTouchUp(int, int[], int[], int[])方法中，在点击Overlay或其弹出气泡时被调用
    
    参数:
    
    overlay - 被点击的Overlay
    
    area - 被点击的区域Annotation.Area，如果回调的area为Annotation.Area.icon，表示点击的是Overlay本身
    
    另请参阅:
    
    Overlay, Annotation.Area
  - onOverlaySelected
```
void onOverlaySelected(Overlay overlay,
                       android.graphics.Point grabbedPoint)
```
    当Overlay被选中是触发的回调
    此回调实际上运行于MapRenderer.onTouchUp(int, int[], int[], int[])方法中
    
    参数:
    
    overlay - 被点击的Overlay
    
    grabbedPoint - 距离点击点最近的有效点坐标，通常情况下，这个点就是点击点本身，但是对于PolylineOverlay或者RouteOverlay可能不是点击点
  - onOverlaySelectedNds
```
void onOverlaySelectedNds(Overlay overlay,
                          NdsPoint grabbedPoint)
```
    当Overlay被选中是触发的回调
    此回调实际上运行于MapRenderer.onTouchUp(int, int[], int[], int[])方法中
    
    参数:
    
    overlay - 被点击的Overlay
    
    grabbedPoint - 距离点击点最近的有效Nds坐标，通常情况下，这个点就是点击点本身，但是对于PolylineOverlay或者RouteOverlay可能不是点击点
    
    Notice:
    
    坐标类型为NDS坐标
  - onOverlayDeselected
```
void onOverlayDeselected(Overlay overlay)
```
    当Overlay由被选中状态到反选时触发
    此回调实际上运行于MapRenderer.onTouchUp(int, int[], int[], int[])方法中
    
    参数:
    
    overlay - 触发事件的Overlay
  - onPoiSelected
```
void onPoiSelected(java.lang.String name,
                   android.graphics.Point pos)
```
    选中POI时触发的回调
    此回调实际上运行于MapRenderer.onTouchUp(int, int[], int[], int[])方法中
    
    参数:
    
    name - POI名称
    
    pos - POI所在位置经纬度坐标
  - onPoiDeselected
```
void onPoiDeselected(java.lang.String name,
                     android.graphics.Point pos)
```
    反选POI时触发的回调
    此回调实际上运行于MapRenderer.onTouchUp(int, int[], int[], int[])方法中
    
    参数:
    
    name - POI名称
    
    pos - POI所在位置经纬度坐标值
  - onPoiSelectedNds
```
void onPoiSelectedNds(java.lang.String name,
                      NdsPoint pos)
```
    选中POI时触发的回调
    此回调实际上运行于MapRenderer.onTouchUp(int, int[], int[], int[])方法中
    
    参数:
    
    name - POI名称
    
    pos - POI所在的NDS坐标
    
    Notice:
    
    坐标类型为NDS坐标
  - onPoiDeselectedNds
```
void onPoiDeselectedNds(java.lang.String name,
                        NdsPoint pos)
```
    反选POI时触发的回调
    此回调实际上运行于MapRenderer.onTouchUp(int, int[], int[], int[])方法中
    
    参数:
    
    name - POI名称
    
    pos - POI所在位置的NDS坐标值
  - onPoiClicked
```
void onPoiClicked(java.lang.String name,
                  android.graphics.Point pos)
```
    点击POI时触发的回调
    此回调实际上运行于MapRenderer.onTouchUp(int, int[], int[], int[])方法中
    
    参数:
    
    name - POI名称
    
    pos - POI所在位置的坐标
  - onCameraChanged
```
void onCameraChanged(int changeType)
```
    相机状态发生改变时触发的回调
    
    参数:
    
    changeType - 相机参数改变类型MapRenderer.CameraSetting
    
    另请参阅:
    
    MapRenderer.CameraSetting
    
    Notice:
    
    注意：相机参数每次可能修改多个，需要以掩码的形式判断都修改了哪些参数。
    例如：(changeType & MapRenderer.CameraSetting.scale) == MapRenderer.CameraSetting.scale表示修改了地图尺寸参数。
    回调可能运行在主线程，也可能运行在绘图线程。
  - onGestureAnimationEvent
```
void onGestureAnimationEvent(boolean animStarted)
```
    手势动画开始和结束时的回调
    
    参数:
    
    animStarted - 动画开始时为true，结束时为false
  - onCameraAnimationEnded
```
void onCameraAnimationEnded()
```
    摄像机变换动画结束后的回调函数
  - onTileLoadingFinished
```
void onTileLoadingFinished()
```
    地图分块数据加载完毕时触发，如，基础地图数据和TMC底图数据
    此方法是在MapRenderer.draw()中调用的，所以是在绘图线程中被调用
    
    Notice:
    
    注意：此方法是运行于绘图线程中的，所以不能用来更新UI
  - onLayerTilesLoaded
```
void onLayerTilesLoaded(int[] layerTypes)
```
    在新的镜头视角下，至少一块地图分块数据加载完毕时触发，如，基础地图数据和TMC底图数据
    此方法是在MapRenderer.draw()中调用的，所以是在绘图线程中被调用
    
    参数:
    
    layerTypes - 已经加载完成的图层瓦片对象 count，加载完成的图层瓦片数量
    
    Notice:
    
    注意：此方法是运行于绘图线程中的，所以不能用来更新UI
  - onLayerTilesReadyForDraw
```
void onLayerTilesReadyForDraw(int[] layerTypes)
```
    监测状态中MapRenderer.monitorDataReadiness() ，当前比例尺下所有格子的某一图层数据准备好时触发，所有图层数据准备好时结束。
    
    参数:
    
    layerTypes - 数据准备好的图层LayerType
  - onOnlineDataVersionChecked
```
void onOnlineDataVersionChecked(boolean upgraded)
```
    在线地图数据版本升级检测回调
    
    参数:
    
    upgraded - 是否升级，如果升级则返回true，否则返回false
  - onUserRasterDataUpdated
```
void onUserRasterDataUpdated(int fromSource)
```
    用户栅格数据更新，调用MapRenderer#setDataPreference(int)和MapRenderer#setDataUrlPrefix(int, String) 时触发，说明读取栅格数据时的数据来源
    
    参数:
    
    fromSource - 数据来源DataPreference

接口 MapRenderer.Listener

方法概要

方法详细资料

onNeedsDisplay

onAnnotationClicked

onAnnotationSelected

onAnnotationDeselected

onFocusChanged

onOverlayClicked

onOverlaySelected

onOverlaySelectedNds

onOverlayDeselected

onPoiSelected

onPoiDeselected

onPoiSelectedNds

onPoiDeselectedNds

onPoiClicked

onCameraChanged

onGestureAnimationEvent

onCameraAnimationEnded

onTileLoadingFinished

onLayerTilesLoaded

onLayerTilesReadyForDraw

onOnlineDataVersionChecked

onUserRasterDataUpdated