Skip to main content

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.

warning

Update all applications to version 1.6.0 or later to access the newest map available. To support recent enhancements, a change in the map format was required.

Legacy map formats will remain available until April 2027.

warning

Due to improvements of our SDK and map data, we kindly ask you to update your applications and projects with any SDK revision released starting with October 2024 in order to continue using the online Magic Lane map-related services and to continue receiving map updates.

[1.8.4] - 2026-03-20​

Build: 7.1.26.12.ADB30465

Fixed​

  • Fixes regarding geofence feature

[1.8.3] - 2026-03-18​

Build: 7.1.26.12.FC99A40E

Added​

  • Added szBorder, szInner parameters to MapView.displayPath(), MapView.presentPath() methods

Fixed​

  • Fixed crashes regarding MapViewRoutesCollection usage

  • Fixed route bubble appearance for situations in which traffic info is not displayed

  • Fixed issue regarding road codes / signposts rendering inside an image view

  • Fixed exit roundabout turns appearance

Changed​

  • Marked SdkSettings.onMapDataReady() deprecated

  • Marked MapView.onReady() deprecated

  • GemOffscreenSurfaceView.onDefaultMapViewCreated() notification is synchronized internally with SDK thread, so please avoid calling SdkCall.execute inside it. Just make SDK call inside it without any SdkCall guard

[1.8.2] - 2026-02-26​

Build: 7.1.26.9.45AF722D

Fixed​

  • Fixed a crash regarding AlarmListener.onCountryEntered() and AlarmListener.onCountryLeft() notifications

[1.8.1] - 2026-02-19​

Build: 7.1.26.8.4EE9C177

Added​

  • Added EMapSpeedLimitCoverage enum, MapSpeedLimit class, MapDetails.getCountrySpeedLimits() method

  • Added AlarmListener.onCountryEntered() and AlarmListener.onCountryLeft() methods

  • Implemented DefaultNetworkProvider.connect() and DefaultNetworkProvider.disconnect() methods

Changed​

  • GemOffscreenSurfaceView.onScreenCreated(), GemOffscreenSurfaceView.onDefaultMapViewCreated(), GemSurfaceView.onScreenCreated(), GemSurfaceView.onDefaultMapViewCreated() calls are now synchronized with SDK thread, so there should be no SdkCall.execute, SdkCall.runSynced blocks inside those notifications

  • Changed default map style (the previous one contained elevation contours layer that slowed down rendering speed)

Removed​

  • Removed SdkSettings.setAllowConnection(value: Boolean), please use SdkSettings.allowConnection = value, in place

Fixed​

  • Fixed SDK behavior for situations in which SdkSettings.allowConnection = true was called after the value was set to false, previously (the SDK is back online, if previously there is a valid Internet connection)

[1.8.0] - 2026-02-16​

Build: 7.1.26.8.79E4DAF7

Added​

  • Added EHighlightLineType, EHighlightImagePosition, ESafetyCameraOverlayParamsKeys, EPublicTransitOverlayParamsKeys, EContentParamsKeys, ERideParamsKeys, EGeofenceParamsKeys, EMapObjectDetectorParamsKeys, EOverlaysParamsKeys, ERideSharingParamsKeys, ESocialOverlayParamsKeys, ETrafficParamsKeys enums

  • Added HighlightRenderSettings.lineType, HighlightRenderSettings.imagePosition properties

  • Added RoutePreferences.setRoundTripParameters() method, EVRoute and EVRouteInstruction classes, Route.toEVRoute() and RouteInstruction.toEVRouteInstruction() methods

  • Added BasicShapeDrawer.drawRoundedRectangle(), BasicShapeDrawer.getTextAscent(), BasicShapeDrawer.getTextDescent(), BasicShapeDrawer.getTextWidth() methods

  • Added OverlayItemAlarmsList.getDeviation, NavigationInstruction.nextWaypointDriveSide properties

Changed​

  • Provided grouping separator and decimal separator at SDK initialization

  • Renamed HO_Selectable to Selectable in EHighlightOptions

  • Updated EEVChargingConnector and ECommonOverlayId enums

  • EVCarModel properties are now configurable

  • Changes in GemSurfaceView:

    • onInitSdk: ((sdkToken: String?) -> Boolean)? became onInitSdk: ((sdkToken: String?) -> Int)? (the method should return SDK initialization error code)

    • Added var onSdkInitFailed: ((Int) -> Unit)? = null callback that provides SDK initialization error as parameter

    • Avoid throwing exception if SDK initialization fails. Please use onSdkInitFailed callback to get SDK initialization error code in such situations

  • GemSdk.initSdkWithDefaults returns an integer value now (initialization error code: GemError.NoError on success, one of the remaining GemError codes on failure)

  • GemGlSurfaceAdapter: added onSdkInitSucceeded and onSdkInitFailed callbacks for SDK initialization result handling

Fixed​

  • Fixed getBooleanValue method from SettingsService

[1.7.1] - 2025-11-17​

Build: 7.1.25.41.85504BAA

Added​

  • Added AlarmService.startAlarmForOverlays(overlayIds: List<Int>), AlarmService.startAlarmForOverlay(overlayId: Int), AlarmService.stopAlarmForOverlays(overlayIds: List<Int>), AlarmService.stopAlarmForOverlay(overlayId: Int), OverlayService.getOverlaysById(ids: List<Int> ...)

  • Added NetworkProvider.isConnected(), NetworkProvider.isWifiConnected(), NetworkProvider.isMobileDataConnected()

  • Added EHighlightOptions.HO_Selectable. HighlightRenderSettings.options has Int type now and it can represent a combination of EHighlightOptions values

  • Added MapView.scale() method

  • Added MapActivity.minZoomLevel, MapActivity.maxZoomLevel and MapActivity.canZoom

  • Added NavigationInstruction.getReturnToRoutePosition(), NavigationInstruction.getReturnToRouteIcon(), ENavigationStatus.WaitingReturnToRoute

Changed​

  • Renamed ContentStoreItem.filename to ContentStoreItem.fileName

  • GemUtilImages.asBitmap(image: SignpostImage?, width: Int, height: Int): Pair<Int, Bitmap?> changed to GemUtilImages.asBitmap(image: SignpostImage?, ...): Bitmap?, SignpoastImage.asBitmap(...): Pair<Int, Bitmap?> changed to SignpoastImage.asBitmap(...): Bitmap?

  • GemUtilImages.asBitmap(image: RoadInfoImage?, ...): Pair<Int, Bitmap?> changed to GemUtilImages.asBitmap(image: RoadInfoImage?, ...): Bitmap?

  • GemUtilImages.asBitmap(image: LaneImage?, ...): Pair<Int, Bitmap?> changed to GemUtilImages.asBitmap(image: LaneImage?, ...): Bitmap?

  • RoadInfoImage, SignpoastImage and LaneImage extend Image

  • RoadInfoImage.asBitmap(...): Pair<Int, Bitmap?> changed to RoadInfoImage.asBitmap(...): Bitmap?, LaneImage.asBitmap(...): Pair<Int, Bitmap?> changed to LaneImage.asBitmap(...): Bitmap?

Fixed​

  • Position recording functionality no longer dependent on DashCam feature

  • Fixed crash in GlSurfaceHolderAdapter

[1.7.0] - 2025-10-08​

Build: 7.1.25.41.85504BAA

Added​

  • Added new values to ELandmarkStoreType: MapHighwayExit, MapRoads, Overlays, Geofence

  • Added LandmarkStoreService.overlaysLandmarkStoreId and LandmarkStoreService.geofenceLandmarkStoreId

  • Added RoutePreferences.avoidGeofenceAreas and RoutePreferences.stickInsideGeofenceAreas

  • Added new route type (ERouteType.Scenic)

  • Added PolygonGeographicArea(coordinatesList: CoordinatesList) constructor.

  • Added PositionData.hasCoordinates(), ImprovedPostionData.hasCoordinates(), ImprovedPostionData.hasTerrainData(), ImprovedPostionData.terrainAltitude, ImprovedPostionData.terrainSlope

  • Added PositionService.positionPublishingPreferences and PositionService.getLastPublishedPosition()

  • Enabled Geofence support in SDK. Added Geofence, Login, PositionPublishingPreferences classes

[1.6.2] - 2025-07-16​

Build: 7.1.25.29.063A32EE

Fixed​

  • Improved GemGlSurfaceAdapter.onScale() behavior

[1.6.1] - 2025-06-15​

Build: 7.1.25.24.A0E07DC1

Added​

  • Added new categories for EGenericCategoriesIDs: ChargingStation, BicycleChargingStation, BicycleParking

Fixed​

  • Solved GEMSdk not running on Automotive Emulator. Updated isRunningOnEmulator() method

[1.6.0] - 2025-05-29​

Build: 7.1.25.22.5235077E

Added​

  • Added Route.extraInfo method

Changed​

  • Removed RecorderConfiguration.deviceModel

[1.5.5] - 2025-03-03​

Build: 7.1.25.10.7B562D2D

Fixed​

  • Fixed erroneous map rotation when in navigation mode

[1.5.4] - 2025-02-18​

Build: 7.1.25.8.85E3F991

Fixed​

  • Fixed NavigationService.getTurnId64() output for waypoints turns (the waypoint side was wrongly reported)

