iOS SDK change log from version 2.4.0 to version 2.5.0

SKCameraSettings class

New class

/** Contains settings that control how the map is viewed.
*/

@interface SKCameraSettings : NSObject

/**
Controls the rotation point of the camera. Valid values are from [ 0.1, 0.9 ] interval. Default is 0.3.
*/
@property (nonatomic, assign) CGFloat center;

/**
Controls the camera tilt. Valid values are from [ 0, 90 ] interval. Default is 15.
*/
@property (nonatomic, assign) CGFloat tilt;

/**
Controls the distance of the camera from the center of the map. Valid values are from [ 30, 300 ] interval. Default is 144.
*/
@property (nonatomic, assign) CGFloat distance;

/**
New instance of SKCameraSettings with default values.
*/
+ (SKCameraSettings *)cameraSettings;

/**
New instance of SKCameraSettings with desired values.
@param center Center of the camera.
@param tilt Tilt of the camera.
@param distance Distance of the camera.
*/
+ (SKCameraSettings *)cameraSettingsWithCenter:(CGFloat)center tilt:(CGFloat)tilt distance:(CGFloat)distance;

SKAdvisorSettings class

Removed property

/** The absolute path to the advisor files configs folder. The default is SKMaps.bundle/AdvisorConfigs, located in the main bundle.
*/
@property(nonatomic, strong) NSString *configPath;

SKAnnotation class

Removed deprecated properties

/** The absolute path to the image file to be added as an annotation. The image must be a square image and the size must be a power of 2. ( 32x32, 64x64, etc. ). DEPRECATED: Use the annotationView property for displaying custom images as annotations.
*/
@property(nonatomic) NSString *imagePath DEPRECATED_ATTRIBUTE;

/** The size of the image (width and height) in pixels. DEPRECATED: Use the annotationView property for displaying custom images as annotations.
*/
@property(nonatomic, assign) int imageSize DEPRECATED_ATTRIBUTE;

SKMapSettings class

Removed deprecated properties

/** Controls if the map follows the user position, orientation or none of them. Default value is SKMapFollowerModeNone. DPERECATED: Use the followUserPosition and headingMode members. */

@property(nonatomic, assign) SKMapFollowerMode followerMode DEPRECATED_ATTRIBUTE;

New deprecated property

/** Controls if the map POI icons are rendered on the map. Default value is YES. DEPRECATED: Use the poiDisplayingOption property for configuring the appearence of map POIs. For hiding all the POIs set the poiDisplayingOption property to SKPOIDisplayingOptionNone. For displaying all the POIs set the poiDisplayingOption property to SKPOIDisplayingOptionCity | SKPOIDisplayingOptionGeneral | SKPOIDisplayingOptionImportant.*/

 @property(nonatomic, assign) BOOL showMapPoiIcons DEPRECATED_ATTRIBUTE;

New properties

/** Controls the framerate of the map for non user interaction camera changes ( navigation, inertia, etc. ). Default is 30 fps. */

@property(nonatomic, assign) NSInteger frameRate;

/** Controls how the map is viewed while in 3D mode. Changing the properties of cameraSettings directly does not have any effect. You must configure your SK3DCameraSettings object then assign it to this property.
*/
@property(nonatomic, strong) SKCameraSettings *cameraSettings;

/** BETA: Controls if the map is transparent or opaque. Default is NO.

 */

@property(nonatomic, assign) BOOL transparencyEnabled;

SKMapView class

Removed deprecated properties

/** Allows or stops the map rendering when the map is visible. Default value is YES. When the map is not visible, rendering is automatically stopped. DPERECATED: Use the enabledRendering property of SKMapSettings.*/

@property(nonatomic, assign) BOOL enabledRendering DEPRECATED_ATTRIBUTE;

/** Manages the displaying of debug information, like the center coordinate of the map and the zoom level. By default is set to NO. DPERECATED: Use the showDebugView property of SKMapSettings.*/

@property(nonatomic, assign) BOOL showDebugView DEPRECATED_ATTRIBUTE;

SKNavigationDelegate class

Removed deprecated callbacks

/** Called when the current or next advice instruction is changed. Deprecated: use the routingService:didUpdateFilteredAudioInstruction:forLanguage: callback
@param routingService The routing service.
@param currentAdviceInstruction The instruction of the current advice.
@param nextAdviceInstruction The instruction of the next advice.
*/
- (void)routingService:(SKRoutingService *)routingService didChangeCurrentAdviceInstruction:(NSString *)currentAdviceInstruction nextAdviceInstruction:(NSString *)nextAdviceInstruction DEPRECATED_ATTRIBUTE;

