BaseMapView

java.lang.Object
- com.geoway.mobile.ui.BaseMapView

```
public class BaseMapView
extends java.lang.Object
```
A platform independent main view class for all mapping operations.
Allows the user to manipulate the map and access various related components.

字段概要

字段
限定符和类型字段和说明

protected boolean swigCMemOwn

字段
限定符和类型	字段和说明
`protected boolean`	`swigCMemOwn`

构造器概要

构造器
构造器和说明

BaseMapView()

BaseMapView(long cPtr, boolean cMemoryOwn)

构造器
构造器和说明
`BaseMapView()`
`BaseMapView(long cPtr, boolean cMemoryOwn)`

方法概要

所有方法静态方法实例方法具体方法
限定符和类型	方法和说明
`void`	`cancelAllTasks()` Cancels all qued tasks such as tile and vector data fetches.
`void`	`clearAllCaches()` Releases memory occupied by all caches.
`void`	`clearPreloadingCaches()` Releases the memory occupied by the preloading area.
`void`	`delete()`
`void`	`enableDoubleClick(boolean canDoubleClick)`
`protected void`	`finalize()`
`MapPos`	`getCameraPos()`
`MapPos`	`getCameraPosMini()`
`static long`	`getCPtr(BaseMapView obj)`
`MapPos`	`getFocusPos()` Returns the position that the camera is currently looking at.
`MapPos`	`getFocusPosMini()`
`Layers`	`getLayers()` Returns the Layers object, that can be used for adding and removing map layers.
`MapEventListener`	`getMapEventListener()` Returns the map event listener.
`MapRenderer`	`getMapRenderer()` Returns the MapRenderer object, that can be used for controlling rendering options.
`Options`	`getOptions()` Returns the Options object, that can be used for modifying various map options.
`Options`	`getOptionsMini()`
`RedrawRequestListener`	`getRedrawRequestListener()` Returns the redraw request listener.
`float`	`getRotation()` Returns the map rotation in degrees. 0 means looking north, 90 means west, -90 means east and 180 means south.
`static java.lang.String`	`getSDKVersion()` Returns the SDK version and build info.
`float`	`getTilt()` Returns the tilt angle in degrees. 0 means looking directly at the horizon, 90 means looking directly down.
`float`	`getZoom()` Returns the zoom level.
`ScreenPos`	`mapToScreen(MapPos mapPos)` Calculates the screen position corresponding to a map position, using the current view parameters.
`ScreenPos`	`mapToScreenMini(MapPos mapPos, int screenWidth, int screenHeight, Options options)`
`void`	`moveToFitBounds(MapBounds mapBounds, ScreenBounds screenBounds, boolean integerZoom, boolean resetRotation, boolean resetTilt, float durationSeconds)` Animate the view parameters (focus position, tilt, rotation, zoom) so that the specified bounding box becomes fully visible.
`void`	`moveToFitBounds(MapBounds mapBounds, ScreenBounds screenBounds, boolean integerZoom, float durationSeconds)` Animate the view parameters (focus position, tilt, rotation, zoom) so that the specified bounding box becomes fully visible.
`void`	`onDrawFrame()` Draws a single frame to the current graphics context.
`void`	`onInputEvent(int event, float x1, float y1, float x2, float y2)` Handles a user input event.
`void`	`onSurfaceChanged(int width, int height)` Changes the screen size of the map view.
`void`	`onSurfaceCreated()` Prepares renderers for drawing.
`void`	`onSurfaceDestroyed()` Stops renderer.
`void`	`pan(MapVec deltaPos, float durationSeconds)` Pans the view relative to the current focus position.
`void`	`pickMapPos(ScreenPos screenPos, MapPickListener listener, boolean waitWhileUpdating)`
`static boolean`	`registerLicense(java.lang.String licenseKey, LicenseManagerListener listener)` Registers the SDK license.
`void`	`requestComponentsDraw()`
`void`	`rotate(float deltaAngle, float durationSeconds)` Rotates the view relative to the current rotation value.
`void`	`rotate(float deltaAngle, MapPos targetPos, float durationSeconds)` Rotates the view relative to the current rotation value.
`MapPos`	`screenToMap(ScreenPos screenPos)` Calculates the map position corresponding to a screen position, using the current view parameters.
`MapPos`	`screenToMapMini(ScreenPos screenPos, Options options)`
`void`	`setCameraPos(MapPos pos, float height, float rotate, float tilt, float durationSeconds)`
`void`	`setCameraPosMini(MapPos pos, float height, float rotate, float tilt)`
`void`	`setFocusPos(MapPos pos, float durationSeconds)` Sets the new absolute focus position.
`void`	`setKineticRatio(double ratio)`
`void`	`setMapEventListener(MapEventListener mapEventListener)` Sets the map event listener.
`void`	`setMapMoveListener(MapMoveListener mapMoveListener)` yk 2022/5/18 设置地图移动监听以及移动结束监听
`void`	`setMapZoomEventListener(MapZoomEventListener mapZoomEventListener)` yk 2022/5/17 单独拆分监听事件
`void`	`setRedrawRequestListener(RedrawRequestListener listener)` Sets the listener which will notified when the map needs to be redrawn
`void`	`setRotation(float angle, float durationSeconds)` Sets the new absolute rotation value. 0 means look north, 90 means west, -90 means east and 180 means south.
`void`	`setRotation(float angle, MapPos targetPos, float durationSeconds)` Sets the new absolute rotation value. 0 means look north, 90 means west, -90 means east and 180 means south.
`void`	`setTilt(float tilt, float durationSeconds)` Sets the new absolute tilt value. 0 means look directly at the horizon, 90 means look directly down.
`void`	`setZoom(float zoom, float durationSeconds)` Sets the new absolute zoom value.
`void`	`setZoom(float zoom, MapPos targetPos, float durationSeconds)` Sets the new absolute zoom value.
`void`	`tilt(float deltaTilt, float durationSeconds)` Tilts the view relative to the current tilt value.
`void`	`zoom(float deltaZoom, float durationSeconds)` Zooms the view relative to the current zoom value.
`void`	`zoom(float deltaZoom, MapPos targetPos, float durationSeconds)` Zooms the view relative to the current zoom value.

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