[1.5.3] - 2025-02-06​

Build: 7.1.25.6.A8D23EF5

Added​

  • Added SoundPlayingService.setDefaultHumanVoice() and ITTSPlayerInitializationListener.onTTSPlayerInitializationFailed() methods

  • Added ESConfigKeys.Position.ImprovedPosPreferRouteSnap property

[1.5.2] - 2025-01-23​

Build: 7.1.25.4.8359B06D

Changed​

  • Improved resume in route over track navigation

[1.5.1] - 2025-01-15​

Build: 7.1.25.3.9ED2450F

Fixed​

  • Fixed crash when computing a bike route

[1.5.0] - 2025-01-08​

Build: 7.1.25.2.0C32661A

Added​

  • Added ElectricBikeProfile.refSpeed, ElectricBikeProfile.ignoreLegalRestrictions properties

Fixed​

  • Fix regarding roundabout turn image

  • Fixed issues regarding AddressInfo usage

[1.4.0] - 2024-11-14​

Build: 7.1.24.46.2F7651F2

Fixed​

  • Fix regarding SDK log size

  • Fixes regarding PositionData: ImprovedPositionData, AccelearationData, RotationData, CameraData objects construction on ARM32 devices

Changed​

  • Replaced default GPS arrow

  • Improved navigation on a GPX route

[1.3.0] - 2024-10-25​

Build: 7.1.24.43.11923D7B

Added​

  • Added MapView.startTrackPositions(), MapView.getTrackedPositions(), MapView.isTrackedPositions() and MapView.stopTrackPositions() methods

Changed​

  • Bug fixing and improvements

[1.2.2] - 2024-09-25​

Build: 7.1.24.39.F5DE2589

Changed​

  • Update consumer proguard file of the SDK

[1.2.1] - 2024-09-10​

Build: 7.1.24.37.74598F2D

Added​

  • Added a consumer proguard file to the SDK. In this case the optimisation will apply when minify with R8 is enabled in client app's build settings

[1.2.0] - 2024-08-29​

Build: 7.1.24.35.050EFEB7

Added​

  • New ways to construct CircleGeographicArea and Marker objects

Changed​

  • Refactor Weather class

[1.1.0] - 2024-08-20​

Build: 7.1.24.34.A27F8A0A

Added​

  • Added MarkerCollectionRenderSettings.setCustomMarkerSettings() method

  • Traffic.addPersistentRoadblock() received event ID parameter. Now can add a persistent roadblock using a geographic area

  • Added Traffic.removePersistentRoadblock(id: String) method

Fixed​

  • Fixed PermissionsHelper.notifyOnPermissionsStatusChanged() call (it did nothing in previous release)

Changed​

  • Optimizations regarding map rendering & touch events handling

[1.0.2] - 2024-07-24​

Build: 7.1.24.30.FB70C514

Added​

  • Magic Lane provides the Maps SDK for Android also via Maven. Find more information about how to do this at Maps SDK Android Kotlin Maven Package Registry Wiki

  • Added GemSdk.generateGPSLog() method

  • Added MapView.displaySimplifiedRoute, MapView.displaySimplifiedRouteTurn

  • Added LandmarkStoreService.mapCitiesLandmarkStoreId property, GemUtil.getFormattedWaypointName method

  • Added save(), load(), sketches(), isSketches() methods to MapViewMarkerCollections class. Added MarkerSketches class

  • Added MarkerCollectionRenderSettings.setCustomMarkerSettings() method

  • Provided error codes on LandmarkStore's add, remove, update operations

Fixed​

  • Fix regarding the provided error message for a caught exception

  • Fixed GemUtil.pairFormatLandmarkDetails output for situations in which the input landmark is a city / settlement

  • Fixes regarding missing MapViewListener.onReady() notification, onDefaultMapViewCreated() notification for GemOffscreenSurfaceView, SearchService.searchByFilter() reference point

  • Fixed crash related to GemOffscreenSurfaceView.destroy() call

[7.1.24.20.8B92211B] - 2024-05-15​

Fixed​

  • Fix related to route simulation

[7.1.24.19.64184A80] - 2024-05-09​

Added​

  • Added DataBuffer.defalte(), DataBuffer.inflate() methods

  • Added MapView.addRouteGeometry, MapView.removeRouteGeometry(), MapView.addNavigationInstructionGeometry(), MapView.removeNavigationInstructionGeometry(), MapView.removeAllMarkers() methods

  • Added NavigationInstruction.exportAs() method

  • Added RoutePreferences.setBuildConnections(), RoutePreferences.getBuildConnections(), RoutePreferences.getBuildConnectionsMaxLength() methods

Changed​

  • RoutePreferences.setEmergencyVehicleMode(value: Boolean, extraFreedom: EEmergencyExtraFreedomLevels) became RoutePreferences.setEmergencyVehicleMode(value: Boolean, extraFreedom: Int = 0)

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

Added​

  • Added ShowUserImage to ERouteRenderOptions enum

  • Added MapView.getClosestAddress() method

Fixed​

  • Fixed regarding reported network connection type

  • Fixed crash inside GemUtil.getDistText() method

[7.1.24.6.9D80705D] - 2024-02-09​

Added​

  • Added NavigationService.getTurnId32(turnDetails) and NavigationService.getTurnId64(turnDetails)

Fixed​

  • Fixed reported crash regarding GPS map matching

[7.1.24.3.AC9A0B85] - 2024-01-18​

Added​

  • Added support for EV routing

  • Added MapSceneObject.saveState(), MapSceneObject.restoreState() methods

  • Added DataBuffer.fromStr(), DataBuffer.toStr() methods

  • Added FollowPositionPreferences.touchHandlerModifyPersistent property

  • Added support for reading map styles from assets

  • Added MapViewPreferences.mapLabelsFading property

  • Added EVCarModel class, RoutingService.evCarModels property

Fixed​

  • Fixed regarding SDK reinitialization

  • Fixed error regarding sound playing notifications (did not receive any notification on the provided sound playing listener)

  • Fixed crash regarding Pair<Double, Double>, Pair<Int, Int> data types usage

Changed​

  • Changed min SDK level from 19 from 21

  • PersistentRoadblockListener.onRoadblockExpired(eventId: Int) became PersistentRoadblockListener.onRoadblocksExpired(list: TrafficEventList), PersistentRoadblockListener.onRoadblockActivated(eventId: Int) became PersistentRoadblockListener.onRoadblocksActivated(list: TrafficEventList)

[7.1.23.41.63AB0887] - 2023-10-13​

Added​

  • Added RouteRenderSettings.lineType property

  • Added GPXThumbnailImage example

  • Added routeRenderSettings parameter to MapView.presentRoute()

Removed​

  • Removed zoomLevel parameter from MapView.presentRoute() and MapView.presentRoutes()

[7.1.23.41.CD21BBB5] - 2023-10-11​

Added​

  • Added GemOffscreenSurfaceView class (for rendering the map inside an offscreen view)

  • Added onStatusChanged lambda to RoutingService (this is the only way in which user can be notified about "Waiting Internet Connection" state)

Fixed​

  • Fixed memory leaks. Fixed SDK reinitialization

  • Fixed crash regarding RoutingService.calculateRoute() usage

Removed​

  • Removed RoutePreferences.svSortingStrategy

[7.1.23.40.3E31A25A] - 2023-10-04​

Changed​

  • Bug fixing and improvements.

[7.1.23.34.BD3E9DF4] - 2023-08-22​

Added​

  • Added RoutePreferences.departureHeading, RoutePreferences.setDepartureHeading(head, accuracy), RouteInstruction.hasRoadInfo, RouteInstruction.roadInfo, RouteInstruction.roadInfoImage

  • Added Hydrants, EmergencyServicesSupport and CivilEmergencyInfrastructure to EGenericCategoriesIDs enum

Changed​

  • Documented RoutePreferences.setBuildTerrainProfile()

[7.1.23.33.8BAF5E3B] - 2023-08-18​

Changed​

  • Bug fixing and improvements.

[7.1.23.29.6D0B6AFC] - 2023-07-22​

Added​

  • Added GLCall object (to be used for posting calls on GL thread)

Fixed​

  • Fixed reported crash regarding markers display

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

Changed​

  • Bug fixing and improvements.

[7.1.23.21.0B8B1AC2] - 2023-05-25​

Changed​

  • Bug fixing and improvements.

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

Added​

  • Added GemUtilImages.setDpi(dpi: Int) method

  • Added RouteSimulationWithoutMap example

Changed​

  • MagicADASListener.onVehicleData(timestamp: Long, headway: Float, distance: Float) became MagicADASListener.onVehicleData(timestamp: Long, vehicle: Obstacle)

Fixed​

  • Fixed crash inside SetTTSLanguage example

[7.1.23.14.BF4263FC] - 2023-03-30​

Added​

  • Added RoutePreferences.setEmergencyVehicleMode(Boolean, EEmergencyExtraFreedomLevels) method

  • Added MapViewPreferences.setViewAngle(value: Int, animated: Boolean = false) method

  • Added center parameter to CanvasListener.onPinch() method

Removed​

  • Removed CanvasListener.onRotate() method

[7.1.23.13.68D7B4E1] - 2023-03-30​

Added​

  • Added FollowPositionPreferences.setViewAngle(angle, animated) method

  • Added Inertial to PositionData.EFixQuality enum (this fixes reported crash regarding PositionData.fixQuality usage)

