Changelog ¶

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog , and this project adheres to Semantic Versioning .

[7.1.25.3.9ED2450F] - 2025-01-15 ¶

Added ¶

New class available: OTRouteObject
New method available in MapViewController.h :

(void)applyStyleWithFilePath:(nonnull NSString *)filePath smoothTransition:(BOOL)smooth
New method available in MapViewControllerDelegate.h :

(BOOL)mapViewController:(nonnull MapViewController *)mapViewController onRenderMapScale:(NSInteger)width scaleValue:(nonnull NSString *)value scaleUnits:(nonnull NSString *)units
New methods available in MapViewPreferencesContext.h :

(void)showMapScale:(BOOL)status

(BOOL)isMapScaleShown

(void)setMapScalePosition:(CGRect)rect

(CGRect)getMapScalePosition
New method available in RecorderContext.h :

(nonnull NSString*)getCurrentRecordPath
New method available in RouteObject.h :

(BOOL)isEVRoute

(BOOL)isOTRoute

(nullable RouteObject *)toEVRoute

(nullable RouteObject *)toOTRoute
New members for EBikeProfileDetails struct:

float batteryCapacity

float departureSoc

float refSpeed

bool ignoreLegalRestrictions

[7.1.24.48.527A3CD3] - 2024-11-27 ¶

Added ¶

New methods available in AlarmContext.h :

(void)grabSafetyCameraOfflineDataWithCompletionHandler:(nonnull void(^)(BOOL success))handler

(void)cancelGrabSafetyCameraOfflineData
New methods available in ImageObject.h :

(CGSize)getAspectRatio

(BOOL)isScalable
New methods available in LogBookmarksContext.h :

(nonnull NSArray <NSString *> *)getLogsSorted:(LogFileSortingOrder)order sortingType:(LogFileSortingType)sortingType

(SDKErrorCode)exportLog:(nonnull NSString *)filePath toFileType:(LogFileType)fileType exportedFileName:(nonnull NSString *)exportedFileName positionDistance:(double)positionDistance

(SDKErrorCode)importLog:(nonnull NSString *)filePath importedFileName:(nullable NSString*)fileName

(NSInteger)getLogDurationInSeconds:(nonnull NSString *)filePath

(nullable NSData *)getUserMetadata:(nonnull NSString *)filePath keyString:(nonnull NSString *)keyString
New methods available in MapViewController.h :

(void)skipAnimation:(BOOL)jumpToDestination

(nullable MapCameraObject *)getMapCamera

(void)setMaxZoomLevel:(int)level

(void)setMinZoomLevel:(int)level

(int)getMinZoomLevel

(void)setTouchViewBehaviour:(TouchViewBehaviour)behaviour completionHandler:(nullable void(^)(MarkerObject * _Nullable market))handler

setTouchViewBehaviour:(TouchViewBehaviour)behaviour didStartTouchHandler:(nullable void(^)(MarkerCollectionObject * _Nullable marketCollection))startTouchHandler didFinishTouchHandler:(nullable void(^)(MarkerObject * _Nullable market))finishTouchHandler
New property available in MapViewRouteRenderSettings.h :

@property(nonatomic, assign) double waypointImageSize
New API available in OverlayServiceContext.h :

(void)grabOverlayOfflineData:(int)uid completionHandler:(nonnull void(^)(BOOL success))handler

(void)cancelGrabOverlayOfflineData:(int)uid
New API available in RecorderConfigurationObject.h :

(void)setMinDurationSeconds:(NSUInteger)value
New API available in RecorderContext.h :

(SDKErrorCode)pauseRecording

(SDKErrorCode)resumeRecording
New API available in RoutePreferencesObject.h :

(float)getFitnessFactor

setFitnessFactor:(float)factor

(RoutePathAlgorithmType)getPathAlgorithm

(void)setPathAlgorithm:(RoutePathAlgorithmType)algorithmType

(RoutePathAlgorithmFlavorType)getPathAlgorithmFlavor

(void)setPathAlgorithmFlavor:(RoutePathAlgorithmFlavorType)flavorType
New API available in SearchContext.h :

(void)setEasyAccessOnlyResults:(BOOL)state

(BOOL)getEasyAccessOnlyResults
New methods available in SwiftUI.MapView :

(nonnull CoordinatesObject *)getCoordinates

(int)getDistance

(int)getTimestamp

[7.1.24.38.4443F8E9] - 2024-09-16 ¶

Added ¶

New method available in MapViewController.h :

(void)setCompassInsets:(UIEdgeInsets)insets
New methods available in MapViewPreferencesContext.h :

(void)setMapLabelsContinuousRendering:(BOOL)status

(BOOL)getMapLabelsContinuousRendering

(BOOL)getDisableFastLoading

(void)setDisableFastLoading:(BOOL)status
New methods available in MarkerObject.h :

(instancetype)initWithCircleCenter:(nonnull CoordinatesObject*)coordinates radius:(int)radius

(instancetype)initWithRectangleShapeCenter:(nonnull CoordinatesObject *)coordinates horizRadius:(int)horizRadius vertRadius:(int)vertRadius

(instancetype)initWithRectangleFirstCorner:(nonnull CoordinatesObject *)corner1 secondCorner:(nonnull CoordinatesObject*)corner2
New methods available in TimeDistanceCoordinatesObject.h :

(nonnull CoordinatesObject *)getCoordinates

(int)getDistance

(int)getTimestamp

[7.1.24.20.093088C8] - 2024-05-27 ¶

Added ¶

New methods available in MapViewController.h :

(BOOL)hasTerrainTopography

(double)getAltitude:(nonnull CoordinatesObject *)location;

(void)setWatermarkText:(nonnull NSString *)line1 line2:(nonnull NSString *)line2
New method available in MapViewControllerDelegate.h

(void)mapViewController:(nonnull MapViewController *)mapViewController didTapCompass:(FollowPositionMapRotationMode)mode
New methods available in GEMKit.MapBase :

func mapCompassSize(_ size: CoreFoundation.CGFloat) -> GEMKit.MapBase

func mapUserInteraction(_ state: Swift.Bool) -> GEMKit.MapBase

func didTapCompass(_ action: @escaping (_ mode: GEMKit.FollowPositionMapRotationMode) -> Swift.Void) -> GEMKit.MapBase

func onConnectedStatusUpdated(_ action: @escaping (_ connected: Swift.Bool) -> Swift.Void) -> GEMKit.MapBase

func onWorldwideRoadMapSupportEnabled(_ action: @escaping () -> Swift.Void) -> GEMKit.MapBase

func onWorldwideRoadMapSupportDisabled(_ action: @escaping (_ reason: GEMKit.ReasonType) -> Swift.Void) -> GEMKit.MapBase

func onWorldwideRoadMapUpdateStarted(_ action: @escaping () -> Swift.Void) -> GEMKit.MapBase

func onWorldwideRoadMapUpdateFinished(_ action: @escaping (_ success: Swift.Bool) -> Swift.Void) -> GEMKit.MapBase
New methods available in GEMKit.MapProxy :

func setPositionTrackerVisibility(_ visibility: Swift.Bool)

func setPositionTrackerScaleFactor(_ factor: Swift.Double)

[7.1.24.20.8B92211B] - 2024-05-15 ¶

Fixed ¶

Fix related to route simulation

[7.1.24.20.5A74CA04] - 2024-05-14 ¶

Added ¶

New method available in DataSourceContext.h :

(nonnull NSString*)getLogPath
New method available in DriverAssistanceContext.h :

(instancetype)initWithContext:(nonnull DataSourceContext *)context tuningParameters:(nullable MagicADASTuningParameters *)tuningParameters
GEMKit for SwiftUI new APIs: MapBase , MapReader , MapProvider and MapCoordinator .

[7.1.24.17.D3970963] - 2024-04-23 ¶

Added ¶

New methods available in GEMSdk.h :

(nullable NSData *)compress:(nonnull NSData *)data

(nullable NSData *)uncompress:(nonnull NSData *)data

(BOOL)isLogSilent
New methods available in NavigationInstructionObject.h :

(void)presentRoutes:(nonnull NSArray<RouteObject *> *)array withTraffic:(nullable TrafficContext *)trafficContext showSummary:(BOOL)summary displayMode:(RouteDisplayMode)mode animationDuration:(NSTimeInterval)duration completionHandler:(nonnull void(^)(BOOL success))handler

(void)centerOnRoutes:(nonnull NSArray<RouteObject *> *)array displayMode:(RouteDisplayMode)mode rectangle:(CGRect)rect animationDuration:(NSTimeInterval)duration completionHandler:(nonnull void(^)(BOOL success))handler

(SDKErrorCode)generateRouteGeometry:(nonnull NSData *)data routeRenderSettings:(MarkerObjectRenderSettings)renderSettings connectionsRenderSettings:(MarkerObjectRenderSettings)connectionsSettings

(void)removeRouteGeometry

(SDKErrorCode)generateNavigationInstructionGeometry:(nonnull NSData *)data renderSettings:(MarkerObjectRenderSettings)renderSettings

(void)removeNavigationInstructionGeometry
New methods available in NavigationInstructionObject.h :

(float)getBatterySoC

(nullable NSData *)exportAs:(PathFileFormat)format withCompresion:(BOOL)compressed

New methods available in RoutePreferencesObject.h :

(void)setBuildConnections:(BOOL)state maxLengthM:(int)maxLengthM

(BOOL)getBuildConnections

(int)getBuildConnectionsMaxLength
New methods available in SwiftUI.MapView :

func present(highlights: [GEMKit.LandmarkObject], settings: GEMKit.HighlightRenderSettings, highlightId: Swift.Int = 0, duration: Swift.Double = -1, action: ((_ finished: Swift.Bool) -> Swift.Void)? = nil)

func remove(highlightId: Swift.Int)

func removeAllHighlights()

func present(routes: [GEMKit.RouteObject], bubbleSummary: Swift.Bool = false, trafficContext: GEMKit.TrafficContext? = nil, displayMode: GEMKit.RouteDisplayMode = .full, duration: Swift.Double = -1, action: ((_ finished: Swift.Bool) -> Swift.Void)? = nil)

func remove(routes: [GEMKit.RouteObject])

func removeAllRoutes()

func centerOn(routes: [GEMKit.RouteObject], displayMode: GEMKit.RouteDisplayMode = .full, rectangle: CoreFoundation.CGRect = CGRect.zero, duration: Swift.Double = 0, action: ((_ finished: Swift.Bool) -> Swift.Void)? = nil)

func setMain(route: GEMKit.RouteObject)

func isMain(route: GEMKit.RouteObject) -> Swift.Bool

func getMainRoute() -> GEMKit.RouteObject?

Fixed ¶

Xcode Preview crash for MapView.

[7.1.24.16.F295FF8E] - 2024-04-16 ¶

Added ¶

GEMKit for SwiftUI is now available.

Changed ¶

New methods available in MapViewController.h :

(void)centerOnCoordinates:(nonnull CoordinatesObject *)location zoomLevel:(int)level point:(CGPoint)point mapAngle:(double)mapAngle viewAngle:(double)viewAngle animationDuration:(NSTimeInterval)duration completionHandler:(nonnull void(^)(BOOL finished))handler

(void)addMarker:(nonnull MarkerCollectionObject *)markerCollection renderSettings:(MarkerCollectionObjectRenderSettings)renderSettings animationDuration:(NSTimeInterval)duration completionHandler:(nonnull void(^)(BOOL finished))handler

(void)presentHighlights:(nonnull NSArray<LandmarkObject *> *)highlights settings:(nonnull HighlightRenderSettings *)settings highlightId:(int)highlightId animationDuration:(NSTimeInterval)duration completionHandler:(nonnull void(^)(BOOL finished))handler
New methods available in MapViewControllerDelegate.h

(void)mapViewController:(nonnull MapViewController *)mapViewController didSelectLandmarks:(nonnull NSArray <LandmarkObject *> *)landmarks onTouchPoint:(CGPoint)point

(void)mapViewController:(nonnull MapViewController *)mapViewController didSelectLandmarks:(nonnull NSArray <LandmarkObject *> *)landmarks onLongTouchPoint:(CGPoint)point

