Developer

Release Notes

Version 1.25.18 - 17/12/2025

Discover the improvements and new features included in the following version. Share your thoughts on this release by using the feedback button located at the bottom of the page.

For more in-depth documentation, check the API Reference

Data Management

Fixes
  • Fix onboard map BMD tile availability algorithm.

Version 1.25.15 - 03/12/2025

Discover the improvements and new features included in the following version. Share your thoughts on this release by using the feedback button located at the bottom of the page.

For more in-depth documentation, check the API Reference

Navigation

Fixes
  • Fix replanning on deviation from imported routes, when running multiple navigation sessions with the same navigation instance.

Version 1.25.14 - 02/10/2025

Discover the improvements and new features included in the following version. Share your thoughts on this release by using the feedback button located at the bottom of the page.

For more in-depth documentation, check the API Reference

Navigation

Fixes
  • Fix route update failures when vehicles were stationary near origin of the route.

Search

Fixes
  • Fix search failures in EV Search caused by overly strict parsing of nearby POI categories.

Version 1.25.13 - 08/09/2025

Discover the improvements and new features included in the following version. Share your thoughts on this release by using the feedback button located at the bottom of the page.

For more in-depth documentation, check the API Reference

Map Visualization

Updates
  • Bring 16kb page size supports to map-display module.
Fixes
  • Fix for crash during navigation.
  • Resolves a deadlock issue that occurs when AssetFetcher invokes callbacks during engine shutdown.

Version 1.25.11 - 16/08/2025

Discover the improvements and new features included in the following version. Share your thoughts on this release by using the feedback button located at the bottom of the page.

For more in-depth documentation, check the API Reference

Navigation

Fixes
  • Change order of words in roundabout guidance messages in French language.
  • Correctly display if a road has controlled access.
  • Correctly show if road is a toll road (online map access).

Search

Fixes

  • Fix failure when com.tomtom.sdk.location.poi.ev.AccessType.Company is passed in the com.tomtom.sdk.search.ev.EvSearchOptions.

Version 1.25.9 - 23/07/2025

Discover the improvements and new features included in the following version. Share your thoughts on this release by using the feedback button located at the bottom of the page.

For more in-depth documentation, check the API Reference

Map Visualization

Fixes
  • Fix incorrect length for average speed zone when free driving.

Version 1.25.7 - 08/07/2025

Discover the improvements and new features included in the following version. Share your thoughts on this release by using the feedback button located at the bottom of the page.

For more in-depth documentation, check the API Reference

Personalization

Fixes
  • Bigger position model is rendered correctly.

Version 1.25.6 - 03/07/2025

Discover the improvements and new features included in the following version. Share your thoughts on this release by using the feedback button located at the bottom of the page.

For more in-depth documentation, check the API Reference

Map Visualization

Fixes
  • Correct smooth style transition when application is not being displayed.

Version 1.25.5 - 01/07/2025

Discover the improvements and new features included in the following version. Share your thoughts on this release by using the feedback button located at the bottom of the page.

For more in-depth documentation, check the API Reference

Map Visualization

Fixes
  • Prevent crash in VectorTileData model and DoubleGpuResource.

Version 1.25.3 - 17/06/2025

Discover the improvements and new features included in the following version. Share your thoughts on this release by using the feedback button located at the bottom of the page.

For more in-depth documentation, check the API Reference

General

New features
  • Move fonts from the onboard style provider to the asset font provider.
Updates
  • Include degradedLineColor in com.tomtom.sdk.map.display.visualization.navigation.betterroute.BetterRouteStyle and degradedPinImage in com.tomtom.sdk.map.display.visualization.navigation.betterroute.BetterRouteMarkerStyle and add them to the equals(), hashCode(), and toString() methods.