- 字段详细资料
  - swigCMemOwn
```
protected boolean swigCMemOwn
```
- 构造器详细资料
  - BaseMapView
```
public BaseMapView(long cPtr,
                   boolean cMemoryOwn)
```
  - BaseMapView
```
public BaseMapView()
```
- 方法详细资料
  - getCPtr
```
public static long getCPtr(BaseMapView obj)
```
  - finalize
```
protected void finalize()
```
    覆盖:
    
    finalize 在类中 java.lang.Object
  - delete
```
public void delete()
```
  - registerLicense
```
public static boolean registerLicense(java.lang.String licenseKey,
                                      LicenseManagerListener listener)
```
    Registers the SDK license. This class method and must be called before
    creating any actual MapView instances.
    
    参数:
    
    licenseKey - The license string provided for this application.
    
    listener - The listener that receives notifications when the license has been updated.
    
    返回:
    
    True if license is valid, false if not.
  - getSDKVersion
```
public static java.lang.String getSDKVersion()
```
    Returns the SDK version and build info. The result should be used only for reporting purposes.
    
    返回:
    
    The SDK version and build info.
  - onSurfaceCreated
```
public void onSurfaceCreated()
```
    Prepares renderers for drawing. Has to be called again if the graphics context was lost.
  - onSurfaceChanged
```
public void onSurfaceChanged(int width,
                             int height)
```
    Changes the screen size of the map view. Calling this method before
    onSurfaceCreated is called results in undefined behaviour.
    
    参数:
    
    width - The new width of the map view.
    
    height - The new height of the map view.
  - onDrawFrame
```
public void onDrawFrame()
```
    Draws a single frame to the current graphics context. Calling this method before
    onSurfaceCreated and onSurfaceChanged are called results in undefined behaviour.
  - onSurfaceDestroyed
```
public void onSurfaceDestroyed()
```
    Stops renderer. Rendering may resume only after onSurfaceCreated is called again.
  - onInputEvent