/**
skFirstVisualAdviceChanged:secondaryVisualAdviceChanged:isLastAdvice:withRouteState: is called when the first or secondary visual advice is changed, or the last advice exists before reaching the destination.
@param routingService - The routing service
@param isFirstVisualAdviceChanged It indicates the changing of the first visual advice.
@param isSecondaryAdviceChanged It indicates the changing of the secondary visual advice.
@param isLastAdvice Specifies if this is the last visual advice before reaching the destination.
@param currentAdvice Contains information about the current advice.
@param nextAdvice Contains information about the next advice.
@param secondAdvice Contains information about the second advice.
*/
- (void)routingService:(SKRoutingService *)routingService didChangeFirstVisualAdvice:(BOOL)isFirstVisualAdviceChanged withSecondVisualAdvice:(BOOL)isSecondaryAdviceChanged lastAdvice:(BOOL)isLastAdvice currentAdvice:(SKRouteAdvice *)currentAdvice nextAdvice:(SKRouteAdvice *)nextAdvice secondAdvice:(SKRouteAdvice *)secondAdvice DEPRECATED_ATTRIBUTE;

SKNavigationSettings class

Removed deprecated properties

/** Used for changing the position of the car position icon on the vertical axis. It is a scale which indicates the distance between the icon and the center of the screen (in [ -0.5, 0.5 ] interval).
The default value is -0.25. DEPRECATED: Use the vertical member of the positionerAlignment property.
*/
@property(nonatomic, assign) float positionerVerticalAlignment DEPRECATED_ATTRIBUTE;

/** Used for changing the position of the car position icon on the horizontal axis. It is a scale which indicates the distance between the icon and the center of the screen (in [ -0.5, 0.5 ] interval).
The default value is 0. DEPRECATED: Use the horizontal member of the positionerAlignment property.
*/
@property(nonatomic, assign) float positionerHorizontalAlignment DEPRECATED_ATTRIBUTE;

/** Sets the threshold for speed warning callbacks inside cities. If the current speed is greater than current speed limit + speedWarningThresholdInCity, the routingService:didUpdateSpeedWarningToStatus:withAudioWarnings:insideCity: callback from the SKNavigationDelegate is called. DEPRECATED: Use the inCity member of the speedWarningThreshold property.
*/
@property(nonatomic, assign) double speedWarningThresholdInCity DEPRECATED_ATTRIBUTE;

/** Sets the threshold for speed warning callbacks outside cities. If the current speed is greater than current speed limit + speedWarningThresholdOutsideCity, the routingService:didUpdateSpeedWarningToStatus:withAudioWarnings:insideCity: callback from the SKNavigationDelegate is called. DEPRECATED: Use the outsideCity member of the speedWarningThreshold property.
*/
@property(nonatomic, assign) double speedWarningThresholdOutsideCity DEPRECATED_ATTRIBUTE;

/** Marks the path behind the current position with trail settings. DEPRECATED: Use the trailSettings property of the SKMapSettings object.
*/
@property(nonatomic, strong) SKTrailSettings *trail DEPRECATED_ATTRIBUTE;

SKRouteAlternativeSettings class

Deprecated properties

/** Indicates whether to avoid toll roads when calculating the route. DPERECATED: Use the avoidTollRoads member of the routeRestrictions property.
*/
@property(nonatomic, assign) BOOL avoidTollRoads DEPRECATED_ATTRIBUTE;

/** Indicates whether to avoid highways (Motorways & Motorway links) when calculating the route. DPERECATED: Use the avoidHighways member of the routeRestrictions property.
*/
@property(nonatomic, assign) BOOL avoidHighways DEPRECATED_ATTRIBUTE;

/** Indicates whether to avoid ferry lines when calculating the route. DPERECATED: Use the avoidFerryLines member of the routeRestrictions property.
*/
@property(nonatomic, assign) BOOL avoidFerryLines DEPRECATED_ATTRIBUTE;

/** Indicates whether to avoid roads that make the user walk along his bike when calculating the route. DPERECATED: Use the avoidBicycleWalk member of the route restrictions property. DPERECATED: Use the avoidBicycleWalk member of the routeRestrictions property.
*/
@property(nonatomic, assign) BOOL avoidBicycleWalk DEPRECATED_ATTRIBUTE;

/** Indicates whether to avoid roads that make the user carry his bike when calculating the route. DPERECATED: Use the avoidBicycleCarry member of the route restrictions property. DPERECATED: Use the avoidBicycleCarry member of the routeRestrictions property.
*/
@property(nonatomic, assign) BOOL avoidBicycleCarry DEPRECATED_ATTRIBUTE;

SKPositionerService class

Removed deprecated property

