com.sygic.sdk.map.data.SimpleCameraDataModel Class Reference
Inheritance diagram for com.sygic.sdk.map.data.SimpleCameraDataModel:
Collaboration diagram for com.sygic.sdk.map.data.SimpleCameraDataModel:

Classes

interface  DynamicDataType
 

Public Member Functions

void onSaveInstance (@Nullable final Camera camera, @NonNull final Bundle outState)
 
void onRestoreInstance (@Nullable final Bundle inState)
 
void setCameraState (final CameraState cameraState)
 
void setPosition (@NonNull final GeoCoordinates position, @NonNull final MapAnimation animation)
 
GeoCoordinates getPosition ()
 
void setRotation (@FloatRange(from=-180.0, to=180.0) final float rotation, @NonNull final MapAnimation animation)
 
float getRotation ()
 
void setZoomLevel (@FloatRange(from=0, to=Float.MAX_VALUE) final float zoom, @NonNull final MapAnimation animation)
 
float getZoomLevel ()
 
void setTilt (@FloatRange(from=0, to=90) final float tilt, @NonNull final MapAnimation animation)
 
float getTilt ()
 
void setRotationMode (@Camera.RotationMode final int rotationMode)
 
.RotationMode int getRotationMode ()
 
void setMovementMode (@Camera.MovementMode final int movementMode)
 
.MovementMode int getMovementMode ()
 
void setMapCenterSettings (final MapCenterSettings settings, @NonNull final MapAnimation animation)
 
MapCenter getMapCenter ()
 
MapCenterSettings getMapCenterSettings ()
 
void setMapPadding (final RectF rect, @NonNull final MapAnimation animation)
 
void setMapPadding (final float left, final float top, final float right, final float bottom, @NonNull final MapAnimation animation)
 
RectF getMapPadding ()
 
void setMapRectangle (@NonNull final MapRectangle mapRectangle, @NonNull final MapAnimation animation)
 
void setMapRectangle (@NonNull final GeoBoundingBox boundingBox, @FloatRange(from=0.0, to=1.0) final float leftMarginPerc, @FloatRange(from=0.0, to=1.0) final float topMarginPerc, @FloatRange(from=0.0, to=1.0) final float rightMarginPerc, @FloatRange(from=0.0, to=1.0) final float bottomMarginPerc, @NonNull final MapAnimation animation)
 
void setMapRectangle (@NonNull final GeoBoundingBox boundingBox, final int leftMarginPx, final int topMarginPx, final int rightMarginPx, final int bottomMarginPx, @NonNull final MapAnimation animation)
 
MapRectangle getMapRectangle ()
 
void setLocalRotation (@NonNull final Point3F angles, @NonNull final MapAnimation animation)
 
Point3F getLocalRotation ()
 
void setLocalTranslation (@NonNull final Point3F offset, @NonNull final MapAnimation animation)
 
Point3F getLocalTranslation ()
 
boolean rotateBy (final float angle, @NonNull final PointF focus, @NonNull final MapAnimation animation)
 
boolean tiltBy (final float angle, @NonNull final MapAnimation animation)
 
boolean zoomBy (final float scale, @NonNull final PointF focus, @NonNull final MapAnimation animation)
 
boolean dragBy (final float x, final float y, final MapAnimation animation)
 
boolean drag (final float xFrom, final float yFrom, final float xTo, final float yTo, final MapAnimation animation)
 
- Public Member Functions inherited from com.sygic.sdk.map.Camera.CameraModel
abstract void setRotationMode (@Camera.RotationMode final int rotationMode)
 
abstract void setMovementMode (@Camera.MovementMode final int movementMode)
 
final void addPositionChangedListener (PositionChangedListener listener)
 
final void removePositionChangedListener (PositionChangedListener listener)
 
final void addModeChangedListener (ModeChangedListener listener)
 
final void removeModeChangedListener (ModeChangedListener listener)
 
void onMovementModeChanged (final int mode)
 