```
public void onInputEvent(int event,
                         float x1,
                         float y1,
                         float x2,
                         float y2)
```
    Handles a user input event.
    
    参数:
    
    event - The event type. First pointer down = 0, second pointer down = 1, either pointer moved = 2,
    gesture canceled = 3, first pointer up = 4, second pointer up = 5.
    
    x1 - The x coordinate of the first pointer. -1 if there are no coordinates.
    
    y1 - The y coordinate of the first pointer. -1 if there are no coordinates.
    
    x2 - The x coordinate of the second pointer. -1 if there are no coordinates.
    
    y2 - The y coordinate of the second pointer. -1 if there are no coordinates.
  - getLayers
```
public Layers getLayers()
```
    Returns the Layers object, that can be used for adding and removing map layers.
    
    返回:
    
    The Layer object.
  - getOptions
```
public Options getOptions()
```
    Returns the Options object, that can be used for modifying various map options.
    
    返回:
    
    the Option object.
  - getOptionsMini
```
public Options getOptionsMini()
```
  - getMapRenderer
```
public MapRenderer getMapRenderer()
```
    Returns the MapRenderer object, that can be used for controlling rendering options.
    
    返回:
    
    the MapRenderer object.
  - getFocusPos
```
public MapPos getFocusPos()
```
    Returns the position that the camera is currently looking at.
    
    返回:
    
    The current focus position in the coordinate system of the base projection.
  - getFocusPosMini
```
public MapPos getFocusPosMini()
```
  - getCameraPos
```
public MapPos getCameraPos()
```
  - getCameraPosMini
```
public MapPos getCameraPosMini()
```
  - getRotation
```
public float getRotation()
```
    Returns the map rotation in degrees. 0 means looking north, 90 means west, -90 means east and 180 means south.
    
    返回:
    
    The map rotation in degrees in range of (-180 .. 180].
  - getTilt
```
public float getTilt()
```
    Returns the tilt angle in degrees. 0 means looking directly at the horizon, 90 means looking directly down.
    
    返回:
    
    The tilt angle in degrees.
  - getZoom
```
public float getZoom()
```
    Returns the zoom level. The value returned is never negative, 0 means absolutely zoomed out and all other
    values describe some level of zoom.
    
    返回:
    
    The zoom level.
  - pan
```
public void pan(MapVec deltaPos,
                float durationSeconds)
```
    Pans the view relative to the current focus position. The deltaPos vector is expected to be in
    the coordinate system of the base projection. The new calculated focus position will be clamped to
    the world bounds and to the bounds set by Options::setPanBounds.
    
    If durationSeconds > 0 the panning operation will be animated over time. If the previous panning animation has not
    finished by the time this method is called, it will be stopped.
    
    参数:
    
    deltaPos - The relative coordinate shift.
    
    durationSeconds - The duration in which the panning operation will be completed in seconds.
  - setFocusPos
```
public void setFocusPos(MapPos pos,
                        float durationSeconds)
```
    Sets the new absolute focus position. The new focus position is expected to be in
    the coordinate system of the base projection. The new focus position will be clamped to
    the world bounds and to the bounds set by Options::setPanBounds.
    
    If durationSeconds > 0 the panning operation will be animated over time. If the previous panning animation has not
    finished by the time this method is called, it will be stopped.
    
    参数:
    
    pos - The new absolute focus position.
    
    durationSeconds - The duration in which the panning operation will be completed in seconds.
  - setCameraPos
```
public void setCameraPos(MapPos pos,
                         float height,
                         float rotate,
                         float tilt,
                         float durationSeconds)
```
  - setCameraPosMini
```
public void setCameraPosMini(MapPos pos,
                             float height,
                             float rotate,
                             float tilt)
```
  - rotate
```
public void rotate(float deltaAngle,
                   float durationSeconds)
```
    Rotates the view relative to the current rotation value. Positive values rotate clockwise, negative values counterclockwise.
    The new calculated rotation value will be wrapped to the range of (-180 .. 180]. Rotations are ignored if Options::setRotatable
    is set to false.
    
    If durationSeconds > 0 the rotating operation will be animated over time. If the previous rotating animation has not
    finished by the time this method is called, it will be stopped.
    
    参数:
    
    deltaAngle - The delta rotation value in degrees.
    
    durationSeconds - The duration in which the rotation operation will be completed in seconds.
  - rotate