(void)mapViewController:(nonnull MapViewController *)mapViewController didSelectRoutes:(nonnull NSArray<RouteObject *> *)routes onTouchPoint:(CGPoint)point

(void)mapViewController:(nonnull MapViewController *)mapViewController didSelectOverlays:(nonnull NSArray<OverlayItemObject *> *)overlays onTouchPoint:(CGPoint)point

(void)mapViewController:(nonnull MapViewController *)mapViewController didSelectOverlays:(nonnull NSArray<OverlayItemObject *> *)overlays onLongTouchPoint:(CGPoint)point

(void)mapViewController:(nonnull MapViewController *)mapViewController didSelectTrafficEvents:(nonnull NSArray<TrafficEventObject *> *)events onTouchPoint:(CGPoint)point

(void)mapViewController:(nonnull MapViewController *)mapViewController didSelectTrafficEvents:(nonnull NSArray<TrafficEventObject *> *)events onLongTouchPoint:(CGPoint)point
New methods available in RouteInstructionObject.h :

(BOOL)hasRoadInfo

(nonnull NSArray <RoadInfoObject *> *)getRoadInfo

(nullable UIImage*)getRoadInfoImage:(CGSize)size

[7.1.24.13.6FE96C8C] - 2024-04-02 ¶

Changed ¶

SDK contains now Privacy Nutrition Label.
New method available in CameraRenderViewController.h :

(void)renderWithMagicADAS:(nullable MagicADASContext*)context
New method available in ContentStoreObject.h :

(void)downloadWithAllowCellularNetwork:(BOOL)allowCellularNetwork progressHandler:(nonnull void(^)(int progress))progressHandler priority:(ContentDownloadThreadPriority)priority completionHandler:(nonnull void(^)(BOOL success))completionHandler
New methods available in DataSourceContext.h :

(nullable instancetype)initDummyPlayback

(nullable instancetype)initWithFilePath:(nonnull NSString *)filePath

(nullable instancetype)initWithRoute:(nonnull RouteObject *)route

(nullable instancetype)initWithExternalSource:(nonnull DataSourceContext *)dataSource

(nullable instancetype)initWithExternalDataTypes:(nonnull NSArray < NSNumber *> *)dataTypes

(nonnull NSString*)getDataTypeDescription:(DataType)type

(nonnull NSArray <NSNumber *> *)getAvailableDataTypes

(nullable DataObject *)getLatestData:(DataType)type

(void)stopDelegateNotifications

(BOOL)pushData:(nonnull DataObject *)dataObject
New methods available in DataSourceContextDelegate.h :

(void)dataSourceContext:(nonnull DataSourceContext *)dataSourceContext onNewData:(nonnull DataObject *)dataObject
New methods available in DriverAssistanceContext.h :

(SDKErrorCode)createSensorDataLoggerWithSecondsToKeep:(int)secondsToKeep recordCameraFrames:(BOOL)recordCameraFrames

(SDKErrorCode)saveSensorDataLog:(NSString *)outputDir logName:(NSString *)logName
New methods available in FollowPositionPreferencesContext.h :

(void)setTouchHandlerModifyHorizontalAngleLimits:(nonnull NSArray <NSNumber *> *)horizAngleLimits

(nonnull NSArray <NSNumber *> *)getTouchHandlerModifyHorizontalAngleLimits

(void)setTouchHandlerModifyVerticalAngleLimits:(nonnull NSArray <NSNumber *> *)horizAngleLimits

(nonnull NSArray <NSNumber *> *)getTouchHandlerModifyVerticalAngleLimits

(void)setTouchHandlerModifyDistanceLimits:(nonnull NSArray <NSNumber *> *)horizAngleLimits

(nonnull NSArray <NSNumber *> *)getTouchHandlerModifyDistanceLimits
New methods available in GEMSdk.h :

(BOOL)initCoreSdk:(NSString*)authorizationKey

(SDKErrorCode)initCoreSdk:(nonnull NSString *)authorizationKey language:(nonnull NSString *)language completionHandler:( void(^)(SDKErrorCode) )handler

(void)setMapLanguage:(MapLanguageType)type

(MapLanguageType)getMapLanguage
New methods available in MagicADASContext.h :

(BOOL)setVanishingPointPosition:(int)vanishingPointX vanishingPointY:(int)vanishingPointY vanishingPointZ:(int)vanishingPointZ

(BOOL)setVehicleHoodPosition:(int)verticalOffset confidence:(float)confidence

(void)destroy

(void)resetCalibrationParameters

(void)attachRecorderConfiguration:(nonnull RecorderConfigurationObject *)configuration

(void)detachRecorderConfiguration:(nonnull RecorderConfigurationObject *)configuration

(SDKErrorCode)createSensorDataLoggerWithSecondsToKeep:(int)secondsToKeep recordCameraFrames:(BOOL)recordCameraFrames

(SDKErrorCode)saveSensorDataLog:(NSString *)outputDir logName:(NSString *)logName
New methods available in MagicADASContextDelegate.h :

(void)magicADASContext:(nonnull MagicADASContext *)context onHeadwayWarningEvent:(HeadwayWarningEvent)event obstacle:(ObstacleObject)vehicle timestamp:(NSInteger)timestamp

(void)magicADASContext:(nonnull MagicADASContext *)context onForwardCollisionWarningEvent:(ForwardCollisionWarningEvent)event obstacle:(ObstacleObject)vehicle timestamp:(NSInteger)timestamp

(void)magicADASContext:(nonnull MagicADASContext *)context onPedestrianCollisionWarningEvent:(PedestrianCollisionWarningEvent)event obstacle:(ObstacleObject)vehicle timestamp:(NSInteger)timestamp

(void)magicADASContext:(nonnull MagicADASContext *)context onStopAndGoAssistEvent:(StopAndGoAssistEvent)event obstacle:(ObstacleObject)vehicle timestamp:(NSInteger)timestamp
All delegate methods from MagicADASContextDelegate.h are now optional.
New methods available in MapViewController.h :

(BOOL)isDefaultPositionTrackerVisible

(BOOL)isDefaultPositionTrackerVisible:(CGRect)rectangle

New methods available in MapViewControllerDelegate.h :

(BOOL)shouldSelectLandmark:(nonnull MapViewController *)mapViewController

(BOOL)shouldSelectStreets:(nonnull MapViewController *)mapViewController

(BOOL)shouldSelectRoute:(nonnull MapViewController *)mapViewController

(BOOL)shouldSelectOverlays:(nonnull MapViewController *)mapViewController

(BOOL)shouldSelectTrafficEvents:(nonnull MapViewController *)mapViewController

New property available in MapViewRouteRenderSettings.h :

RouteLineType lineType;

New method available in NavigationContext.h :

(BOOL)isCalculatingRoute
New methods available in NavigationInstructionObject.h :

(nullable RouteInstructionObject *)getNextInstruction

(nullable RouteInstructionObject *)getNextNextInstruction

New methods available in PositionObject.h :

                (nullable PositionObject *)createPosition:(NSInteger)timestamp
                                latitude:(double)latitude longitude:(double)longitude altitude:(double)altitude
                                  course:(double)course
                                   speed:(double)speed
                           speedAccuracy:(double)speedAccuracy
                      horizontalAccuracy:(double)horizontalAccuracy
                        verticalAccuracy:(double)verticalAccuracy
                          courseAccuracy:(double)courseAccuracy

               

(nullable RouteInstructionObject *)getNextNextInstruction

(BOOL)hasRoadLocalization

(nonnull NSString*)getRoadAddressFieldNameWithType:(AddressSearchFieldType)type

(int)getRoadModifier

(double)getRoadSpeedLimit

(nonnull NSArray <RoadInfoObject *> *)getRoadInfo

(nullable UIImage*)getRoadCodeImage:(CGSize)size

(nullable UIImage*)getRoadCodeImage:(CGSize)size scale:(CGFloat)scale ppi:(NSInteger)ppi

New methods available in RouteInstructionObject.h :

(BOOL)isExit

(nonnull NSString *)getExitDetails

(BOOL)isCommon

(BOOL)isEV

New methods available in RouteObject.h :

(nonnull NSArray<LandmarkObject *> *)getWaypoints:(RouteWaypointsOption)option

(nonnull NSArray <NSString *> *)getDominantRoads

(nullable PathObject *)getRouteTrack

(nullable SearchableParameterListObject *)getExtraInfo

(void)setExtraInfo:(nonnull SearchableParameterListObject *)list

New methods available in RoutePreferencesObject.h :

(BOOL)getAllowOnlineCalculation

(void)setAllowOnlineCalculation:(BOOL)state

New method available in TrafficEventObject.h :

(nullable UIImage*)getImage:(CGSize)size scale:(CGFloat)scale ppi:(NSInteger)ppi

New method available in TurnDetailsObject.h :

(TurnSimplifiedType64)getTurnId64

New classes available: AccelerationObject , CameraObject , DataObject , EVRouteObject , RotationObject , RouteObjectDelegate
New SwiftUI struct available: MapView

[7.1.24.3.755A6098] - 2024-01-15 ¶

Changed ¶

New methods available in DriverAssistanceContext.h :

(void)attachRecorderConfiguration:(nonnull RecorderConfigurationObject *)configuration

(void)detachRecorderConfiguration:(nonnull RecorderConfigurationObject *)configuration
New method available in GEMSdk.h :

(SDKErrorCode)getStripePublicKeyInTestMode:(BOOL)testMode completionHandler:(nonnull void(^)(NSString *session, SDKErrorCode error))handler

(SDKErrorCode)getStripeSessionInTestMode:(BOOL)testMode amount:(double)amount currency:(nonnull NSString *)currency completionHandler:(nonnull void(^)(NSString *session, SDKErrorCode error))handler
New method available in MapViewController.h :

(void)setOnMapViewRendered:(nonnull void (^)(ViewDataTransitionStatus status, ViewCameraTransitionStatus cameratatus))handler

(void)resetOnMapViewRenderedCompletion

(void)centerOnRoutes:(nonnull NSArray<RouteObject *> *)array displayMode:(RouteDisplayMode)mode animationDuration:(NSTimeInterval)duration completionHandler:(nonnull void(^)(BOOL success))handler

(nullable UIImage *)snapshotImageWithSize:(CGSize)size captureRect:(CGRect)rect
New method available in MapViewPreferencesContext.h :

(BOOL)getMapLabelsFading

(void)setMapLabelsFading:(BOOL)status

[7.1.23.47.08560DD1] - 2023-11-24 ¶

Changed ¶

New methods available in MapStyleContext.h :

(nullable ContentStoreObject *)getItemById:(NSInteger)contentId

(void)refreshContentStore
New method available in MapViewController.h :

(nullable CoordinatesObject *)getPositionTrackerCoordinates

(void)setPositionTrackerCoordinates:(nonnull CoordinatesObject *)coordinates

(CameraOrientationAngles)getPositionTrackerOrientation

(void)setPositionTrackerOrientation:(CameraOrientationAngles)orientation

(BOOL)getPositionTrackerVisibility

(void)setPositionTrackerVisibility:(BOOL)state

(CGRect)getPositionTrackerScreenRect

(nullable NSData *)saveStatePositionTracker

(SDKErrorCode)restoreStatePositionTracker:(nonnull NSData *)data

(double)getTrackingObjectHeading

(double)getTrackingObjectPitch

(double)getTrackingObjectDistance

(double)getTrackingObjectZoomFactor
New method available in MapViewControllerDelegate.h :

(void)mapViewController:(nonnull MapViewController *)mapViewController onDoubleTouch:(CGPoint)position

(void)mapViewController:(nonnull MapViewController *)mapViewController onTwoTouches:(CGPoint)position

(void)mapViewController:(nonnull MapViewController *)mapViewController onShove:(double)pointersAngleDeg initial:(CGPoint)initial start:(CGPoint)start end:(CGPoint)end

(void)mapViewController:(nonnull MapViewController *)mapViewController didSelectTrafficEvents:(nonnull NSArray<TrafficEventObject *> *)events
New method available in NavigationContext.h :

(SDKErrorCode)setRouteRoadBlock:(nonnull RouteInstructionObject *)object

(void)resetRouteRoadBlocks

(nonnull TransferStatisticsContext *)getTransferStatistics