Fixes
  • Fix a crash that occurred when planning a route while already driving an existing route.
  • Fix a data race issue in the vehicle motion calculator component to ensure accurate and consistent results.
  • Fix a navigation crash triggered by sending telemetry events.
  • The INSTANCE field in feature toggles is no longer removed by ProGuard.
  • Update NavSDK to the latest version of org.apache.commons.io.
  • Update NavSDK to the latest version of org.apache.xmlgraphics:batik-svgrasterizer.
  • Update the sample code for the location halo feature to address issues or make enhancements.
Deprecations
  • NdsMapContext is now deprecated. Pass NdsStore and NdsStoreUpdater directly to HybridNavigationDataStore.
  • Remove Android armeabi-v7a ABI support.
  • The contents of com.tomtom.sdk.telemetry:telemetry-config-provider-default have been moved to com.tomtom.sdk.telemetry:telemetry. Remove the dependency on com.tomtom.sdk.telemetry:telemetry-config-provider-default.
Removals
  • Remove deprecated com.tomtom.sdk.common.networkstate.NetworkStateProvider.
  • Remove redundant constructor from com.tomtom.sdk.datamanagement.nds.update.NdsStoreUpdaterConfiguration.

Location

New features

  • Override the toString function for the following classes:

    • com.tomtom.sdk.location.poi.ev.ChargePointOperator
    • com.tomtom.sdk.location.poi.ev.ChargePointOperatorId
    • com.tomtom.sdk.location.poi.ev.EMobilityServiceProvider
    • com.tomtom.sdk.location.poi.ev.EMobilityServiceProviderId.
Fixes
  • Fix the hashCode method of the GeoPoint class when a value is close to the rounding boundary.
Removals
  • Remove the deprecated com.tomtom.sdk.location.GeoLocation.copy() method.
  • Remove the deprecated com.tomtom.sdk.location.GeoLocation destructuring declarations.

Map Visualization

Updates
  • TomTomMap is now an interface class.
  • Convert com.tomtom.sdk.map.display.MapOptions from a data class to a class.
  • Introduce an onboard map information API.
  • Update Orbis map styles to the latest version. Localized (EU, USA, CAN, UK) exit shield assets are now visible on the map.
Fixes
  • Add RouteUpdatedListener2 to NavigationEventsConnector.
  • Add an introduction and explanation of Reachable Range API usage and output.
  • Apply the correct active route style to route updates.
  • Avoid potential crash on smooth style transition when using lines with 'line-dasharray' property.
  • Fix a crash in routing visualization that occurred when attempting to remove polylines twice.
  • Fix an issue where the route tube displayed the wrong color when the route plan was shown again.
  • Fix issue where planned routes showed progress before navigation started.
  • Fix regression in instruction placement in the upgraded map renderer.
  • Fix smooth style transition graphical issues.
  • Fix Vehicle Restrictions guide to correctly render all restriction icons that were previously shown as plain text.
  • Prevent StyleService instance-closed crash by joining mainStyle and darkStyle jobs before closing.
  • Reduce frequency of prefetching requests on MapDataStoreConnector.
  • Remove the origin of the Better Route Planning (BRP) route from the active route.
  • Select the route when the ETA marker is clicked.
  • Show speed camera markers only when they are set to visible.
  • Stop flickering of safety location markers on the map display.
  • When prefetching with MapDataStore, reduce I/O operations, data consumption and battery consumption.
Deprecations
  • Deprecate copy() methods and destructuring declarations in com.tomtom.sdk.map.display.MapOptions.