```
public void rotate(float deltaAngle,
                   MapPos targetPos,
                   float durationSeconds)
```
    Rotates the view relative to the current rotation value. Positive values rotate clockwise, negative values counterclockwise.
    The new calculated rotation value will be wrapped to the range of (-180 .. 180]. Rotations are ignored if Options::setRotatable
    is set to false.
    
    Rotating is done around the specified target position, keeping it at the same location on the screen.
    
    If durationSeconds > 0 the rotating operation will be animated over time. If the previous rotating animation has not
    finished by the time this method is called, it will be stopped.
    
    参数:
    
    deltaAngle - The delta angle value in degrees.
    
    targetPos - The zooming target position in the coordinate system of the base projection.
    
    durationSeconds - The duration in which the rotation operation will be completed in seconds.
  - setRotation
```
public void setRotation(float angle,
                        float durationSeconds)
```
    Sets the new absolute rotation value. 0 means look north, 90 means west, -90 means east and 180 means south.
    The rotation value will be wrapped to the range of (-180 .. 180]. Rotations are ignored if Options::setRotatable
    is set to false.
    
    If durationSeconds > 0 the rotating operation will be animated over time. If the previous rotating animation has not
    finished by the time this method is called, it will be stopped.
    
    参数:
    
    angle - The new absolute angle value in degrees.
    
    durationSeconds - The duration in which the rotation operation will be completed in seconds.
  - setRotation
```
public void setRotation(float angle,
                        MapPos targetPos,
                        float durationSeconds)
```
    Sets the new absolute rotation value. 0 means look north, 90 means west, -90 means east and 180 means south.
    The rotation value will be wrapped to the range of (-180 .. 180]. Rotations are ignored if Options::setRotatable
    is set to false.
    
    Rotating is done around the specified target position, keeping it at the same location on the screen.
    
    If durationSeconds > 0 the rotating operation will be animated over time. If the previous rotating animation has not
    finished by the time this method is called, it will be stopped.
    
    参数:
    
    angle - The new absolute angle value in degrees.
    
    targetPos - The zooming target position in the coordinate system of the base projection.
    
    durationSeconds - The duration in which the rotation operation will be completed in seconds.
  - tilt
```
public void tilt(float deltaTilt,
                 float durationSeconds)
```
    Tilts the view relative to the current tilt value. Positive values tilt the view down towards the map,
    negative values tilt the view up towards the horizon. The new calculated tilt value will be clamped to
    the range of [30 .. 90] and to the range set by Options::setZoomRange.
    
    If durationSeconds > 0 the tilting operation will be animated over time. If the previous tilting animation has not
    finished by the time this method is called, it will be stopped.
    
    参数:
    
    deltaTilt - The number of degrees the camera should be tilted by.
    
    durationSeconds - The duration in which the tilting operation will be completed in seconds.
  - setTilt
```
public void setTilt(float tilt,
                    float durationSeconds)
```
    Sets the new absolute tilt value. 0 means look directly at the horizon, 90 means look directly down. The
    minimum tilt angle is 30 degrees and the maximum is 90 degrees. The tilt value can be further constrained
    by the Options::setTiltRange method. Values exceeding these ranges will be clamped.
    
    If durationSeconds > 0 the tilting operation will be animated over time. If the previous tilting animation has not
    finished by the time this method is called, it will be stopped.
    
    参数:
    
    tilt - The new absolute tilt value in degrees.
    
    durationSeconds - The duration in which the tilting operation will be completed in seconds.
  - zoom
```
public void zoom(float deltaZoom,
                 float durationSeconds)
```
    Zooms the view relative to the current zoom value. Positive values zoom in, negative values zoom out.
    The new calculated zoom value will be clamped to the range of [0 .. 24] and to the range set by Options::setZoomRange.
    
    If durationSeconds > 0 the zooming operation will be animated over time. If the previous zooming animation has not
    finished by the time this method is called, it will be stopped.
    
    参数:
    
    deltaZoom - The delta zoom value.
    
    durationSeconds - The duration in which the zooming operation will be completed in seconds.
  - zoom