(SDKErrorCode)skipNextIntermediateDestination
New method available in NavigationContextDelegate.h :

(void)navigationContext:(nonnull NavigationContext *)navigationContext onSkipNextIntermediateDestinationDetected:(BOOL)state
New method available in PositionObject.h :

(BOOL)hasTerrainData

(double)getTerrainAltitude

(double)getTerrainSlope
New method available in SoundContext.h :

(BOOL)isSessionInterrupted
New method available in TimeDistanceObject.h :

(NSString*)getFormattedDistance:(int)value

(NSString*)getFormattedDistanceUnit:(int)value
New method available in TrafficContext.h :

(nullable TrafficEventObject *)addPersistentRoadblock:(nonnull CircleGeographicAreaObject*)circleArea startTime:(nonnull TimeObject *)startUTC expireTime:(nonnull TimeObject *)expireUTC transportMode:(RouteTransportMode)transportMode identifier:(nonnull NSString *)identifier
New method available in TrafficEventObject.h :

(TrafficEventImpactZone)getImpactZone

(BOOL)isActive

(BOOL)isExpired
New classes available: CircleGeographicAreaObject, SoundContextDelegate.

[7.1.23.40.6789DC8F] - 2023-10-02 ¶

Changed ¶

New methods available in LandmarkStoreContext.h :

(nonnull NSArray <LandmarkObject *> *)getLandmarksWithRectangleGeographicArea:(nonnull RectangleGeographicAreaObject*)rectangle categoryId:(int)categoryId

(nullable NSURL *)getPreviewUrl
New method available in LandmarkStoreContextCollection.h :

(void)clear
New method available in MapViewController.h :

(nonnull NSArray <NSNumber *> *)getVisibleRouteInterval:(nonnull RouteObject *)route rect:(CGRect)rect
New method available in PositionContext.h :

(PositionDataType)getSourceType

(void)setSpeedMultiplier:(float)value
New method available in RoutePreferencesObject.h :

(void)setEmergencyVehicleMode:(BOOL)mode extraFreedom:(int)extraFreedom

(double)getDepartureHeading

(double)getDepartureHeadingAccuracy

(void)setDepartureHeading:(double)head accuracy:(double)accuracy
New method available in SearchContext.h :

(nullable OverlayMutableCollectionObject *)geOverlayMutableCollection
New classes available: IntentsContext, OverlayMutableCollectionObject.

[7.1.23.35.9E3DBD80] - 2023-08-31 ¶

Changed ¶

New method available in MapViewController.h :

(nonnull NSArray <OverlayItemObject *> *)getCursorSelectionOverlayItems
New methods available in OverlayItemObject.h :

(nullable OverlayInfoObject *)getOverlayInfo

(nullable NSURL *)getPreviewUrl

(nonnull NSString *)getPreviewData:(PreviewDataType)type

(nullable NSValue *)searchInPreviewDataSocialReportParameterType:(SocialReportParameterType)parameterType

(BOOL)hasPreviewExtendedData

(void)getPreviewExtendedDataWithCompletionHandler:(nonnull void(^)(SearchableParameterListObject *parametersList))handler

(void)cancelGetPreviewExtendedDataWithCompletionHandler:(nonnull void(^)(BOOL finished))handler

(int)getCategoryId
New methods available in RoutePreferencesObject.h :

(void)setRouteRanges:(nonnull NSArray <NSNumber *> *)array quality:(int)quality

(nonnull NSArray <NSNumber *> *)getRouteRanges

(int)getRouteRangesQuality
New methods available in RouteTerrainProfileObject.h :

(nonnull NSArray <RoadSteepSectionObject *> *)getSteepSections:(NSArray <NSNumber *> *)steepnessIntervals

(float)getElevationChartMinValueY

(float)getElevationChartMaxValueY
New class available: SearchableParameterListObject.
Bug fixing and improvements.

[7.1.23.24.F818CE1B] - 2023-06-14 ¶

Changed ¶

New method available in MapsContext.h :

(nonnull NSString*)getSizeFormatted:(double)value
New methods available in OverlayItemObject.h :

(nullable NSValue *)searchInPreviewDataSafetyCameraParameterType:(SafetyCameraParameterType)parameterType

(void)resetCacheImage
New methods available in SoundContext.h :

(void)updateSessionWithAudioOutput:(AudioOutput)audioOutput

(void)setDelay:(int)value

(int)getDelay
New classes available: TimezoneContext, TimezoneResultObject.
Bug fixing and improvements.

[7.1.23.21.0B8B1AC2] - 2023-05-25 ¶

Changed ¶

New methods available in MapViewController.h :

(void)addMarker:(nonnull MarkerCollectionObject *)markerCollection renderSettings:(MarkerCollectionObjectRenderSettings)renderSettings

(void)setTouchViewBehaviour:(TouchViewBehaviour)behaviour renderSettings:(MarkerCollectionObjectRenderSettings)renderSettings completionHandler:(nullable void(^)(NSArray <CoordinatesObject *> *))handler
New methods available in MarkerObject :

(nonnull NSArray <CoordinatesObject *> *)getCoordinates:(int)part

(void)setCoordinates:(nonnull NSArray < CoordinatesObject*> *)array

(void)setCoordinates:(nonnull NSArray < CoordinatesObject*> *)array part:(int)part

(void)add:(nonnull CoordinatesObject *)location index:(int)index part:(int)part

(void)deleleFromIndex:(int)index part:(int)part

(void)update:(nonnull CoordinatesObject *)location index:(int)index part:(int)part
Bug fixing and improvements.

[7.1.23.20.D1E234B6] - 2023-05-18 ¶

Added ¶

New method available in DataSourceContext.h :

(void)setLoopMode:(BOOL)value
New methods available in HumanVoiceContext.h :

(BOOL)isContentPreloaded

(void)preloadContentWithCompletionHandler:(void(^)(BOOL success))handler
New method available in ImageObject.h :

(instancetype)initWithDataBuffer:(nonnull NSData *)data format:(ImageFormat)format
New methods available in LandmarkObject.h :

(void)setImageData:(nonnull NSData *)data format:(ImageFormat)format

(void)resetCacheImage
New methods available in LandmarkStoreContext.h :

(void)importLandmarks:(nonnull NSString *)filePath format:(LandmarkImportFileFormat)format progressHandler:(nonnull void(^)(float progress))progressHandler completionHandler:(nonnull void(^)(SDKErrorCode code))completionHandler

- (void)importLandmarks:(nonnull NSString *)filePath format:(LandmarkImportFileFormat)format categoryId:(int)categoryId progressHandler:(nonnull void(^)(float progress))progressHandler completionHandler:(nonnull void(^)(SDKErrorCode code))completionHandler
New method available in MagicADASContextDelegate.h :

(void)magicADASContext:(nonnull MagicADASContext *)context onLaneData:(float)position timestamp:(NSInteger)timestamp
New methods available in MapsContext.h :

(BOOL)isContentPreloaded

(void)preloadContentWithCompletionHandler:(void(^)(BOOL success))handler
New methods available in MapStyleContext.h :

(BOOL)isContentPreloaded

(void)preloadContentWithCompletionHandler:(void(^)(BOOL success))handler
New methods available in MapViewController.h :

(BOOL)isDefaultFollowingPosition

(double)getPitchInDegrees

(double)getMapScale

(void)setDebugEdgeAreaVisible:(BOOL)state

(void)setTouchViewBehaviour:(TouchViewBehaviour)behaviour completionHandler:(nullable void(^)(NSArray <CoordinatesObject *> *))handler

(TouchViewBehaviour)getTouchViewBehaviour

(void)showMapLogo

(void)hideMapLogo
New method available in MapViewControllerDelegate :

(void)mapViewController:(nonnull MapViewController *)mapViewController onPinch:(CGPoint)startPoint1 startPoint2:(CGPoint)startPoint2 toPoint1:(CGPoint)endPoint1 toPoint2:(CGPoint)endPoint2 center:(CGPoint)center
Deprecated methods in GEMSdkDelegate.h :

(void)mapViewController:(nonnull MapViewController *)mapViewController onRotatePoint:(CGPoint)startPoint1 startPoint2:(CGPoint)startPoint2 toPoint1:(CGPoint)endPoint1 toPoint2:(CGPoint)endPoint2 center:(CGPoint)center delta:(double)delta

(void)mapViewController:(nonnull MapViewController *)mapViewController onPinch:(CGPoint)startPoint1 startPoint2:(CGPoint)startPoint2 toPoint1:(CGPoint)endPoint1 toPoint2:(CGPoint)endPoint2
New method available in RouteBookmarksObject :

(nullable LandmarkObject *)setWaypointTrackData:(nonnull PathObject *)pathObject

New methods available in RoutePreferencesObject :

(void)setAccurateTrackMatch:(BOOL)value

(BOOL)getAccurateTrackMatch

New methods available in NavigationInstructionObject :

(nullable UIImage*)getCurrentRoadCodeImage:(CGSize)size limit:(int)limit

(nullable UIImage*)getCurrentRoadCodeImage:(CGSize)size scale:(CGFloat)scale ppi:(NSInteger)ppi limit:(int)limit

(nullable UIImage*)getNextRoadCodeImage:(CGSize)size limit:(int)limit

(nullable UIImage*)getNextRoadCodeImage:(CGSize)size scale:(CGFloat)scale ppi:(NSInteger)ppi limit:(int)limit

(nullable UIImage*)getNextNextRoadCodeImage:(CGSize)size limit:(int)limit

(nullable UIImage*)getNextNextRoadCodeImage:(CGSize)size scale:(CGFloat)scale ppi:(NSInteger)ppi limit:(int)limit

[7.1.23.12.D3E4D7BA] - 2023-03-21 ¶

Added ¶

New methods available in GEMSdk.h :

(void)setTilesMaxSpace:(int)maxSpace

(int)getTilesMaxSpace

(void)deactivateDebugLogger
New methods available in AlarmContext :

(SDKErrorCode)enableSocialReportsWithCategory:(int)categUid

(SDKErrorCode)disableSocialReportsWithCategory:(int)categUid

(BOOL)isSocialReportsEnabledWithCategory:(int)categUid
New method available in DriverAssistanceContext :

(instancetype)initWithContext:(nonnull DataSourceContext *)context configuration:(MagicADASInitConfiguration)configuration
New methods available in FollowPositionPreferencesContext :

(void)setTouchHandlerModifyPersistent:(BOOL)persistent

(BOOL)getTouchHandlerModifyPersistent
New categories available in GenericCategoriesContext :

GenericCategoryTypeHydrants

GenericCategoryTypeEmergencyServicesSupport

GenericCategoryTypeCivilEmergencyInfrastructure
New method available in ImageObject :

(nullable UIImage*)renderImageWithSize:(CGSize)size scale:(CGFloat)scale ppi:(NSInteger)ppi
New method available in LandmarkCategoryObject :

(nullable UIImage *)getImage:(CGSize)size scale:(CGFloat)scale ppi:(NSInteger)ppi
New method available in LandmarkObject :

(nullable UIImage*)getLandmarkImage:(CGSize)size scale:(CGFloat)scale ppi:(NSInteger)ppi
New methods available in MapViewController :

(void)setFontModifiersScale:(CGFloat)value boldStyle:(BOOL)state

(void)setTextureScaleFactor:(CGFloat)value

(nonnull NSArray <LandmarkObject *> *)getHighlight:(int)highlightId

(void)centerOnRoutes:(nonnull NSArray<RouteObject *> *)array displayMode:(RouteDisplayMode)mode rectangle:(CGRect)rect animationDuration:(NSTimeInterval)duration

(void)refreshRoutesWithEdgeAreaInsets:(UIEdgeInsets)insets

(void)centerOnLocation:(nonnull LandmarkObject *)landmark rectangle:(CGRect)rect animationDuration:(NSTimeInterval)duration
New method available in MapViewControllerDelegate :

(void)mapViewController:(nonnull MapViewController *)mapViewController didUpdateMapAngle:(double)angle
New methods available in MapViewPreferencesContext :

(nullable MapViewRouteRenderSettings *)getRenderSettings:(nonnull RouteObject *)routeObject