[7.1.23.13.00B7E257] - 2023-03-28​

Fixed​

  • Fixed issue regarding global reference table overflow

[7.1.23.12.9D4F3B36] - 2023-03-21​

Added​

  • Added ExternalBattery, ExternalCompass, ExternalAcceleration, ExternalTemperature, ExternalMagneticField, ExternalOrientation, ExternalAttitude, ExternalActivity, ExternalCamera (to be used to push data from corresponding sensors to an external data source)

  • Added RoadSafetyAlerts.createSensorDataLogger(), RoadSafetyAlerts.saveSensorDataLog() methods

  • Added allowOnline parameter to GemSdk.initSdkWithDefaults() method

Changed​

  • Renamed SenseDataSource.getLastData() to SenseDataSource.getLatestData()

  • Renamed package aidashcam to adas

  • Moved Recorder from package sensordatasource to new dashcam package

  • Renamed RoadSafetyAlerts to MagicADAS, RoadSafetyAlertsListener to MagicADASListener

Removed​

  • Removed SenseDataSource.getFirstData()

[7.1.23.5.0AA862C4] - 2023-02-01​

Changed​

  • Bug fixing & improvements.

[7.1.23.4.8D1F18B9] - 2023-01-25​

Added​

  • Format landmark details methods to GemUtil

  • New postLambdasOnMain parameter to GemSurfaceView constructor

  • Support for saving / restoring map state inside surface view, for situations in which surface is recreated

  • New onMapAngleUpdated API method to MapViewListener class

Changed​

  • Fix regarding free text search

  • Fix postal code search via address search service

Removed​

  • MapView.onTouchRotate() method

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

Added​

  • New viewAngle parameter for MapView.centerOnRouteInstruction(), MapView.centerOnRouteTrafficEvent() methods

  • New initial parameter for MapView.shove() method

Changed​

  • Refactored AI Dash Cam CalibrationConfiguration class (some members disappeared, others have been renamed)

  • Fixed crash regarding Coordinates object usage

  • Fixed crash regarding overlay items handling

  • Fixed crash regarding SDK objects list usage

Removed​

  • MapView.onTouchShove() method

[7.1.22.46.8999C03E] - 2022-11-14​

Changed​

  • Bug fixing & improvements.

[7.1.22.44.2B4D1305] - 2022-11-01​

Changed​

  • Bug fixing & improvements.

[7.1.22.41.6B0D8D54] - 2022-10-10​

Changed​

  • Bug fixing & improvements.

[7.1.22.39.4A2FB489] - 2022-09-27​

Added​

  • SDK log is written to a private file (which can be sent to GM, if something wrong is happening)

  • Added onInitSdk lambda to GemSurfaceView class that allows user to perform a custom SDK initialization (see above)

  • Added sdkToken attribute to GemSurfaceView class (the user can now specify SDK token inside layout xml, as an attribute of GemSurfaceView element)

  • Added SendDebugInfo, SpeedTTSWarning, BLEServer, BLEClient examples

Changed​

  • Used Context.getExternalFilesDirs("") output for default app internal / external paths. If the user wants to keep previous default paths, a custom SDK initialization should be done:
gemSurfaceView.onInitSdk = { sdkToken ->
val internalPath = if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.N)
{
    dataDir.absolutePath
}
else
{
    filesDir.absolutePath
}

GemSdk.initSdkWithDefaults(this, sdkToken, null, internalPath, getExternalFilesDir("")?.absolutePath)
}

  • PositionService is now an object. Fixed DriverBehavior and VoiceInstrRouteSimulation examples

  • Fixed crash regarding search operation

  • Improved Favourites example behavior

  • Fixed turn appearance inside RouteSimulationWithInstructions example

  • Refactored LocationWikipedia, MapGestures, MapPerspectiveChange, MultipleSurfacesInFragment, MultipleSurfacesInFragmentRecycler examples

[7.1.22.31.A096D237] - 2022-08-04​

Added​

  • Bug fixes and improvements

  • Add new SDK examples: RangeFinder, SetTTSLanguage

[7.1.22.26.D501C72F] - 2022-06-30​

Added​

  • Enum: EMarkerLabelingMode, ETouchGestures, ETrafficAvoidance

  • Member: MapViewPreferences.trafficVisibility

    ERouteRenderOptions.ShowHighlights

    MarkerCollectionRenderSettings: labelingMode, labelTextColor, labelTextSize, labelGroupTextColor, labelGroupTextSize, imageSize

    TruckProfile.maxSpeed

  • Methods: MapViewPreferences: enableTouchGestures, isTouchGestureEnabled

Changed​

PathCollection had been renamed to MapViewPathCollection

SdkSettings.setAllowMapUpdate renamed to setAllowAutoMapUpdate

MarkerCollection.name is var now.

MapViewPreferences.paths returns MapViewPathCollection now.

RoutePreferences.avoidTraffic is now ETrafficAvoidance instead of Boolean.

Removed​

MarkerCollectionRenderSettings.pointsTextSize

MapCamera: getTopographyAltitudeMeters, setCameraPositionAboveTopography, setCameraBoundingBoxCentered

[7.1.22.18.90A12C26] - 2022-05-04​

Added​

  • Class: ObjectLaneDetector, ObjectLaneDetectorOutput, MapViewRoutesCollection, RouteRenderSettings, MapViewRoute

  • Enum: ERouteRenderOptions

  • Enum Value: EFrameFit.ZoomFill

    EEngineType.ImageProcessing

    EExecutionType.CPU_GPU

  • Method: MapScene.getDefScene

    Path.getCoordinatesAtPercent

    SettingsService.flush

    NavigationListener.onTraveledRouteTrackTrimmed

    PositionData.produceMockPosition

    Datasource: isMockData, setMockData

    MapViewListener: onCursorSelectionUpdatedPath, onCursorSelectionUpdatedMapSceneObject

    MapView: scroll, fling

    MapCamera: setCameraBoundingBoxCentered, setCameraRelativeToTarget, generatePositionAndOrientationRelativeToTarget, setCameraRelativeToCenteredTarget, generatePositionAndOrientationRelativeToCenteredTarget, setCameraTargetCentered, generatePositionAndOrientationTargetCentered, setCameraOrientation, setCameraPositionAboveTopography, getTopographyAltitudeMeters, setCameraPosition, generatePositionAndOrientationWithHeading, generatePositionAndOrientation

    Recorder.isAudioRecording

    Rgba.isLight

  • Method params: SenseDataSource.addListener added preferences as optional

    GemSdk.initSdkWithDefaults added: timer, internalPath, externalPath, language, languageTts, savePolicy, listener, appVariant, useApiExceptions, logger, breakpadCallback

    pos to MapSceneObject.produce

  • Members: MapView.cursorSelectionSceneObject

    MapSceneObject.scaleFactor, MapSceneObject.maxScaleFactor, NavigationInstruction.routeTrack

    SdkSettings.isMapDataReady, CameraConfiguration.rotation, Rgba.luma

    MapScene: scaleFactor, maxScaleFactor

    CameraData.orientation

Changed​

Default save policy had been changed to UseBothPreferInternal instead of UseBothPreferExternal

CanvasBufferRenderer.updateImage's orientation input type is now EOrientationType

CameraData.rotation had been renamed to orientation with data type : EOrientationType

OffboardListener related EStatus, EReason had been renamed to EOffboardListenerStatus, EOffboardListenerReason

NativeRefObj renamed to GemNativeObj

SdkList renamed to GemList

SdkLog renamed to GemLog

UtilGemImages renamed to GemUtilImages

SdkHandler renamed to GemSdkHandler

SdkUtil renamed to GemUtil

SdkMap renamed to GemMap

SdkCall renamed to GemCall

MapViewPreferences.routes will now return MapViewRoutesCollection

MarkerCollectionDisplaySettings renamed to MarkerCollectionRenderSettings

OverlayDisplaySettings renamed to OverlayRenderSettings

Renamed SenseDataSource.get/setConfiguration to get/setPreferences.

Renamed ConfigKey to ESConfigKey

Renamed ESConfigKey.key* to ESConfigKey.*

Refactored EFrameFit's values.

Removed​

ECameraStateExtraData

MapCamera: restoreCameraState/saveCameraState's extraData param

CanvasBufferRenderer.updateCameraData's rotation input param

ENavigationStatus.WaitingData

RoutesCollection: getLabel, setLabel, getImages, setImages, hideLabel

RoutesCollection.add input param : label, image

CameraData.rotation

[7.1.22.8.567F8EF8] - 2022-02-21​

Added​

  • Enum: EFollowPositionMapRotationMode

    ERouteType

    EWheelchairAccessible

    EBikesAllowed

  • Enum member: ESdkCapabilities: Timezone, Sound, Projection

    EHighlightOptions.Bubble

  • Class member: FollowPositionPreferences.mapRotationMode

    IOpenGLContext.textureScaleFactor

    FollowPositionPreferences.accuracyCircleVisible

  • Method: FollowPositionPreferences: setMapRotationMode, isTrackObjectFollowingMapRotation

    OverlayItem: getPreviewData, hasPreviewExtendedData, getPreviewExtendedData, cancelGetPreviewExtendedData, RouteTrafficEvent

    TrafficEvent: getPreviewData, cancelGetPreviewData

  • Method param: startStamp: Time to LogUploaderListener.onLogStatusChanged

    albumName: String to RecorderBookmarks.exportLog