Removals

  • Remove the following deprecated items:

    • com.tomtom.sdk.map.display.marker.MarkerOptions.copy() method
    • com.tomtom.sdk.map.display.marker.MarkerOptions destructuring declarations
    • com.tomtom.sdk.map.display.visualization.routing.RoutingVisualization.activeRoute property
    • com.tomtom.sdk.map.display.visualization.routing.RoutingVisualization.areTrafficIncidentsEnabled property
    • com.tomtom.sdk.map.display.visualization.routing.RoutingVisualization.getActiveRoute() method
    • com.tomtom.sdk.map.display.visualization.routing.RoutingVisualization.getAreTrafficIncidentsEnabled() method
    • com.tomtom.sdk.map.display.visualization.routing.RoutingVisualization.getRoutes() method
    • com.tomtom.sdk.map.display.visualization.routing.RoutingVisualization.getTrafficIncidents() method
    • com.tomtom.sdk.map.display.visualization.routing.RoutingVisualization.isZoomToRoutePlanEnabled property
    • com.tomtom.sdk.map.display.visualization.routing.RoutingVisualization.routes property
    • com.tomtom.sdk.map.display.visualization.routing.RoutingVisualization.setActiveRoute() method
    • com.tomtom.sdk.map.display.visualization.routing.RoutingVisualization.setTrafficIncidentsEnabled() method
    • com.tomtom.sdk.map.display.visualization.routing.RoutingVisualization.setZoomToRoutePlanEnabled() method

Navigation

Breaking changes

  • Change TomTomNavigation.setActiveRoutePlan(RoutePlan) to TomTomNavigation.setActiveRoutePlan(RoutePlan?).

    As a result of calling TomTomNavigation.setActiveRoutePlan(RoutePlan?) with null while in the ActiveGuidance navigation state, the navigation will transition to the FreeDriving mode, and all active route plans will be cleared from the session. If the navigation is in the Idle or FreeDriving state, invoking this method will have no effect.

    This change doesn't introduce breaking changes in the current code. Additionally, the existing behavior of TomTomNavigation.setActiveRoutePlan(RoutePlan?) is preserved when a non-null property is provided.

  • Filter out area hazards from the data provided on horizon.

New features
  • Add createHorizonOptions function for self-service in com.tomtom.sdk.navigation.horizon.
  • Add rules and assets for roadshields in Japan and Korea.
  • Better Route Proposal now supports enforced Fork Point instructions for scenarios where the Better Route diverges from the active route with an instruction that would normally be considered superfluous. This enables announcements like "For a better route, go straight".
  • Do not allow horizon extension beyond route destination when the main path search policy in com.tomtom.sdk.navigation.horizon.HorizonOptions is com.tomtom.sdk.navigation.horizon.ExplicitDistancePolicy and the navigation state is active guidance.
  • Filter out traffic events that will have expired by the time the vehicle reaches them, and traffic events that will not start until after the vehicle has driven past them.
  • Introduce an API for configuration of TomTomNavigation Dynamic Properties.
  • Promote Geopolitical View feature for NDS.Live from internal to experimental API.