(nonnull NSArray <MapViewRouteObject *> *)getMapViewRoutes
New property isavailable in MapViewRouteRenderSettings :

imageSize
New method available in NavigationContext :

(nullable RouteObject *)getNavigationRoute
New method available in NavigationContextDelegate :

(void)navigationContext:(nonnull NavigationContext *)navigationContext navigationInstructionUpdatedForRoute:(nonnull RouteObject *)route updatedEvents:(int)events
New methods available in NavigationInstructionObject :

(nullable UIImage*)getSignpostImage:(CGSize)size border:(NSInteger)border roundCorners:(BOOL)round rows:(NSInteger)rows

(nullable UIImage*)getSignpostImage:(CGSize)size scale:(CGFloat)scale ppi:(NSInteger)ppi border:(NSInteger)border roundCorners:(BOOL)round rows:(NSInteger)rows

(nullable UIImage*)getCurrentRoadCodeImage:(CGSize)size

(nullable UIImage*)getCurrentRoadCodeImage:(CGSize)size scale:(CGFloat)scale ppi:(NSInteger)ppi

(nullable UIImage*)getNextRoadCodeImage:(CGSize)size

(nullable UIImage*)getNextRoadCodeImage:(CGSize)size scale:(CGFloat)scale ppi:(NSInteger)ppi

(nullable UIImage*)getNextTurnImage:(CGSize)size scale:(CGFloat)scale ppi:(NSInteger)ppi

(nullable UIImage*)getNextTurnImage:(CGSize)size scale:(CGFloat)scale ppi:(NSInteger)ppi colorActiveInner:(nonnull UIColor*)colorActiveIn colorActiveOuter:(nonnull UIColor*)colorActiveOut colorInactiveInner:(nonnull UIColor*)colorInactiveIn colorInactiveOuter:(nonnull UIColor*)colorInactiveOut

(nonnull NSString*)getNextNextStreetName

(BOOL)hasNextNextRoadInfo

(nullable UIImage*)getNextNextRoadCodeImage:(CGSize)size

(nullable UIImage*)getNextNextRoadCodeImage:(CGSize)size scale:(CGFloat)scale ppi:(NSInteger)ppi

(nonnull NSArray <RoadInfoObject *> *)getNextNextRoadInformation

(nullable UIImage*)getNextNextTurnImage:(CGSize)size scale:(CGFloat)scale

(nullable UIImage*)getNextNextTurnImage:(CGSize)size colorActiveInner:(nonnull UIColor*)colorActiveIn colorActiveOuter:(nonnull UIColor*)colorActiveOut colorInactiveInner:(nonnull UIColor*)colorInactiveIn colorInactiveOuter:(nonnull UIColor*)colorInactiveOut

(nullable UIImage*)getNextNextTurnImage:(CGSize)size scale:(CGFloat)scale ppi:(NSInteger)ppi colorActiveInner:(nonnull UIColor*)colorActiveIn colorActiveOuter:(nonnull UIColor*)colorActiveOut colorInactiveInner:(nonnull UIColor*)colorInactiveIn colorInactiveOuter:(nonnull UIColor*)colorInactiveOut

BOOL)hasLaneInfo

(nullable UIImage*)getLaneImage:(CGSize)size backgroundColor:(nonnull UIColor *)backgroundColor activeColor:(nonnull UIColor *)activeColor inactiveColor:(nonnull UIColor *)inactiveColor

(nullable UIImage*)getLaneImage:(CGSize)size scale:(CGFloat)scale ppi:(NSInteger)ppi backgroundColor:(nonnull UIColor *)backgroundColor activeColor:(nonnull UIColor *)activeColor inactiveColor:(nonnull UIColor *)inactiveColor

(nonnull NSString*)getNextNextTurnInstructionFormatted

(nonnull NSString*)getDistanceToNextNextTurnFormatted

(nonnull NSString*)getDistanceToNextNextTurnUnitFormatted

(nonnull NSString*)getCurrentStreetSpeedLimitFormatted
New methods available in NavigationContextDelegate :

(void)setBikeProfile:(BikeProfile)profile withEBikeProfileDetails:(EBikeProfileDetails)eBikeProfileDetails

(EBikeProfileDetails)getEBikeProfileDetails

(EBikeProfileDetails)getDefaultEBikeProfile

(void)setStrictTrackFollow:(BOOL)state

(BOOL)getStrictTrackFollow
New methods available in SearchContext :

(nullable LandmarkStoreContextCollection *)getLandmarkStoreCollection

(BOOL)isSearchOnlyOnboardEnabled

(int)getThresholdDistance

(BOOL)removeCategory:(nonnull LandmarkCategoryObject*)category

(BOOL)removeAllCategories

(BOOL)getAllowFuzzyResults

(void)setEstimateMissingHouseNumbers:(BOOL)state

(BOOL)getEstimateMissingHouseNumbers

(void)cancelAddressSearch

(void)cancelAddressSearchCountries
New method available in SocialReportsOverlayCategoryObject :

(nullable NSValue *)searchInPreviewData:(SocialReportCategoryParameterType)parameterType
New methods available in SoundContext :

(void)playFileType:(FileAudioType)type

(void)playWarningAlert:(DriverAssistanceAudioFile)audioFile
New method available in TimeDistanceObject :

(nonnull NSMeasurement <NSUnitLength *> *)getTotalDistanceMeasurement

Changed ¶

Renamed class RoadSafetyAlertsContext into MagicADASContext .
Renamed class RoadSafetyAlertsContextDelegate into MagicADASContextDelegate .

[7.1.23.2.F5465C47] - 2023-01-11 ¶

Added ¶

Example app with projection can be found here: D3Scene/D3Scene.xcworkspace/Projections
New methods available in GEMSdk.h :

(void)useSystemTimer

(void)useDisplayLink
New method available in GEMSdkDelegate.h :

(void)onConnectionStatusUpdated:(BOOL)connected
Deprecated method in GEMSdkDelegate.h :

(void)onlineConnectionStatusChanged:(OnlineConnectionStatus)status __attribute__((deprecated("Please use 'onConnectionStatusUpdated' instead")))
New methods available in LandmarkStoreContext.h :

(BOOL)updateLandmark:(nonnull LandmarkObject*)landmark

(nonnull NSString*)getFilePath

(void)importLandmarks:(nonnull NSString *)filePath format:(LandmarkImportFileFormat)format completionHandler:(nonnull void(^)(SDKErrorCode code))handler

(void)cancelImportLandmarks
New methods available in MapViewController.h :

(void)setCompassSize:(CGFloat)size

(void)scrollMap:(CGPoint)translation

(void)flingMap:(CGPoint)velocity
New methods available in MapViewPreferencesContext.h :

(CGRect)getFocusViewport

(void)setFocusViewport:(CGRect)rect
New properties available in MapViewRouteRenderSettings.h :

waypointTextSize , waypointTextInnerColor , waypointTextOuterColor
New methods available in RouteBookmarksObject.h :

(void)setAutoDeleteMode:(BOOL)mode

(BOOL)getAutoDeleteMode
New methods available in RoutePreferencesObject.h :

(void)setIgnoreRestrictionsOverTrack:(BOOL)state

(BOOL)getIgnoreRestrictionsOverTrack

(void)setEmergencyVehicleMode:(BOOL)state

(BOOL)getEmergencyVehicleMode
New methods available in RecorderContext.h :

(NSUInteger)addUserData:(NSUInteger)dataTypeIdentifier buffer:(nonnull NSData *)data

(void)addADASCalibrationConfiguration:(nonnull DriverAssistanceContext *)context
Removed deprecated compatibility alias in CoordinatesObject.h : GeoLocation
LandmarkObject now supports NSSecureCoding protocol. This means that the object can now be encode/decode.

[7.1.22.46.8999C03E] - 2022-11-14 ¶

Added ¶

New feature available: Coordinates Projections. The SDK supports now the following projections types: W3W ( what3words ), Military Grid Reference System, British National Grid, Lambert 93, Universal Transverse Mercator and Gauss-Krueger.
Projection API: ProjectionContext , ProjectionObject , ProjectionW3WObject , ProjectionMGRSObject , ProjectionLAMObject , ProjectionBNGObject , ProjectionGKObject , ProjectionUTMObject , ProjectionWGS84Object .
Example app with projection can be found here: D3Scene/D3Scene.xcworkspace/Projections
New method available in DriverAssistanceContext.h :

(instancetype)initWithContext:(nonnull DataSourceContext *)context configuration:(RoadSafetyAlertsInitConfiguration)configuration

[7.1.22.43.A866AF6C] - 2022-10-27 ¶

Added ¶

New methods available in DataSourceConfigurationObject.h :

(void)setImprovedPositionSnapToMapLinkThresholdVehicle:(NSInteger)threshold

(void)setImprovedPositionSnapToMapLinkThresholdBike:(NSInteger)threshold

[7.1.22.41.9C5833F1] - 2022-10-13 ¶

Changed ¶

Solved app crash on iPhone Simulator with x86_64 arch (Intel Macs).
NavigationContextDelegate is now optional.

[7.1.22.41.6B0D8D54] - 2022-10-10 ¶

Added ¶

New method available in ContentStoreObject.h :

(void)downloadWithAllowCellularNetwork:(BOOL)allowCellularNetwork progressHandler:(nonnull void(^)(int progress))progressHandler completionHandler:(nonnull void(^)(BOOL success))completionHandler
Solved memory leak in map view.

[7.1.22.39.4A2FB489] - 2022-09-27 ¶

Added ¶

New method available in SearchContext.h :

(void)searchAroundWithQuery:(nonnull NSString*)query location:(nonnull CoordinatesObject *)location completionHandler:(nonnull void(^)(NSArray<LandmarkObject *> *array))handler

[7.1.22.31.C4AB7AB1] - 2022-08-04 ¶

Added ¶

GEMKit SDK now contains the following architectures: ios-arm64, ios-arm64_x86_64-maccatalyst, ios-arm64_x86_64-simulator. This means that the Sdk can run now on iPhone Simulators and also on Mac Catalyst projects.
New method available in MapViewController.h :

(CGRect)getViewport;

(MapViewPerspective)getPerspective

(void)centerOnPolygonArea:(nonnull PolygonGeographicAreaObject *)area zoomLevel:(int)level animationDuration:(NSTimeInterval)duration completionHandler:(nonnull void(^)(BOOL success))handler
- New method available in CameraRenderViewController.h :
(BOOL)isRenderActive
New method available in MapViewControllerDelegate :

(void)mapViewController:(nonnull MapViewController *)mapViewController didRender:(ViewDataTransitionStatus)dataStatus cameraTransitionStatus:(ViewCameraTransitionStatus)cameraStatus
New methods available in PathObject :

(instancetype)initWithDataBuffer:(nonnull NSData *)data format:(PathFileFormat)format

(nullable NSData *)exportAs:(PathFileFormat)format
New methods available in RouteObject :

(nullable NSData *)exportAs:(PathFileFormat)format

(nullable RoutePreferencesObject *)getPreferences
New method available in SoundContext :

(void)setUseTtsWithLanguage:(nonnull NSString *)language completionHandler:(nonnull void(^)(BOOL success))handler
New classes available: PolygonGeographicAreaObject
Renamed class ExceptionHandler.h into GEMExceptionHandler .
Deprecated class GeoLocation.h . Please use CoordinatesObject instead.

[7.1.22.18.D57E5A51] - 2022-06-30 ¶

Added ¶

New method available in GEMSdk.h :

(BOOL)initSdk:(nonnull NSString *)authorizationKey language:(nonnull NSString *)language languageTTS:(nonnull NSString *)languageTTS
Deprecated methods in MapViewController.h :

(void)centerOnGeoLocation:(nonnull GeoLocation *)location zoomLevel:(int)level animationDuration:(NSTimeInterval)duration

(void)centerOnGeoLocation:(nonnull GeoLocation *)location zoomLevel:(int)level mapAngle:(double)mapAngle viewAngle:(double)viewAngle animationDuration:(NSTimeInterval)duration

(void)centerOnGeoLocation:(nonnull GeoLocation *)location zoomLevel:(int)level point:(CGPoint)point mapAngle:(double)mapAngle viewAngle:(double)viewAngle animationDuration:(NSTimeInterval)duration
Deprecated methods in LandmarkObject.h :