Changed​

Renamed RecorderConfiguration.diskSpaceLimit to diskSpaceLimitMb

Renamed SensorDelay to ESensorDelay

Renamed StringIds to EStringIds

Replaced IOpenGLContext.fontScaleFactor with IOpenGLContext.fontModifiers

Removed​

  • Class member: MapServiceExtensions.gpsAccuracyCircleEnabled

  • Method: MapViewPreferences.toggle2DWithAltitude

Fixed​

  • TTS not playing while navigating.

[7.1.22.6.6BACA322] - 2022-02-08​

Added​

  • Class: SceneObjectData

  • Methods: MapView.getHighlightArea

    MapView.getOptimalHighlightCenterViewport

  • Enum values to ESdkCapabilities: Content, Dashcam, Weather, Vrp, Sense, Places.

Changed​

LandmarkStoreService.createLandmarkStore return type to Pair<LandmarkStore?, ErrorCode>

EExtendedDataType is deprecated now. EExtendedDataType renamed to EPreviewDataType

MapViewPreferences.getMapViewPerspective is used as member MapViewPreferences.mapViewPerspective

MapViewPreferences.getViewAngle is used as member MapViewPreferences.viewAngle

MapViewPreferences.getTiltAngle is used as member MapViewPreferences.tiltAngle

MapViewPreferences.followPositionWithRoutePreferences renamed to followPositionPreferences

  • Moved following from MapViewPreferences to FollowPositionPreferences: followPositionCameraFocus, setFollowPositionTouchHandlerModifyLimits, getFollowPositionTouchHandlerExitAllow, getFollowPositionTouchHandlerModifyHorizontalAngleLimits, getFollowPositionTouchHandlerModifyVerticalAngleLimits, getFollowPositionTouchHandlerModifyDistanceLimits

    HighlightRenderSettings.iconSz is deprecated now. iconSz renamed to imageSize

    MapView.getZoomLevel is used as member MapView.zoomLevel

    MapView.getSlippyZoomLevel is used as member MapView.slippyZoomLevel

    Renamed enum SceneObjectFileFormat to ESceneObjectFileFormat

    MapSceneObject.produce.. is based now on a SceneObjectData instead of DataBuffer and its format.

    MapSceneObject.customizeDefPositionTracker's input to SceneObjectDataList

    MapSceneObject.producePositionTracker return type to Pair<MapSceneObject?, ErrorCode>

Removed​

enum ECameraFollowMode

FollowPositionPreferences's default constructor.

param mode: ECameraFollowMode from: MapViewPreferences.setMapViewPerspective and from get.

param mode: ECameraFollowMode from: MapViewPreferences.setViewAngle and from get.

param mode: ECameraFollowMode from: MapViewPreferences.setTiltAngle and from get.

param mode: ECameraFollowMode from: MapView.setZoomLevel, MapView.setSlippyZoomLevel, and from corresponding getters.

field MapView.cameraFollowMode

method MapView.cursorSelectionRouteInstruction

Library dependency: com.google.android.gms:play-services-location

[7.1.22.2.417AD833] - 2022-01-11​

Added​

  • Class: ImprovedPositionData

  • Enum: GemSdk.ESdkCapabilities

  • Member: ConfigKey.kKeyImprovedPositionUpdateFreq

    ConfigKey.kKeyImprovedPositionDefTransportMode

    OverlayItem.categoryId

    GemSdk.capabilities

    GemError.MissingCapability

    EViewOnlineServiceType.External

Changed​

PositionService.addListener and PositionService.position is using ImprovedPosition by default instead of direct sensor Position.

AddressInfo.format allows null inputs as default.

Fixed​

GemGlSurfaceCallback zoom in/out in default map view not pan around anymore.

AddressInfo.format works properly now.

[7.1.21.50.7E1BDC39] - 2021-12-16​

Added​

  • Class: GemSurfaceContainerAdapter

    FollowPositionPreferences

  • Enum: ELandmarkFileFormat

    AcclerationData.EUnitOfMeasurement

  • Method: BasicShapeDrawer.createTexture with image param

    MapView.getOptimalRoutesCenterViewport

    LandmarkStore: importLandmarksBuffer, importLandmarks, cancelImportLandmarks, startFastUpdateMode, stopFastUpdateMode, isFastUpdateMode

    Image.produceWithPath

    RoutePreferences: isAutomaticTimestamp, setIsAutomaticTimestamp

    EnumHelper.fromOrdinal

    MapViewListener and MapView's lambdas : onHoveredMapLabelHighlightedLandmark, onHoveredMapLabelHighlightedOverlayItem, onHoveredMapLabelHighlightedTrafficEvent, MapView.highlightHoveredMapLabel

  • Member: AccelerationData.unit

    MapView.cursorSelectionPath

  • Auto fetch offline maps from assets. See RouteSimulationOffline example.

Changed​

BasicShapeDrawer.renderShapes nullable params

RectF: center and dimensions to Float types.

GemGlSurfaceCallback renamed to GemGlSurfaceAdapter

PermissionsHelper is singleton now. See PermissionsHelper.instance

Removed​

Member : LandmarkStore.fastUpdateMode Android Auto direct dependency. End user have to match min sdk requirements for android auto dependency when implementing.

[7.1.21.46.DA24169E] - 2021-11-15​

Added​

  • Class: ElectricBikeProfile

  • Fields: RoutePreferences: eBikeProfile, defaultEBikeProfile

    AbstractGeometryImage.aspectRatio, Image.aspectRatio

    GemGlSurfaceCallback: onVisibleAreaChanged, visibleArea

    MapViewPreferences: mapDetailsQualityLevel

  • Method: MapViewPreferences: isMapSceneObjectVisible, setMapSceneObjectVisibility

    TruckProfile : constructor with param.

    GeographicArea.convert

  • Method Params: RoutePreferences.setBikeProfile added eProfile: ElectricBikeProfile

  • Enum: EEBikeType, EMapDetailsQualityLevel

  • EnumValue: ERouteType.Economic

Changed​

  • TruckProfile.weight renamed to TruckProfile.mass.

  • GemGlSurfaceCallback is available only in minApi 23 SDK.

Removed​

GlSurfaceHolderAdapter is internal now.

Fixed​

  • Startup crash on Android 8 or lower devices.

[7.1.21.43.0A164E49] - 2021-10-30​

Added​

  • Class : BrakeDetector

    TrafficSignDetector

    ClassifiedObject

  • Enum: EClassificationFilter

  • Member: NativeRefObj.address

    SocialReportsOverlayCategory: uid, overlayUid, name, image

    IBitmap: width, height

    DetectedObject.classifiedObject

    ObjectDetector.classificationFilter

    Rgba.argbValue, Rgba.bgraValue

    MapCamera.position, MapCamera.orientation

    TrafficSignClassifier.classificationTime

    BrakeClassifier.classificationTime

    ObjectDetector.detectionTime

    LaneDetector.detectionTime

    Landmark.extraImage

    MapDetails.isoCodeForCurrentPosition

  • Method: SocialReportsOverlayCategory.hasSubcategories()

    SdkSettings.setAllowConnection(value: Boolean)

    LogUploaderListener constructor(postOnMain: Boolean = false)

    NavigationListener.create

    AlarmListener.create

    MapView: produce and produceByContext without listener: MapViewListener

    SocialOverlayItemListener.create

    LogUploaderListener.create

    RoadSafetyAlertsListener.create

    LandmarkStoreListener.onLandmarkStoreRegistered

    SdkCall.execute with maxWaitMs

    DataSource.addListener with array ouf EDataType

    TrafficSignClassifier.classifyList

    TrafficSignClassifier.getOutput

    ObjectDetector.updateClassificationFilter

    BrakeClassifier.classifyList

    BrakeClassifier.getOutput

    Rgba: constructor with Color, swapRedBlue, asColor

    MapViewPreferences.setDrawFPS

    SearchPreferences.removeAllCategoryFilters

    MapView.invalidate

    OverlayService: enableOverlayOfflineDataGrabber, disableOverlayOfflineDataGrabber, isOverlayOfflineDataGrabberEnabled, isOverlayOfflineDataGrabberSupported

    MapViewPreferences.getDrawFPS

  • Param: autoInitLiveDataSource to GemSdk.initSdkWithDefaults

    rect to TrafficSignClassifier.classify

    rect to BrakeClassifier.classify

    postLambdasOnMain to MapView.produce, MapView.produceByContext

    allowChargeNetwork, roadMapAutoUpdateListener to SdkSettings.setAllowMapUpdate

    address to NativeRefObj.release

    onStarted to : RoutingService.calculateRoute methods

    critical to TrafficSignClassifier.produce, ObjectDetector.produce, LaneDetector.produce, BrakeClassifier.produce

    completionCallback to RecorderBookmarks.exportLog