Updates

  • com.tomtom.sdk.navigation.guidance.instruction.GuidanceInstruction documentation now includes known inheritors.

  • Add missing toString functions to com.tomtom.sdk.navigation.horizon.CoverPathSearchPolicy and com.tomtom.sdk.navigation.horizon.RouteLengthPolicy.

  • Add missing documentation for NavigationEngineRegistry, and ensure that updateEngines throws an exception if closed.

  • Convert com.tomtom.sdk.navigation.guidance.LaneGuidance from a data class to a regular class.

  • Convert com.tomtom.sdk.routing.route.section.lane.Lane from a data class to a regular class.

  • Disable back to route for short-range (<= 40 km) onboard routes.

  • Implement the toString method in the RouteRemovedReason class.

  • Improve BetterProposalAcceptanceMode documentation by clarifying the reasoning behind each acceptance mode and removing outdated public preview content.

  • Improve Lane Level Guidance documentation by clarifying its precise usage conditions and providing practical examples for better understanding.

  • Improve Simple Lane Guidance documentation by clarifying usage conditions and adding code snippets demonstrating practical use.

  • Improve Better Route Proposal acceptance mode documentation.

  • Improve documentation for GuidanceEngineOptions.instructionDistanceThreshold.

  • Improve documentation for GuidanceUpdatedListener by explaining how and when events are triggered and clarifying the list of instructions and how they work.

  • Improve documentation for skipRouteStop to clarify that it performs a soft-avoid operation.

  • Navigation UI fork, exit highway and switch highway icon reflects real geometry, including bifurcation, trifurcation and 4-plus furcation.

  • Refactor guidance triggering conflict values to align with the specification.

  • The following components of the com.tomtom.sdk.datamanagement.navigationtile.AreaAlongRoute class are now generally available:

    • property corridorMinLength
    • companion object DEFAULT_CORRIDOR_MIN_LENGTH
    • companion object MAX_CORRIDOR_WIDTH
    • companion object MIN_CORRIDOR_WIDTH

  • The following components of the com.tomtom.sdk.datamanagement.navigationtile.CachingConfiguration class are now generally available:

    • property maxMemorySize.
    • property refreshPeriod.
    • constructor CachingConfiguration(storageConfiguration, maxMemorySize, refreshPeriod).

  • The following components of the com.tomtom.sdk.datamanagement.navigationtile.PrefetchingConfiguration class are now generally available:

    • property prefetchedAreaAlongRoute.
    • constructor PrefetchingConfiguration(prefetchedAreaRadius, shouldRequestLaneTiles, prefetchedAreaAlongRoute) .
    • companion object DEFAULT_RADIUS

  • The NDS store no longer uses Most Probable Path (MPP) in free driving mode for map update hints.

Fixes
  • com.tomtom.sdk.navigation.arrival.ArrivalDetectionEngineOptions now requires non-negative values in its primary constructor.
  • Correct the logic in DataStoreMaintenanceService concerning Map Positioning Point (MPP) and position updates in free driving mode.
  • Demote com.tomtom.sdk.navigation.navigationresumesnapshot.NavigationResumeSnapshot.invoke(...) function from Public Preview.
  • Do not publish RouteUpdated when Better Route Proposal is automatically accepted in case of data source switch.
  • Enable lane change transitions to eliminate gaps in lane recommendations.
  • Enhance the announcement of an active route update even when Better Route Proposal (BRP) is auto-accepted to facilitate accurate comparison with the updated values of the removed active route.
  • Ensure that NavigationResumeSnapshot no longer relies on UniqueIds from the previous process, and instead refreshes them in the current process.
  • Extend lane transition distance to 6.5m.
  • Fix a crash that could occur after reaching the destination.
  • Fix a memory retention issue when the car is not moving during active navigation.
  • Fix a rare android.app.ForegroundServiceStartNotAllowedException that could occur when using com.tomtom.sdk.navigation.ui.NavigationFragment with NavigationUiOptions.keepInBackground=true.
  • Fix an issue in Simple Lane Guidance where lane guidance for distant instructions was displayed too early after a roundabout.
  • Fix an issue in Simple Lane Guidance where the guidance for the next instruction incorrectly displayed the previous instruction.
  • Fix an issue where Simple Lane Guidance was partially generated when data for all lanes was not available.
  • Fix an out-of-bounds exception during the route mapping.
  • Fix continuous route replanning and replanning after deviations to ensure the ETA is correctly adjusted based on the current time, especially when the initial route was planned using RoutePlanningOptions.departAt or RoutePlanningOptions.arriveAt.
  • Fix guidance triggering phase selection when the distance with the message is within the earliest range of the Confirmation phase.
  • Fix issues with refreshing the route that may occur near a waypoint.
  • Fix missing imports in com.tomtom.sdk.navigation.orchestrator.domain.process.NavigationProcess.
  • Implement disconnection exceptions in the Hive MQTT Client.
  • Increase the confirmation announcement triggering distance in city areas.
  • Lane sections are selected with the same precision as provided from the backend.
  • Make it possible to enable the Realistic Junction View feature after fixing a map locking issue.
  • Progress is now calculated after a longer jump if the current position is close to the route.
  • Reduce memory usage by DefaultRouteTrackingEngine.
  • Remove the gap between a lane-level route and a road-level route extension.
  • Resolve a data race condition in the local horizon snapshot state in com.tomtom.sdk.navigation.orchestrator.domain.process.NavigationProcess, which could lead to unpredictable behavior.
  • Retain turn-specific and future TPEG traffic events even if they extend beyond the end of the horizon path.
  • The LanePathGeneratorService no longer keeps the lock to the storeAccess, but closes it appropriately.
  • The Android Text-To-Speech Engine now modifies the SSML for US-English to replace unsupported characters with supported ones.
  • The exit icon reference of a signpost is now serialized and deserialized in the NavigationResumeSnapshot.
  • The lane-level scenario won't start when there is a gap between trimmed lane level routes.
  • Update the copy() function in NavigationTileStoreConfiguration to now use deep copy after changing properties from val to var.
  • Update the expected arrival time on the guidance view after changing the active route plan using com.tomtom.sdk.navigation.ui.NavigationFragment.setActiveRoute(RoutePlan).
  • Use horizon path geometry for checking tiles availability in free drive mode.
  • Waypoint marked as departed using com.tomtom.sdk.navigation.TomTomNavigation.departFromWaypoint is no longer detected as deviation.