void onRotationModeChanged (final int mode)
 
void onPositionChanged (final GeoCoordinates geoCenter, final float zoom, final float rotation, final float tilt)
 
void onPositionChangeCompleted ()
 
final void setPosition (@NonNull final GeoCoordinates position)
 
final void setRotation (@FloatRange(from=-180.0, to=180.0) final float rotation)
 
final void setZoomLevel (@FloatRange(from=0, to=Float.MAX_VALUE) final float zoom)
 
final void setTilt (@FloatRange(from=0, to=90) final float tilt)
 
final void setMapCenterSettings (final MapCenterSettings settings)
 
final void setMapPadding (final RectF rect)
 
final void setMapPadding (final float left, final float top, final float right, final float bottom)
 
final void setMapRectangle (@NonNull final MapRectangle mapRectangle)
 
final void setMapRectangle (@NonNull final GeoBoundingBox boundingBox, @FloatRange(from=0.0, to=1.0) final float leftMarginPerc, @FloatRange(from=0.0, to=1.0) final float topMarginPerc, @FloatRange(from=0.0, to=1.0) final float rightMarginPerc, @FloatRange(from=0.0, to=1.0) final float bottomMarginPerc)
 
final void setMapRectangle (@NonNull final GeoBoundingBox boundingBox, final int leftMarginPx, final int topMarginPx, final int rightMarginPx, final int bottomMarginPx)
 
final boolean rotateBy (final float angle, @NonNull final PointF focus)
 
final boolean tiltBy (final float angle)
 
final boolean zoomBy (final float scale, @NonNull final PointF focus)
 
final boolean dragBy (final float x, final float y)
 
final boolean drag (final float xFrom, final float yFrom, final float xTo, final float yTo)
 
- Public Member Functions inherited from com.sygic.sdk.map.Camera.ModeChangedListener
void onMovementModeChanged (@MovementMode int mode)
 
void onRotationModeChanged (@RotationMode int mode)
 

Protected Member Functions

final void observeCameraStateChange (@NonNull final Observer observer)
 
final void observeDynamicValueChange (@NonNull final Observer observer)
 
final void observeCallbackValues (@NonNull final Observer observer)
 
final void disposeCallbackValues (@NonNull final Observer observer)
 
final void disposeCameraStateChange (@NonNull final Observer observer)
 
final void disposeDynamicValueChange (@NonNull final Observer observer)
 
void onCameraDestroy (@NonNull final Camera camera)
 
void clear ()
 
CameraState getCameraState ()
 
- Protected Member Functions inherited from com.sygic.sdk.map.Camera.CameraModel
abstract void observeCameraStateChange (@NonNull final java.util.Observer observer)
 
abstract void observeDynamicValueChange (@NonNull final java.util.Observer observer)
 
abstract void observeCallbackValues (@NonNull final java.util.Observer observer)
 
abstract void disposeCallbackValues (@NonNull final java.util.Observer observer)
 
abstract void disposeCameraStateChange (@NonNull final java.util.Observer observer)
 
abstract void disposeDynamicValueChange (@NonNull final java.util.Observer observer)
 

Member Function Documentation

◆ clear()

void com.sygic.sdk.map.data.SimpleCameraDataModel.clear ( )
protected

◆ disposeCallbackValues()

final void com.sygic.sdk.map.data.SimpleCameraDataModel.disposeCallbackValues ( @NonNull final Observer  observer)
protected

◆ disposeCameraStateChange()

final void com.sygic.sdk.map.data.SimpleCameraDataModel.disposeCameraStateChange ( @NonNull final Observer  observer)
protected

◆ disposeDynamicValueChange()

final void com.sygic.sdk.map.data.SimpleCameraDataModel.disposeDynamicValueChange ( @NonNull final Observer  observer)
protected

◆ drag()

boolean com.sygic.sdk.map.data.SimpleCameraDataModel.drag ( final float  xFrom,
final float  yFrom,
final float  xTo,
final float  yTo,
final MapAnimation  animation 
)