Changed​

  • SdkError is now considered as Int instead of enum.
  • MainSceneObjects renamed to EMainSceneObjects
  • NNEngineType renamed to EEngineType
  • NNExecutionType renamed to EExecutionType
  • TrafficSignClassifier.detect renamed to classify
  • BrakeClassifier.detect renamed to classify
  • EExtraInfo.AttachedTrainstation renamed to EExtraInfo.AttachedTrainStation
  • OffboardListener.onOnlineWorldMapSupportDisabled renamed to onWorldwideRoadMapSupportDisabled
  • OffboardListener.onOnlineWorldMapSupportEnabled renamed to onWorldwideRoadMapSupportEnabled
  • OffboardListener.onOnlineWorldMapSupportStatus renamed to onWorldwideRoadMapSupportStatus
  • OffboardListener.onWorldMapVersionUpdated renamed to onWorldwideRoadMapVersionUpdated
  • OffboardListener.onOnlineWorldMapUnsupportedCapabilities renamed to onWorldwideRoadMapUnsupportedCapabilities
  • DataSourceListener.onNewData's SenseData param replaced with EDataType
  • SdkError.ResourcesMissing renamed to SdkError.ResourceMissing
  • SdkError.getDescriptionText renamed to getMessage
  • SdkError renamed to GemError
  • RoadSafetyAlerts.setWindshieldLateralDisplacement renamed to setCameraLateralDisplacement
  • Size, SizeF, Xy, XyF, Tuple4d, Tuple3d, Rect, RectF
  • RoutePreferences.routeResultType used as member instead of method.
  • NavigationListener.canPlayNavigationSound used as member instead of method.
  • SocialOverlay.prepareReporting param reorder.
  • ImageDatabase.import replaced String param with data: DataBuffer, format: EImageFileFormat
  • ImageDatabase.remove replaced Image param with imageId: Int

Removed​

  • CameraConfiguration.autoFocusEnabled
  • ELandmarkStoreType.Last
  • EGlobalLandmarkCategory.Base, EGlobalLandmarkCategory.Last
  • EContactInfoFieldType.Last
  • Canvas.isView
  • EMapProviderId.Last
  • GemSurfaceView: getGlContext, getScreen, getDefaultMapView
  • EContentType.First, EContentType.Last
  • MapView.defaultMapViewListener()
  • SocialOverlayItemListener constructor with lambda
  • LogUploaderListener constructors with params
  • Screen.fps

Fixed​

  • SearchService not clearing category filters before any search is made.
  • TextState not allocating object.

[7.1.21.38.70F93E78] - 2021-09-20​

Added​

  • enum ETrackingModeUpdateRequest, ECameraStateExtraData

  • Member: MapSceneObject.visibility

    PTRoute.polygonGeographicArea

    Route.polygonGeographicArea

    LandmarkBrowseSession.settings

  • Param: removeLmkContent to LandmarkStore.removeCategory

    breakpadCallback to GemSdk.initialize

  • Method: MapViewListener: onEnterManuallyAdjustedFollowingPosition, onExitManuallyAdjustedFollowingPosition

    MapView: restoreFollowingPosition, isFollowingPositionTouchHandlerModified

    MapSceneObject: getDefPositionTracker, customizeDefPositionTracker

    MapScene.getDefScene

    IBitmap: produce, produceBgr888, produceAlpha8

    LaneDetector.computeAccuracy

    TrafficSignClassifier.computeAccuracy

    BrakeClassifier.computeAccuracy

    Rect.pointInRectangle

    RectF.pointInRectangle

    MapViewPreferences: setFollowPositionTouchHandlerModifyLimits, getFollowPositionTouchHandlerExitAllow, getFollowPositionTouchHandlerModifyHorizontalAngleLimits, getFollowPositionTouchHandlerModifyVerticalAngleLimits, getFollowPositionTouchHandlerModifyDistanceLimits

    LandmarkStoreListener: onLandmarksUpdated, onLandmarksRemoved

    LandmarkStore: removeAllLandmarks, setLandmarkCategory, getLandmarksByArea

    MapCamera: saveCameraState, restoreCameraState

    ImageDatabase.getTrafficSignImage

Changed​

SceneObjectFileFormat's values.

ETrafficSignType's values.

MapSceneObject.produce methods require lists of DataBuffer and formats instead of one of each.

LandmarkStore.createLandmarkBrowseSession input params

Preset member images of ImageDatabse are now static. (tollImage, ferryImage, greenBallImage, yellowBallImage, redBallImage)

  • Renamed method: MapViewListener: onEnterManuallyAdjustedFollowingPosition to onEnterTouchHandlerModifyFollowingPosition

    MapViewListener: onExitManuallyAdjustedFollowingPosition to onExitTouchHandlerModifyFollowingPosition

  • Renamed class: SdkIcons to SdkImages

    SdkImages.Other_Engine to SdkImages.Engine_Misc

Removed​

  • classes: Bitmap, AdjustableBitmap

  • member: MapView.followingPositionDisplayMode

  • enum : EPositionDisplay

  • method: AbstractGeometryImage.renderInto

    Image.produceWithPath

    LandmarkStore: removeLandmarkFromCategory, removeLandmarkFromAllCategories,

  • Param: blend from Image.render, AbstractGeometryImage.render, AbstractGeometryImage.renderArrow, RoadInfoImage.render, LaneImage.render

  • enum value: ETrafficSignType.All, EBrakeType.All, EObjectType.All

[Unreleased] - 2021-09-01​

Added​

  • class MapSceneObject

  • enum MainSceneObjects

  • Method: PathCollection.clear

    Rect.center, Rect.dimensions. Same for RectF.

    Screen.needsRender

    MapServiceExtensions.getHighlightGroupItemIndex

    MapView.deactivateAllHighlights

    Marker.setCoordinates

    MarkerCollectionDisplaySettings.setPointMarkerLabelExtractor

    Route.getDominantRoads, PTRoute.getDominantRoads

    CanvasBufferRenderer.updateCameraData, CanvasBufferRenderer.updateImage

  • Property: MarkerCollectionDisplaySettings.pointsTextSize

    Coordinates.sceneObject

  • Method input param: SocialOverlay.report: added categoryId

    highlightId to MapView.activateHighlightLandmarks, MapView.activateOverlayItemsHighlight, MapView.deactivateHighlight

    MapView.startFollowingPosition: navArrow, trackMethod

    MapView.followPosition: navArrow, trackMethod

    parentSceneObject to Coordinates's constructor, Coordinates.assignValues

Changed​

  • Method inputParam: SocialOverlay.prepareReportingWithCoordinates, SocialOverlay.prepareReporting : removed dryRun

  • Renamed class ViewCustomization to MapServiceExtensions

  • Renamed MapView.customization to MapView.extensions

  • EasyAccess: object.getMember changed to object.member for easy access.

  • EasyAccess: object.setMember(value) changed to object.member = value for easy access.

Removed:​

  • Method: Image.renderWithMask, AbstractGeometryImage.renderWithMask

    MapServiceExtensions.setCursorTexture

    CanvasBufferRenderer.uploadFrame

[Unreleased] - 2021-08-09​

Added​

  • Enum Value: EValueType.ListValue

  • Method: Parameter: key, valueList

    SocialOverlay: getReportSnapshot, prepareReportingWithCoordinates, prepareReporting,

    report, confirmReport, denyReport, updateReport, deleteReport, addComment

    SocialReportsOverlayCategory: parameters,

    Time.getTimeZoneMillisecondsTime

    CanvasBufferRenderer: frameFit, scaleFactor, translateFactor

    BasicShapeDrawer: createTexture with image as ByteArray

    Size.isEmpty, SizeF.isEmpty

    GemSdk.produceDefaultLiveDataSource

    SdkCall.lock, SdkCall.unlock

  • Method input param: BasicShapeDrawer.renderShapes: translationFactor: XyF?, scaleFactor: XyF?

    SocialOverlay.cancel: listener: ProgressListener

    GemSdk.initialize: autoInitLiveDataSource: Boolean = false

  • Method output param: In NavigationService added SdkError as Int for startNavigationWithRoute, startSimulation, startSimulationWithRoute

  • Class: SocialUsersOverlayInfo, LaneDetector, LaneDetectorOutput, TrafficSignClassifierOutput, TrafficSignClassifier, Obstacle, CalibrationConfiguration, RoadSafetyAlertsListener, InitializationConfiguration, RoadSafetyAlerts, BrakeClassifierOutput, BrakeClassifier

Changed​

  • Renaming: SocialReportsOverlayCategory: getCountry to country, getSubcategories to subcategories

    SocialOverlay: getReportsOverlayInfo to reportsOverlayInfo, getUsersOverlayInfo to usersOverlayInfo, registerIMarkerListener to registerOverlayItemListener, unregisterIMarkerListener to unregisterOverlayItemListener

Removed​

  • SocialReportsOverlayCategory: getValidity, getImpactRadius

[7.1.21.30.F7B1DCD6] - 2021-07-27​

Added​

  • Class:

    SocialReportsOverlayCategory

    SocialReportsOverlayInfo

  • Methods:

    Rect.toRectF for fast conversion

    RectF.toRect for fast conversion

    RectangleGeographicArea.set with coords, horizontal and vertical radius

    MarkerCollectionDisplaySettings.polylineInnerSize and MarkerCollectionDisplaySettings.polylineOuterSize

    OverlayCategory.subcategories and OverlayCategory.hasSubcategories

    OverlayInfo.getCategory and OverlayInfo.hasCategories

    SocialOverlay.getReportsOverlayInfo

    SocialOverlay.getUsersOverlayInfo

    Static in Time: daysFromMilliseconds, hoursFromMilliseconds, minutesFromMilliseconds, secondsFromMilliseconds

  • Method Param: categoryId for OverlayService: enableOverlay, disableOverlay, isOverlayEnabled