Deprecations

  • Deprecate componentN() and copy(...) methods in com.tomtom.sdk.navigation.guidance.LaneGuidance.

  • Deprecate componentN() and copy(...) methods in com.tomtom.sdk.routing.route.section.lane.Lane.

  • Deprecate the com.tomtom.sdk.navigation.horizon.MainPathSearchOptions.minDistanceAhead property.

  • Deprecate the com.tomtom.sdk.navigation.horizon.MainPathSearchOptions(Duration=,PathSearchDistancePolicy=,Distance) constructor. Use com.tomtom.sdk.navigation.horizon.MainPathSearchOptions(Duration=,PathSearchDistancePolicy=) instead.

  • Deprecate the NavigationTileStoreConfiguration, PrefetchingConfiguration, CachingConfiguration copy methods.

  • In com.tomtom.sdk.datamanagement.navigationtile.CachingConfiguration, the following are now deprecated:

    • property cacheMemoryMaxSize is deprecated, use maxMemorySize instead.
    • property tileRefreshPeriod is deprecated, use refreshPeriod instead.
    • constructor CachingConfiguration(cacheMemoryMaxSize, cacheStorageConfiguration, tileRefreshPeriod) is deprecated, use CachingConfiguration(storageConfiguration, maxMemorySize, refreshPeriod) instead.
Removals

  • Remove the following deprecated features across various classes:

    • com.tomtom.sdk.datamanagement.navigationtile.CachingConfiguration.cacheStorageConfiguration property
    • com.tomtom.sdk.datamanagement.navigationtile.CachingConfiguration.CachingConfiguration(cacheMemoryMaxSize, cacheStorageConfiguration) constructor
    • com.tomtom.sdk.datamanagement.navigationtile.CachingConfiguration.copy() method
    • com.tomtom.sdk.datamanagement.navigationtile.CachingConfiguration.getCacheStorageConfiguration() method
    • com.tomtom.sdk.navigation.guidance.GuidanceAnnouncement.copy() method and destructuring declarations
    • com.tomtom.sdk.vehicle.ConnectorDetails.copy() method and destructuring declarations
    • com.tomtom.sdk.vehicle.Vehicle.Bus.copy() method and destructuring declarations
    • com.tomtom.sdk.vehicle.Vehicle.Car.copy() method and destructuring declarations
    • com.tomtom.sdk.vehicle.Vehicle.Motorcycle.copy() method and destructuring declarations
    • com.tomtom.sdk.vehicle.Vehicle.Taxi.copy() method and destructuring declarations
    • com.tomtom.sdk.vehicle.Vehicle.Truck.copy() method and destructuring declarations
    • com.tomtom.sdk.vehicle.Vehicle.Van.copy() method and destructuring declarations
    • com.tomtom.sdk.vehicle.VehicleDimensions.copy() method and destructuring declarations

