Class YMKMapWindow

Handles the MapWindow element.

Instance Methods

- addSizeChangedListenerWithSizeChangedListener:

Adds a SizeChangedListener.

- height

Screen height in physical pixels.

- onMemoryWarning

Called on memory warning.

- removeSizeChangedListenerWithSizeChangedListener:

Removes a SizeChangedListener.

- screenToWorldWithScreenPoint:

Transforms coordinates from screen space to world space.

- setMaxFpsWithFps:

Caps FPS.

- width

Screen width in physical pixels.

- worldToScreenWithWorldPoint:

Transforms the position from world coordinates to screen coordinates.

Properties

fieldOfViewY

Sets the vertical field of view, in degrees.

focusRect

When using controls that overlay the map view, calculating the proper camera position can be tricky.

focusRegion

Gets the focused region.

map

Gets the map interface.

pointOfView

Defines the position of the point of view.

scaleFactor

Defines the scale factor, which equals the number of pixels per device-independent point.

valid

Tells if this object is valid or no.

zoomFocusPoint

Defines the focus point of zoom gestures.

zoomFocusPointMode

Specifies the way provided zoom focus point affects gestures.

Method Detail

-addSizeChangedListenerWithSizeChangedListener:

- (void)addSizeChangedListenerWithSizeChangedListener:(nonnull id< YMKMapSizeChangedListener >)sizeChangedListener 

Adds a SizeChangedListener.

-height

- (NSInteger)height

Screen height in physical pixels.

-onMemoryWarning

- (void)onMemoryWarning

Called on memory warning.

-removeSizeChangedListenerWithSizeChangedListener:

- (void)removeSizeChangedListenerWithSizeChangedListener:(nonnull id< YMKMapSizeChangedListener >)sizeChangedListener 

Removes a SizeChangedListener.

-screenToWorldWithScreenPoint:

- (nullable YMKPoint *)screenToWorldWithScreenPoint:(nonnull YMKScreenPoint *)screenPoint 

Transforms coordinates from screen space to world space.

Parameters:
screenPoint

The point in screen coordinates relative to the top left of the map. These coordinates are in physical pixels and not in device independent (virtual) pixels.

Returns:

Latitude and longitude information.

-setMaxFpsWithFps:

- (void)setMaxFpsWithFps:(float)fps 

Caps FPS.

Valid range: (0, 60]. Default: 60.

-width

- (NSInteger)width

Screen width in physical pixels.

-worldToScreenWithWorldPoint:

- (nullable YMKScreenPoint *)worldToScreenWithWorldPoint:(nonnull YMKPoint *)worldPoint 

Transforms the position from world coordinates to screen coordinates.

Parameters:
worldPoint

Latitude and longitude information.

Returns:

The point in screen space corresponding to worldPoint; returns none if the point is behind the camera.

Property Detail

fieldOfViewY

(assign, readwrite) double fieldOfViewY

Sets the vertical field of view, in degrees.

Default: 30.

focusRect

(assign, readwrite) YMKScreenRect * focusRect

When using controls that overlay the map view, calculating the proper camera position can be tricky.

This method simplifies the task by defining the area of interest (the focus rectangle) inside the view. This area serves as a reference for all subsequent camera movements.

For example, when using a semi-transparent control that overlays the top half of the map view, define the focus rectangle as the lower half of the view to ensure that all camera movements will have the center of the lower half as their target.

On iOS, if you change the focus rectangle in the viewDidLayoutSubviews callback, it's recommended to call MapView.layoutIfNeeded just before that action.

Optional property, can be nil.

focusRegion

(assign, readonly) YMKVisibleRegion * focusRegion

Gets the focused region.

Returns:

A region that corresponds to the current focusRect or the visible region if focusRect is not set. Region IS bounded by latitude limits [-90, 90] and IS NOT bounded by longitude limits [-180, 180]. If longitude exceeds its limits, we see the world's edge and another instance of the world beyond this edge.

map

(assign, readonly) YMKMap * map

Gets the map interface.

pointOfView

(assign, readwrite) YMKPointOfView pointOfView

Defines the position of the point of view.

Cameras use perspective projection, which causes perspective deformations. Perspective projection has an axis, and points on this axis are not affected by perspective deformations. This axis is a line parallel to the view's direction, so its projection to the screen is a point - the "point of view". By default, this point is at the center of the screen, but some applications might want to set it to the center of focusRect. Use this flag to do so. Default: ScreenCenter

scaleFactor

(assign, readwrite) float scaleFactor

Defines the scale factor, which equals the number of pixels per device-independent point.

valid

(assign, readonly, getter=isValid) BOOL valid

Tells if this object is valid or no.

Any method called on an invalid object will throw an exception. The object becomes invalid only on UI thread, and only when its implementation depends on objects already destroyed by now. Please refer to general docs about the interface for details on its invalidation.

zoomFocusPoint

(assign, readwrite) YMKScreenPoint * zoomFocusPoint

Defines the focus point of zoom gestures.

Actual behaviour depends on zoomFocusPointMode. If the point is not set, the source point of the gesture will be used as the focus point. Default: none.

Optional property, can be nil.

zoomFocusPointMode

(assign, readwrite) YMKZoomFocusPointMode zoomFocusPointMode

Specifies the way provided zoom focus point affects gestures.

Default: TapGestures.