A UIView subclass used by an application to display a map. More...
#import <SYMapView.h>
Instance Methods | |
| (nonnull instancetype) | - initWithFrame:geoCenter:rotation:zoom:tilt: |
| Initialize SYMapView with camera target values. More... | |
| (SYCameraMovement cameraMovementMode) | - __deprecated_msg |
| Represents the camera movement mode. Take a look at the available SYCameraMovementModes. More... | |
| (SYCameraRotation cameraRotationMode) | - __deprecated_msg |
| Represents the camera rotation behaviour. Take a look at the available SYCameraRotationModes. More... | |
| (SYGeoCoordinate *geoCenter) | - __deprecated_msg |
| The SYGeoCoordinates corresponding to the current screen position of the transformCenter. More... | |
| (CGFloat zoom) | - __deprecated_msg |
| Current view zoom level. The zoom level determines how "close" the map view is to the surface of the Earth. Higher zoom levels give a closer view. Zoom 1 is the view on the earth, zoom 10 is approximately view on city, 15 on street, etc. More... | |
| (SYAngle rotation) | - __deprecated_msg |
| The current view rotation,in a range of degrees between [0..360). 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. More... | |
| (SYGeoBoundingBox *boundingBox) | - __deprecated_msg |
| The SYGeoBoundingBox representing the current screen area of the SYMapView. More... | |
| (SYAngle tilt) | - __deprecated_msg |
| Current view tilt in degrees <0,80> 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. More... | |
| (BOOL isMapMoving) | - __deprecated_msg |
| YES if map is changing its position, NO otherwise. More... | |
| (SYCameraRotationOffset cameraRotationOffset) | - __deprecated_msg |
| Setting this property will rotate camera around its axes. With default 0,0,0 rotation offset, camera is looking directly at SYMapView.geoCenter point. More... | |
| (SYCameraTranslationOffset cameraTranslationOffset) | - __deprecated_msg |
| Camera translation from its origin point. More... | |
| (nonnull NSArray< SYGeoCoordinate * > *) | - geoCoordinatesFromScreenPoints: |
| Converts points from screen coordinates to geographical coordinates. More... | |
| (nonnull NSArray< NSString * > *) | - availableSkins |
| Enumerate available map skins. To set active skins, use SYMapView activeSkins property. More... | |
| (nonnull NSArray< NSValue * > *) | - screenPointsFromGeoCoordinates: |
| Converts geographical coordinates to screen points stored as [NSValue valueWithCGPoint]. More... | |
| (SYMapObjectsResult) | - addMapObject: |
| Adds a SYMapObject to the SYMapView. Valid geo coordinates will produce a valid point,even if the coordinates are not on the screen or are above the visible horizon,as long as the coordinates are not too far from the current map location. More... | |
| (SYMapObjectsResult) | - addMapObjects: |
| Adds an array of SYMapObjects to the SYMapView. More... | |
| (SYMapObjectsResult) | - removeMapObject: |
| Removes a SYMapObject from the SYMapView. More... | |
| (SYMapObjectsResult) | - removeMapObjects: |
| Removes an array of SYMapObjects from the SYMapView. More... | |
| (nullable SYTask *) | - objectsAtPoint:withCompletion: |
| Request a NSArray of all SYViewObject objects that are selected at a specified point on the screen. More... | |
| (void) | - setFpsLimitMode:withFpsLimit: |
| Set target FPS value. More... | |
| (SYAnimationId) | - rotateView:withDuration:curve:completion: |
| Rotate current view camera by offset in degrees. More... | |
| (SYAnimationId) | - dragView:withDuration:curve:completion: |
| Drag current view camera by offset in screen points. More... | |
| (SYAnimationId) | - dragViewFrom:to:withDuration:curve:completion: |
| Drag current view camera from one screen point to another screen point. More... | |
| (SYAnimationId) | - zoomView:atPoint:withDuration:curve:completion: |
| Zoom current view camera by scale. More... | |
| (SYAnimationId) | - setViewBoundingBox:withEdgeInsets:duration:curve:completion: |
| Transforms the map to fit an arbitrary geo bounding box. More... | |
| (SYAnimationId) | - animate:withDuration:curve:completion: |
| Animate map view properties. More... | |
| (nonnull SYCameraProperties *) | - calculateCameraPropertiesForBoundingBox:transformCenter:rotation:tilt:maxZoomLevel:edgeInsets: |
| Calculates camera properties to make reqested area visible with given parameters. More... | |
| (void) | - cancelAnimationWithId: |
| Cancel animation. More... | |
| ("use camera method instead.") | - __deprecated_msg |
| Cancel all animations. More... | |
| (void) | - setTransformCenterSettings:withDuration:curve: |
| Set map transform center point and animation properties. More... | |
| (void) | - setCameraRotationOffset:withDuration:curve: |
| Set map camera rotation offset with animation. More... | |
| (void) | - setCameraTranslationOffset:withDuration:curve: |
| Set map camera translation offset with animation. More... | |
| ("use camera method instead.") | - __deprecated_msg |
| Get map transform center settings. More... | |
| ("use camera method instead.") | - __deprecated_msg |
| Get actual transform center. More... | |
| (void) | - setVisibility:forMapLayerCategories: |
| Set the visibility of the map layer categories to be rendered. The layer categories are specified using the SYMapLayerCategory enum. More... | |
| (nullable SYAnnotationView *) | - dequeueReusableAnnotationViewWithIdentifier: |
| Used by the delegate to acquire a reusable annotation view, or create a new view for registered class, in lieu of allocating a new one. More... | |
| (BOOL) | - addAnnotation: |
| Adds the specified SYAnnotation to the SYMapView. More... | |
| (void) | - removeAnnotation: |
| Adds an array of SYAnnotation objects to the SYMapView. More... | |
| (BOOL) | - addMapMarkersCluster: |
| Adds SYMapMarkersCluster to the SYMapView. More... | |
| (BOOL) | - removeMapMarkersCluster: |
| Removes SYMapMarkersCluster from the SYMapView. More... | |
| (nonnull NSArray< SYMapMarkersCluster * > *) | - mapMarkersClusters |
| Returns all SYMapMarkersClusters in the SYMapView. More... | |
| (void) | - releaseSdkView [implementation] |
Class Methods | |
| (NSHashTable< SYMapView * > *) | + allMapViews [implementation] |
| (void) | + releaseAllViews [implementation] |
Properties | |
| id< SYMapViewDelegate > | delegate |
| SYMapViewDelegate delegate. More... | |
| SYMapCamera * | camera |
| SYMapCamera provides interface to move and animate mapView. More... | |
| BOOL | renderEnabled |
| Enables or disables rendering of the map view. More... | |
| SYMapPositionIndicator * | positionIndicator |
| The position indicator. More... | |
| BOOL | mapInteractionEnabled |
| Enables or disables map gesture interaction for the SYMapView. If this property is set to NO,you can not use ani map gestures and you can implement yours. More... | |
| NSArray< NSString * > * | activeSkins |
| Represents the current active skins. More... | |
| NSString * | displayLanguage |
| The language which the map is set to render. It is nil if the display language isn't set and the default language English (en) is being used. More... | |
| SYMapDisplayUnits | displayUnits |
| Units which the map is set to render. More... | |
| NSArray< SYAnnotation * > * | annotations |
| Annotations are models used to annotate coordinates on the map. Implement [SYMapViewDelegate mapView:viewForAnnotation:] to return the annotation view for each annotation. More... | |
| BOOL | isMapGestureInProgress |
| YES if any map move gesture is performed on SYMapView, NO otherwise. If SYMapView::mapInteractionEnabled is set to NO, property is always NO. More... | |
| Sygic::Map::MapView * | mapView [implementation] |
A UIView subclass used by an application to display a map.
| - (SYGeoCoordinate* geoCenter) __deprecated_msg | ("use camera.geoCenter instead.") |
The SYGeoCoordinates corresponding to the current screen position of the transformCenter.
| - (BOOL isMapMoving) __deprecated_msg | ("use camera.isMoving instead.") |
YES if map is changing its position, NO otherwise.
| - (SYCameraMovement cameraMovementMode) __deprecated_msg | ("use camera.movementMode instead.") |
Represents the camera movement mode. Take a look at the available SYCameraMovementModes.
| - (SYAngle rotation) __deprecated_msg | ("use camera.rotation instead.") |
The current view rotation,in a range of degrees between [0..360). 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.
| - (SYCameraRotation cameraRotationMode) __deprecated_msg | ("use camera.rotationMode instead.") |
Represents the camera rotation behaviour. Take a look at the available SYCameraRotationModes.
| - (SYCameraRotationOffset cameraRotationOffset) __deprecated_msg | ("use camera.rotationOffset instead.") |
Setting this property will rotate camera around its axes. With default 0,0,0 rotation offset, camera is looking directly at SYMapView.geoCenter point.
| - (SYGeoBoundingBox* boundingBox) __deprecated_msg | ("use camera.tilt instead.") |
The SYGeoBoundingBox representing the current screen area of the SYMapView.
| - (SYAngle tilt) __deprecated_msg | ("use camera.tilt instead.") |
Current view tilt in degrees <0,80> 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.
| - (SYCameraTranslationOffset cameraTranslationOffset) __deprecated_msg | ("use camera.translationOffset instead.") |
Camera translation from its origin point.
| - (CGFloat zoom) __deprecated_msg | ("use camera.zoom instead.") |
Current view zoom level. The zoom level determines how "close" the map view is to the surface of the Earth. Higher zoom levels give a closer view. Zoom 1 is the view on the earth, zoom 10 is approximately view on city, 15 on street, etc.
| - ("use camera method instead.") __deprecated_msg |
Get map transform center settings.
| - ("use camera method instead.") __deprecated_msg |
Get actual transform center.
| - ("use camera method instead.") __deprecated_msg |
Cancel all animations.
| - (BOOL) addAnnotation: | (nonnull SYAnnotation *) | annotation |
Adds the specified SYAnnotation to the SYMapView.
| - (BOOL) addMapMarkersCluster: | (nonnull SYMapMarkersCluster *) | markersCluster |
Adds SYMapMarkersCluster to the SYMapView.
| - (SYMapObjectsResult) addMapObject: | (nonnull SYMapObject *) | mapObject |
Adds a SYMapObject to the SYMapView. Valid geo coordinates will produce a valid point,even if the coordinates are not on the screen or are above the visible horizon,as long as the coordinates are not too far from the current map location.
| mapObject | SYMapObject to add. |
| - (SYMapObjectsResult) addMapObjects: | (nonnull NSArray< SYMapObject * > *) | mapObjects |
Adds an array of SYMapObjects to the SYMapView.
| mapObjects | Array of SYMapObject to add. |
|
implementation |
| - (SYAnimationId) animate: | (nonnull void(^)(void)) | animations | |
| withDuration: | (NSTimeInterval) | duration | |
| curve: | (SYMapAnimationCurve) | curve | |
| completion: | ("use camera method instead.") | __deprecated_msg | |
Animate map view properties.
| animations | Animation block containing properties changes. Animable properties are geoCenter, rotation, tilt and zoom. @duration Animation duration. |
| curve | Animation curve. |
| completion | Animation completion block. |
| - (nonnull NSArray<NSString*>*) availableSkins |
Enumerate available map skins. To set active skins, use SYMapView activeSkins property.
| - (nonnull SYCameraProperties*) calculateCameraPropertiesForBoundingBox: | (nonnull SYGeoBoundingBox *) | boundingBox | |
| transformCenter: | (CGPoint) | transformCenter | |
| rotation: | (CGFloat) | rotation | |
| tilt: | (CGFloat) | tilt | |
| maxZoomLevel: | (CGFloat) | maxZoom | |
| edgeInsets: | ("use camera method instead.") | __deprecated_msg | |
Calculates camera properties to make reqested area visible with given parameters.
| boundingBox | BoundingBox to display on map. |
| transformCenter | Requested transform center. |
| rotation | Requested rotation. |
| tilt | Requested tilt. |
| maxZoom | Maximum zoom level. |
| edgeInsets | Edge insets in relative screen coordinates <0,1>. |
| - (void) cancelAnimationWithId: | ("use camera method instead.") | __deprecated_msg |
Cancel animation.
| - (nullable SYAnnotationView*) dequeueReusableAnnotationViewWithIdentifier: | (nonnull NSString *) | identifier |
Used by the delegate to acquire a reusable annotation view, or create a new view for registered class, in lieu of allocating a new one.
| - (SYAnimationId) dragView: | (CGPoint) | drag | |
| withDuration: | (NSTimeInterval) | duration | |
| curve: | (SYMapAnimationCurve) | curve | |
| completion: | ("use camera method instead.") | __deprecated_msg | |
Drag current view camera by offset in screen points.
| drag | Camera move offset in screen points. |
| duration | Animation duration. |
| curve | Animation curve. |
| completion | Animation completion block. |
| - (SYAnimationId) dragViewFrom: | (CGPoint) | from | |
| to: | (CGPoint) | to | |
| withDuration: | (NSTimeInterval) | duration | |
| curve: | (SYMapAnimationCurve) | curve | |
| completion: | ("use camera method instead.") | __deprecated_msg | |
Drag current view camera from one screen point to another screen point.
| from | Screen from point. |
| to | Screen to point. |
| duration | Animation duration. |
| curve | Animation curve. |
| completion | Animation completion block. |
| - (nonnull NSArray<SYGeoCoordinate*>*) geoCoordinatesFromScreenPoints: | (nonnull NSArray< NSValue * > *) | screenPoints |
Converts points from screen coordinates to geographical coordinates.
| - (nonnull instancetype) initWithFrame: | (CGRect) | frame | |
| geoCenter: | (nonnull SYGeoCoordinate *) | geoCenter | |
| rotation: | (SYAngle) | rotation | |
| zoom: | (CGFloat) | zoom | |
| tilt: | (SYAngle) | tilt | |
Initialize SYMapView with camera target values.
| - (nonnull NSArray<SYMapMarkersCluster*>*) mapMarkersClusters |
Returns all SYMapMarkersClusters in the SYMapView.
| - (nullable SYTask*) objectsAtPoint: | (CGPoint) | point | |
| withCompletion: | (nonnull void(^)(NSArray< SYViewObject * > *_Nonnull)) | completion | |
Request a NSArray of all SYViewObject objects that are selected at a specified point on the screen.
| point | Screen point. |
| completion | Completion block. |
|
implementation |
|
implementation |
| - (void) removeAnnotation: | (nonnull SYAnnotation *) | annotation |
Adds an array of SYAnnotation objects to the SYMapView.
| - (BOOL) removeMapMarkersCluster: | (nonnull SYMapMarkersCluster *) | markersCluster |
Removes SYMapMarkersCluster from the SYMapView.
| - (SYMapObjectsResult) removeMapObject: | (nonnull SYMapObject *) | mapObject |
Removes a SYMapObject from the SYMapView.
| mapObject | SYMapObject to remove. |
| - (SYMapObjectsResult) removeMapObjects: | (nonnull NSArray< SYMapObject * > *) | mapObjects |
Removes an array of SYMapObjects from the SYMapView.
| mapObjects | Array of SYMapObject to be removed. |
| - (SYAnimationId) rotateView: | (SYAngle) | angle | |
| withDuration: | (NSTimeInterval) | duration | |
| curve: | (SYMapAnimationCurve) | curve | |
| completion: | ("use camera method instead.") | __deprecated_msg | |
Rotate current view camera by offset in degrees.
| angle | Camera rotation offset in degrees. |
| duration | Animation duration. |
| curve | Animation curve. |
| completion | Animation completion block. |
| - (nonnull NSArray<NSValue*>*) screenPointsFromGeoCoordinates: | (nonnull NSArray< SYGeoCoordinate * > *) | geoCoords |
Converts geographical coordinates to screen points stored as [NSValue valueWithCGPoint].
| - (void) setCameraRotationOffset: | (SYCameraRotationOffset) | offset | |
| withDuration: | (NSTimeInterval) | duration | |
| curve: | ("use camera method instead.") | __deprecated_msg | |
Set map camera rotation offset with animation.
| - (void) setCameraTranslationOffset: | (SYCameraTranslationOffset) | offset | |
| withDuration: | (NSTimeInterval) | duration | |
| curve: | ("use camera method instead.") | __deprecated_msg | |
Set map camera translation offset with animation.
| - (void) setFpsLimitMode: | (SYFpsLimitMode) | mode | |
| withFpsLimit: | (CGFloat) | limit | |
Set target FPS value.
| mode | SYFpsLimitMode. |
| limit | In case of SYFpsLimitModePerformance mode,limit means target fps value which is always tried to achieve. In case of SYFpsLimitModeBalanced,limit means lowest fps value,which is tried to achieve at slow camera movements to save battery life. |
| - (void) setTransformCenterSettings: | (SYTransformCenterSettings) | settings | |
| withDuration: | (NSTimeInterval) | duration | |
| curve: | ("use camera method instead.") | __deprecated_msg | |
Set map transform center point and animation properties.
| - (SYAnimationId) setViewBoundingBox: | (nonnull SYGeoBoundingBox *) | boundingBox | |
| withEdgeInsets: | (UIEdgeInsets) | edgeInsets | |
| duration: | (NSTimeInterval) | duration | |
| curve: | (SYMapAnimationCurve) | curve | |
| completion: | ("use camera method instead.") | __deprecated_msg | |
Transforms the map to fit an arbitrary geo bounding box.
| boundingBox | SYGeoBoundingBox to show. |
| edgeInsets | Edge insets in relative screen coordinates <0,1>. |
| duration | Animation duration. |
| curve | Animation curve. |
| completion | Animation completion block. |
| - (void) setVisibility: | (BOOL) | visible | |
| forMapLayerCategories: | (nonnull NSArray< NSNumber * > *) | layerCategories | |
Set the visibility of the map layer categories to be rendered. The layer categories are specified using the SYMapLayerCategory enum.
| visible | YES to make map layer categories visible, NO to hide. |
| layerCategories | An array of NSNumber objects containing SYMapLayerCategory values. |
| - (SYAnimationId) zoomView: | (CGFloat) | scale | |
| atPoint: | (CGPoint) | center | |
| withDuration: | (NSTimeInterval) | duration | |
| curve: | (SYMapAnimationCurve) | curve | |
| completion: | ("use camera method instead.") | __deprecated_msg | |
Zoom current view camera by scale.
| scale | Zoom scale. |
| center | Screen point to zoom at. Usually represents center of pinch gesture toches. Ignored if SYMapView.cameraMovementMode is not SYCameraMovementFree. |
| duration | Animation duration. |
| curve | Animation curve. |
| completion | Animation completion block. |
|
readwritenonatomiccopy |
Represents the current active skins.
|
readnonatomicassign |
Annotations are models used to annotate coordinates on the map. Implement [SYMapViewDelegate mapView:viewForAnnotation:] to return the annotation view for each annotation.
|
readnonatomicassign |
SYMapCamera provides interface to move and animate mapView.
|
readwritenonatomicweak |
SYMapViewDelegate delegate.
|
readwritenonatomicstrong |
The language which the map is set to render. It is nil if the display language isn't set and the default language English (en) is being used.
|
readwritenonatomicassign |
Units which the map is set to render.
|
readnonatomicassign |
YES if any map move gesture is performed on SYMapView, NO otherwise. If SYMapView::mapInteractionEnabled is set to NO, property is always NO.
|
readwritenonatomicassign |
Enables or disables map gesture interaction for the SYMapView. If this property is set to NO,you can not use ani map gestures and you can implement yours.
|
readwritenonatomicassignimplementation |
|
readnonatomicassign |
The position indicator.
|
readwritenonatomicassign |
Enables or disables rendering of the map view.
1.8.16 