Personalization

New features
  • Add new properties in the existing UserSettings class.
  • Add offline storage of new user settings parameter.
Updates
  • Document client responsibilities and the side effects of using RecentDestinationSuggestionsProvider with PersonalData.
Fixes
  • Fix the recent destination suggestion time delta of 90 mins so that it now works correctly across days. This means users will receive accurate recent destination suggestions even when transitioning to the following day.

Routing

Breaking changes
  • Prevent the use of considerTraffic=ConsiderTraffic.No when chargingOptions are specified in RoutePlanningOptions for EV route planning, as it was previously ignored and treated as ConsiderTraffic.Yes.
New features
  • Add the createRoutePlanningOptions function that allows creation of RoutePlanningOptions according to Self-Service guidelines.
  • Add the RoutePlanner() function that allows simplified creation of OfflineRoutePlanners according to Self-Service guidelines.
  • Add the RoutePlanner() function that allows simplified creation of RoutePlanners according to Self-Service guidelines.
  • Ensure the junction view is now supported for NDS.Live.
  • Propagate the minChargeAtFirstChargingStop parameter to the onboard planner.
  • Propagate the minChargeAtFirstChargingStop parameter to the online planner.
Updates

  • Deprecate the following methods:

    • ReconstructionMode.Update.
    • RoutePlanner.advanceGuidanceProgress and RouteIncrementOptions.
    • RoutePlanner.backToRoute and BackToRouteOptions.
    • Synchronous RoutePlanner.planRoute.

  • Migrate non-test consumers to the online route planner factory.

  • Promote the following APIs:

    • Route.plannedWith to GA.
    • AlphaOnlineRoutePlannerApi to BetaOnlineRoutePlannerApi.
    • ExperimentalOnlineRoutePlannerApi to AlphaOnlineRoutePlannerApi.

  • Set RoutingCallback.onRoutePlanned to Unit by default. The method is used to provide a facility for incremental alternative routes in onboard route planning.

  • Update the Getting Started guide for Routing.

  • Update the PRO factory annotation for consistency with RoutePlanner.

Fixes
  • OnlineRoutePlanner no longer attempts to make online requests in case of no connection.
  • Allow sending empty supporting points for the first leg in Onboard EV Route Update.
  • Enable the Thrilling RouteType in RoutePlanningOptions for Orbis.
  • Fix map access and native routing client lifetime management race condition.
  • Fix occasionally missing forkPoints in online route planning with alternatives.
  • Improve entryPointIndex documentation so it is more understandable.
  • Set extendedSections to ExtendedSections.All in createRoutePlanningOptions.
Deprecations

  • Deprecate the following methods in com.tomtom.sdk.routing.route.ForkPoint:

    • component1()
    • component2()
    • component3()
    • copy().
