Table Release Notes

Version	Release date	Changes
v1.12.8-hotfix02	2025.11.18	[Improved] 1. Changed the KakaoSDK (v2-common) version: • Previous: 2.21.4 • Updated: 2.23.0 [Fixed] 1. Fixed a crash when viewing route details from the full route 2. Fixed an error when tapping the traffic-information button repeatedly on the full-route screen during driving 3. Fixed a crash when using TalkBack on the driving screen 4. Fixed bottom-menu scrolling in landscape 5. Fixed POI flickering when zooming out
v1.12.8	2025.09.30	[New] 1. Added an API to change appUserId (KNSDK.setAppUserId(String?)) [Improved] 1. Changed the Android target API version: 🔹 Previous: targetSDKVersion 33 (Android 13) 🔸 Updated: targetSDKVersion 34 (Android 14) 2. Enhanced section-enforcement cameras and safe-driving guidance • Added options to adjust guidance-start distance for turn sections and speed-enforcement cameras • Added options for speed-enforcement camera violation and speeding-alert thresholds • Added an alert-sound option for mobile speed-enforcement cameras • Added a camera type: old diesel-vehicle restriction enforcement camera • Improved section-enforcement camera guidance and display: - Shows the section-enforcement UI after passing the camera - Keeps section-enforcement camera guidance when switching between safe-driving and route-guidance modes - Improved the section-enforcement distance criteria - Keeps the section-enforcement UI after restart or going off route • Improved rear enforcement-camera guidance: keeps the camera symbol for a set distance after passing the actual camera location • Improved safe-driving data: - Added and improved codes and display for rear section-enforcement start/end points - Improved symbols for rear speed and signal-speed enforcement cameras - Improved mini symbols at section-enforcement start/end points: labels start and end on the symbols • Added roadType and facilityType to KNLocation received in safe-driving mode 3. Improved route guidance (RG) and voice policy • Added route guidance for unprotected left turns, going straight, and road facilities (tunnels, underpasses, overpasses) • Added road-surface guide-line information to route guidance • Adjusted near-highway guidance distance (500 m → 600 m) • Replaced the default voice file (default.snd) and updated the wording 🔹 Previous: 지하차도 침수 주의 구간입니다. 안전 운행하세요. 🔸 Updated: 상습 도로 침수 구간입니다. 안전 운행하세요. • Changed voice-guidance policy: reordered 'follow-on' and 'additional' utterances and added a skip policy 🔹 Previous: base guidance → follow-on guidance → additional guidance (example: 500 m 앞 좌회전입니다. 이어서 우회전입니다. 첫 번째 출구입니다.) 🔸 Updated: base guidance → additional guidance → follow-on guidance (example: 500 m 앞 좌회전입니다. 첫 번째 출구입니다. 이어서 우회전입니다.) 4. Improved route search and matching accuracy • Added turn-angle information to the KNDirection class • Adjusted matching speed during simulation • Added route-tree re-expansion when network map matching is delayed • Improved ETA and traffic-status updates so the server can control the refresh cycle independently of route recalculation • Added KNPOI.linkFilterInfo to route requests • Added preferred-route usage to KNTrip 5. Adjusted the service-area detection zone (entry without exit: 2 km → 1 km) 6. Added settings for Usage and ContentType of AudioAttributes • Default - AudioAttributes.USAGE_MEDIA - AudioAttributes.CONTENT_TYPE_MUSIC • Change functions - KNGuide_Voice.setUSAGE(aUsage: Int) - KNGuide_Voice.SetContentType(aContentType: Int) 7. Improved memory use and performance • Reduced memory spikes when registering many markers • Added a guard against memory spikes when allocating rendering resources • Reduced memory use on low-spec devices • Improved map performance 8. Unified map scale for CarPlay and the cluster view 9. Optimized FrameDraw updates by adding a monitoring interface that handles fade-animation end timing 10. Adjusted the tail length of route arrows 11. Strengthened guidance information display • Added bus-only lane operating status to the bottom bar • Improved the red-screen policy in section-enforcement zones: 🔹 Previous: the red screen was based on average speed in the enforcement section 🔸 Updated: the red screen is triggered based on speed-enforcement cameras and section-enforcement end cameras in the zone. It is synchronized with the speeding warning sound according to the guidance-start distance setting for speed-enforcement cameras • Removed duplicate traffic-incident symbols - For partial closures, show the same traffic incident once on the route. For full closures, keep duplicate display as before - For partial closures, the same traffic incident is shown only once on the route. For full closures, duplicate display is unchanged • Keeps the sign after passing a rear speed-enforcement camera • Applied lane-guide-line colors to lane information, new route guidance, and the direction view 12. Added user options • Added an on/off option for traffic information on the driving screen • Added a coordinate callback on a long press on the map • Added an on/off option for complex-intersection images • Map zoom-scale option 13. Added support for the Android 16 KB page size [Fixed] 1. Going off route and rerouting • Fixed reroute not being requested when going off route • Fixed a service-area deviation-prevention error (topScoreCandidate was not updated in makeCandidate) • Fixed the display section disappearing after passing a camera in a rear-enforcement zone after rerouting 2. Arrival detection and ETA • Fixed arrival being detected too early • Fixed route caching not working when requesting a route through KNTrip while driving • Fixed a crash caused by incorrect route-merge detection • Fixed duplicate requests for eta and dynamic information • Fixed eta updates stopping • Fixed ETA resetting when entering a service area • Fixed an ETA timer refresh error 3. Location matching • Fixed tunnel-matching checks when GPS is inaccurate • Fixed the initial coordinates remaining when invalid gpsData continues after first launch • Fixed route-matching position falling back to the last network-matching location when network matching is inaccurate in a service area 4. Fixed average speed not being calculated in section enforcement, or dropping when entering a tunnel 5. Removed duplicate section-enforcement information when there are multiple end points 6. Fixed camera alerts not playing at the end of a link 7. Fixed a camera zone on the last link being set ahead of the actual location 8. Markers and route lines • Fixed deleted markers disappearing only after a camera update • Fixed an error when updating a marker object • Fixed an error when updating route line thickness 9. Fixed magenta appearing on first CarPlay launch 10. Fixed an intermittent crash during POI overlap handling 11. Fixed a null-pointer exception (NPE) in KNConnection 12. Fixed an error in remain of KNTrip 13. Fixed animations not completing 14. Fixed the route not displaying correctly on U-turn routes 15. Fixed FrameDraw handling through RequestRenderer 16. Fixed errors related to POI updates 17. Changed the map style parser so it does not parse when data is missing in the middle (data mismatch)
v1.10.5-hotfix01	2024.09.05	[Improved] 1. Added safe-driving types • Intentional traffic-accident hotspot (26) • Underpass flooding section (40) 2. Accessibility support 3. Added validation for the aIdList argument of KNSDK.reqPOiDetail [Fixed] 1. Improved exception handling for map matching 2. Fixed overlap-removal logic when displaying multiple routes • Resolved missing routes by handling start points of the main and alternative routes separately
v1.10.4 Beta.2	2024.08.16	[Improved] 1. Added the BroadcastReceiver Context.RECEIVER_NOT_EXPORTED parameter when calling KNSDK.handleWillEnterForeground() on API 34 or later
v1.10.4 Beta.1	2024.06.28	[Fixed] 1. Fixed a performance drop during map matching 2. Fixed remaining off route in certain situations 3. Fixed incorrect route outline colors 4. Fixed marker bounds still using the previous image after the marker image was changed
v1.10.3 Beta.1	2024.06.10	[Improved] 1. Enhanced location-calculation logic 2. Changed the error code for a trip request (makeTripWithStart) before initialization: C000 → C116 [Fixed] 1. Fixed toll calculation failing because tollgate start information was not linked after going off route 2. Fixed map tiles appearing gray 3. Fixed abnormal map-resource requests • Fixed repeated map-resource requests when the network is unstable
v1.10.2 Beta.1	2024.05.10	[Improved] 1. Improved location and speed performance 2. Improved routing performance 3. Fixed memory leaks • Added release handling for KNVoice_Guide when shouldPlayVoiceGuide returns false [Fixed] 1. Fixed a crash related to simulated driving in tunnels 2. Fixed section speed not updating in certain section-enforcement cases 3. Fixed an SQLite database update issue 4. Fixed route-guidance information updating late during guidance
v1.10.1 Beta.1	2024.04.15	[Improved] 1. Renamed identifiers of the initialization function (KNSDK.initializeWithAppKey()) and added a new identifier • Renamed identifier: aUserKey -> aCsId • Added identifier: aAppUserId. An unchanging value that identifies the installed device or user 2. Added in-tunnel location simulation when entering a tunnel in safe-driving mode 3. Improved map matching 4. Changed the initial values of roadType and facilityType in KNLocation: added '_unknown' and use it as the default 5. When voiceCode of KNGuide_Voice is KNVoiceCode_BusLaneGuide, delivers KNBusLane (bus-only lane) information in guideObj [Fixed] 1. Fixed passed RoadEvent information continuing to be delivered 2. Fixed an ANR related to route color settings
v1.10.0 Beta	2024.02.29	[New] 1. Enhanced safe-driving data matching [Improved] 1. Raised the minimum supported Android version: • Previous: API 23: Android 6.0 (Marshmallow) or later • Updated: API 26: Android 8.0 (Oreo) or later 2. Changed the KakaoSDK (v2-common) version: • Previous: 2.11.1 • Updated: 2.19.0 3. Location • Improved FIN (Fused Indoor localizatioN) positioning in tunnels 4. Made section-enforcement camera voice guidance more detailed • Added voice guidance for passing only the section-enforcement start point without the end point 5. Changed the criteria for showing signal information 6. Added an option to hide safe-driving information while driving in safe-driving mode 7. Fixed toll information disappearing when going off route 8. Improved arrow design on the route 9. Shows a guidance popup when an error occurs during route search 10. Improved the safe-driving mode guidance policy • Changed the maximum number of signs (3 -> 2) • Adjusted sign display priority • Changed the criteria for the speeding alert sound and warning screen • Expanded the symbol display range • Added a traffic-incident code and symbol: weather information (5) 11. Added scrolling to the menu screen [Fixed] 1. Fixed guidanceRouteChanged not being called when changeRoute() is invoked
v1.9.4	2024.02.05	[Improved] 1. Applied KMLocation SDK 1.103.63 • Enhanced location-calculation logic 2. Replaced the default voice file 3. Improved lane-guidance information • KNLane_Laneinfo: changed the information delivery format • Improved lane-guidance color display 4. guidanceRouteChanged: updated the route-change callback • Delivers the previous route, the new route, and the reason for the change 5. When using an in-vehicle infotainment system, delivers all lane information instead of only the lanes adjacent to the route guidance [Fixed] 1. Fixed treating the same coordinates with different valid flags as the same map-matching result 2. Added a matching-reset condition 3. Fixed the condition for delivering the link ID on user reroute 4. Fixed rerouting using default coordinates
v1.9.3	2023.11.27	[Improved] 1. Applied KMLocation SDK 1.3.57 • Added an API to set an external user-location callback 2. Added an End button at the bottom of arrival and guidance-end popups [Fixed] 1. Fixed map-matching score calculation 2. Fixed an out-of-memory error in the Realm loader when loading map data 3. Fixed the vehicle icon moving to the camera center when calling scaleToMbr 4. Fixed vehicle-icon animation in north-up mode • Added the useNorthHeadingMode flag
v1.9.2	2023.10.26	[Improved] 1. Changed the CarApp library version • Previous: 1.1.0-rc01 • Updated: 1.3.0-rc01 2. Applied KMLocation SDK 1.103.55 3. Enhanced KNNetworkLinkMatching and KNMapMatching logic 4. Improved alternative-route selection and confirmation [Fixed] 1. Fixed rerouting to the default coordinates (Gwanghwamun) when GPS is unavailable 2. Fixed route resume requesting a route from the origin instead of the current location 3. Fixed speedTrust and angleTrust settings of KNGPSData • Fixed KNGPSData values becoming inaccurate due to global variables at creation
v1.9.1	2023.09.19	[Improved] 1. Changed the Android target API version • Previous: targetSDKVersion 31 (Android 12) • Updated: targetSDKVersion 33 (Android 13) 2. Applied KMLocation SDK 1.3.51 • Enhanced OpenSky Accuracy logic • Enhanced indoor entry/exit logic • Updated the indoor-positioning library 3. Enhanced network map matching and route map matching 4. Improved how lane information is displayed • Previous: if non-straight guidance (right turn, left turn, U-turn, and so on) was within 550 m, provided lane information for that guidance point • Updated: provides lane information for the current location 5. Added sign information and voice guidance for safe driving • Speed-enforcement camera (rear) • Signal and speed-enforcement camera (rear) • Bus-only lane and speed-enforcement camera • Real-time fog caution zone • Real-time icy-road caution zone 6. Added map setting options • Added a POI text-size option (0.1–2.0) • Added a setting for whether 3D buildings are displayed 7. Improved POI overlap 8. Added error messages for more detailed freight-route search error codes 9. Applied UI for new safe-driving codes 10. Added a restriction on accessing SDK Manager before SDK initialization completes 11. KNGPSData • Added OpenSky Accuracy [Fixed] 1. Fixed a map-matching error 2. Fixed the end-guidance popup not appearing after driving ended 3. Fixed an issue when getting waypoint location information (KNLocation) from a route (KNRoute) 4. Fixed a map-matching issue 5. Fixed POI text not updating immediately after a language change 6. Fixed residual images when creating a route 7. Fixed driving-UI display policy and related issues 8. Fixed other crashes
v1.8.1	2023.06.22	[New] 1. Applied Map Matching V2 • Improved matching using nearby road data • Improved off-route detection using matching information (for example, preventing false deviation and matching errors) • Performs basic map matching even when there is no route • Matches safe-driving data to roads and decides guidance based on routing between the current road and the target road • Extended safe-driving guidance distance and filtered inaccurate guidance 2. KNGPSData, KNLocation: changed the type of the pos property • Previous: IntPoint • Updated: DoublePoint 3. Changed the safe-driving data format 4. Added guidance for variable speed-enforcement cameras 5. Added functions to KNLocation • isSameToLocation: compares two objects to determine whether they share the same location and location information 6. Added information displayed on the map • Provides building wings, building entrances/exits, and extra POIs in addition to POI labels 7. Added functions to KNNaviView: • guideNewDestinations: cancels safe driving and starts new route guidance • guideCancel: cancels current route guidance and switches to safe driving 8. Added functions to KNNaviView_StateDelegate: • naviViewPopupOpenCheck: delivers whether a popup is open or closed • naviViewScreenState: delivers the current screen state [Improved] 1. Updated Google Play services • Previous: 18.0.0 • Updated: 21.0.1 2. Updated compileSdkVersion • compileSdkVersion 33 • Kotlin 1.7.20 • Kotlinx 1.6.4 • compileOptions JavaVersion 11 (previous: JavaVersion 1.8) • buildToolsVersion 30.0.3 (previous: buildToolsVersion 30.0.1) • gradle 7.2.2 (previous: gradle 7.0.3) • gradle-7.2-all (previous: gradle-7.5-bin) 3. Applied KMLocation SDK 1.3.36 • Improved indoor positioning 4. Improved how direction names are shown at the first guidance point 5. KNGuide_Voice: added route-request types for which voice guidance is played 6. Improved how direction information is shown for waypoints 7. Improved how voice guidance is combined 8. Improved the map loader: • Improved reading and parsing map data from the database • Reduced map-data loading time • Changed the map database from sqlite to Realm (version 10.38.3) • The server can set the initial database type (sqlite, Realm) 9. Changed the map font 10. Increased the number of POI labels 11. Improved the highway-mode and highway-information screen • Shows rest areas and details such as restrooms • Shows fuel and charging prices and information in service areas • Shows light-repair information in service areas • Shows a separate icon for freight service areas 12. Added an option to enable or disable the route-cancel button 13. Added an option for the arrival notification popup 14. Applies the GPS heading more quickly at the start of driving 15. Redesigned the driving-screen menu and added custom buttons and related features 16. Added a driving-error report feature for safe driving • Enables related features when tapping a safe-driving sign or the lane-guidance area 17. Added detailed options for freight routes 18. Reduced app authentication time [Fixed] 1. Fixed slow initial matching at the start of driving 2. Fixed repeated off-route events in the initial matching state at the start of driving 3. Fixed matching of some camera information during safe driving 4. Fixed distortion of the vehicle image 5. Fixed POIs displaying incorrectly 6. Fixed the map intermittently failing to load right after initialization 7. Fixed arrival time not updating when the vehicle is stopped 8. Fixed other crashes
v1.6.10	2023.03.24	[Fixed] 1. Added exception handling for out-of-memory (OOM) in KNGuide_Voice 2. Fixed the error callback not firing when the network drops as soon as map download starts 3. Fixed an issue where the guide line was not shown when setting a goal with KNLocation guideLineGoal without a route 4. Fixed a crash caused by an incorrect network-thread lifecycle
v1.6.9	2023.03.03	[Fixed] 1. Fixed a crash during voice guidance • Added exception handling for KNSoundPlayer and KNGuidance MediaPlayer crashes 2. KNComponentBottomView: fixed arrival time not updating when stopped during driving
v1.6.8	2022.12.16	[New] 1. KNComponentBottomMenuView: sets whether the route-cancel button is enabled [Improved] 1. Added highway guidance information: rest areas, fuel prices, freight service areas, and light-repair shops 2. Added direction-name display information: a. Shows the direction name at the first guidance point when it is available b-1. Shows the road name when no direction name is available at a turn guidance point b-2. Shows the facility name when no direction name is available at a facility-entry guidance point b-3. Shows route guidance when no direction name is available at an entrance/exit, one-tolling entry, or merge after a fork b-4. Shows the node name when no direction name is available at a tollgate guidance point c. If no name is available for the first guidance in item b, hides the direction name, keeps the previous behavior, or shows the node or direction name based on the next guidance point
v1.6.6	2022.11.28	[New] 1. Added a setting for whether to show the guidance-end popup [Improved] 1. Applied KMLocation SDK 1.2.18 2. Stabilization: memory leaks and crashes 3. Changed the Android target API version • Previous: targetSDKVersion 30 (Android 11) • Updated: targetSDKVersion 31 (Android 12)
v1.6.5	2022.10.24	[New] 1. Changed how the Kakao Navi Directions SDK is distributed • Previous: distributed as an Android Archive package (.arr) file • Updated: distributed through Maven 2. Added background guidance: keeps voice guidance for the current route when switching to another screen such as a third-party UI, and resumes the existing route when returning to the guidance screen 3. Added KNCitsDataType to provide traffic lights, accidents, and emergency-vehicle information on the current road 4. Added switching between 2D and 3D maps 5. Added switching between day and night driving themes 6. Added the KNNaviView_StateDelegate delegate for KNNaviView state (day/night mode, 2D/3D map switching, and so on) 7. Added route-line settings by day/night driving theme and traffic [Improved] 1. Applied KMLocation SDK 1.2.16 2. Changed the map background from blue to white to reduce the visual gap during loading 3. Improved the draw order so the route is not hidden by buildings 4. Changed the access modifier of aroundSafeties in KNGuidance from private to public 5. Added KNNaviView_GuideStateDelegate for the guide state of KNNaviView [Fixed] 1. Fixed markers not appearing when returning to the foreground after starting guidance in the background
v1.5.6	2022.08.19	[Improved] 1. Applies route-theme changes immediately 2. KNGuidance: • Issues a new transId when starting safe-driving mode after guidance ends • Sets trip to null when guidance ends on arrival. trip in the guidance delivered by guidanceGuideEnded() can therefore be null • Prevents duplicate connections with the same transId • If transId is not received due to a network issue during a route request, does not disconnect and reconnect 3. KNTrip: when using route resume after an abnormal app exit such as a crash, requests the route based on the current location 4. Shows the distance-priority option when selecting route priority on the navigation screen 5. Added a guard against a multi-thread crash when updating the destination guide line 6. Renamed functions: • Previous: KNNaviView enableVolumeSetting • Updated: isEnabledVolumeSetting [Fixed] 1. KNConnection: • Fixed reconnection failing after a network error closed the connection • Fixed a nullPointException in the KNConnection delegate 2. KNGuidance: fixed duplicate connection logs being uploaded 3. KNCitsManager: fixed an overflow during matching 4. Fixed an index-reference issue when creating a route 5. Fixed markers for origin, waypoints, and destination not appearing when returning to the navigation screen from the background 6. Fixed the distance-priority option not appearing when selecting another route during driving
v1.5.0	2022.06.24	[New] 1. Added required libraries and frameworks • ReactiveX • Koin • Efficient Java Matrix Library (EJML) 2. Added properties to KNRouteConfiguration • usage: sets vehicle usage 3. Applied Kakao Navi brand sounds [Improved] 1. Integrated the KMLocation SDK • Changed GPS-enabled and permission checks after integrating the KMLocation SDK 2. Improved how onGPSSettingStatus is delivered • Previous: delivered onGPSSettingStatus when KNGPSManager.checkGPSSettingStatus() was called • Updated: delivers onGpsSettingStatus when the status changes, without a separate call 3. Allows switching day/night map themes immediately during map initialization 4. Improved the map appearing too far away in landscape 5. Improved long-distance route creation speed 6. Plays speeding-enforcement voice alerts according to the guidance code 7. Delivers linkId when adding a waypoint 8. Separated the C103 authentication error message [Changed] 1. Removed onConnectionFailed from KNGPSSettingsReceiver