/** The current position stored by the library, in the SKPosition format. DEPRECATED: Use the currentCoordinate property for for getting the current position.
*/
@property(nonatomic, readonly, assign) SKPosition currentPosition DEPRECATED_ATTRIBUTE;

New property

/** Allow or forbid location update pause when movement is not detected. This is useful for optimizing battery life. Default is YES.
If this property is YES, battery life can be prolonged but if the app is in background it may be completely suspended after a while, thus it may be undesirable for background navigation.
If the property is NO, the battery life may suffer but your app will receive location updates even if the device is stationary.
In a real life situation it is recommended that this property is YES because if the the app is in background it will be resumed periodically, whenever the location is updated.
*/
@property(nonatomic, assign) BOOL automaticLocationUpdatePause;

SKNearbySearchSettings class

/** The radius of the searched area, in meters.
*/
@property(nonatomic, assign) int radius;

type changed to

/** The radius of the searched area, in meters. Please pick a value from the interval of an unsigned integer(0-65535).
*/
@property(nonatomic, assign) unsigned int radius;

SKRealreachSettings class

New property

/** If this value is YES, the real reach will be calculated considering that the user wants to get back to the start position of the reach. The default value of this property is NO.
*/
@property(nonatomic, assign, getter=isRoundTrip) BOOL roundTrip;

SKRouteAdvice class

New property

/** The functional classification of a road is the class, or group, of roads that the road belongs to. Roads with functional class FunctionalClassification1 are the most important, fastest roads.(e.g. highways)
*/
@property(nonatomic, assign) SKFunctionalClassification functionalClassification;

SKRouteSettings class

/** The number of routes to be calculated, including alternatives. Setting this property to a value > 1 is enough for getting basic route alternatives. Default value is 1.
*/
@property(nonatomic, assign) NSUInteger numberOfRoutes;

/** Route calculation modes for alternative routes, an array of SKRouteAlternativeSettings objects. If nil, default alternatives will be generated.
*/
@property(nonatomic, strong) NSArray *alternativeRoutesModes;

changed to

/** The maximum number of routes returned by the SDK. Default value is 1. In some cases you would like to calculate more routes then the number specified by this property and to get the best routes limited by this number. For configuring the desired alternative routes please see the documentation of the SKRouteAlternativeSettings class.
*/
@property(nonatomic, assign) NSUInteger maximumReturnedRoutes;

/** Route calculation modes for alternative routes, an array of SKRouteAlternativeSettings objects. If nil, default alternatives will be generated.
*/
@property(nonatomic, strong) NSArray *alternativeRouteCalculations;

New property

/** Indicates whether to filter/remove the alternatives that are too similar with the previous calculated ones. Two routes are considered similar if less than 10% of them are different.
*/
@property(nonatomic, assign) BOOL filterAlternatives;

Removed deprecated properties

/** Indicates whether to avoid toll roads when calculating the route. DPERECATED: Use the avoidHighways member of the route restrictions property.
*/
@property(nonatomic, assign) BOOL avoidTollRoads DEPRECATED_ATTRIBUTE;

/** Indicates whether to avoid highways (Motorways & Motorway links) when calculating the route. DPERECATED: Use the avoidHighways member of the routeRestrictions property.
*/
@property(nonatomic, assign) BOOL avoidHighways DEPRECATED_ATTRIBUTE;

/** Indicates whether to avoid ferry lines when calculating the route. DPERECATED: Use the avoidFerryLines member of the routeRestrictions property.
*/
@property(nonatomic, assign) BOOL avoidFerryLines DEPRECATED_ATTRIBUTE;

/** Indicates whether to avoid roads that make the user walk along his bike when calculating the route. DPERECATED: Use the avoidBicycleWalk member of the routeRestrictions property.
*/
@property(nonatomic, assign) BOOL avoidBicycleWalk DEPRECATED_ATTRIBUTE;

/** Indicates whether to avoid roads that make the user carry his bike when calculating the route. DPERECATED: Use the avoidBicycleCarry member of the routeRestrictions property.
*/
@property(nonatomic, assign) BOOL avoidBicycleCarry DEPRECATED_ATTRIBUTE;

Deprecated properties

/** The number of routes to be calculated, including alternatives. Setting this property to a value > 1 is enough for getting basic route alternatives. Default value is 1. DEPRECATED: Use maximumReturnedRoutes. */

@property(nonatomic, assign) NSUInteger numberOfRoutes DEPRECATED_ATTRIBUTE;

/** Route calculation modes for alternative routes, an array of SKRouteAlternativeSettings objects. If nil, default alternatives will be generated. DEPRECATED: Use alternativeRouteCalculations. */

@property(nonatomic, strong) NSArray *alternativeRoutesModes DEPRECATED_ATTRIBUTE;