Removals

  • Remove deprecated methods and properties across various classes:

    • com.tomtom.sdk.navigation.guidance.instruction.Signpost.copy() method
    • com.tomtom.sdk.navigation.guidance.instruction.Signpost destructuring declarations
    • com.tomtom.sdk.routing.options.guidance.GuidanceOptions.getGuidanceVersion method and guidanceVersion property
    • com.tomtom.sdk.routing.options.guidance.GuidanceOptions.OnlineApiVersion class
    • com.tomtom.sdk.routing.route.instruction.arrival.ArrivalInstruction.copy() method and destructuring declarations
    • com.tomtom.sdk.routing.route.instruction.autotransport.EnterAutoTransportInstruction.copy() method and destructuring declarations
    • com.tomtom.sdk.routing.route.instruction.autotransport.ExitAutoTransportInstruction.copy() method and destructuring declarations
    • com.tomtom.sdk.routing.route.instruction.bordercrossing.BorderCrossingInstruction.copy() method and destructuring declarations
    • com.tomtom.sdk.routing.route.instruction.carpoollane.EnterCarpoolLaneInstruction.copy() method and destructuring declarations
    • com.tomtom.sdk.routing.route.instruction.carpoollane.ExitCarpoolLaneInstruction.copy() method and destructuring declarations
    • com.tomtom.sdk.routing.route.instruction.waypoint.WaypointInstruction destructuring declarations
    • com.tomtom.sdk.routing.route.instruction.departure.DepartureInstruction.copy() method and destructuring declarations
    • com.tomtom.sdk.routing.route.instruction.fork.ForkInstruction.copy() method and destructuring declarations
    • com.tomtom.sdk.routing.route.instruction.highway.ExitHighwayInstruction.copy() method and destructuring declarations
    • com.tomtom.sdk.routing.route.instruction.highway.SwitchHighwayInstruction.copy() method and destructuring declarations
    • com.tomtom.sdk.routing.route.instruction.mandatoryturn.MandatoryTurnInstruction.copy() method and destructuring declarations
    • com.tomtom.sdk.routing.route.instruction.merge.MergeInstruction.copy() method and destructuring declarations
    • com.tomtom.sdk.routing.route.instruction.roundabout.ExitRoundaboutInstruction.copy() method and destructuring declarations
    • com.tomtom.sdk.routing.route.instruction.roundabout.RoundaboutInstruction.copy() method and destructuring declarations
    • com.tomtom.sdk.routing.route.instruction.tollgate.TollgateInstruction.copy() method and destructuring declarations
    • com.tomtom.sdk.routing.route.instruction.turn.TurnInstruction.copy() method and destructuring declarations
    • com.tomtom.sdk.routing.route.instruction.turnaroundwhenpossible.TurnAroundWhenPossibleInstruction.copy() method and destructuring declarations
    • com.tomtom.sdk.routing.route.instruction.waypoint.WaypointInstruction.copy() method
    • com.tomtom.sdk.routing.route.section.traffic.TrafficSection.effectiveSpeedInKmh property and related methods and constructor
    • com.tomtom.sdk.routing.route.Signpost.copy() method and destructuring declarations
    • com.tomtom.sdk.vehicle.ChargingInformation.copy() method and destructuring declarations.

Search

Breaking changes
  • Remove the experimental secondary constructor for com.tomtom.sdk.location.poi.CategoryId(StandardCategoryId). If you were relying on this constructor, please use the primary constructor com.tomtom.sdk.location.poi.CategoryId(StandardCategoryId, String? = null) instead.
New features
  • Implement online reverse geocoder.
Updates

  • Change the logging level from info to debug for various log messages to reduce excessive logging and to ensure sensitive information is not logged at an info level.

  • Convert the following classes from data to regular:

    • com.tomtom.sdk.search.SearchOptions
    • com.tomtom.sdk.search.SearchResponse
    • com.tomtom.sdk.search.autocomplete.AutocompleteOptions
    • com.tomtom.sdk.search.autocomplete.AutocompleteResponse
    • com.tomtom.sdk.search.geometrydata.GeometryDataResponse
    • com.tomtom.sdk.search.model.geometry.GeometryData
    • com.tomtom.sdk.search.model.result.AutocompleteResult
    • com.tomtom.sdk.search.model.result.AutocompleteSegmentBrand
    • com.tomtom.sdk.search.model.result.AutocompleteSegmentPoiCategory
    • com.tomtom.sdk.search.model.result.AutocompleteSegmentPlainText
    • com.tomtom.sdk.search.poicategories.PoiCategoryOptions
    • com.tomtom.sdk.search.poicategories.PoiCategoryResponse
    • com.tomtom.sdk.search.model.result.PoiDetails
    • com.tomtom.sdk.search.model.result.SearchResultId
    • com.tomtom.sdk.search.poidetails.PoiDetailsOptions
    • com.tomtom.sdk.search.poidetails.PoiDetailsResponse

    Add equals(other: Any?), hashCode(), toString() methods to the converted classes.

  • Correct the KDoc in com.tomtom.sdk.search.reversegeocoder.hybrid.HybridReverseGeocoder to accurately describe the configuration of geopolitical views.

  • Enhance structured search functionality for NDS maps with multiple update regions.

  • Implement geopolitical view in EVSearch and EVAlongRouteSearch.

  • Improve the Reverse Geocoder API: add IntRange with minimum/maximum accepted values com.tomtom.sdk.search.reversegeocoder.ReverseGeocoderOptions.

  • Migrate com.tomtom.sdk.search.SearchResponse from data class to class.

  • Override com.tomtom.sdk.search.reversegeocoder.ReverseGeocoderOptions.toString().