```
public void zoom(float deltaZoom,
                 MapPos targetPos,
                 float durationSeconds)
```
    Zooms the view relative to the current zoom value. Positive values zoom in, negative values zoom out.
    The new calculated zoom value will be clamped to the range of [0 .. 24] and to the range set by Options::setZoomRange.
    
    Zooming is done towards the specified target position, keeping it at the same location on the screen.
    
    If durationSeconds > 0 the zooming operation will be animated over time. If the previous zooming animation has not
    finished by the time this method is called, it will be stopped.
    
    参数:
    
    deltaZoom - The delta zoom value.
    
    targetPos - The zooming target position in the coordinate system of the base projection.
    
    durationSeconds - The duration in which the zooming operation will be completed in seconds.
  - setZoom
```
public void setZoom(float zoom,
                    float durationSeconds)
```
    Sets the new absolute zoom value. The minimum zoom value is 0, which means absolutely zoomed out and the maximum
    zoom value is 24. The zoom value can be further constrained by the Options::setZoomRange method. Values
    exceeding these ranges will be clamped.
    
    If durationSeconds > 0 the zooming operation will be animated over time. If the previous zooming animation has not
    finished by the time this method is called, it will be stopped.
    
    参数:
    
    zoom - The new absolute zoom value.
    
    durationSeconds - The duration in which the zooming operation will be completed in seconds.
  - setZoom
```
public void setZoom(float zoom,
                    MapPos targetPos,
                    float durationSeconds)
```
    Sets the new absolute zoom value. The minimum zoom value is 0, which means absolutely zoomed out and the maximum
    zoom value is 24. The zoom value can be further constrained by the Options::setZoomRange method. Values
    exceeding these ranges will be clamped.
    
    Zooming is done towards the specified target position, keeping it at the same location on the screen.
    
    If durationSeconds > 0, the zooming operation will be animated over time. If the previous zooming animation has not
    finished by the time this method is called, it will be stopped.
    
    参数:
    
    zoom - The new absolute zoom value.
    
    targetPos - The zooming target position in the coordinate system of the base projection.
    
    durationSeconds - The duration in which the zooming operation will be completed in seconds.
  - moveToFitBounds
```
public void moveToFitBounds(MapBounds mapBounds,
                            ScreenBounds screenBounds,
                            boolean integerZoom,
                            float durationSeconds)
```
    Animate the view parameters (focus position, tilt, rotation, zoom) so that the specified bounding box becomes fully visible.
    This method does not work before the screen size is set.
    
    参数:
    
    mapBounds - The bounding box on the map to be made visible in the base projection's coordinate system.
    
    screenBounds - The screen bounding box where to fit the map bounding box.
    
    integerZoom - If true, then closest integer zoom level will be used. If false, exact fractional zoom level will be used.
    
    durationSeconds - The duration in which the operation will be completed in seconds.
  - moveToFitBounds
```
public void moveToFitBounds(MapBounds mapBounds,
                            ScreenBounds screenBounds,
                            boolean integerZoom,
                            boolean resetRotation,
                            boolean resetTilt,
                            float durationSeconds)
```
    Animate the view parameters (focus position, tilt, rotation, zoom) so that the specified bounding box becomes fully visible.
    Also supports resetting the tilt and rotation angles over the course of the animation.
    This method does not work before the screen size is set.
    
    参数:
    
    mapBounds - The bounding box on the map to be made visible in the base projection's coordinate system.
    
    screenBounds - The screen bounding box where to fit the map bounding box.
    
    integerZoom - If true, then closest integer zoom level will be used. If false, exact fractional zoom level will be used.
    
    resetTilt - If true, view will be untilted. If false, current tilt will be kept.
    
    resetRotation - If true, rotation will be reset. If false, current rotation will be kept.
    
    durationSeconds - The duration in which the operation will be completed in seconds.
  - getMapEventListener
```
public MapEventListener getMapEventListener()
```
    Returns the map event listener. May be null.
    
    返回:
    
    The map event listener.
  - setMapEventListener