Changed​

  • Method Param: In OverlayMutableCollection: add, addByCategory, remove, removeByCategory, contains, containsByCategory. Only the overlayId is required instead of whole object.

[7.1.21.29.5996E8AB] - 2021-07-21​

Added​

  • Class: BasicShapeDrawer for drawing basic things over GemSurfaceView.

  • Methods: GemSurfaceView.onDrawFrameCustom for custom gl drawing support.

  • Other: More predefined colors as static in Rgba

Changed​

  • object.getMember changed to object.member for easy access.

  • object.setMember(value) changed to object.member = value for easy access.

  • Renamed: Util.getPhonePath renamed to Util.getAppDirInternalPath

    Util.getSdCardPath renamed to Util.getAppFilesDirExternalPath

Removed​

  • ISOCode object replaced with String.

[7.1.21.27.F0A8520E] - 2021-07-08​

Added​

  • Enum values:

    ERoutingAlgoModifiers.DisableFallbacks

  • Methods:

    Screen.getFPS

    GuidedAddressSearchPreferences.setAllowFuzzyResults

    GuidedAddressSearchPreferences.getAllowFuzzyResults

    SearchPreferences.setAllowFuzzyResults

    SearchPreferences.getAllowFuzzyResults

Changed​

  • EBuildingsVisibility's values

  • SteepSection.getCateg renamed to SteepSection.getCategory

  • SteepSection.setCateg renamed to SteepSection.setCategory

[7.1.21.26.568B4C80] - 2021-07-02​

Added​

  • Shortcuts:

    PositionListener can be used directly with a lambda instead of extend and override its methods.

    LogUploaderListener can be used directly with a lambda instead of extend and override its methods.

    SocialOverlayItemListener can be used directly with a lambda instead of extend and override its methods.

    MapViewPreferences.landmarkStores can be called instead of MapViewPreferences.lmks

    SearchPreferences.landmarkStores can be called instead of SearchPreferences.lmks

    AlarmService.landmarkStores can be called instead of AlarmService.lmks

    ContentUpdater.getContentType returns enum type. getContentTypeInt returns only an int

    Constructor with nullable params for DetectorConfiguration

    Constructor with nullable params for DetectedObject

    Constructor with nullable params for AbstractGeometryImageRenderSettings

    Constructor with params for ProxyDetails

  • Class:

    SizeF

    AdjustableBitmap

    IAdjustableBitmap

    LaneImageRenderSettings

  • Methods:

    MapView.setEdgeAreaInsets

    GemSurfaceView.hadBeenInitialized

    GemSurfaceView.hadBeenReleased

    AbstractGeometryImage.renderWithMask

    RoadInfoImage.render

    LaneImage.render

    ContentUpdater.isStarted

  • Input parameter:

    isMapReady for SdkSettings.onMapDataReady

    displayMode for MapView.presentRoute(s)

    edgeAreaInsets for MapView.presentRoute(s)

  • Other:

    EMapExtendedCapability.HighPrecisionBuildings

    app:autoReleaseOnDetachedFromWindow attribute to GemSurfaceView for preventing auto release when onDetachedFromWindow is triggered.

Changed​

  • Renamed:

    TimerListener renamed to ITimerListener

    Canvas.isView to Canvas.isMapView

Removed​

  • Input param:

    type: EDirectBufferType away from CanvasBufferRenderer.uploadFrame

[7.1.21.25.51BBEB8E] - 2021-06-24​

Added​

  • Shortcuts:

    mapView.defaultMapViewListener lambdas can be set directly in mapView. E.g.: mapView.onRender instead of mapView.defaultMapViewListener.onRender.

    When providing null Coordinates for SearchService.searchAroundPosition it will use current position instead.

  • Helper methods:

    AlarmService.startAlarmForOverlay(s)

    AlarmService.stopAlarmForOverlay(s)

    MapView.presentPath

    MapView.displayPaths

    OverlayService.getOverlaysById with inputs: ECommonOverlayId and onCompleted

    Animation constructor with lambdas.

  • Classes:

    OverlayMutableCollection

    OverlayDisplaySettings

    MapViewOverlayCollection

  • Enums:

    IOpenGLContext.EOutputBufferType

    ECameraFollowMode

  • Input parameter:

    zoomLevel for MapView.presentRoute(s)

    mode for MapViewPreferences: setMapViewPerspective, getMapViewPerspective, getViewAngle, setViewAngle, getTiltAngle, setTiltAngle

    mode for MapView: setZoomLevel, setSlippyZoomLevel, getZoomLevel, getSlippyZoomLevel

    restoreCameraMode for MapView.stopFollowingPosition

  • Methods:

    IOpenGLContext.getOutputBufferType

    DataBuffer.empty

    ContentStoreItem.setProgressListener

    OverlayService.getAvailableOverlays only with onCompleted trigger as input.

    OverlayMutableCollection.getOverlayByUid with enum type input.

    OverlayMutableCollection.add with ArrayList<OverlayInfo> input.

    OverlayMutableCollection.remove with ArrayList<OverlayInfo> input.

    SdkSettings.isMapDataReady

    MapView.getCameraFollowMode

Changed​

  • Method signature:

    AlarmService: external fun overlays(): ArrayList<OverlayInfo>? to external fun overlays(): OverlayMutableCollection?

    MapViewPreferences: external fun overlays(): ArrayList<OverlayInfo>? to external fun overlays(): MapViewOverlayCollection?

    MapView.setZoomLevel allows null xy input.

    MapView.setSlippyZoomLevel allows null xy input.

Removed​

  • Methods:

    MapViewPreferences: enableMapRenderingFeature, isMapRenderingFeatureEnabled, setMapRenderingFeaturePosition, setMapRenderingFeatureRect, getMapRenderingFeatureRect

Fixed​

  • Issue regarding SdkSettings when releasing the sdk then recreate it again.
  • Touch events not triggered.

[7.1.21.24.F957BE25] - 2021-06-15​

Added​

  • Easy searching methods for SearchService.

  • Methods: in MapDetails: getCountryNameByIndex, getCountryImageByIndex, getCountryIsoByIndex.

  • Methods: Route.getInstructions

  • Methods: ContentStore.checkForUpdate, OffboardListener.onAvailableContentUpdate

  • Methods: MapView.presentRoutes, MapView.hideRoutes

  • Methods: in ImageDatabase: getTollImage, getFerryImage, getGreenBallImage

  • Enum: EGenericCategoriesIDs and afferent methods in GenericCategories

  • Methods: getCurrentPosition, getCurrentImprovedPosition

  • Interface: INetworkListener

  • Methods: MapView.defaultMapViewListener if no listener was provided when view had been created.

  • SDK token can also be passed through GemSurfaceView's constructor or through surface's xml tag: app:sdkToken="YOUR_TOKEN"

  • Methods: ContentStore's methods related to EContentType.

  • Methods: produce for Path.

  • Methods: in MapViewListener:

    onEnterFollowingPosition, onExitFollowingPosition, onCursorSelectionUpdatedLandmarks, onCursorSelectionUpdatedOverlayItems

    onCursorSelectionUpdatedTrafficEvents, onCursorSelectionUpdatedRoutes, onCursorSelectionUpdatedMarkerMatch

  • ContentStore.asyncGetStoreContent will return the list on complete trigger (OnContentStoreAsyncCompleted)

  • Methods: ContentStoreItem.asyncDownload with lambda onStarted, onProgress and onCompleted.

  • Methods: in SearchPreferences: addCategoriesFilter, removeCategoriesFilter for fast adding category filters.

  • Methods: produce for Image.

  • Default animation for MapView center on or follow position methods.

  • Landmark constructor with name, latitude, longitude for fast writing.

  • Methods: NavigationService.startNavigation only with destination Landmark.

  • Methods: RoutingService.calculateRoute only with destination Landmark.

  • Methods: Path.toLandmark to avoid using RouteBookmarks.setWaypointTrackData as conversion.

  • Methods: MapView.display, MapView.hidePath

  • Methods: Rgba.red, Rgba.green, Rgba.blue

  • Methods: PTRouteInstruction.isCommon, RouteInstruction.isCommon

  • Methods: PTRouteSegment.isCommon, RouteSegment.isCommon

  • RouteSegment.isPublicTransportSegment which is an alias for RouteSegment.isCommon

  • Methods: PTRouteSegment.isStationWalk

  • Methods: Easy search in current visible area on a map. see SearchService

  • Category filters can be passed directly to SearchService methods.

  • MapView.transformScreenToWgsListArea allows null input.

  • Methods: DataBuffer constructor with ByteBuffer input.

  • Methods: MapView.activateHighlight method only for an element.

  • MarkerCollectionDisplaySettings builder constructor, all inputs are null by default.

  • Methods: Marker.add, Marker.update with latitude and longitude for fast writing.

  • Methods: PositionService.getImprovedPosition