◆ dragBy()

boolean com.sygic.sdk.map.data.SimpleCameraDataModel.dragBy ( final float  x,
final float  y,
final MapAnimation  animation 
)

◆ getCameraState()

CameraState com.sygic.sdk.map.data.SimpleCameraDataModel.getCameraState ( )
protected

◆ getLocalRotation()

Point3F com.sygic.sdk.map.data.SimpleCameraDataModel.getLocalRotation ( )

Retrieves orientation of a camera on each axis

Returns
Angle of rotation in degrees for each axis

Reimplemented from com.sygic.sdk.map.Camera.CameraModel.

◆ getLocalTranslation()

Point3F com.sygic.sdk.map.data.SimpleCameraDataModel.getLocalTranslation ( )

Retrieves position offset of a camera on each axis

Returns
Local translation in meters for each axis

Reimplemented from com.sygic.sdk.map.Camera.CameraModel.

◆ getMapCenter()

MapCenter com.sygic.sdk.map.data.SimpleCameraDataModel.getMapCenter ( )

Return the point of map on the screen which will be recognized as map center for rotation and vehicle position

Returns
Pair of x and y position on screen from range 0 - 1

Reimplemented from com.sygic.sdk.map.Camera.CameraModel.

◆ getMapCenterSettings()

MapCenterSettings com.sygic.sdk.map.data.SimpleCameraDataModel.getMapCenterSettings ( )

Returns the map center (point for rotation axis and vehicle position) for locked and unlocked map state.

Returns
Map center settings

Reimplemented from com.sygic.sdk.map.Camera.CameraModel.

◆ getMapPadding()

RectF com.sygic.sdk.map.data.SimpleCameraDataModel.getMapPadding ( )

◆ getMapRectangle()

MapRectangle com.sygic.sdk.map.data.SimpleCameraDataModel.getMapRectangle ( )

◆ getMovementMode()

.MovementMode int com.sygic.sdk.map.data.SimpleCameraDataModel.getMovementMode ( )

Returns mode how camera should move when the vehicle is moving - if it is following the vehicle or not.

Returns
Camera.MovementMode

Reimplemented from com.sygic.sdk.map.Camera.CameraModel.

◆ getPosition()

GeoCoordinates com.sygic.sdk.map.data.SimpleCameraDataModel.getPosition ( )

Returns camera GeoCoordinates on the map.

Reimplemented from com.sygic.sdk.map.Camera.CameraModel.

◆ getRotation()

float com.sygic.sdk.map.data.SimpleCameraDataModel.getRotation ( )

Returns the rotation of map in degrees. By default,the map is oriented with north toward the top of the map (0 degrees). As the orientation angle increases,the map rotates counter-clockwise so that at 90 degrees.

Returns
Rotation in degrees

Reimplemented from com.sygic.sdk.map.Camera.CameraModel.

◆ getRotationMode()

.RotationMode int com.sygic.sdk.map.data.SimpleCameraDataModel.getRotationMode ( )

Returns mode how the camera rotation should behave when the vehicle is moving.

Returns
Camera.RotationMode

Reimplemented from com.sygic.sdk.map.Camera.CameraModel.

◆ getTilt()

float com.sygic.sdk.map.data.SimpleCameraDataModel.getTilt ( )

Returns the tilt of map in degrees. The tilt controls the perspective at which the map is viewed. A value of 0 degrees corresponds to looking straight down at the map from above (2D). As the tilt value is increased,the view shifts to a 3D perspective.

The tilt of the map may be further constrained at some zoom levels. For example,no tilt is allowed at the lowest zoom levels when the globe is visible. This is to provide a better user experience when interacting with globe,since viewing a "tilted" globe does give any benefit.

Returns
Tilt in degrees

Reimplemented from com.sygic.sdk.map.Camera.CameraModel.

◆ getZoomLevel()

