kakaomobility Developers

English

한국어

English

한국어

Appearance

한국어
Table Release Notes
VersionRelease dateChanges
v1.12.122025.09.30[New]

1. Added an API to change appUserId ((void)setAppUserId:(NSString *)aAppUserId)

2. Added APIs
• onCameraAnimationChanging: called on each frame while the camera animation updates after KNMapView.animateCamera


[Improved]

1. 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

2. 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 앞 좌회전입니다. 첫 번째 출구입니다. 이어서 우회전입니다.)

3. 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

4. Adjusted the service-area detection zone (entry without exit: 2 km → 1 km)

5. 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

6. Unified map scale for CarPlay and the cluster view

7. 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

8. 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


[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

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
v1.10.92024.08.30[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
v1.10.8
Beta.1		2024.06.28[Improved]

1. Improved memory issues on low-spec devices
• Changed CarPlay anti-aliasing (previous: MSAA → updated: FXAA)


[Fixed]

1. Fixed a performance drop during map matching

2. Fixed remaining off route in certain situations
v1.10.6
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

3. Improved map display performance
v1.10.4
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 NO

4. Added support for the privacy manifest (PrivacyInfo.xcprivacy)


[Fixed]

1. Fixed a crash related to simulated driving in tunnels

2. Fixed section speed not updating in certain section-enforcement cases

3. Fixed route-guidance information updating late during guidance
v1.10.2
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
v1.10.1
Beta		2024.02.29[New]

1. Enhanced safe-driving data matching


[Improved]

1. Raised the minimum supported iOS version:
• Previous: iOS 12 or later
• Updated: iOS 15 or later

2. Location
• Improved location stability in tunnels

3. Made section-enforcement camera voice guidance more detailed
• Added voice guidance for passing only the section-enforcement start point without the end point

4. Changed the criteria for showing signal information

5. Added an option to hide safe-driving information while driving in safe-driving mode

6. Fixed toll information disappearing when going off route

7. Improved arrow design on the route

8. Shows a guidance popup when an error occurs during route search

9. 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)

10. Added scrolling to the menu screen


[Fixed]

1. Fixed guidanceRouteChanged not being called when changeRoute() is invoked

2. Fixed crashes when connecting or disconnecting CarPlay

3. Fixed traffic-information button alignment when entering safe-driving mode in landscape
v1.9.82024.02.05[Improved]

1. Applied KMLocation SDK 1.103.63
• Enhanced location-calculation logic
• Improved stability: fixed intermittent crashes

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


[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.62023.11.27[Improved]

1. Applied KMLocation SDK 1.3.58
• Added an API to set an external user-location callback
• Changed the LocationManager constructor

2. When using an in-vehicle infotainment system, delivers all lane information instead of only the lanes adjacent to the route guidance

3. Optimized GPU memory
• Optimized GPU buffer initial memory and allocation after map-data changes
• Reduced maximum GPU memory: 630 MB → 370 MB

4. Changed how map data is loaded
• Loads map data only in the foreground
• Pauses map-data loading when entering the background and resumes it when returning to the foreground

5. Added a guard to image-hash key generation

6. Added an End button at the bottom of arrival and guidance-end popups


[Fixed]

1. Fixed abnormal map rendering

2. Fixed missing data when a full map download completes
v1.9.42023.10.25[Improved]

1. Applied KMLocation SDK 1.103.52

2. Enhanced KNNetworkLinkMatching and KNMapMatching logic

3. 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

4. Fixed the font size changing unexpectedly in the first route-guidance information

5. Fixed building height not rising when switching to 3D during guidance or tapping the 3D button
• Changed the default of isVisibleBuilding to true
v1.9.32023.09.19[Improved]

1. Applied KMLocation SDK 1.3.47
• Enhanced OpenSky Accuracy logic
• Enhanced indoor entry/exit logic
• Updated the indoor-positioning library

2. Enhanced network map matching and route map matching

3. 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

4. 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

5. Added map setting options
• Added a POI text-size option (0.1–2.0)
• Added a setting for whether 3D buildings are displayed

6. Improved POI overlap

7. Added error messages for more detailed freight-route search error codes

8. Applied UI for new safe-driving codes

9. Added a restriction on accessing SDK Manager before SDK initialization completes

10. KNGPSData
• Added OpenSky Accuracy

11. Allows simultaneous rendering on mobile and CarPlay


[Fixed]

1. Fixed the end-guidance popup not appearing after driving ended

2. Fixed an issue when getting waypoint location information (KNLocation) from a route (KNRoute)

3. Fixed POI text not updating immediately after a language change

4. Fixed residual images when creating a route

5. Fixed driving-UI display policy and related issues

6. Fixed other crashes
v1.8.22023.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: 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. Applied KMLocation SDK 1.3.33
• Improved indoor positioning

2. Improved how direction names are shown at the first guidance point

3. KNGuide_Voice: added route-request types for which voice guidance is played

4. Improved how direction information is shown for waypoints

5. Improved how voice guidance is combined

6. 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)

7. Changed the map font

8. Increased the number of POI labels

9. 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

10. Added an option to enable or disable the route-cancel button

11. Added an option for the arrival notification popup

12. Applies the GPS heading more quickly at the start of driving

13. Redesigned the driving-screen menu and added custom buttons and related features

14. Added a driving-error report feature for safe driving
• Enables related features when tapping a safe-driving sign or the lane-guidance area

15. Added detailed options for freight routes

16. 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.72023.03.03[Improved]

1. Applied KMLocation SDK 1.2.23

2. KNGuidance: improved highway information for consecutive ICs with the same name


[Fixed]

1. NSTimer: fixed the timer stopping when scrolling the screen

2. Fixed abnormally thick black road borders when zooming out during driving

3. Fixed small road signs occasionally enlarging when zooming the map during driving

4. Added a guard against crashes from thread conflicts on route objects
v1.6.52022.12.16[New]

1. KNMenuView: sets whether the route-cancel button is enabled
v1.6.42022.11.28[New]

1. Added switching between 2D and 3D maps

2. Added switching between day and night driving themes

3. Added route-line settings by day/night driving theme and traffic

4. Added the KNNaviView_StateDelegate delegate for KNNaviView state (day/night mode, 2D/3D map switching, and so on)

5. KNNaviView: added a setting for whether to show the guidance-end popup


[Improved]

1. Applied KMLocation SDK 1.2.22


[Fixed]

1. Fixed the screen freezing when changing the language

2. Allows rolling back map data when a database file is corrupted
v1.6.22022.09.14[New]

1. Changed how the Kakao Navi Directions SDK is distributed
• Previous: distributed as an XCFramework
• Updated: distributed through CocoaPods

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 KNCitsType to provide traffic lights, accidents, and emergency-vehicle information on the current road


[Improved]

1. Applied KMLocation SDK 1.2.14

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. Fixed parts of the map intermittently appearing white

5. Moved methods from KNNaviView into standalone classes
• KNNaviMapView: sets the vehicle image displayed on the map
• KNCurDirectionView: background color of the first route-guidance information
• KNNextDirectionView: background color of the second route-guidance information

6. Renamed KNNaviView_GuideStateDelegate and added functions
• Renamed KNNaviView_GuideStateDelegate
　- Previous: KNNaviView_Delegate
　- Updated: KNNaviView_GuideStateDelegate
• Added naviViewGuideState to query the guide state of KNNaviView

7. Added the KNNaviView_StateDelegate delegate for KNNaviView state


[Fixed]

1. Fixed POIs flickering intermittently during zoom and pan

2. Fixed POIs not appearing when switching the map from the day theme to the night theme on first launch
v1.5.52022.08.19[Improved]

1. Changed navigation voice guidance
• Kakao Navi start sound
• Camera warning sound

2. KNGuidance:
• Issues a new transId when starting safe-driving mode after guidance ends
• Sets trip to null when guidance ends on arrival

3. KNTrip: when using route resume after an abnormal app exit such as a crash, requests the route based on the current location

4. Improved single-tap event priority so events are returned according to the setting


[Fixed]

1. Fixed background map borders being visible

2. KNGuidance: fixed reconnection failing after a network error closed the connection
v1.5.02022.06.24[New]

1. Added properties to KNRouteConfiguration
• usage: sets vehicle usage

2. Applied Kakao Navi brand sounds

3. Added the KNGPSBackgroundUpdateType enumeration to set background location access


[Improved]

1. Integrated the KMLocation SDK

2. KNGuidance: removed voice-limit code on KNSoundPlayer.paused and handles it in the sound player

3. Plays speeding-enforcement voice alerts according to the guidance code

4. Separated the C103 authentication error message