Changed​

  • ETurnInfoType, ETurnType, ETurnWaypointType merged into ETurnEvent
  • MarkerCollection.getGroupHeadMarker renamed to MarkerCollection.getPointsGroupHead
  • MarkerCollectionDisplaySettings.groupingMaxZoomLevel renamed to pointsGroupingZoomLevel
  • MarkerCollectionDisplaySettings.lowDensityGroupImage renamed to MarkerCollectionDisplaySettings.lowDensityPointsGroupImage
  • MarkerCollectionDisplaySettings.mediumDensityGroupImage renamed to MarkerCollectionDisplaySettings.mediumDensityPointsGroupImage
  • Route.exportGPX renamed to Route.exportAs
  • EPathImportFormat renamed to EPathFileFormat
  • Parameters order for: NavigationService.startSimulation
  • RouteBookmarks's members setWaypointTrackData, getWaypointTrackData, waypointHasTrackData, reverseWaypointTrackData, setWaypointTrackDepartureAndDestination moved as statistics since they are helper methods.
  • Renamed EAnimation.AnimationLinear to EAnimation.Linear. Same for rest of members.
  • Removed method input parameter for PositionService.getPosition.

Removed​

  • TurnDetails.getInfoType
  • ERouteSegmentType
  • PTRouteInstruction/RouteInstruction.getInstructionType
  • PTRouteSegment/RouteSegment.getSegmentType
  • RouteSegment.isSignificant

[7.1.21.22.98275CBE] - 2021-06-02​

Added​

  • GemSdk.initWithDefaults(context, token). Token is optional. Initializes the Sdk in a easy to use manner by providing default: Timer Service, Application Paths, Language, Network Provider. Also if the token is not provided it will finally attempt to retrieve it from AndroidManifest.xml as seen in examples before. Initializes the DefaultSoundSession
  • Ease of use constructors for : SearchService, RoutingService. Allows user to provide directly onStarted and onCompleted lambdas.
  • ProgressListener.onComplete's reason code is now directly a SdkError instead of Int.
  • GemSurfaceView will init GemSdk if not already initialized by calling GemSdk.initWithDefaults
  • By default GemSurfaceView will create a MapView. To disable this please use the attribute app:createDefaultMapView="false"
  • Exposed access to the default MapView created by the GemSurfaceView. see getDefaultMapView(), releaseDefaultMapView()
  • GemSdk.release is called by default on SdkCall.execute{ }

[7.1.21.18.0D3FDE9D] - 2021-05-06​

Added​

  • Method: PositionData.isValid
  • Methods: PermissionHelper: hasPermission, hasPermissions, requestPermissions, onRequestPermissionsResult

Removed​

  • Enums: EApiCustomer, EApiProduct, EApiHosting, EApiFlavor
  • Class: AppVariant

Fixed​

  • Bad method name: getTruckProfile(value) to setTruckProfile(value)

[7.1.21.17.B6FA7F67] - 2021-04-26​

Added​

  • Enum value: EContentUpdaterStatus.CheckForUpdate.
  • Method: CommonSettings.setLanguageAsString.
  • Value: FeatureIds.MapDebugDetalisFeatureId.
  • Methods: MapView.getNorthFixedFlag, MapView.setNorthFixedFlag.
  • Methods: MapViewPreferences.getsetRotationAngle, MapViewPreferences.setRotationAngle.
  • Method: MapViewPreferences.setMapStyleByDataBuffer.
  • Method: MapViewPreferences.setMapStyleByContentStoreItem.
  • Method: MapViewMarkerCollections.removeCollection.
  • Class: OverlayCategory.
  • Method: OverlayInfo.getCategories.
  • Class: TruckProfile.
  • Methods: RoutePreferences.getsetTruckProfile, RoutePreferences.setTruckProfile
  • EnumValues: EDataInterruptionReason: AudioDeviceInUseByAnotherClient, VideoDeviceInUseByAnotherClient

Changed​

  • Renamed class MapService to MapView.
  • Renamed class MapServiceConfiguration to MapSceneConfiguration.
  • Renamed class MapServiceConfigurationListener to MapSceneConfigurationListener.
  • Renamed EImagePixelFormat.UNKNOWNto EImagePixelFormat.Unknown.
  • Renamed enum value: EAnimation.Fly to EAnimation.AnimationLinear.

[7.1.21.15.B5218653] - 2021-04-14​

Added​

  • Method: ProgressListener.create based on provided lambdas
  • Method: CommonSettings.setDefaultNetworkProvider

Changed​

  • CommonSettings is object now instead of class
  • No longer need to manually create the DefaultNetworkManager. Use CommonSettings.setDefaultNetworkProvider method instead.
  • Renamed d3scene.GemMapSurface to core.GemSurfaceView.
  • Simplified APIS for: SearchService, RoutingService, SocialOverlay, CommonSettings , ContentStore, GuidedAddressSearchService.

[7.1.21.14.7762644] - 2021-04-05​

Added​

  • Param: GemSdk.initialize needs ISO3 language string and TTS language string or use defaults.
  • Method: MapView.transformScreenToWgsListArea.
  • Method: SdkCall.postAsync and SdkCall.postSync.
  • Method: Screen.getOpenGLContext.
  • Method: GemSdk.getAppVariant.
  • Enum Value: EMapExtendedCapability.TrimmedHeader

Changed​

  • Renamed class VectorItem to Marker.
  • Renamed class VectorDataSource to MarkerCollection.
  • Renamed class VectorMatch to MarkerMatch.
  • Renamed class VectorDataSourceCollection to MapViewMarkerCollections.
  • Renamed class VectorItemCustomRenderData to MarkerCustomRenderData.
  • Renamed class VectorDataSourceDisplaySettings to MarkerCollectionDisplaySettings.
  • Renamed enum EVectorDataType to EMarkerType
  • Renamed enum EVectorMatchType to EMarkerMatchType
  • Renamed package routingandnavigation to routesandnavigation.
  • Renamed package searching to places.
  • Renamed package datasource to sensordatasource.
  • Renamed method SignpostImageRenderSettings.setBorderSizePx to SignpostImageRenderSettings.setBorderSize, analog for get
  • Renamed enum EEntranceLocationsType to EEntranceLocationType
  • Renamed method LandmarkStoresCollection.getCategoriesCount to LandmarkStoresCollection.getCategoryCount.
  • Renamed method LandmarkBrowseSession.getLandmarksCount to LandmarkBrowseSession.getLandmarkCount.
  • Renamed method LandmarkStore.getLandmarkStoreId to LandmarkStore.getId.
  • Renamed method LandmarkStore.getLandmarkStoreType to LandmarkStore.getType.
  • Renamed method LandmarkStore.getLandmarkStoreName to LandmarkStore.getName.
  • Renamed method MapView.activateMarkersHighlight to MapView.activateOverlayItemsHighlight.
  • Renamed method MapView.cursorSelectionMarkers to MapView.cursorSelectionOverlayItems.
  • Renamed method MapServiceConfiguration.setMapServiceConfigurationListener to MapServiceConfiguration.setListener.
  • Renamed method MapServiceConfiguration.loadConfiguration to MapServiceConfiguration.load.
  • Renamed method MapServiceConfiguration.saveConfiguration to MapServiceConfiguration.save.
  • Renamed method MapViewPreferences.markers to MapViewPreferences.overlays.
  • Reorganized classes in the new packages.

Fixed​

  • Android plays iOS recorded Log and vice versa.

[7.1.21.10.A60EFE2C] - 2021-03-11​