```
public void setMapEventListener(MapEventListener mapEventListener)
```
    Sets the map event listener. If a null pointer is passed no map events will be generated. The default is null.
    
    参数:
    
    mapEventListener - The new map event listener.
  - setMapZoomEventListener
```
public void setMapZoomEventListener(MapZoomEventListener mapZoomEventListener)
```
    yk 2022/5/17 单独拆分监听事件
    
    参数:
    
    mapZoomEventListener -
  - setMapMoveListener
```
public void setMapMoveListener(MapMoveListener mapMoveListener)
```
    yk 2022/5/18 设置地图移动监听以及移动结束监听
    
    参数:
    
    mapMoveListener -
  - getRedrawRequestListener
```
public RedrawRequestListener getRedrawRequestListener()
```
    Returns the redraw request listener.
    
    返回:
    
    The redraw request listener.
  - setRedrawRequestListener
```
public void setRedrawRequestListener(RedrawRequestListener listener)
```
    Sets the listener which will notified when the map needs to be redrawn
    
    参数:
    
    listener - The redraw listener.
  - screenToMap
```
public MapPos screenToMap(ScreenPos screenPos)
```
    Calculates the map position corresponding to a screen position, using the current view parameters.
    
    参数:
    
    screenPos - The screen position.
    
    返回:
    
    The calculated map position in base projection coordinate system.
  - screenToMapMini
```
public MapPos screenToMapMini(ScreenPos screenPos,
                              Options options)
```
  - mapToScreen
```
public ScreenPos mapToScreen(MapPos mapPos)
```
    Calculates the screen position corresponding to a map position, using the current view parameters.
    
    参数:
    
    mapPos - The map position in base projection coordinate system.
    
    返回:
    
    The calculated screen position.
  - mapToScreenMini
```
public ScreenPos mapToScreenMini(MapPos mapPos,
                                 int screenWidth,
                                 int screenHeight,
                                 Options options)
```
  - cancelAllTasks
```
public void cancelAllTasks()
```
    Cancels all qued tasks such as tile and vector data fetches. Tasks that have already started
    may continue until they finish. Tasks that are added after this method call are not affected.
  - clearPreloadingCaches
```
public void clearPreloadingCaches()
```
    Releases the memory occupied by the preloading area. Calling this method releases some
    memory if preloading is enabled, but means that the area right outside the visible area has to be
    fetched again.
  - clearAllCaches
```
public void clearAllCaches()
```
    Releases memory occupied by all caches. Calling this means that everything has to be fetched again,
    including the visible area.
  - requestComponentsDraw
```
public void requestComponentsDraw()
```
  - enableDoubleClick
```
public void enableDoubleClick(boolean canDoubleClick)
```
  - pickMapPos
```
public void pickMapPos(ScreenPos screenPos,
                       MapPickListener listener,
                       boolean waitWhileUpdating)
```
  - setKineticRatio
```
public void setKineticRatio(double ratio)
```

类 BaseMapView

字段概要

构造器概要

方法概要

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

字段详细资料

swigCMemOwn

构造器详细资料

BaseMapView

BaseMapView

方法详细资料

getCPtr

finalize

delete

registerLicense

getSDKVersion

onSurfaceCreated

onSurfaceChanged

onDrawFrame

onSurfaceDestroyed

onInputEvent

getLayers

getOptions

getOptionsMini

getMapRenderer

getFocusPos

getFocusPosMini

getCameraPos

getCameraPosMini

getRotation

getTilt

getZoom

pan

setFocusPos

setCameraPos

setCameraPosMini

rotate

rotate

setRotation

setRotation

tilt

setTilt

zoom

zoom

setZoom

setZoom

moveToFitBounds

moveToFitBounds

getMapEventListener

setMapEventListener

setMapZoomEventListener

setMapMoveListener

getRedrawRequestListener

setRedrawRequestListener

screenToMap

screenToMapMini

mapToScreen

mapToScreenMini

cancelAllTasks

clearPreloadingCaches

clearAllCaches

requestComponentsDraw

enableDoubleClick

pickMapPos

setKineticRatio