(nonnull GeoLocation*)getLandmarkGeoLocation

(void)setLandmarkGeoLocation:(nonnull GeoLocation *)location
New method available in ContentStoreObject.h :

(BOOL)isNightStyle
New methods available in GenericCategoriesContext.h :

(nullable LandmarkCategoryObject *)getCategory:(GenericCategoryType)categoryType

(nonnull NSArray <LandmarkCategoryObject *> *)getPoiCategories:(int)genericCategory

(nullable LandmarkCategoryObject *)getGenericCategory:(int)poiCategory

(int)getLandmarkStoreId
Removed method in `GenericCategoriesContext.h:

(nonnull LandmarkCategoryObject *)getLandmarkCategoryObjectWithType:(GenericCategoryType)categoryType
New method available in LogBookmarksContext.h :

(BOOL)isMetadataAvailable:(nonnull NSString *)filePath
New methods available in MapViewController.h :

(BOOL)isRenderActive

(void)stopFollowingPositionWithRestoreCameraMode:(BOOL)restoreCameraMode

(void)centerOnCoordinates:(nonnull GeoLocation *)location zoomLevel:(int)level animationDuration:(NSTimeInterval)duration

(void)centerOnCoordinates:(nonnull GeoLocation *)location zoomLevel:(int)level mapAngle:(double)mapAngle viewAngle:(double)viewAngle animationDuration:(NSTimeInterval)duration

(void)centerOnCoordinates:(nonnull GeoLocation *)location zoomLevel:(int)level point:(CGPoint)point mapAngle:(double)mapAngle viewAngle:(double)viewAngle animationDuration:(NSTimeInterval)duration
New enum available in MapViewHeader.h :

MapViewTouchGestures
New methods available in MapViewPreferencesContext.h :

(nullable LandmarkStoreContextCollection *)getLandmarkStoreCollection

(BOOL)getTrafficVisibility

(SDKErrorCode)setTrafficVisibility:(BOOL)state

(SDKErrorCode)enableTouchGesture:(MapViewTouchGestures)gesture enable:(BOOL)state

(SDKErrorCode)enableTouchGestures:(NSInteger)gestures enable:(BOOL)state

(BOOL)isTouchGestureEnabled:(MapViewTouchGestures)gesture

(NSInteger)getEnabledTouchGestures
New methods available in TrafficContext.h :

(TrafficOnlineRestrictions)getOnlineServiceRestrictions:(nonnull GeoLocation *)location

(nonnull TransferStatisticsContext*)getTransferStatistics

(nullable TrafficEventObject *)addPersistentRoadblock:(nonnull NSArray <GeoLocation *> *)array startTime:(nonnull TimeObject *)startUTC expireTime:(nonnull TimeObject *)expireUTC transportMode:(RouteTransportMode)transportMode

(void)removePersistentRoadblock:(nonnull GeoLocation *)location

(void)removeAllPersistentRoadblocks

(nonnull NSArray < RouteTrafficEventObject *> *)getPersistentRoadblocks

(void)removeUserRoadblock:(nonnull TrafficEventObject *)event

(void)startPersistentRoadblockNotification

(void)stopPersistentRoadblockNotification
New classes available:

DriverBehaviourContext

DriverBehaviourAnalysisObject

DrivingScoresObject

LandmarkPositionObject

LandmarkStoreContextCollection

LandmarkStoreContextService

MappedDrivingEventObject

PersistentRoadblockDelegate

OverlayCollectionObject

OverlayHeader

OverlayInfoObject

OverlayItemPositionObject

OverlayServiceContext

SocialReportsOverlayInfoObject

TrafficEventObject

TransferStatisticsContext

[7.1.22.18.0A8870F1] - 2022-05-04 ¶

Added ¶

New method available in CameraRenderViewController.h :

(BOOL)isRenderingDriverAssistance;
New methods available in DataSourceContext.h :

(DataSourceOrigin)getOrigin

(TemperatureLevel)getTemperatureLevel

(double)getTemperatureDegrees

(SDKErrorCode)setMockDataWithPosition:(nullable MockPositionObject *)positionObject

(BOOL)isMockData:(DataType)type
New method available in DataSourceContextDelegate.h :

(void)dataSourceContext:(nonnull DataSourceContext *)dataSourceContext onTemperatureChanged:(TemperatureLevel)level degreee:(double)degree

(void)dataSourceContext:(nonnull DataSourceContext *)dataSourceContext onDeviceMountedChanged:(BOOL)isMounted isPortraitMode:(BOOL)isPortrait
New classes available: LandmarkStoreCollectionObject, MapViewRouteObject, MapViewRouteRenderSettings.h, MockPositionObject.
New methods available in GeoLocation.h :

(nonnull instancetype)coordinatesWithLatitude:(double)latitude longitude:(double)longitude altitude:(double)altitude

(double)getAzimuth:(nonnull GeoLocation*)point
New method available in LandmarkStoreContext.h :

(instancetype)initWithIdentifier:(int)identifier
New methods available in LandmarkStoreContext.h :

(CGPoint)transformWgsToScreen:(nonnull GeoLocation *)location

(nonnull NSArray <RectangleGeographicAreaObject *> *)transformScreenRectToWgs:(CGRect)rect
New methods available in MapViewPreferencesContext.h :

(nullable LandmarkStoreCollectionObject *)getLandmarkStores

(nullable PathCollectionObject *)getPaths

(nullable MarkerCollectionObject *)getMarkers

(nonnull MapViewRouteRenderSettings *)getRenderSettings:(nonnull RouteObject *)routeObject

(void)setRenderSettings:(nonnull MapViewRouteRenderSettings *)settings route:(nonnull RouteObject *)routeObject
New method available in PathObject.h :

(nullable GeoLocation *)getCoordinateAtPercent:(double)percent
New methods available in RoutePreferencesObject.h :

(int)getMinimumTransferTimeInMinutes

(void)setMinimumTransferTimeInMinutes:(int)value

(unsigned int)getMaximumTransferTimeInMinutes

(void)setMaximumTransferTimeInMinutes:(unsigned int)value

[7.1.22.8.A6D2863A] - 2022-04-01 ¶

Added ¶

New method available in GEMSdk.h :

(void)logMessage:(nonnull NSString*)string
New methods available in MapViewController.h :

(nonnull GeoLocation *)getCursorWgsPosition

(BOOL)isFollowingPositionTouchHandlerModified

(nullable PathCollectionObject *)getPaths

(void)setFlatPositionTracker

(void)setPositionTrackerScaleFactor:(double)factor

(double)getPositionTrackerScaleFactor

(double)getPositionTrackerMaxScaleFactor

(void)customizePositionTrackerGlTF:(nonnull NSData *)data
New methods available in MapViewPreferencesContext :

(int)routesCollectionSize

(nullable RouteObject *)getRoute:(int)index

(int)indexOf:(nonnull RouteObject *)route

(BOOL)isMainRoute:(nonnull RouteObject *)routeObject

(nullable RouteObject *)getMainRoute

(void)setMainRoute:(nonnull RouteObject *)routeObject

(void)setRouteLabel:(nonnull RouteObject *)routeObject label:(nonnull NSString *)string

(nullable NSString *)getRouteLabel:(nonnull RouteObject *)routeObject

(nonnull NSArray <ImageObject *> *)getRouteImages:(nonnull RouteObject *)routeObject

(void)setRouteImages:(nonnull RouteObject *)routeObject images:(nonnull NSArray <UIImage *> *)images

(BOOL)addRoute:(nonnull RouteObject *)routeObject isMainRoute:(BOOL)isMainRoute label:(nullable NSString *)label images:(nullable NSArray <UIImage *> *)images

(void)hideRouteLabel:(nonnull RouteObject *)routeObject

(void)removeRoute:(nonnull RouteObject *)routeObject

(BOOL)containsRoute:(nonnull RouteObject *)routeObject

(void)clearRoutes
New method available in NavigationContext :

(void)calculateRouteWithWaypoints:(nonnull NSArray<LandmarkObject *> *)array statusHandler:(nonnull void(^)(RouteStatus))statusHandler completionHandler:(nonnull void(^)(NSArray<RouteObject *> *array))completionHandler
New method available in PathObject :

(instancetype)initWithCoordinates:(nonnull NSArray <GeoLocation *> *)coordinates
New method available in RecorderContext :

(BOOL)isAudioRecording
New methods available in RouteBookmarksObject :

(instancetype)initWithFileName:(nonnull NSString *)file folderName:(nullable NSString *)folder

(nullable LandmarkObject *)setWaypointTrackData:(nonnull LandmarkObject *)landmarkObject path:(nonnull PathObject *)pathObject
Removed method from RouteBookmarksObject :

(instancetype)initWithName:(nonnull NSString *)name
New method available in RouteObject :

(nullable RouteObject *)toPTRoute
New method available in RouteSegmentObject :

(nonnull NSArray<PTRouteInstructionObject *> *)getPTInstructions
New method available in LogBookmarksContext.h :

(void)exportLogToPhotos:(nonnull NSString *)filePath albumName:(nonnull NSString *)albumName completionHandler:(nonnull void(^)(SDKErrorCode code))handler
New methods available in DriverAssistanceContextDelegate :

(void)driverAssistance:(nonnull DriverAssistanceContext *)context ttsWarning:(nonnull NSString *)string severity:(AlertSeverity)severity

(void)driverAssistance:(nonnull DriverAssistanceContext *)context audioWarning:(DriverAssistanceAudioFile)audioFile severity:(AlertSeverity)severity

[7.1.22.8.A17891D0] - 2022-02-21 ¶

Added ¶

New methods available in FollowPositionPreferencesContext :

(void)setMapRotationMode:(FollowPositionMapRotationMode)mode angle:(double)angle objectFollowMap:(BOOL)followMap

(FollowPositionMapRotationMode)getMapRotationMode

(BOOL)isTrackObjectFollowingMapRotation

(void)setAccuracyCircleVisibility:(BOOL)value

(BOOL)isAccuracyCircleVisible
New methods available in LandmarkObject :

(void)setExtraInfo:(nonnull NSArray <NSString *> *)array

(nonnull NSString *)findExtraInfo:(nonnull NSString *)string
New method available in LogBookmarksContext :

(nonnull NSArray < NSDictionary <NSString *, NSObject *> *> *)getSoundMarks:(nonnull NSString *)filePath;
New methods available in MapViewController :

centerOnGeoLocation:(GeoLocation *)location zoomLevel:(int)level mapAngle:(double)mapAngle viewAngle:(double)viewAngle animationDuration:(NSTimeInterval)duration

centerOnGeoLocation:(GeoLocation *)location zoomLevel:(int)level point:(CGPoint)point mapAngle:(double)mapAngle viewAngle:(double)viewAngle animationDuration:(NSTimeInterval)duration

(void)presentHighlights:(nonnull NSArray<LandmarkObject *> *)highlights settings:(nonnull HighlightRenderSettings *)settings

(void)presentHighlights:(nonnull NSArray<LandmarkObject *> *)highlights settings:(nonnull HighlightRenderSettings *)settings highlightId:(int)highlightId

(void)removeHighlight:(int)highlightId

(nullable RectangleGeographicAreaObject *)getHighlightArea

(nullable RectangleGeographicAreaObject *)getHighlightArea:(int)highlightId
- New methods available in RecorderContext :
(void)startAudioRecording

(void)stopAudioRecording
- New method available in SoundContext :
(void)updateSessionWithAudioCategory:(AudioCategory)audioCategory
The following methods are now deprecated in MapViewController :

(void)presentHighlight:(nonnull LandmarkObject *)landmark contourColor:(nullable UIColor*)color centerLayout:(BOOL)center animationDuration:(NSTimeInterval)duration

(void)presentHighlights:(nonnull NSArray<LandmarkObject *> *)highlights animationDuration:(NSTimeInterval)duration

(void)setHighlightPinImage:(nonnull UIImage *)image

(void)setHighlightPinSize:(NSInteger)size

[7.1.22.6.44F1F5EF] - 2022-02-08 ¶

Added ¶

New methods available in GEMSdk :

(nonnull NSArray <NSNumber *> *)getCapabilities

(BOOL)isWiFiConnected

(BOOL)isMobileDataConnected
New methods available in MapViewController :

(void)setDefaultPositionTracker

(void)customizePositionTracker:(nonnull NSData *)textureData

(void)customizePositionTracker:(nonnull NSData *)objData material:(nonnull NSData *)matData

(nonnull MapViewPreferencesContext *)getPreferences
Removed methods from MapViewController :

(int)getZoomLevelWithFollowMode:(CameraFollowMode)mode

(void)setZoomLevel:(int)level point:(CGPoint)point followMode:(CameraFollowMode)mode animationDuration:(NSTimeInterval)duration

(double)getTiltAngleWithFollowMode:(CameraFollowMode)followMode
New method available in RecorderContext :

(NSUInteger)getDiskSpaceUsedPerSecond
New method available in RecorderConfigurationObject :

(void)setDeviceModel:(nonnull NSString *)model
New method available in RecorderContextDelegate :

recorderContext:(nonnull RecorderContext *)recorderContext recordingCompleted:(nonnull NSString *)path
New classes available: FollowPositionPreferencesContext , MapViewPreferencesContext , DataSourcePlaybackContext , ExceptionHandler , DriverAssistanceContext .

[7.1.22.1.89E158C4] - 2022-01-07 ¶

Added ¶

New methods available in DataSourceContext :

(instancetype)initWithFilePath:(nonnull NSString *)filePath

(BOOL)setConfiguration:(nonnull DataSourceConfigurationObject *)configuration forType:(DataType)type

seekTo:(NSInteger)valueMs

(NSInteger)getCurrentPosition

(NSInteger)getDuration
New methods available in DataSourceContextDelegate :

(void)dataSourceContext:(nonnull DataSourceContext *)dataSourceContext onProgressChanged:(NSInteger)progress

(void)dataSourceContext:(nonnull DataSourceContext *)dataSourceContext onPlayingStatusChanged:(DataType)type status:(PlayingStatus)playingStatus
New method available in MapViewController :

(nullable LandmarkObject *)getClosestAddress:(nonnull GeoLocation *)location radius:(int)radius

(MapDetailsQualityLevel)getMapDetailsQualityLevel
New methods available in PositionContext :

(BOOL)startProcessingLocationServicesDataWithDataSourceConfigurationObject:(nonnull DataSourceConfigurationObject *)configuration

(BOOL)clean

(BOOL)startProcessingLogData:(nonnull DataSourceContext *)context

(BOOL)stopProcessingLogData

(BOOL)isProcessingLogData
The following methods are now deprecated in PositionContext :

(BOOL)startProcessingLocationServicesDataWithAllowBackgroundLocationUpdates:(BOOL)allowBackgroundLocationUpdates
New methods available in RoadSafetyAlertsContext :

(instancetype)initWithContext:(nonnull DataSourceContext *)context

(instancetype)initWithContext:(nonnull DataSourceContext *)context useMapMatchedPosition:(BOOL)useMapMatchedPosition type:(ProcessorExecutionType)processorType
Implemented support for CameraRenderViewController .
Implemented support for DataSourceConfigurationObject .
Implemented support for LogPlayingContext , LogUploadContext , LogUploadDelegate , LogUploadHeader .
Implemented support for RecorderConfigurationObject , RecorderContext , RecorderContextDelegate , RecorderHeader
Removed the following file ImageDrawerController .

[7.1.21.47.6C765E74] - 2021-11-24 ¶

Added ¶

New methods available in MapViewController :

setMapDetailsQualityLevel:(MapDetailsQualityLevel)level

(MapDetailsQualityLevel)getMapDetailsQualityLevel
New methods available in NavigationContext :

(void)simulateWithRoute:(nonnull RouteObject *)route speedMultiplier:(float)speed completionHandler:(nonnull void(^)(BOOL success))handler

(void)navigateWithRoute:(nonnull RouteObject *)route completionHandler:(nonnull void(^)(BOOL success))handler
New method available in MapViewControllerDelegate :

(void)mapViewController:(nonnull MapViewController *)mapViewController didSelectOverlays:(nonnull NSArray<OverlayItemObject *> *)overlays
New method available in PositionContext :

(nullable PositionObject*)getPosition:(PositionType)type;
New case in RouteType enum available:

RouteTypeEconomic
New profile available in RoutePreferencesObject :

EBikeProfile

EBikeProfileDetails
New methods available in SocialOverlayContext :

(nonnull NSArray < SocialReportsOverlayCategoryObject *> *)getCategoriesWithIsoCode:(nonnull NSString *)isoCode

(nullable SocialReportsOverlayCategoryObject *)getCategoryWithIdentifier:(int)categoryId isoCode:(nonnull NSString *)isoCode
New classes available: MapDetailsContext.h , OverlayCategoryObject.h , SocialReportsOverlayCategoryObject DataSourceContext , DataSourceContextDelegate , RoadSafetyAlertsContext , RoadSafetyAlertsContextDelegate

Changed ¶

The following methods are now deprecated in NavigationContext :

simulateRouteWithRoute:(nonnull RouteObject *)route speedMultiplier:(float)speed completionHandler:(nonnull void(^)(BOOL success))handler

navigateRouteWithRoute:(nonnull RouteObject *)route completionHandler:(nonnull void(^)(BOOL success))handler

Removed ¶

Removed deprecated methods from PositionContext , NavigationContext , MapViewController and RouteInstructionObject .

[7.1.21.43.FAFF5D4E] - 2021-10-29 ¶

Added ¶

New methods available in OverlayItemObject :

(nonnull NSString *)getPreviewData:(ExtendedDataType)type

(nullable NSValue *)searchInPreviewData:(SocialReportParameterType)parameterType

Changed ¶

Fixed app crash for custom map style.

Removed ¶

Removed methods from ImageDatabaseObject :

(int)import:(nonnull NSString *)filePath

(BOOL)removeImageObject:(nonnull ImageObject *)object

[7.1.21.43.B28E7C7F] - 2021-10-25 ¶

Added ¶

New methods available in AlarmContext :

(void)enableSafetyCameraOfflineDataGrabber

(void)disableSafetyCameraOfflineDataGrabber

(BOOL)isSafetyCameraOfflineDataGrabberEnabled

(BOOL)isSafetyCameraOfflineDataGrabberSupported

(void)enableSocialReportsOfflineDataGrabber

(void)disableSocialReportsOfflineDataGrabber

(BOOL)isSocialReportsOfflineDataGrabberEnabled

(BOOL)isSocialReportsOfflineDataGrabberSupported

(void)setOverSpeedThreshold:(double)threshold insideCityArea:(bool)inside

(double)getOverSpeedThreshold:(BOOL)insideCityArea

(nonnull NSArray <RectangleGeographicAreaObject *> *)getCrossedBoundaries

(nonnull NSArray <LandmarkObject *> *)getLandmarkAlarms

(nonnull NSArray <OverlayItemObject *> *)getOverlayItemAlarmsPassedOver
Make AlarmContextDelegate optional.
New methods available in AlarmContextDelegate :

(void)alarmContextOnBoundaryCrossed:(nonnull AlarmContext *)alarmContext

(void)alarmContextOnMonitoringStateChanged:(nonnull AlarmContext *)alarmContext

(void)alarmContextOnTunnelEntered:(nonnull AlarmContext *)alarmContext

(void)alarmContextOnTunnelLeft:(nonnull AlarmContext *)alarmContext

(void)alarmContextOnLandmarkAlarmsUpdated:(nonnull AlarmContext *)alarmContext

(void)alarmContextOnOverlayItemAlarmsUpdated:(nonnull AlarmContext *)alarmContext

(void)alarmContextOnLandmarkAlarmsPassedOver:(nonnull AlarmContext *)alarmContext

(void)alarmContextOnOverlayItemAlarmsPassedOver:(nonnull AlarmContext *)alarmContext

(void)alarmContextOnEnterDayMode:(nonnull AlarmContext *)alarmContext

(void)alarmContextOnEnterNightMode:(nonnull AlarmContext *)alarmContext
New enums available for LandmarkCategoryObject :

DefaultLandmarkCategory
New methods available for LandmarkObject :

(nullable ImageObject*)getImage

(void)setImage:(nonnull ImageObject *)object

(nullable ImageObject*)getExtraImage

(void)setExtraImage:(nonnull ImageObject *)object
New methods available for LandmarkStoreContext :

(BOOL)updateCategory:(nonnull LandmarkCategoryObject *)category

(BOOL)removeCategory:(nonnull LandmarkCategoryObject *)category

(BOOL)removeCategoryWithAllContent:(nonnull LandmarkCategoryObject *)category
New methods available for RectangleGeographicAreaObject :

(nonnull GeoLocation *)getCenterPoint

(BOOL)isDefault

(BOOL)isEmpty

(void)reset

Changed ¶

Fixed typo in methods available for MapViewController :

(void)searchAroundWithCompletionHandler:(nonnull void(^)(NSArray<LandmarkObject *> *array))handler

(void)searchAroundWithCategory:(nonnull LandmarkCategoryObject *)category completionHandler:(void(^)(NSArray<LandmarkObject *> *array))handler
Fixed typo in methods available for SearchContext :

(void)searchAroundWithLocation:(nonnull GeoLocation *)location completionHandler:(nonnull void(^)(NSArray<LandmarkObject *> *array))handler;

[7.1.21.41.741983E3] - 2021-10-15 ¶

Added ¶

New methods available in ContactInfoObject :

(void)setField:(int)index type:(ContactInfoFieldType)fieldType value:(nonnull NSString *)value name:(nonnull NSString *)name

(void)addField:(ContactInfoFieldType)fieldType value:(nonnull NSString *)value name:(nonnull NSString *)name

(void)removeField:(int)index
New methods available in GEMSdkDelegate :

(BOOL)shouldUpdateWorldwideRoadMapForStatus:(ContentStoreOnlineSupportStatus)status

(void)updateWorldwideRoadMapFinished:(BOOL)success

(void)onWorldwideRoadMapSupportEnabled

(void)onWorldwideRoadMapSupportDisabled:(ReasonType)reason
Removed methods from GEMSdkDelegate :

(BOOL)shouldUpdateWorldMapForStatus:(ContentStoreOnlineSupportStatus)status

(void)updateWorldMapDisabled:(ReasonType)reason
New methods available in LandmarkObject :

(void)setLandmarkDescription:(nonnull NSString *)description

(void)setAuthor:(nonnull NSString *)value

(void)setProviderId:(int)value

(void)setTimeStamp:(nullable TimeObject*)object

(void)setLandmarkGeoLocation:(nonnull GeoLocation *)location

(void)setContactInfo:(nullable ContactInfoObject *)object

(nonnull NSString*)getLandmarkNameFormatted

(nonnull NSString*)getLandmarkDescriptionFormatted
- Removed methods from LandmarkObject :
(void)setCurrentPositionMark:(BOOL)state

(BOOL)isCurrentPositionMarked
New methods available in MapViewController :

(void)setCursorPosition:(CGPoint)point

(nonnull NSArray <LandmarkObject *> *)getCursorSelectionLandmarks

(nonnull NSArray <LandmarkObject *> *)getCursorSelectionStreets

(nonnull NSArray <LandmarkObject *> *)getCursorSelectionOverlayItems

(nonnull NSArray <LandmarkObject *> *)getCursorSelectionTrafficEvents

(nonnull NSArray <LandmarkObject *> *)getCursorSelectionRoutes

(nullable RouteInstructionObject *)getCursorSelectionRouteInstruction:(nonnull RouteObject *)routeObject

(nonnull NSArray <LandmarkObject *> *)getNearestLocations:(nonnull GeoLocation *)location

(void)startFollowingPositionWithAnimationDuration:(NSTimeInterval)duration zoomLevel:(int)level viewAngle:(double)angle completionHandler:(nonnull void(^)(BOOL success))handler

(void)restoreFollowingPositionWithAnimationDuration:(NSTimeInterval)duration completionHandler:(nonnull void(^)(BOOL success))handler

(void)setViewAngle:(double)value

(double)getViewAngle

(void)setTiltAngle:(double)angle followMode:(CameraFollowMode)mode

(double)getTiltAngle

(double)getTiltAngleWithFollowMode:(CameraFollowMode)followMode
Make MapViewControllerDelegate optional.
New methods available in MapViewControllerDelegate :

(void)mapViewController:(nonnull MapViewController *)mapViewController onFollowingPositionModifyByTouchHandler:(BOOL)isModify

(void)mapViewController:(nonnull MapViewController *)mapViewController onLongTouchPoint:(CGPoint)point

(void)mapViewController:(nonnull MapViewController *)mapViewController didSelectStreets:(nonnull NSArray<LandmarkObject *> *)streets onTouchPoint:(CGPoint)point

(void)mapViewController:(nonnull MapViewController *)mapViewController didSelectStreets:(nonnull NSArray<LandmarkObject *> *)streets onLongTouchPoint:(CGPoint)point
Removed methods from MapViewControllerDelegate :

(void)mapViewController:(nonnull MapViewController *)mapViewController didSelectStreets:(nonnull NSArray<LandmarkObject *> *)streets
New methods available in PositionObject :

(NSInteger)getSatelliteTime

(PositionProvider)getProvider

(double)getLatitude

(double)getLongitude

(nonnull GeoLocation*)getCoordinates

(double)getAltitude

(double)getSpeedAccuracy

(double)getCourse

(double)getCourseAccuracy

(double)getHorizontalAccuracy

(double)getVerticalAccuracy

(PositionFixQuality)getFixQuality

(BOOL)isValid

(BOOL)hasCoordinates

(BOOL)hasAltitude

(BOOL)hasSpeedAccuracy

(BOOL)hasCourse

(BOOL)hasCourseAccuracy

(BOOL)hasHorizontalAccuracy

(BOOL)hasVerticalAccuracy
Removed methods from PositionObject :

(nullable GeoLocation*)getPositionGeoLocation;
The following method is now deprecated in RouteInstructionObject :

(nullable UIImage *)getTurnImage:(CGSize)size colorActiveInner:(nonnull UIColor*)colorActiveIn colorActiveOuter:(nonnull UIColor*)colorActiveOut colorInactiveInner:(nonnull UIColor*)colorInactiveIn colorInactiveOuter:(nonnull UIColor*)colorInactiveOut
New methods available in TurnDetailsObject :

(nullable UIImage *)getTurnImage:(CGSize)size colorActiveInner:(nonnull UIColor*)colorActiveIn colorActiveOuter:(nonnull UIColor*)colorActiveOut colorInactiveInner:(nonnull UIColor*)colorInactiveIn colorInactiveOuter:(nonnull UIColor*)colorInactiveOut

(int)getTurnImageId

[7.1.21.38.F7EA52F0] - 2021-09-20 ¶

Added ¶

New method available in GEMSdk :

(nonnull NSString *)getVersion
New classes available: PathObject , RouteBookmarksObject , RoutePreferencesObject.h
New methods available in MapViewController :

(nonnull NSArray < RouteObject *> *)getPresentedRoutes

(CGFloat)getScaleFactor

(NSInteger)getPpiFactor

(void)centerOnRouteInstruction:(nonnull RouteInstructionObject *)routeInstruction zoomLevel:(int)level animationDuration:(NSTimeInterval)duration completionHandler:(nonnull void(^)(BOOL success))handler

(void)centerOnRouteTrafficEvent:(nonnull RouteTrafficEventObject *)trafficEvent zoomLevel:(int)level animationDuration:(NSTimeInterval)duration completionHandler:(nonnull void(^)(BOOL success))handler

(void)centerOnArea:(nonnull RectangleGeographicAreaObject *)area zoomLevel:(int)level animationDuration:(NSTimeInterval)duration completionHandler:(nonnull void(^)(BOOL success))handler
New methods available in MapViewControllerDelegate :

(void)mapViewController:(nonnull MapViewController *)mapViewController onPinch:(CGPoint)startPoint1 startPoint2:(CGPoint)startPoint2 toPoint1:(CGPoint)endPoint1 toPoint2:(CGPoint)endPoint2
New method available in NavigationInstructionObject :

(nonnull NSString*)getCurrentStreetSpeedLimitFormatted
New methods available in PositionObject :

(BOOL)hasSpeed

(double)getSpeed

(nonnull NSString *)getFormattedSpeed

(nonnull NSString *)getFormattedSpeedUnit
New methods available in RouteObject :

(nullable GeoLocation *)getCoordinateOnRoute:(int)distance

(int)getDistanceOnRoute:(nonnull GeoLocation*)location activePart:(BOOL)activePart

(nullable PathObject*)getPath:(int)start end:(int)end
New methods available in TimeObject :

(BOOL)isValid

(void)milliSecondSleep:(unsigned int)msec

(NSUInteger)getEpoch

(nonnull TimeObject *)getLocalTime

(nonnull TimeObject *)getUniversalTime

(void)setUniversalTime

(void)setLocalTime

(NSUInteger)asInt

(void)fromInt:(NSInteger)timestamp

(int)getYear

(void)setYear:(int)value

(int)getMonth

(void)setMonth:(int)value

(int)getDay

(void)setDay:(int)value

(int)getDayOfWeek

(int)getHour

(void)setHour:(int)value

(int)getMinute

(void)setMinute:(int)value

(int)getSecond

(void)setSecond:(int)value

(int)getMillisecond

(void)setMillisecond:(int)value

(nonnull NSString *)toStr:(BOOL)utcTime

(NSInteger)getTimeZoneMilliseconds
The following methods are now deprecated in NavigationContext :

setTransportMode:(RouteTransportMode)mode

(RouteTransportMode)getTransportMode

setBuildTerrainProfile:(BOOL)state

setRouteType:(RouteType)type

setAvoidMotorways:(BOOL)state

setAvoidTollRoads:(BOOL)state

setAvoidFerries:(BOOL)state

setAvoidTurnAroundInstruction:(BOOL)state

setAvoidUnpavedRoads:(BOOL)state

setAvoidCarpoolLanes:(BOOL)state

setUseWheelchair:(BOOL)state

setUseBikes:(BOOL)state

setMaximumWalkDistance:(unsigned int)distance

setAvoidTraffic:(BOOL)state

setResultDetails:(RouteResultDetails)details

[7.1.21.35.6B2C9079] - 2021-08-30 ¶

Added ¶

New method available in MapViewController :

(void)setHighlightPinSize:(NSInteger)size
New methods available in MapViewControllerDelegate :

(void)mapViewController:(nonnull MapViewController *)mapViewController onFollowingPositionStateChanged:(BOOL)isFollowingPosition

(void)mapViewController:(nonnull MapViewController *)mapViewController onMapStyleChanged:(NSInteger)identifier
New method available in GeoLocation :

(double)getDistance:(nonnull GeoLocation*)point
New methods available in NavigationContext :

(RouteTransportMode)getTransportMode

(void)setResultDetails:(RouteResultDetails)details
New enums available for NavigationContext :

RouteResultDetailsFull

RouteResultDetailsTimeDistance

RouteResultDetailsPath
New methods available in SoundContext :

(BOOL)isPlaying

(void)cancel
- New method available in PositionContext :
(PositionDataType)getPositionDataType
New enums available for PositionContext :

PositionDataTypeLive

BuildingsVisibilityHide

PositionDataTypePlayback

PositionDataTypeUnavailable
New method available in ContentStoreObject :

(ContentStoreOnlineType)getType
New enums available for ContentStoreObject :

ContentStoreOnlineTypeViewStyleHighRes

ContentStoreOnlineTypeViewStyleLowRes

ContentStoreOnlineTypeRoadMap

ContentStoreOnlineTypeHumanVoice

ContentStoreOnlineTypeComputerVoice
New method available in HumanVoiceContext :

(nonnull NSString*)getCountryName:(nonnull NSString*)code

(nonnull NSString*)getNativeLanguage:(nonnull ContentStoreObject *)object

(nullable UIImage*)getGenderImage:(HumanVoiceGender)gender size:(CGSize)size

[7.1.21.32.1CFA7043] - 2021-08-13 ¶

Added ¶

New delegate method available in MapViewControllerDelegate :

(void)mapViewController:(nonnull MapViewController *)mapViewController onRotatePoint:(CGPoint) startPoint2:(CGPoint) toPoint1:(CGPoint) toPoint2:(CGPoint) center:(CGPoint) delta:(double)
New methods available in MapViewController :

setZoomLevel:(int)level animationDuration:(NSTimeInterval)duration

(void)setCompassFollowUserInterfaceStyle:(BOOL)value

(NSInteger)getStyleIdentifier

(void)setMaxMatches:(int)value

(void)setExactMatch:(BOOL)value

(void)setSearchAddresses:(BOOL)value

(void)setSearchMapPOIs:(BOOL)value

(void)setSearchOnlyOnboard:(BOOL)value

(void)setThresholdDistance:(int)threshold

(BOOL)setCategory:(nonnull LandmarkCategoryObject*)category

(void)setAllowFuzzyResults:(BOOL)value

(void)cancelSearch

(void)stopFollowingPosition
New method available in ContentStoreObject :

(nullable UIImage *)getAsyncImagePreview:(CGFloat)width completionHandler:(nonnull void(^)(UIImage* _Nullable image) )handler
New method available in PositionContext :

(BOOL)startProcessingLocationSevicesDataWithAllowBackgroundLocationUpdates:(BOOL)allowBackgroundLocationUpdates;

Changed ¶

Fixed bug related to no network connection.
Faster search results with MapViewController search Api and more controller over search preferences.
The following methods are now deprecated in MapViewController :

addPolylinesWithCoordinates

removePolylines
The following methods are now deprecated in PositionContext :

startProcessingLocationSevicesData

[7.1.21.30.47C453AA] - 2021-07-30 ¶

Added ¶

New method and new enum available in GEMSdk :

(void)verifySdk:(nonnull NSString*)authorizationKey completionHandler:(void(^)(BOOL success))handler

AuthorizationKeyStatusValid

AuthorizationKeyStatusExpired

AuthorizationKeyStatusInvalidInput

AuthorizationKeyStatusAccessDenied

AuthorizationKeyStatusConnectionRequired

AuthorizationKeyStatusError
New method available in GEMSdkDelegate :

(void)authorizationKeyRejected
New methods available in AlarmContext :

(void)enableSafetyCamera

(void)disableSafetyCamera

(BOOL)isSafetyCameraEnabled

(void)enableSocialReports

(void)disableSocialReports

(BOOL)isSocialReportsEnabled
New methods available in PositionContext :

(BOOL)startProcessingLocationSevicesData

(BOOL)stopProcessingLocationSevicesData

(BOOL)isProcessingLocationSevicesData
New methods available in MarkerCollectionObject :

(void)setInnerColor:(nonnull UIColor *)color

(void)setOuterColor:(nonnull UIColor *)color

(void)setInnerSize:(double)size

(void)setOuterSize:(double)size

(void)setFillColor:(nonnull UIColor *)color

(nonnull UIColor *)getInnerColor

(nonnull UIColor *)getOuterColor

(double)getInnerSize

(double)getOuterSize

(nonnull UIColor *)getFillColor

Changed ¶

Fixed polyline outer size.
Fixed issue related to map style on fresh app install.

[7.1.21.30.F8FD4DB3] - 2021-07-27 ¶

Added ¶

New method available in GeoLocation :

(BOOL)isValid
New method available in LandmarkObject :

(int)getLandmarkStoreIdentifier
New methods available in MapViewController :

(void)showLandmarksFromAllCategories:(nonnull LandmarkStoreContext*)landmarkStore

(void)hideLandmarksFromAllCategories:(nonnull LandmarkStoreContext*)landmarkStore

(void)showLandmarksFromCategory:(nonnull LandmarkCategoryObject*)landmarkCategory context:(nonnull LandmarkStoreContext*)landmarkStore

(void)hideLandmarksFromCategory:(nonnull LandmarkCategoryObject*)landmarkCategory context:(nonnull LandmarkStoreContext*)landmarkStore
New method available in LandmarkStoreContext :

(void)updateCategory:(nonnull LandmarkCategoryObject *)category

Changed ¶

Methods signature changed in LandmarkStoreContext :

(nonnull LandmarkCategoryObject *)getCategoryById:(int)categoryId

(BOOL)addLandmark:(nonnull LandmarkObject*)landmark

(BOOL)removeLandmark:(nonnull LandmarkObject*)landmark

(void)removeAllLandmarks

(BOOL)addLandmark:(nonnull LandmarkObject*)landmark toCategoryId:(int)categoryId

(BOOL)removeLandmark:(nonnull LandmarkObject*)landmark fromCategoryId:(int)categoryId

(nullable LandmarkObject *)getLandmark:(int)landmarkId

(int)getLandmarkCount

nonnull NSArray <LandmarkObject *> *)getLandmarks

(int)getLandmarkCount:(int)categoryId

(nonnull NSArray <LandmarkObject *> *)getLandmarks:(int)categoryId

[7.1.21.29.F6977F8B] - 2021-07-22 ¶

Added ¶

New methods available in RectangleGeographicAreaObject :

(GeographicAreaType)getType

(void)setTopLeft:(nonnull GeoLocation*)location

(void)setBottomRight:(nonnull GeoLocation*)location

(BOOL)intersects:(nonnull RectangleGeographicAreaObject *)rectangle

(BOOL)contains:(nonnull RectangleGeographicAreaObject *)rectangle
New methods available in LandmarkCategoryObject :

(instancetype)initWithName:(nonnull NSString *)

(void)setName:(nonnull NSString *)

(void)setImage:(nonnull UIImage *)
New methods available in LandmarkObject :

(void)setLandmarkName:(nonnull NSString *)

(void)setLandmarkImage:(nonnull UIImage *)
New methods available in LandmarkStoreContext :

(void)addCategory:(nonnull LandmarkCategoryObject *)category

(void)removeCategory:(nonnull LandmarkCategoryObject *)category

(nullable LandmarkCategoryObject *)getCategoryByName:(nonnull NSString *)categoryString

(int)getId

(LandmarkStoreType)getType;

(nonnull NSArray <LandmarkCategoryObject *> *)getCategories

(int)getLandmarkCount:(nonnull NSString*)category

(nonnull NSArray <LandmarkObject *> *)getLandmarks:(nonnull NSString*)category

(nullable LandmarkObject *)getLandmarkWithIdentifier:(int)identifier

(nonnull NSArray <LandmarkObject *> *)getLandmarksWithRectangleGeographicArea:(nonnull RectangleGeographicAreaObject*)area

Changed ¶

Fix app crash when switching between multiple MapViewController with polylines on the map view.
Removed deprecated methods from MapViewController .

[7.1.21.27.F104E3C4] - 2021-07-06 ¶

Added ¶

New classes available ContactInfoObject , LandmarkStoreContext
New methods available in LandmarkObject :

(nonnull NSArray <NSString *> *)getExtraInfo

(nonnull NSArray <LandmarkCategoryObject *> *)getCategories

(nullable RectangleGeographicAreaObject *)getGeographicArea

(nullable ContactInfoObject *)getContactInfo
New enums available for BuildingsVisibility :

BuildingsVisibilityDefault

BuildingsVisibilityHide

BuildingsVisibility2D

BuildingsVisibility3D
New method available in SearchContext :

setAllowFuzzyResults:(BOOL)value

[7.1.21.26.FD631602] - 2021-07-02 ¶

Added ¶

New method available in MapsContext and MapStyleContext :

(BOOL)isUpdateStarted

[7.1.21.25.FB8DC20C] - 2021-07-01 ¶

Added ¶

New protocol ContentUpdateDelegate .
New methods available in GEMSdkDelegate :

updateWorldMapDisabled:(ReasonType)reason

updateWorldMapFinished:(BOOL)success

(void)onlineConnectionStatusChanged:(OnlineConnectionStatus)status
New methods available in MapsContext and MapStyleContext :

(nonnull NSString *)getWorldMapVersion

checkForUpdateWithCompletionHandler:(nonnull void(^)(ContentStoreOnlineSupportStatus status))handler

updateWithAllowCellularNetwork:(BOOL)allowCellularNetwork completionHandler:(nonnull void(^)(BOOL success))handler

(void)cancelUpdate

(NSInteger)getUpdateProgress

(nonnull NSArray <ContentStoreObject *> *)getUpdateItems

(nonnull NSString *)getUpdateSizeFormatted
New methods available in MapViewController :

setBuildingsVisibility:(BuildingsVisibility)visibility

(BOOL)isCameraMoving

Changed ¶

Fix app crash when using more than one MapViewController .
Implemented support for map update on request.

[7.1.21.25.DDC98F41] - 2021-06-23 ¶

Added ¶

Implemented support for GEMSdk delegate.
Implemented support to update the world map with SDK client approval.
New methods available in GEMSdk :

(void)setAllowConnection:(BOOL)state

(BOOL)getAllowConnection
New methods available in MapViewController :

(int)getZoomLevelWithFollowMode:(CameraFollowMode)mode

(void)setZoomLevel:(int)level point:(CGPoint)point followMode:(CameraFollowMode)mode animationDuration:(NSTimeInterval)duration

(void)setEdgeAreaInsets:(UIEdgeInsets)insets
New methods available in RouteObject :

(nullable RectangleGeographicAreaObject *)getGeographicArea

(nullable TimeDistanceObject *)getTimeDistanceWithActivePart:(BOOL)activePart
New methods available in MapViewController :

(void)set2DPerspectiveWithAnimationDuration

(void)set3DPerspectiveWithAnimationDuration

[7.1.21.24.51C956AF] - 2021-06-17 ¶

Added ¶

Implemented support for custom map style data buffer.
Implemented support for route profile ( new RouteTerrainProfileObject class )
Implemented support for calculating a route from a gpx file.
New method available in MapViewController :

(void)applyStyleWithStyleBuffer:(nonnull NSData *)styleBuffer smoothTransition:(BOOL)smooth;
New method available in RouteObject :

(nullable RouteTerrainProfileObject *)getTerrainProfile;
New method available in NavigationContext :

(void)calculateRouteWithStartWaypoints:(nonnull NSArray<LandmarkObject *> *)startArray buffer:(nonnull NSData*)data endWaypoints:(nonnull NSArray<LandmarkObject *> *)endArray completionHandler:(nonnull void(^)(NSArray<RouteObject *> *array))handler;

[7.1.21.23.9E891AB0] - 2021-06-11 ¶

Added ¶

Implemented support for map view customization.
New methods available in MapViewController :

(nullable GeoLocation *)transformScreenToWgs:(CGPoint)point

(void)setFollowPositionCameraFocus:(CGPoint)point

(CGPoint)getFollowPositionCameraFocus

(void)setMinimumAllowedZoomLevel:(int)level

(void)setMaximumAllowedZoomLevel:(int)level

(void)setHighlightPinImage:(nonnull UIImage *)image

[7.1.21.23.7A56AE1E] - 2021-06-10 ¶

Added ¶

Implemented support for public transit route description.
Implemented support for PTRouteSegmentObject class.
Implemented support for RectangleGeographicAreaObject class.

[7.1.21.22.0F756BC9] - 2021-06-04 ¶

Added ¶

Implemented support for GenericCategoriesContext class.
Implemented support for LandmarkCategoryObject class.
New methods available:

SearchContext: (BOOL)setCategory:(nonnull LandmarkCategoryObject*)category

SearchInterface: (BOOL)setCategory:(gem::LandmarkCategory)category

Changed ¶

ApplicationContext renamed to GEMSdk

[7.1.21.22.82497343] - 2021-05-31 ¶

Added ¶

Implemented support for HumanVoiceContext class.
Implemented support for SoundObject class.
New methods available:

SoundContext: setUseTtsWithCompletionHandler

SoundContext: setUseHumanVoiceWithIdentifier

SoundContext: playSound:(nonnull SoundObject *)object

SoundContext: playText:(nonnull NSString *)text

Changed ¶

ContentStoreObject: getImagePreview

MapViewController: applyStyleWithStyleIdentifier

[7.1.21.22.811AFB6] - 2021-05-24 ¶

Added ¶

Implemented support for road codes information.
Implemented support for safety camera notification.
New classes available:

AlarmContext

AlarmContextDelegate

OverlayItemObject

RoadInfoObject

[7.1.21.19.7F5A4140] - 2021-05-11 ¶

Added ¶

Implemented support for route instructions.
New classes available:

RouteSegmentObject

RouteInstructionObject

SignpostDetailsObject

TimeDistanceObject

TurnDetailsObject

[7.1.21.19.227B51FF] - 2021-05-10 ¶

Added ¶

Implemented support for download maps.
New classes:

MapsContext

ContentStoreObjectStatus

Changed ¶

ContentStoreObject: (nonnull NSArray<NSString *> *)getCountryCodes

[7.1.21.17.3F055C56] - 2021-04-26 ¶

Added ¶

Implemented support for map compass.

[7.1.21.16.2861B264] - 2021-04-19 ¶

Added ¶

Implemented support for Address Search.
Implemented support for get/set map view zoom level.
Implemented support for map view pan direction ( CarPlay support )

Changed ¶

New map view controller init method. Add support for scale factor parameter.
(instancetype)initWithPpi:(NSInteger)ppi scale:(CGFloat)scale

[Unreleased] - 2021-03-09 ¶

[7.1.21.10.75657511]: Initial release

Maps & 3D scene

Locations & Search

Magic Studio

Routes & Navigation

Route Optimization

Micromobility

Navigation for automotive

E-Bike companion app

Emergency vehicles

Fleet management & Logistics

On-demand rides & Delivery

Sports & Outdoors

Build, Operate, Transfer

Documentation

Pricing

Download

About

News

Changelog ¶

[7.1.25.3.9ED2450F] - 2025-01-15 ¶

Added ¶

[7.1.24.48.527A3CD3] - 2024-11-27 ¶

Added ¶

[7.1.24.38.4443F8E9] - 2024-09-16 ¶

Added ¶

[7.1.24.20.093088C8] - 2024-05-27 ¶

Added ¶

[7.1.24.20.8B92211B] - 2024-05-15 ¶

Fixed ¶

[7.1.24.20.5A74CA04] - 2024-05-14 ¶

Added ¶

[7.1.24.17.D3970963] - 2024-04-23 ¶

Added ¶

Fixed ¶

[7.1.24.16.F295FF8E] - 2024-04-16 ¶

Added ¶

Changed ¶

[7.1.24.13.6FE96C8C] - 2024-04-02 ¶

Changed ¶

[7.1.24.3.755A6098] - 2024-01-15 ¶

Changed ¶

[7.1.23.47.08560DD1] - 2023-11-24 ¶

Changed ¶

[7.1.23.40.6789DC8F] - 2023-10-02 ¶

Changed ¶

[7.1.23.35.9E3DBD80] - 2023-08-31 ¶

Changed ¶

[7.1.23.24.F818CE1B] - 2023-06-14 ¶

Changed ¶

[7.1.23.21.0B8B1AC2] - 2023-05-25 ¶

Changed ¶

[7.1.23.20.D1E234B6] - 2023-05-18 ¶

Added ¶

[7.1.23.12.D3E4D7BA] - 2023-03-21 ¶

Added ¶

Changed ¶

[7.1.23.2.F5465C47] - 2023-01-11 ¶

Added ¶

[7.1.22.46.8999C03E] - 2022-11-14 ¶

Added ¶

[7.1.22.43.A866AF6C] - 2022-10-27 ¶

Added ¶

[7.1.22.41.9C5833F1] - 2022-10-13 ¶

Changed ¶

[7.1.22.41.6B0D8D54] - 2022-10-10 ¶

Added ¶

[7.1.22.39.4A2FB489] - 2022-09-27 ¶

Added ¶

[7.1.22.31.C4AB7AB1] - 2022-08-04 ¶

Added ¶

[7.1.22.18.D57E5A51] - 2022-06-30 ¶

Added ¶

[7.1.22.18.0A8870F1] - 2022-05-04 ¶

Added ¶

[7.1.22.8.A6D2863A] - 2022-04-01 ¶

Added ¶

[7.1.22.8.A17891D0] - 2022-02-21 ¶

Added ¶

[7.1.22.6.44F1F5EF] - 2022-02-08 ¶

Added ¶