Added​

  • ApiCallLogger.onUseSytemLogging
  • Canvas.getViewportF
  • GemSdk.getDataSavePolicy and GemSdk.setDataSavePolicy
  • GeographicArea.makeIntersection and GeographicArea.makeUnion`
  • MarkerOverlaysService.enableOverlay, MarkerOverlaysService.disableOverlay and MarkerOverlaysService.isOverlayEnabled
  • RecorderConfiguration.deviceModel and set for it.
  • SdkList of LandmarkPosition and MarkerPosition.
  • SocialOverlay.searchAroundPOIAndReports, searchAround, searchAlongRoute, searchReportsForPOIs, refreshReports
  • Time.getLocalTime and Time.getUniversalTime

Changed​

  • Animation.getMethod renamed to Animation.getType
  • Animation.getFly renamed to Animation.getFlyType

[7.1.21.10.39CEC079] - 2021-03-09​

Added​

  • constructor to GemMapSurface
  • AlarmListener insideCityArea flag for: onHighSpeed, onNormalSpeed, onSpeedLimit
  • default implementation for: NetworkManager, NetworkProvider, TimerService

Removed​

  • AlarmListener.onLowSpeed
  • AlarmService.setHighSpeedThreshold and AlarmService.getHighSpeedThreshold
  • AlarmService.setLowSpeedThreshold and AlarmService.getLowSpeedThreshold

Fixed​

  • Dealloc of SDK, surface.

[7.1.21.8.95555709] - 2021-02-26​

Added​

  • Added missing doc
  • isReference method to NativeRefObj. Will tell if a certain object is Ref or not.

Changed​

  • Renamed all enums starting with T* to E*. ex: TRouteType to ERouteType
  • Renamed some non upper camel case classes to met upper camel case
  • Sdk packages

Removed​

  • Duplicate classes that hold Ref. ex: RouteInstructionRef merged into RouteInstruction.

Fixed​

  • Map not working well when put in fragment
  • Crash due to bad handling of gem::ApiRef<T>

[7.1.21.8.ECCB3B03] - 2021-02-22​

Added​

  • Param: CanvasBufferRenderer.uploadFrame added bufferType: EDirectBufferType

Changed​

  • Renamed class: View to MapView
  • Renamed class: ViewListener to MapViewListener
  • Renamed class: Camera to MapCamera
  • Renamed class: ViewPreferencesRef to MapViewPreferencesRef
  • Renamed class: Scene to MapScene
  • Renamed method: GuidedAddressSearchService.cancelRequest to GuidedAddressSearchService.cancelSearch
  • Renamed method: SearchPreferences.maxMatches to SearchPreferences.getMaxMatches

[7.1.21.6.3S80B91A] - 2021-02-12​

Added​

  • new enum: TViewCameraTransitionStatus
  • new param: ViewListener.onViewRendered, camStatus: TViewCameraTransitionStatus
  • new method: ViewListener.onMarkerItemRender
  • new methods: RectangleGeographicArea: intersects, contains, setIntersection, setUnion
  • new method: ViewPreferencesRef.vectors
  • new param: Recorder.addUserData, dataTypeIdentifier: Long
  • constructor: MarkerCollection
  • MountInformationData and EDataType.MountInformation

Changed​

  • TPositionDisplay's values changed from EPosition* to EPD_*
  • TRouteDisplayMode's values changed from ERouteDisplay* to ERDI_*
  • TPathImportFormat's values changed from E* to EPI_*
  • renamed: TViewTransitionStatus to TViewDataTransitionStatus
  • renamed: TTransportMode to TRouteTransportMode
  • renamed: TResultDetails to TRouteResultDetails
  • renamed: TAlternativesSchema to TRouteAlternativesSchema
  • renamed: TPathAlgorithm to TRoutePathAlgorithm
  • renamed: TSortOrder to TRouteBookmarksSortOrder
  • renamed: DataSourceListener.onDataInterruption to DataSourceListener.onDataInterruptionEvent and added param ended: Boolean

Removed​

  • method: TRgba.defaultColor
  • param: MarkerCollection.add's param name: String
  • method: OrientationData.isMountedForCameraUse
  • methods: ViewListener: onMarkerRender, onMarkerItemRender

[7.1.21.3.E776B859] - 2021-01-18​

Added​

  • Weather Service. See Weather.kt
  • TimeDistanceCoordinate structure
  • Marker methods: getId, getPartCount, delPart, getPartArea and part param to add, del, update, getCoordinates
  • SenseData.getTime method
  • OrientationData.isMountedForCameraUse method
  • RouteBase.getTimeDistanceCoordinates method
  • TSoundMark structure and LogMetadata.getSoundMarks
  • LogMetadata.getLogSize method
  • View.cursorSelectionVectors and View.isCameraMoving methods
  • TExtraInfo enum and Landmark.getExtraInfo method based on enum.
  • Debug.getAllWeatherConditions and Debug.getResourceUpdaterTransferStats` methods

Changed​

  • All timestamps are now expressed in Long UTC milliseconds instead of Double seconds.
  • Some return types or input params are not ArrayList<Abc> they are now AbcList.
  • TPathAlgorithm.EPA_Osrm changed into TPathAlgorithm.EPA_ExternalCH.
  • Renamed SenseData.getTimestamp to SenseData.getAcquisitionTimestamp.

Removed​

  • ERecorderStatus.Saving.
  • TWgsRectangle structure.
  • MarkerOverlayInfoRef.getNearbyInfoUrl.
  • RectangleGeographicArea.set(value: TWgsRectangle).

[7.1.20.51.E4F23422] - 2020-12-23​

Added​

  • LogMetadata.produce.
  • TProxyDetails.

Changed​

  • TRecorderConfiguration.recordingAudio renamed to TRecorderConfiguration.enableAudio.
  • Recorder.setAudioMuted split into Recorder.startAudioRecorder, Recorder.stopAudioRecorder .
  • NetworkListener.onConnectDidFinished and NetworkListener.onConnectFinished signature.
  • DataSource.addListener signature.

Removed​

  • DataSource.startNotifyCameraBuffers, DataSource.stopNotifyCameraBuffers.

Fixed​

  • Crash when using PTRouteInstructionRef.

[7.1.20.51.BD965DE6] - 2020-12-16​

Added​

  • CanvasListener: onPointerDown, onPointerMove, onPointerUp, onPinchSwipe.
  • TCameraConfiguration, get/set for: focalLength, physicalSensorWidth, physicalSensorHeight.
  • TMarkerMatchType.EVMT_CoordinateGroup.
  • TMarkerCollectionDisplaySettings.
  • MarkerCollection.getArea.
  • TTSLocalization.
  • FeatureIds.TTS_LOCALIZATION_FEATURE_ID.

Changed​

  • CanvasListener's onRotate signature.

[7.1.20.50.9977856E] - 2020-12-09​

Added​

  • DataSource: getConfiguration and setConfiguration(dataType).
  • DataSource: configuration param to addListener, default null.
  • TRecorderConfiguration: keepMinimumSeconds, diskSpaceLimit, recordingAudio and setters.
  • Recorder: setKeepMinimumSeconds, setDiskSpaceLimit, getConfiguration, setChunkDurationInSeconds, setMinimumBatteryPercent, setContinuousRecording.
  • TLandmarkBrowseSessionSettings: coordinates and setCoordinates.
  • Playback: step.

Changed​

  • TRecorderConfiguration: renamed tempDir to logsDir.

[7.1.20.48.F5AF9EE2] - 2020-11-23​

Added​

  • BatteryData.EPluggedType.
  • BatteryData.getLowBatteryNoticed.
  • BatteryData.getPluggedType.
  • BatteryData.getVoltage.
  • BatteryData.getTemperature.
  • PositionData.getLocationTime.
  • TLandmarkBrowseSessionSettings object.
  • TLandmarkOrder enum.

Changed​

  • ActivityData.EType.
  • BatteryData.EState.
  • BatteryData.EHealth.
  • CompassData.EAccuracy.Unreliable renamed to Unknown.
  • return type of startNotifyCameraBuffers.
  • createLandmarkBrowseSession input param.
  • renamed camera frame's field recordedAngle to rotationAngle.
  • merged EVideoQuality, Resolutions and CameraResolutions enums into EResolution.

[7.1.20.47.F1A369D1] - 2020-11-16​

Added​

  • PermissionsHelper and PermissionsListener.
  • LandmarkStoreListener.onBrowseSessionInvalidated.
  • DataSource.startNotifyCameraBuffers.
  • DataSource.stopNotifyCameraBuffers.
  • SenseDataSource enum EPlayingStatus.
  • DataSourceListener.onPlayingStatusChanged.

Changed​

  • LandmarkStore's methods: registerBrowseSession, unregisterBrowseSession, getBrowseSessionLandmarksCount, getBrowseSessionLandmarks merged into LandmarkBrowseSession object.

Fixed​

  • Recorded video's orientation for external players like VLC.

Removed​

  • DataSource.getLastUpdateTimestamp.
  • ViewPreferences.enableAutomaticZooming.
  • ViewPreferences.isAutomaticZoomingEnabled.

Issues​

  • DataSource Pause/Resume might go into deadlock.

[7.1.20.44.4215D8A2] - 2020-11-1​

Added​

  • CommonSettings.verifyAppAuthorization.

Fixed​

  • Datasource's getPlayback() not returning null.

[7.1.20.44.4FA0F84F] - 2020-10-26​

Added​

  • RecorderBookmarks.markLogProtected.
  • TRecorderConfiguration.continuousRecording.
  • MarkerCollectionCollectionRef.indexOf.
  • MarkerMatch.getItemIndex.
  • MarkerCollection.indexOf.
  • RouteBookmarks.getFilePath.
  • EnumHelp to cast easier an int to a specific enum type.
  • Added TFrameFit enum and used into CanvasBufferRenderer.
  • recordedAngle in TCameraConfiguration.
  • PermissionsHelper to notify when permissions status has been changed.

Changed​

  • GEMSdk renamed "mmc" naming to "sdcard".
  • RecorderBookmarks "saved logs" renamed to "protected logs".
  • Input parameters of RouteBookmarks.Produce.
  • EVideoQuality enum values.
  • RecorderListener replaced with ProgressListener.
  • TEncoding, EPixelFormat, ImageFormat all replaced with EImagePixelFormat.

Removed​

  • Recorder.saveRecording
  • TRecorderConfiguration.loopRecordingSeconds
  • LandmarkStoreService.getGenericCategoriesLandmarkStoreId
  • Removed buffer type from CameraData.getDirectBuffer.

Fixed​

  • Crash when releasing CanvasBufferRenderer.
  • Bluish image when recording/play video log.
  • Video rotation when playing a log.
  • Bad TCameraConfiguration when playing a log.

[Unreleased]​

  • [7.1.20.43.693001B4]: Update demo apps for SDK v7.1.20.43.693001B4
  • [7.1.20.42.AF307B1F]: Update demo apps for SDK v7.1.20.42.AF307B1F
  • [7.1.20.41.37C8C713]: Update demo apps for SDK v7.1.20.41.37C8C713
  • [7.1.20.40.76465CE8]: Update demo apps for SDK v7.1.20.40.76465CE8
  • [7.1.20.39.5E1A0550]: Initial release
Last updated on