Fixes

  • LanguageConverter now correctly handles locales with script. This means that the reverseGeocode feature in NavSDK will use Traditional Chinese for Taiwan, previously it was using Simplified Chinese.

  • Correct the chargingPark field in PoiDetailsResponse to ensure it contains relevant data about charging stations and providers. You can now retrieve detailed charging park information for points of interest, including service providers and operators, through the SDK.

  • Cut short the com.tomtom.sdk.location.GeoPoint) log in com.tomtom.sdk.search.SearchOptions.

  • Enhance error handling in the Cacher class initialization and prevent crashes in the future.

    Ensure that EvdsId is populated when using onboard search with the onboard Zenrin map for electric vehicles.

  • Fix exception when sending feedback for a CrossStreet search result.

  • Fix the hybrid reverse geocoder taking too much time when the network is slow or not available.

  • Online EV search along the route now uses an increased timeout to prevent failures on long routes.

Deprecations

  • Deprecate the componentN() and copy(...) methods in the following classes:

    • com.tomtom.sdk.search.SearchOptions
    • com.tomtom.sdk.search.SearchResponse
    • com.tomtom.sdk.search.autocomplete.AutocompleteOptions
    • com.tomtom.sdk.search.autocomplete.AutocompleteResponse
    • com.tomtom.sdk.search.geometrydata.GeometryDataResponse
    • com.tomtom.sdk.search.model.geometry.GeometryData
    • com.tomtom.sdk.search.model.result.AutocompleteResult
    • com.tomtom.sdk.search.model.result.AutocompleteSegmentBrand
    • com.tomtom.sdk.search.model.result.AutocompleteSegmentPoiCategory
    • com.tomtom.sdk.search.model.result.AutocompleteSegmentPlainText
    • com.tomtom.sdk.search.poicategories.PoiCategoryOptions
    • com.tomtom.sdk.search.poicategories.PoiCategoryResponse
    • com.tomtom.sdk.search.model.result.PoiDetails
    • com.tomtom.sdk.search.model.result.SearchResultId
    • com.tomtom.sdk.search.poidetails.PoiDetailsOptions
    • com.tomtom.sdk.search.poidetails.PoiDetailsResponse

    Use corresponding property getters and setters to access and manage the values.

  • Deprecate the following classes and constructors:

    • com.tomtom.sdk.search.reversegeocoder.ReverseGeocoderSummary.
    • com.tomtom.sdk.search.SearchSummary along with constructors com.tomtom.sdk.search.model.summary.SearchSummary(String=,GeoPoint?=,Duration?=) and com.tomtom.sdk.search.SearchResponse(SearchSummary,List<SearchResult>=).

Traffic

Updates
  • Note that com.tomtom.sdk.traffic.TrafficChangedListener callbacks now run on the main thread.
  • Note that dependencies passed to com.tomtom.sdk.traffic.client.TrafficClientFactory methods must not be closed prior to the factory-created instance.