float com.sygic.sdk.map.data.SimpleCameraDataModel.getZoomLevel ( )

Returns the zoom value from range (0 - 20.0) The zoom level determines how "close" the map view is to the surface of the Earth. Higher zoom levels give a closer view. Zoom level values must be in the range returned by getMinMaxZoomLevel() Zom level: 0 - world, 10 - city, 15 - street, 20 - buildings

Returns
The zoom level value

Reimplemented from com.sygic.sdk.map.Camera.CameraModel.

◆ observeCallbackValues()

final void com.sygic.sdk.map.data.SimpleCameraDataModel.observeCallbackValues ( @NonNull final Observer  observer)
protected

◆ observeCameraStateChange()

final void com.sygic.sdk.map.data.SimpleCameraDataModel.observeCameraStateChange ( @NonNull final Observer  observer)
protected

◆ observeDynamicValueChange()

final void com.sygic.sdk.map.data.SimpleCameraDataModel.observeDynamicValueChange ( @NonNull final Observer  observer)
protected

◆ onCameraDestroy()

void com.sygic.sdk.map.data.SimpleCameraDataModel.onCameraDestroy ( @NonNull final Camera  camera)
protected

◆ onRestoreInstance()

void com.sygic.sdk.map.data.SimpleCameraDataModel.onRestoreInstance ( @Nullable final Bundle  inState)

◆ onSaveInstance()

void com.sygic.sdk.map.data.SimpleCameraDataModel.onSaveInstance ( @Nullable final Camera  camera,
@NonNull final Bundle  outState 
)

◆ rotateBy()

boolean com.sygic.sdk.map.data.SimpleCameraDataModel.rotateBy ( final float  angle,
@NonNull final PointF  focus,
@NonNull final MapAnimation  animation 
)

◆ setCameraState()

void com.sygic.sdk.map.data.SimpleCameraDataModel.setCameraState ( final CameraState  cameraState)

◆ setLocalRotation()

void com.sygic.sdk.map.data.SimpleCameraDataModel.setLocalRotation ( @NonNull final Point3F  angles,
@NonNull final MapAnimation  animation 
)

Rotates orientation of a camera on each axis

Parameters
anglesAngle of rotation in degrees for each axis
animationSetters animation

Reimplemented from com.sygic.sdk.map.Camera.CameraModel.

◆ setLocalTranslation()

void com.sygic.sdk.map.data.SimpleCameraDataModel.setLocalTranslation ( @NonNull final Point3F  offset,
@NonNull final MapAnimation  animation 
)

Offsets position of a camera on each axis

Parameters
offsetLocal translation in meters for each axis
animationSetters animation

Reimplemented from com.sygic.sdk.map.Camera.CameraModel.

◆ setMapCenterSettings()

void com.sygic.sdk.map.data.SimpleCameraDataModel.setMapCenterSettings ( final MapCenterSettings  settings,
@NonNull final MapAnimation  animation 
)

Sets the map center (point for rotation axis and vehicle position) for locked and unlocked map state.

Reimplemented from com.sygic.sdk.map.Camera.CameraModel.

◆ setMapPadding() [1/2]

void com.sygic.sdk.map.data.SimpleCameraDataModel.setMapPadding ( final float  left,
final float  top,
final float  right,
final float  bottom,
@NonNull final MapAnimation  animation 
)

◆ setMapPadding() [2/2]

void com.sygic.sdk.map.data.SimpleCameraDataModel.setMapPadding ( final RectF  rect,
@NonNull final MapAnimation  animation 
)

◆ setMapRectangle() [1/3]

void com.sygic.sdk.map.data.SimpleCameraDataModel.setMapRectangle ( @NonNull final GeoBoundingBox  boundingBox,
@FloatRange(from=0.0, to=1.0) final float  leftMarginPerc,
@FloatRange(from=0.0, to=1.0) final float  topMarginPerc,
@FloatRange(from=0.0, to=1.0) final float  rightMarginPerc,
@FloatRange(from=0.0, to=1.0) final float  bottomMarginPerc,
@NonNull final MapAnimation  animation 
)

◆ setMapRectangle() [2/3]

void com.sygic.sdk.map.data.SimpleCameraDataModel.setMapRectangle ( @NonNull final GeoBoundingBox  boundingBox,
final int  leftMarginPx,
final int  topMarginPx,
final int  rightMarginPx,
final int  bottomMarginPx,
@NonNull final MapAnimation  animation 
)

◆ setMapRectangle() [3/3]

void com.sygic.sdk.map.data.SimpleCameraDataModel.setMapRectangle ( @NonNull final MapRectangle  mapRectangle,
@NonNull final MapAnimation  animation 
)

◆ setMovementMode()

void com.sygic.sdk.map.data.SimpleCameraDataModel.setMovementMode ( @Camera.MovementMode final int  movementMode)

◆ setPosition()

void com.sygic.sdk.map.data.SimpleCameraDataModel.setPosition ( @NonNull final GeoCoordinates  position,
@NonNull final MapAnimation  animation 
)

Move camera to given position GeoCoordinates on the map with an animation.

Parameters
positionPosition on map to move on
animationMapAnimation

Reimplemented from com.sygic.sdk.map.Camera.CameraModel.

◆ setRotation()

void com.sygic.sdk.map.data.SimpleCameraDataModel.setRotation ( @FloatRange(from=-180.0, to=180.0) final float  rotation,
@NonNull final MapAnimation  animation 
)

Sets the rotation of map in degrees. By default,the map is oriented with north toward the top of the map (0 degrees). As the orientation angle increases,the map rotates counter-clockwise.

Parameters
rotationRotation in degrees
animationMapAnimation

Reimplemented from com.sygic.sdk.map.Camera.CameraModel.

◆ setRotationMode()

void com.sygic.sdk.map.data.SimpleCameraDataModel.setRotationMode ( @Camera.RotationMode final int  rotationMode)

◆ setTilt()

void com.sygic.sdk.map.data.SimpleCameraDataModel.setTilt ( @FloatRange(from=0, to=90) final float  tilt,
@NonNull final MapAnimation  animation 
)

Sets the tilt of map in degrees with an animation. The tilt controls the perspective at which the map is viewed. A value of 0 degrees corresponds to looking straight down at the map from above (2D). As the tilt value is increased,the view shifts to a 3D perspective.

The tilt of the map may be further constrained at some zoom levels. For example,no tilt is allowed at the lowest zoom levels when the globe is visible. This is to provide a better user experience when interacting with globe,since viewing a "tilted" globe does give any benefit.

Parameters
tiltTilt in degrees
animationMapAnimation

Reimplemented from com.sygic.sdk.map.Camera.CameraModel.

◆ setZoomLevel()

void com.sygic.sdk.map.data.SimpleCameraDataModel.setZoomLevel ( @FloatRange(from=0, to=Float.MAX_VALUE) final float  zoom,
@NonNull final MapAnimation  animation 
)

Sets the zoom value from range (0 - 20.0). The zoom level determines how "close" the map view is to the surface of the Earth. Higher zoom levels give a closer view. Zoom level values must be in the range returned by getMinMaxZoomLevel() Zoom level: 0 - world, 10 - city, 15 - street, 20 - buildings

Parameters
zoomZoom level value
animationMapAnimation

Reimplemented from com.sygic.sdk.map.Camera.CameraModel.

◆ tiltBy()

boolean com.sygic.sdk.map.data.SimpleCameraDataModel.tiltBy ( final float  angle,
@NonNull final MapAnimation  animation 
)

◆ zoomBy()

boolean com.sygic.sdk.map.data.SimpleCameraDataModel.zoomBy ( final float  scale,
@NonNull final PointF  focus,
@NonNull final MapAnimation  animation 
)

The documentation for this class was generated from the following file: