Release Notes

version 0.32.0 - 13/09/2023

General

Breaking changes

  • Rename com.tomtom.sdk.hazards.online.HazardSeverity.Low to com.tomtom.sdk.hazards.online.HazardSeverity.Minor.

Fixes

  • Fix publishing consumer proguard rules preventing gosdk minification.

Updates

  • Rename com.tomtom.sdk.navigation.horizon.dataadapter.hazards.online.HazardSeverity.Low to com.tomtom.sdk.navigation.horizon.dataadapter.hazards.online.HazardSeverity.Minor.

Location

Breaking changes

  • RoadType unintentionally was made Generally Available - it is Public Preview.
  • Move com.tomtom.sdk.location.DrivingSide from com.tomtom.sdk.location:model to com.tomtom.sdk.location:location-route and rename to com.tomtom.sdk.location.road.DrivingSide.
  • Move com.tomtom.sdk.location.FineGraindRoadType from com.tomtom.sdk.location:model to com.tomtom.sdk.location:location-route and rename to com.tomtom.sdk.location.road.FineGraindRoadType.
  • Move com.tomtom.sdk.location.RoadType from com.tomtom.sdk.location:model to com.tomtom.sdk.location:location-route and rename to com.tomtom.sdk.location.road.RoadType.
  • Remove the Road suffixes from the values in FineGrainedRoadType.
  • Rename FineGrainedRoadType to RoadType.
  • Rename RoadType to RoadCategory.

Updates

  • Creat new module com.tomtom.sdk-location:location-route.

Map

New Features

  • Expose copyrights caption.

Fixes

  • After changing tracking mode zooming doesn't work.
  • Fix for turn instruction highlighted arrow misplaced .
  • Fix missing companion field in MapFragment.
  • Fix proguard configuration not to remove nested classes of internal SDK classes.
  • Fix the API key for accessing the sprite file is incorrect in vector map and traffic example.

Updates

  • Simplify proguard configuration for map-display modules.
  • Split map-display module into map-display and map-display-common.
  • Use single MapView and MapFragment definition for each mapdisplay flavor.

Breaking changes

  • Change roadType to roadCategory in RegionalSpeedLimit.
  • Change LocationContext from data class to class and remove Road nested class.
  • Change the property com.tomtom.sdk.navigation.locationcontext.LocationContext.road to nullable.
  • Convert data classes in Horizon Engine to classes.
  • Move com.tomtom.sdk.navigation.horizon.elements.generalroadproperties.NumberOfLanes to com.tomtom.sdk.location.road.NumberOfLanes.
  • Move com.tomtom.sdk.navigation.horizon.elements.generalroadproperties.RoadCondition to com.tomtom.sdk.location.road.RoadCondition.
  • Remove com.tomtom.sdk.navigation.horizon.elements.countryinformation.RegionalSpeedLimitType and replace the speed limit with com.tomtom.sdk.location.SpeedLimit.
  • Remove com.tomtom.sdk.navigation.horizon.elements.speedlimit.SpeedLimitsType and replace the speed limit with com.tomtom.sdk.location.SpeedLimit.
  • Remove com.tomtom.sdk.navigation.locationcontext.LocationContext.Road and replace it with com.tomtom.sdk.location.road.RoadProperties.
  • Remove com.tomtom.sdk.navigation.locationcontext.SpeedLimit and replace references to it with references to com.tomtom.sdk.location.SpeedLimit.
  • Remove isWeatherDependent and isTimeDependent field in RegionalSpeedLimitType.
  • Remove road related properties in com.tomtom.sdk.navigation.horizon.elements.generalroadproperties.GeneralRoadProperties and replace those properties with com.tomtom.sdk.location.road.RoadProperties.
  • Rename com.tomtom.sdk.navigation.horizon.elements.hazard.HazardSeverity.Low to com.tomtom.sdk.navigation.horizon.elements.hazard.HazardSeverity.Minor.

New Features

  • Extend RouteProgress with remainingTrafficDelay.
  • Introduce a new class com.tomtom.sdk.location.road.RoadProperties.

Fixes

  • Do not replan when current car position is off-road near origin.
  • Fix crash in traffic module that could happen if user applies obfuscation.
  • Fix Protobuf related crash at navigation initialization.

Updates

  • Improve the documentation of the properties of LocationContext.
  • TomTomNavigation will throw on start and update if vehicle provider has not been properly configured.

Routing

Breaking changes

  • Refactor interface RouteStop to class RouteStop.
  • Remove Origin, Destination, Waypoint classes and replace them with RouteStop class.
  • Remove startOfRoute and endOfRoute properties from Route class.

Fixes

  • Enable runtime switching of endpoints when using OnlineRoutePlanner with custom apiUri. The custom apiUri parameter must contain only the baseURL (without the endpoint). The endpoint will be appended by the OnlineRoutePlanner automatically.

Updates

  • Add waypoints property to Route class.

New Features

  • Add personal locations support to offline search.

Fixes

  • Introduce missing TTOM standard POI categories.

Updates

  • Update documentation for search common module.

version 0.31.1 - 31/08/2023

Routing

Fixes

  • Fix for re-planning crash.

version 0.31.0 - 25/08/2023

General

Updates

  • Update broken links and references in telemetry documentation.

Map

Updates

  • Promote route visualization to GA.
  • Replace horizon api by safety location.
  • Replace navigation visualization data class from public API.
  • Use generic interface where possible.

Breaking changes

  • Prepare navigation visualization to promote to GA.

Routing

Fixes

  • Fixes set_active_route_on_map test failing.

Fixes

  • Fix origin coordinate is wrongly set to 0.0,0.0 while navigating.

New Features

  • Automatic replanning on deviation sticks to route if supporting points are provided in the initial planning.
  • Trigger replan even though destination has been reached.

Breaking changes

  • Replace LocationContext.Address with com.tomtom.sdk.location.Address.

Search

New Features

  • Update documentation for reverse geocoder.

version 0.30.1 - 14/08/2023

Map

Breaking changes:

  • Solve discrepancies with iOS of module routing visualization to promote to GA.

Updates:

  • Expand the CameraTrackingMode type with the configurable classes that can contain FollowCameraOperatorConfig
  • Promote FollowCameraOperatorConfig to publicpreview

Search

Updates:

*

Routing

Breaking changes:

  • Remove context parameter from OfflineRoutePlanner.create() function.

Fixes:

  • Fix waypoints not being updated on selecting alternative route for EV cars on long distance routes.
  • Prevent setting vehicleHeading=360 when planning a route.

Breaking changes:

  • Group number of lanes properties in GeneralRoadProperties.
  • Group tunnel and bridge properties together.
  • Remove properties speedFog, speedSnow and speedRain from horizon API class SpeedLimits. Remove value Variable from horizon API value class SpeedLimitsType.
  • Replace LocationTracesParser.fromAssets(String) method with extension function LocationTracesParser.fromAssets(Context, String).

New features:

  • LocationTracesParser.fromInputStream(InputStream).

Updates:

  • Improve inline documentation for off-road navigation.
  • Promote Hybrid Navigation API to PP

Fixes:

  • Always interpret the input speed limit values as kph.
  • Fix origin coordinate is wrongly set to 0.0,0.0 while navigating.
  • Initialize horizon engine if null in HybridTomTomNavigationFactory

version 0.29.0 - 08/08/2023

Map

New features:

  • Draw a dotted line connecting the drivable and final destination.
  • Geojson-based primitives use JsonObject for properties.
  • NDS.Live bindings and implementation in NavigationTileStore
  • Use unified engines with NDS.Live implementation of NavigationTileStore

Updates:

  • Add versioning info on performance graph

Fixes:

  • Ndslive bindings macOS kmp context failure

Search

New features:

  • Add support for supported vehicle types in the search response for online mode.

Updates:

  • Fix artifact id for custom online search.

Routing

Removals:

  • Updated documentation for track import. Removed incorrect statement about user waypoints support.

Fixes:

  • Prevent setting vehicleHeading=360 when planning a route.

Breaking changes:

  • Change in Public Preview code: com.tomtom.sdk.location.DrivingSide replaces com.tomtom.sdk.traffic.DrivingSide and com.tomtom.sdk.navigation.horizon.elements.countryinformation.DrivingSide

New features:

  • Support tunnel and bridge names in Navigation UI

Updates:

  • Add IntRange checking to the properties of GeneralRoadProperties

Fixes:

  • Notification with the same distance to the next instruction will be sent only once.

version 0.28.0 - 01/08/2023

Map

Breaking changes:

  • Add vehicle restrictions styles for onboard map.

New features:

  • Unsupported GeoJSON Marker operations now throw an exception.

Updates:

  • Add NavigationTileStoreConfiguration values bounds for prefetchedAreaRadiusMeters and cache sizes.
  • Add big groups of markers in batches rather than one by one.
  • Enable smooth style reloading feature by default.
  • Release note message.
  • Remove explicit font names from copyright notice.
  • Update standard style version.

Fixes:

  • Vehicle Restrictions within Routing Visualization

Search

Fixes:

  • Throw NetworkOnMainThreadException when calling Search from the Main Thread.

Routing

Fixes:

  • Create route points for legs with a single arc.

New features:

  • Add tunnel and bridge names in LocationContext.

Updates:

  • Added close() method to TomTomNavigationService that needs to be called before unbindService().
  • Fix namings and documentation in ReplannedRouteValidator and RouteMergerTest.
  • Improve performance by not creating unnecessary lists in RouteMerger.
  • Promote RouteTrackingState to PP.
  • Update the documentation for RouteUpdatedListener.

Fixes:

  • Fix crash in Route.init() that can happen during route refresh.
  • Remove unnecessary dependency to online component from offline route projection.

version 0.27.0 - 25/07/2023

Map

New features:

  • Add support for GeoJson Markers.

Updates:

  • Promote hillshading APIs of StyleController to GA.
  • Use time since boot to calculate duration of location marker’s animation and location accuracy policy.

Removals:

  • Remove camera operators config from style.

Search

Fixes:

  • Handle kNdsCategoryNotFound in android bindings

Routing

New features:

  • Add the possibility to avoid specific charging parks when planning a route with automatically added charging stops.

Breaking changes:

  • Implement OffRoadTomTomNavigationFactory.
  • Removed
  • Removed TomTomNavigationFactory and NavigationConfiguration. Use new navigation factories (e.g. OnlineTomTomNavigationFactory) instead.

Fixes:

  • Improve documentation for addProgressUpdatedListener in TomTomNavigation.

General

Updates:

  • Strip native binaries from debug information for JVM targets.

version 0.26.0 - 07/07/2023

Map

New features:

  • Add support for GeoJson Polylines.

Updates:

  • Follow DDD on NavigationVisualization module
  • Log map tiles download times.

Routing

New features:

  • Support arrival side preference in the offline route planner.

Breaking changes:

  • Rename packages

New features:

  • Traffic section api, bindings and implementation

Updates:

  • The close method also stops navigation.
  • Update documentation for setting GuidanceUpdatedListener.

Fixes:

  • Fix proguard rules forBackToRoutePointCalculator.

Location

New features:

  • Make prediction generator more robust.

General

Fixes:

  • Listener not triggered when changing engine type.

version 0.25.0 - 30/06/2023

Map

New features:

  • Add support for number of axles for Vehicle restriction
  • Expose camera operators customization on the SDK API

Updates:

  • Move first number of safety location from style to API
  • Update navigation visualization safety cameras UX spec

Fixes:

  • Add missing font to Routing Visualization
  • Fix flaky tests for map display binding

Search

Fixes:

  • Add support for address ranges from online search in GOSDK online search.
  • Use the search endpoint even when the category filter is set.

Breaking changes:

  • Data store maintenance is reset when navigation is stopped.
  • Update signature of DataUpdatedListener to use a list of GeoBoundingBox within the component com.tomtom.sdk.navigation:horizon-data-adapter.
  • Updated signature of OnlineHazardsHorizonDataAdapterFactory.create to consume Hazards object.
  • Updated signature of OnlineSafetyLocationsDataAdapterFactory.create to consume SafetyLocations object.

Updates:

  • Vehicle profile test case for horizon-engine-unified.

Fixes:

  • Correct dependencies.
  • DataStoreMaintenanceEngineFactory and DataStoreMaintenanceEngine are visible in SDK.

General

New features:

  • Promote CompositeRegionsUpdater API to public preview

Updates:

  • Convert quantity classes to Kotlin’s value classes.
  • Refactor UnitBase abstract class to an interface.

version 0.24.0 - 23/06/2023

Map

Fixes:

  • Remove redundant animation of the moveCamera() method.

Routing

New features:

  • Extend routing options with arrival side preference.

Updates:

  • Clarify avoid behavior for routing in documentation.
  • Add missingn lez and unpaved sections to documentation

Fixes:

  • Promote arrival side preference to public preview

Updates:

  • Add new factories for online, offline and hybrid navigation.
  • Navigation handles updating of data stores internally.

Fixes:

  • Correct dependencies.
  • DataStoreMaintenanceEngineFactory and DataStoreMaintenanceEngine are visible in SDK.
  • DefaultTomTomNavigation should properly implement AutoCloseable.

General

Updates:

  • Mark interfaces as functional.

Fixes:

  • Throw if the same listener is added multiple times.

version 0.23.1 - 21/06/2023

version 0.23.0 - 16/06/2023

Map

New features:

  • Implement a decision point hint on route manager
  • Release note message.

Updates:

  • Add possibility to run performance test on different zoom levels.
  • Bump style version to 24.2.*
  • Minor optimisation and snippet fix.

Fixes:

  • Fix crash on sprites loading when local cache file cant be opened.
  • Fix false map interaction events
  • Fix rare crash that happened on style load.

Search

Breaking changes:

  • Replace position, address, entryPoints properties in CustomRecord.CustomPoi with Place class.

New features:

  • Add support for address for custom POIs.

Updates:

  • Move online custom POI support to Public Preview

Fixes:

  • Fix for non-findable offline search native library.

Routing

New features:

  • Expose information on when and where path alternative forks off the primary route.
  • Extend routing options with arrival side preference.

Fixes:

  • Fix routing sections mapping.
  • Promote arrival side preference to public preview
  • Release note message.

Breaking changes:

  • Refactor RouteTrackingEngine to handle RouteTrackingState.
  • Renaming dependency

New features:

  • Add waypoint arrival panel to navigation fragment
  • Conversion from a bounding box to a list of tiles.
  • Promote NavigationTileStore API to Public Preview.
  • Rename OnlineLocationContextProvider engines according to convention and move APIs to Public Preview.

Updates:

  • Add translations for waypoint arrival panel
  • Declare click listener parameter for UI components as View.OnClickListener instead of an anonymous type.
  • Filter out Lane Sections with no Direction to follow.
  • Use NavigationConfiguration to createTomTomNavigation in the Navigation use case.

Fixes:

  • Correct timestamps in predictions.
  • Fix potential crash during navigation of Route planned with RouteInformationMode=FirstIncrement.
  • Guidance instructions and maneuver icon displayed too early after the route has been refreshed.

General

Breaking changes:

  • Enable RSA with OAEP encryption.

New features:

  • Add optional charging parameters
  • Extend DefaultVehicleProvider to support optional charging parameters.

Updates:

  • Initialize vehicle snapshot through DefaultVehicleProvider constructor.
  • Promot an Experimental Telemetry API to Public Preview.

Removals:

  • Retire Navigation Visualization Addon

Fixes:

  • Inconsistent use of function names.
  • Incorrect bottom padding on the map.
  • Minor DefaultVehicleProvider improvements
  • UpdateVehicleState should properly handle updates that lead to inconsistent state of the vehicle.

version 0.22.4 - 06/06/2023

Map

New features:

  • Add IC, JCT and traffic light icon for Japan map.
  • Add Routing Visualization to maps-demo-app
  • Create NavigationVisualization module within Maps
  • Intersection name and traffic light icon visualization.
  • Intersection name visualization for Japan map.

Updates:

  • Add instruction length calculation for Routing API v2
  • Load Orbis specific copyrights when Orbis feature is enabled.
  • Migrate vehicle restriction to travelModeProfile

Fixes:

  • Fixed table presentation for vehicle restriction page on dev portal.
  • Make current location marker grey if location is not updated for a some time.
  • Revert addon API to Public Preview

Search

New features:

  • Support for custom POI search with online-only search mode.

Routing

Fixes:

  • Hotfix an issue with route sections.

Breaking changes:

  • Remove LocationContextProviderEngines' language parameter, locale will be used from snapshot
  • Remove LocationProvider from the NavigationEngineRegistry and expose it on the TomTomNavigation interface as the mutable property: TomTomNavigation.locationProvider.
  • Reverse order of the parameters in HorizonSnapshot.distanceTo method.

New features:

  • Expose vehicle provider in TomTomNavigation
  • Extend Route Replanning to compute instructions incrementally on the active route as required.
  • Next waypoint can be manually marked as visited after it has been reached.

Updates:

  • Improve inline documentation for navigation horizon module.
  • Remove sticking to route on deviation
  • Add platform-specific attributes to the bindings.

Fixes:

  • Fix progress calculation on the overlapping route.
  • Improve synchronization in NavigationEngineRegistry.
  • Prevent repeated calls to RouteReplanner.incrementRouteContents when route length changes.

General

New features:

  • Remove RouteProjection feature toggle.

Updates:

  • Add performance test for orbis map and vehicle restrictions map.
  • Unclear methods explanations.

Fixes:

  • Incorrect bottom padding on the map.
  • Replaced keys with placeholders.

version 0.18.4 - 02/06/2023

version 0.18.0 - 22/05/2023

Map

Updates:

  • Update vehicle restrictions documentation with LEZ, hazmat, and supported restriction types.

Fixes:

  • Fix the issue of sprites not being displayed for custom styles that contain URL encoded characters
  • Make current location marker grey if location is not updated for a some time.

Search

Fixes:

  • Use time zone correctly in opening hours

Routing

Updates:

  • Adjust projection lower boundary.

Fixes:

  • Add remaining charging plug types mapping.
  • Hotfix an issue with route sections.
  • Move RouteIncrementResult to onboard infrastructure package
  • Setting internalAnnouncementPoints to none in case of the long-distance EV route.

Breaking changes:

  • Change id property type in com.tomtom.sdk.navigation.horizon.datasource.SafetyLocationData from string to SafetyLocationId inline class.
  • Change safetyLocationId property type in com.tomtom.sdk.navigation.horizon.elements.SafetyLocation from string to SafetyLocationId inline class.
  • Omit needless vehicle prefix for VehicleUpdateOption cases

New features:

  • Add bindings for get-pruned-pectangles method.
  • Add hybrid VH engine.
  • Add utility function of getting geometry of an element in a horizon snapshot.
  • Propagate guidance progress from instruction engine

Updates:

  • Remove sticking to route on deviation
  • Use limited parallelism in navigation.

Fixes:

  • Fix checking if the route can be replanned if the number of different points is the same as provided threshold in the RouteReplannerConfiguration.
  • Prevent repeated calls to RouteReplanner.incrementRouteContents when route length changes.

General

Breaking changes:

  • Change the api of DefaultVehicleProvider’s setVehicle method

Fixes:

  • Fix links on the FAQs page.

version 0.12.0 - 26/04/2023

Map

Breaking changes:

  • Remove LaneLevelSegmentController class.
  • Remove primitive accessors(markers, circles, polygons, polygonOverlays, polylines) from TomTomMap class.

New features:

  • Add support for ADR & Hazmat for vehicle restrictions.
  • Create Routing Visualization module within Maps
  • Enables adding and removing request observers for diagnostic information in httphandler.
  • Extend Polyline with pattern texture support.
  • Manual Map Management at update region set level.
  • Introduce a hybrid data provider

Updates:

  • Allow to pass null value to LocationController.setLocationProvider().
  • Add handling of invalid URL and mapping file as a result error.
  • Add missing NotoSans fonts.
  • Add more debug information to route validation error.
  • Add padding parameter to zoomToMarkers() method of MarkerController interface.
  • Add the possibility of drawing the route section based on the geometry and route offset.
  • Align the style across all the offline styles
  • Extend layer API with layer visibility
  • Promote MapOptions, MapView and MapFragment to general availability.
  • Promote TomTomMap class to general availability.
  • Update documentation of the com.tomtom.sdk.map.display.styleprovider.offline.StyleUriProvider to be used only with the offline map.
  • Update style version to 24.1.* and add dark mode support to vehicle restriction style.

Fixes:

  • Fix crash when traffic incident is tapped.
  • Avoid Opt-in for experimental feature in addons
  • Enable generation of documentation for StyleUriProvider
  • Fix crash when switching between map fragments using offline mode
  • Fix metadata handling on custom styles.
  • Get unknown icon category back.
  • Update the link text to indicate that the list of supported languages is for online maps
  • Add a Kdoc for setLanguage fun of MapController
  • Update the documentation for tomtom map config to specify how the contract for factory

Search

Breaking changes:

  • ChargingConnectorAvailabilityDetails is renamed to ConnectorAvailabilityDetails
  • ChargingAvailabilityId is renamed to availabilityId in EvChargingAvailabilityOptions
  • ConnectorType is renamed to type in ConnectorAvailability
  • ConnectorTypeSet is renamed to connectors in EvChargingAvailabilityOptions
  • EvChargingStationSearch is renamed to requestEVChargingAvailability in EvChargingAvailabilityProvider
  • Redesign AutocompleteSegment.
  • Remove timeout from HybridReverseGeocoder, OnlineReverseGeocoder, and HybridSearch.

New features:

  • Expose the provided fuel types in gas station POIs for offline search
  • FuelPriceResponse now has fuelPriceId
  • ParkingAvailabilityResponse now has parkingDetailId
  • Provide accessible vehicle types for POIs in offline search
  • Introduce accessibility of different types of vehicles at the Point of Interest.

Updates:

  • Remove unused types
  • Add tests for geobias when geometry search is used.
  • Use limited parallelism in search.

Fixes:

  • Add Locale to the constructor of SearchOptions for search along route scenario
  • Return empty sets of phones and URLs when non are provided in the online response.
  • Rely on the default view of online search instead of explicitly passing unified as geopolitical view.
  • Support deserialization of charging park without any connector detail.
  • When there are multiple search areas, utilize the first search area for offline search.

Routing

Breaking changes:

  • Ignore unsupported computeBestOrder for EV routing request
  • Ignore unsupported vehicleModelId for non-EV routing request
  • Prepare api for other range boundary types
  • Remove ConsumptionModel interface
  • Remove RangeCalculationOptions from RangeCalculationFailure and RangeCalculationResult to align with route planning
  • Remove coordinate precision
  • RouteIncrementResult is removed from public API
  • IncrementRouteResult renamed to advanceGuidanceProgress in RoutePlanner

New features:

  • Low emission zone avoidance option added for the onboard client
  • Low emission zone avoidance option added for the online client
  • Low emission zone section added for the online client
  • OnlineRoutePlanner charging parameters support.

Updates:

  • Extend short lane sections from online routing to display lane guidance sooner.

Fixes:

  • Always use non-scientific notation for floating-point parameters in request url
  • Do not add vehicleModelId-specific parameters to route/range request
  • Ensure that offset of arrival instruction does not exceed route length.
  • Filter out lane sections which have empty lane list.
  • Fixed onboard VehicleRestrictedSections

Breaking changes:

  • Change Horizon Engine API
  • Change update vehicle profile api in binding
  • Modify the restriction API to use types from Vehicle.
  • Move TollgatePaymentType from package com.tomtom.sdk.routing.route.instruction.common to com.tomtom.sdk.routing.route.
  • Refactor
  • Remove message and messagePhonetics parameters from GuidanceAnnouncement.
  • Rename ContinuousReplanningMode to BetterProposalAcceptanceMode
  • Rename GuidanceUpdateListener to GuidanceUpdatedListener.
  • Rename RouteUpdateReason.Unreachable tp RouteUpdateReason.Blockage and RouteReplanningReason.Unreachable to RouteReplanningReason.Blockage.
  • Rename TomTomNavigation.addGuidanceUpdateListener method to TomTomNavigation.addGuidanceUpdatedListener.
  • Rename TomTomNavigation.removeGuidanceUpdateListener method to TomTomNavigation.removeGuidanceUpdatedListener.
  • Restructure the LocationContext class to contain the Address and Road classes.
  • Rework locations in hazard.

New features:

  • Add NdsStoreAccessPermit as a way to specify either the map license or keystore password and add it to NdsStoreConfiguration.
  • Add option to RoutePlanningOptions for controlling instruction computation mode
  • Add support for Finnish and Mexican Spanish in spoken messages.
  • Add support for better route proposals of out-of-range EV routes.
  • Add support for hazard warning in vehicle horizon.
  • Create hazard models in horizon data source module.
  • Enable vehicle profile update
  • Ignore instructions when validating/merging route on route refresh
  • Implement the vehicle and dangerous goods restriction elements.
  • Improve NavigationTileStore configuration API.
  • Introduce data store switch logic.
  • Route replanning during navigation uses the most up-to-date vehicle profile information available.
  • Truck restriction tests
  • When leaving the charging stop with insufficient charge, GoSDK issues a route replan.
  • Vehicle and dangerous goods restriction API

Updates:

  • Add documentation about DangerousGoodsRestriction and VehicleRestriction.
  • Add factory methods for creating a hybrid navigation.
  • Add missing public preview notes in com.tomtom.sdk.navigation.horizon.* packages.
  • Allow only one data source for a given Virtual Horizon’s data type.
  • Configure navigation api path based on Orbis feature toggle state.
  • Fix the default maximum main path searching distance to 2km.
  • Make DetailedHazardInformation subclasses as data classes.
  • Replace TomTom logo in the notification for navigation service.
  • Reset maxAlternative option to zero in case of deviation route re-planing for Primary route.
  • Restore validation of navigation start not being called twice.
  • Retry plan route request for continuous re-planing with maxAlternatives set to 0 in case inner routing computation timeout error.
  • Trigger navigation tile store updates in hybrid mode.

Fixes:

  • Improve lane guidance view scaling.
  • Avoid mixing online and offline projected route segments in hybrid navigation.
  • Back to route accounts for supporting points.
  • Better handling of larger font in ETA panel.
  • Change margins of eta panel
  • Check map access before reverse geocoding
  • Chevron animation is not moving smoothly during map updates.
  • Do not hide street view when a destination is reached.
  • Do not show route updated notification if the route is not changed.
  • Ensure that we have properly initialized engines no matter if map is changed or not.
  • Filter out lane sections which have empty lane list.
  • Fix MissingResourceException when generating verbal message.
  • Fix TestProgressUpdatedListener.
  • Fix crash caused by non-matching RouteLeg’s geometry and Section’s geometry after route refresh.
  • Fix distance units in notifications.
  • Fix division by zero in the route progress engine.
  • Fix fix format of ETA.
  • Fix fonts for navigation elements
  • Fix lowEmissionZoneSections routeOffset calculation
  • Fix predictions initialisation.
  • Fix typo in style name.
  • Fixes documentation for navigationProcessingThrottle parameter.
  • Navigating with a waypoint result in the chevron not moving.
  • Offroad positions for updating horizon
  • Require last instruction for arrival detection
  • The LocationProvider is no longer closed inside the NavigationEngineRegistry.updateEngines method, it has to be handled by the user of the SDK.
  • OnDestinationReached may crash if there are no Instructions.

Location

Updates:

  • Catch IOExceptions inside the DirectoryLoggerStrategy and throw IllegalStateException when the file creation fails.

Fixes:

  • Fix location traces recorder using documents tree directory.
  • Fix recorded TTP logs header.
  • Remove bin file extension from the TTP file if the file is represented as RawDocumentFile.

General

Breaking changes:

  • Rename artifact

New features:

  • Add DefaultVehicleProvider support for vehicle model id.
  • Add full form overloads for quantity functions using abbreviated units in their names
  • NavVis Addon: Implement support for showing pattern textures on traffic lines
  • NavVis Addon: Implement traffic lines transition from solid color to pattern on zoom level changes
  • NavVisAddon: Enable speed cameras and add danger zones
  • VehicleProvider charging parameters support.

Updates:

  • Add use cases for VehicleProvider to documentation.
  • Fix comment block formatting.
  • Highlight that navigation fetches vehicle’s data from VehicleProvider during navigation.
  • Improve logging for Vehicle SDK and UI.
  • Make vehicle-client-api documentation visible to the customers.
  • Remove ExperimentalTrafficApi annotation and move experimental part of the traffic API to public preview.
  • Update offline map documentation.
  • Vehicle SDK docs are visible on developer portal.

Fixes:

  • Improve retrying http mechanism
  • Remove unnecessary public functions from Vehicle SDK.

version 0.3.1617 - 10/02/2023

Map

Breaking changes:

  • Remove ResourceCache configuration from MapOptions.
  • Remove duration filter from OnlineCachePolicy.

New features:

  • Add traffic support for Onboard-style-provider
  • Enable fetching of onboard hill shading tiles.
  • Map region language configuration

Updates:

  • Promote OrbisMapFeature from @InternalTomTomSdkApi to @ExperimentalMapFeature.
  • Promote SmoothStyleReloadFeature from @InternalTomTomSdkApi to @ExperimentalMapFeature.
  • Updated style version to 24.0.x

Search

Breaking changes:

  • Move entryPoints from Poi to Place.
  • Remove FuelName and extend FuelType to replace it.
  • Remove navigablePosition from reversegeocoder’s PlaceMatch and replace it with entryPoints in Place.
  • Implement custom base URL for reverse geocoder.
  • Rename ReverseGeocoder.EntityType to AreaType.

Routing

Updates:

  • Promoting route planners API to general availability.
  • Publish new guide on importing, exporting and modifying routes.

Breaking changes:

  • Change the HybridRouteReplanner.create method to accept only RoutePlanners for online and offline.
  • Remove DefaultRouteReplanner and com.tomtom.sdk.navigation:route-replanner-default dependency.
  • Remove the method from OfflineRouteReplannerFactory that created the RoutePlanner internally.
  • Remove the method from OnlineRouteReplannerFactory that created the RoutePlanner internally.
  • Rename OnVehicleUpdateListener to VehicleUpdatedListener.

New features:

  • Calculate arc’s route offsets and add support for the partial route window.
  • Extend createOfflineNavigation method with RoutePlanner parameter.
  • Extension functions to the TomTomNavigationFactory for simpler initialization of the TomTomNavigation in the offline mode.
  • Extension functions to the TomTomNavigationFactory for simpler initialization of the TomTomNavigation in the online mode.
  • Introduce OfflineRouteReplannerFactory to initialize the RouteReplanner used for offline navigation.
  • Introduce OnlineRouteReplannerFactory to initialize the RouteReplanner used for online navigation.

Updates:

  • Move ArrivalDetectionEngine interface to navigation-engines module.
  • Move GuidanceEngine interface to navigation-engines module.
  • Move HorizonEngine interface to navigation-engines module.
  • Move LocationContextProviderEngine interface to navigation-engines module.
  • Move RouteProgressEngine interface to navigation-engines module.
  • Move RouteProjectionEngine interface to navigation-engines module.
  • Move RouteReplanningEngine interface to navigation-engines module.
  • Move RouteTrackingEngine interface to navigation-engines module.
  • Update navigation initialization documentation to use the new TomTomFactory methods.

Fixes:

  • Fix navigation crash on the location updates start.
  • Instruction offsets are updated after replan.

General

Breaking changes:

  • Remove copy function from Quantities

Updates:

  • Add runtime validation of API parameters value
  • Simplify Quantity library

version 0.3.1547 - 03/02/2023

Map

Updates:

  • Add tpeg traffic case to maps demo app.
  • Promote Rendered Features to general availability including geojson package.
  • Promote com.tomtom.sdk.map.display.location.* to general availability.
  • Promote com.tomtom.sdk.map.display.route.* to general availability.
  • Promote com.tomtom.sdk.map.display.style.* to general availability.

Search

Fixes:

  • Support localization in reverse geocoder based on only language for online search unsupported ietf languages tags.

Routing

Updates:

  • Promote Route API to general availability.
  • Promoting RoutingFailure to general availability.

Breaking changes:

  • Add navigation-engines module and move map-matching-engine there
  • Make quantizedTurnAngle parameter not nullable in RoundaboutInstruction and ExitRoundaboutInstruction.
  • Remove RoundaboutDirection from RoundaboutInstruction and ExitRoundaboutInstruction.

New features:

  • Implement API for manual announcements.

Fixes:

  • Fix offline navigation use case tutorial app crash due to closed LocationProvider.

General

Breaking changes:

  • Convert various structures to use Quantities

version 0.3.1522 - 30/01/2023

Map

Updates:

  • Promote com.tomtom.sdk.map.display.map.* to general availability.
  • Thrown IllegalArgumentException when provided layer mapping isn’t correct.

Fixes:

  • Fix crash when starting map with Satellite style.

Search

Breaking changes:

  • A new class, PoiDetails, is now returned from the requestPoiDetails API instead of SearchResult. The new class only has the data relevant to the POI.
  • Remove offset and add default values for other fields in SearchRequestSummary.

Fixes:

  • Parse the speed limit for reverse geocoder correctly.

Routing

Breaking changes:

  • Removing inheritance of

Fixes:

  • Add a property for requesting path alternatives.
  • Make vehicle load a value class and change it to UN hazmat.
  • Mark path alternative routes as such in Routing SDK.
  • Remove EngineType from public API.

New features:

  • Introduce traces-logger module for recording and parsing location traces (TTP format).

General

Breaking changes:

  • Rename Probability Quantity to Ratio.

Updates:

  • Promote com.tomtom.quantity.* to general availability.

version 0.3.1486 - 24/01/2023

Map

New features:

  • Add an example app to map demo app for hill shading support in onboard mode.
  • Add in memory caching for offline data provider.
  • Add support for hill shade tiles in offline data provider.
  • Extend RouteOptions with fields to customize the departure and destination markers.
  • Traffic data provider implementation.

Updates:

  • Specify OpenGLES3.0 is specified minimum requirement.
  • Improve rotation inertia calculation, in general, rotation inertia should be more substantial.
  • Mark all public API in gesture-detectors module as @InternalTomTomSdkApi.
  • Promote com.tomtom.sdk.map.display.camera.* to general availability.
  • Promote com.tomtom.sdk.map.display.circle.* to general availability.
  • Promote com.tomtom.sdk.map.display.copyright.* to general availability.
  • Promote com.tomtom.sdk.map.display.gesture.* to general availability.
  • Promote com.tomtom.sdk.map.display.image.* to general availability.
  • Promote com.tomtom.sdk.map.display.marker.* to general availability.
  • Promote com.tomtom.sdk.map.display.polyline.* to general availability.
  • Promote com.tomtom.sdk.map.display.traffic.* to general availability.
  • Promote com.tomtom.sdk.map.display.ui.* to general availability apart from MapView.
  • Remove unnecessary PP notices from internal apis.
  • Suppress feature toggle types due to being internal use only.

Fixes:

  • Fix move gesture inertia sensitivity, now it is smaller especially on devices with low dpi.
  • Fix of quick scale gesture, now scaling is linear.

Search

Breaking changes:

  • Use Quantity.Speed to represent speed limit in PlaceMatch in the reverse geocoder instead of a plain string.
  • Remove mapcode from reverse geocoder.
  • Renames, inputQuery to query, category to poiCategory, SortBy to SortOrder, SearchRequestSummary to SearchSummary. Remove numResults from all Summary classes. Remove AddressRanges. Enhance the documentation for countryCode in Address.kt to mention that it is an ISO two-letter code.

Routing

Breaking changes:

  • Add validation for tollgateName and paymentTypes in TollgateInstruction to ensure at least one value is specified.

New features:

  • Expose the online planning reason with the route summary.

Breaking changes:

  • Add validation in BorderCrossing to ensure that from and to countries are not same.
  • Remove travelTime property from Instruction.
  • Remove values keepLeft and keepRight from TurnDirection.
  • Rename ItineraryPointSide to ItineraryPointRelativePosition.
  • Replace RoutePoint with InstructionPoint in Instruction.routePath.
  • TurnDirection backing values has been changed.

New features:

  • Add projected route offsets and refactor and simplify logic in route projection engine.
  • Expose country information element in Horizon Engine.
  • Navigation snapshot contains vehicle data from Vehicle SDK.
  • Speak intersection name for audio instruction.

Updates:

  • Add ItineraryPointRelativePosition.Ahead value.
  • Add validation for tollgateName and paymentTypes in GuidanceTollgateInstruction to ensure at least one value is specified.
  • Introduce LocationReference marker interface for DataObject.

Fixes:

  • Fix navigation use case tutorial app crash due to closed LocationProvider.

General

Breaking changes:

  • Change UnitBase from interface to abstract class and change the visibility to internal for name and factor properties.
  • Rename Distance.Zero to .ZERO, add ZERO members for other Quantities.
  • Remove quantity.Duration, Probability.InWholeUnitRange and Angle.InWholeRadians.

New features:

  • NavVis Addon: Implement stylization API for the departure and destination markers.

Updates:

  • Add documentation for quantity objects.

Removals:

  • Remove toDouble(unit: Unit) and toLong(unit:Unit) from com.tomtom.quantity.Quantity.
  • Remove troy ounces unit and related method from com.tomtom.quantity.Weight.

Fixes:

  • Fix typo in com.tomtom.quantity.Force.Unit from KilowattHoursPerKilometers to KilowattHoursPerKilometer.
  • Fix typo in com.tomtom.quantity.FuelPerTime.Unit from MillimetersPerHour to MillilitersPerHour.
  • Fix typo for milliliters abbreviation in com.tomtom.quantity.FuelConsumption, com.tomtom.quantity.FuelPerTime and com.tomtom.quantity.Volume.

version 0.3.1427 - 16/01/2023

Map

New features:

  • Add field of view to initializer of CameraOptions.

Search

Breaking changes:

  • Change the type of geometry from GeoGemetry to Geometry from the geojson package in PlaceMatch.kt
  • Rename class Summary in reverse geocoder to ReverseGeocoderSummary.
  • Rename parameter reverseGeocoderOptions in the reverseGeocode API to options.
  • Rename parameter reverseGeocoderCallback in the reverseGeocode API to callback.
  • Use GeoPoliticalView for representing geopolitical view in ReverseGeocoderOptions instead of a string.

New features:

  • Use quantity library for representing an angle in reverse geocoding options.

Fixes:

  • Do not request for addresses when a poi-specific.
  • Fix documentation for search to use @property tag for properties.

Routing

Breaking changes:

Rename routing errors to routing failures.

Updates:

  • Promote routing options API to general availability.

Fixes:

  • Fix routing with coordinates close to 0.0

Breaking changes:

  • Rename CountryInfo to Country.
  • Rename RoadInformation to Road.

Fixes:

  • Handle route re-planning in the RouteProjectionEngine.

version 0.3.1389 - 09/01/2023

Map

Breaking changes:

  • Change MapController.visibleRegion property to a method.
  • Remodel InvalidPointException to PointConversionFailure.
  • Remodel InvalidRegionException to RegionCalculationFailure.
  • Сonvert CompassButton.VisibilityPolicy to the "value class".
  • Сonvert CurrentLocationButton.VisibilityPolicy to the "value class".
  • Сonvert LaneBoundary.Type to the "value class".
  • Сonvert LogoView.VisibilityPolicy to the "value class".
  • Сonvert RadiusUnit to the "value class".
  • Сonvert TextAnchoring to the "value class".
  • Сonvert WidthUnit to the "value class".
  • Rename com.tomtom.sdk.map.gesture.OnScaleGestureListener → com.tomtom.sdk.map.gesture.ScaleGestureListener
  • Rename com.tomtom.sdk.map.gesture.OnDoubleTapListener → com.tomtom.sdk.map.gesture.DoubleTapListener
  • Rename com.tomtom.sdk.map.display.ui.currentlocation.CurrentLocationButton.removeOnCurrentLocationButtonClickListener() → com.tomtom.sdk.map.display.ui.currentlocation.CurrentLocationButton.removeCurrentLocationButtonClickListener()
  • Rename com.tomtom.sdk.map.display.ui.currentlocation.CurrentLocationButton.addOnCurrentLocationButtonClickListener() → com.tomtom.sdk.map.display.ui.currentlocation.CurrentLocationButton.addCurrentLocationButtonClickListener()
  • Rename com.tomtom.sdk.map.display.ui.compass.CompassButton.removeOnCompassButtonClickListener() → com.tomtom.sdk.map.display.ui.compass.CompassButton.removeCompassButtonClickListener()
  • Rename com.tomtom.sdk.map.display.ui.compass.CompassButton.addOnCompassButtonClickListener() → com.tomtom.sdk.map.display.ui.compass.CompassButton.addCompassButtonClickListener()
  • Rename com.tomtom.sdk.map.display.ui.OnUiComponentClickListener → com.tomtom.sdk.map.display.ui.UiComponentClickListener
  • Rename com.tomtom.sdk.map.display.ui.OnMapReadyCallback → com.tomtom.sdk.map.display.ui.MapReadyCallback
  • Rename com.tomtom.sdk.map.display.traffic.TrafficController.removeOnTrafficIncidentClickListener() → com.tomtom.sdk.map.display.traffic.TrafficController.removeTrafficIncidentClickListener()
  • Rename com.tomtom.sdk.map.display.traffic.TrafficController.addOnTrafficIncidentClickListener() → com.tomtom.sdk.map.display.traffic.TrafficController.addTrafficIncidentClickListener()
  • Rename com.tomtom.sdk.map.display.traffic.OnTrafficIncidentClickListener → com.tomtom.sdk.map.display.traffic.TrafficIncidentClickListener
  • Rename com.tomtom.sdk.map.display.route.RouteController.removeOnRouteClickListener() → com.tomtom.sdk.map.display.route.RouteController.removeRouteClickListener()
  • Rename com.tomtom.sdk.map.display.route.RouteController.addOnRouteClickListener() → com.tomtom.sdk.map.display.route.RouteController.addRouteClickListener()
  • Rename com.tomtom.sdk.map.display.route.OnRouteClickListener → com.tomtom.sdk.map.display.route.RouteClickListener
  • Rename com.tomtom.sdk.map.display.polyline.PolylineController.removeOnPolylineClickListener → com.tomtom.sdk.map.display.polyline.PolylineController.removePolylineClickListener
  • Rename com.tomtom.sdk.map.display.polyline.PolylineController.addOnPolylineClickListener → com.tomtom.sdk.map.display.polyline.PolylineController.addPolylineClickListener
  • Rename com.tomtom.sdk.map.display.polyline.OnPolylineClickListener → com.tomtom.sdk.map.display.polyline.PolylineClickListener
  • Rename com.tomtom.sdk.map.display.polygon.PolygonController.removeOnPolygonClickListener → com.tomtom.sdk.map.display.polygon.PolygonController.removePolygonClickListener
  • Rename com.tomtom.sdk.map.display.polygon.PolygonController.addOnPolygonClickListener → com.tomtom.sdk.map.display.polygon.PolygonController.addPolygonClickListener
  • Rename com.tomtom.sdk.map.display.polygon.OnPolygonClickListener → com.tomtom.sdk.map.display.polygon.PolygonClickListener
  • Rename com.tomtom.sdk.map.display.location.LocationController.removeOnLocationMarkerClickListener → com.tomtom.sdk.map.display.location.LocationController.removeLocationMarkerClickListener
  • Rename com.tomtom.sdk.map.display.location.LocationController.addOnLocationMarkerClickListener → com.tomtom.sdk.map.display.location.LocationController.addLocationMarkerClickListener
  • Rename com.tomtom.sdk.map.display.gesture.GesturesController.removeOnMapPanningListener() → com.tomtom.sdk.map.display.gesture.GesturesController.removeMapPanningListener()
  • Rename com.tomtom.sdk.map.display.gesture.GesturesController.addOnMapPanningListener() → com.tomtom.sdk.map.display.gesture.GesturesController.addMapPanningListener()
  • Rename com.tomtom.sdk.map.display.gesture.GesturesController.removeOnMapLongClickListener() → com.tomtom.sdk.map.display.gesture.GesturesController.removeMapLongClickListener()
  • Rename com.tomtom.sdk.map.display.gesture.GesturesController.addOnMapLongClickListener() → com.tomtom.sdk.map.display.gesture.GesturesController.addMapLongClickListener()
  • Rename com.tomtom.sdk.map.display.gesture.GesturesController.removeOnMapDoubleClickListener() → com.tomtom.sdk.map.display.gesture.GesturesController.removeMapDoubleClickListener()
  • Rename com.tomtom.sdk.map.display.gesture.GesturesController.addOnMapDoubleClickListener() → com.tomtom.sdk.map.display.gesture.GesturesController.addMapDoubleClickListener()
  • Rename com.tomtom.sdk.map.display.gesture.GesturesController.removeOnMapClickListener() → com.tomtom.sdk.map.display.gesture.GesturesController.removeMapClickListener()
  • Rename com.tomtom.sdk.map.display.gesture.GesturesController.addOnMapClickListener() → com.tomtom.sdk.map.display.gesture.GesturesController.addMapClickListener()
  • Rename com.tomtom.sdk.map.display.camera.CameraController.removeOnCameraSteadyListener() → com.tomtom.sdk.map.display.camera.CameraController.removeCameraSteadyListener()
  • Rename com.tomtom.sdk.map.display.camera.CameraController.addOnCameraSteadyListener() → com.tomtom.sdk.map.display.camera.CameraController.addCameraSteadyListener()
  • Rename com.tomtom.sdk.map.display.camera.CameraController.removeOnCameraChangeListener() → com.tomtom.sdk.map.display.camera.CameraController.removeCameraChangeListener()
  • Rename com.tomtom.sdk.map.display.camera.CameraController.addOnCameraChangeListener() → com.tomtom.sdk.map.display.camera.CameraController.addCameraChangeListener()
  • Rename com.tomtom.sdk.map.display.circle.removeOnCircleClickListener() → com.tomtom.sdk.map.display.circle.removeCircleClickListener()
  • Rename com.tomtom.sdk.map.display.circle.addOnCircleClickListener() → com.tomtom.sdk.map.display.circle.addCircleClickListener()
  • Rename com.tomtom.sdk.map.display.marker.MarkerController.removeOnMarkerSelectedListener() → com.tomtom.sdk.map.display.marker.MarkerController.removeMarkerSelectionListener()
  • Rename com.tomtom.sdk.map.display.marker.MarkerController.addOnMarkerSelectedListener() → com.tomtom.sdk.map.display.marker.MarkerController.addMarkerSelectionListener()
  • Rename com.tomtom.sdk.map.display.marker.MarkerController.removeOnMarkerLongClickListener() → com.tomtom.sdk.map.display.marker.MarkerController.removeMarkerLongClickListener()
  • Rename com.tomtom.sdk.map.display.marker.MarkerController.addOnMarkerLongClickListener() → com.tomtom.sdk.map.display.marker.MarkerController.addMarkerLongClickListener()
  • Rename com.tomtom.sdk.map.display.marker.MarkerController.removeOnMarkerClickListener() → com.tomtom.sdk.map.display.marker.MarkerController.removeMarkerClickListener()
  • Rename com.tomtom.sdk.map.display.marker.MarkerController.addOnMarkerClickListener() → com.tomtom.sdk.map.display.marker.MarkerController.addMarkerClickListener()
  • Rename com.tomtom.sdk.map.display.marker.OnMarkerSelectedListener → com.tomtom.sdk.map.display.marker.MarkerSelectionListener
  • Rename com.tomtom.sdk.map.display.marker.OnMarkerLongClickListener → com.tomtom.sdk.map.display.marker.MarkerLongClickListener
  • Rename com.tomtom.sdk.map.display.marker.OnMarkerClickListener → com.tomtom.sdk.map.display.marker.MarkerClickListener
  • Rename com.tomtom.sdk.map.display.location.OnLocationMarkerClickListener → com.tomtom.sdk.map.display.location.LocationMarkerClickListener
  • Rename com.tomtom.sdk.map.display.gesture.OnMapPanningListener → com.tomtom.sdk.map.display.gesture.MapPanningListener
  • Rename com.tomtom.sdk.map.display.gesture.OnMapLongClickListener → com.tomtom.sdk.map.display.gesture.MapLongClickListener
  • Rename com.tomtom.sdk.map.display.gesture.OnMapDoubleClickListener → com.tomtom.sdk.map.display.gesture.MapDoubleClickListener
  • Rename com.tomtom.sdk.map.display.gesture.OnMapClickListener → com.tomtom.sdk.map.display.gesture.MapClickListener
  • Rename com.tomtom.sdk.map.display.copyright.OnCopyrightsFetchedCallback → com.tomtom.sdk.map.display.copyright.CopyrightsFetchingCallback
  • Rename com.tomtom.sdk.map.display.common.OnCancellableActionCallback → com.tomtom.sdk.map.display.camera.AnimateCameraCallback
  • Rename com.tomtom.sdk.map.display.circle.OnCircleClickListener → com.tomtom.sdk.map.display.circle.CircleClickListener
  • Rename com.tomtom.sdk.map.display.camera.OnCameraChangeListener → com.tomtom.sdk.map.display.camera.CameraChangeListener
  • Rename com.tomtom.sdk.map.display.camera.OnCameraSteadyListener → com.tomtom.sdk.map.display.camera.CameraSteadyListener
  • Rename com.tomtom.sdk.map.display.style.OnStyleLoadedCallback → com.tomtom.sdk.map.display.style.StyleLoadingCallback

New features:

  • Enable map display componentization by default and remove the map display componentization toggle and deprecated interfaces.
  • Add API to provide route sections using RouteOptions.

Search

Breaking changes:

  • Make reverse geocoder use locale instead of IETF language code.
  • Removed unneeded runtime features from search.
  • Use default locale in search APIs.

Updates:

  • Make DEFAULT_RADIUS public in ReverseGeocoderOptions.

Routing

Breaking changes:

  • Remove unused languageCode from RoadShield.
  • Rename RoutePlanningResult to RoutePlanningResponse.
  • Replace java.net.URL with android.net.Uri.
  • Use Locale for language in PhoneticString and TextWithPhonetic.
  • Use Locale for language in Phonetics.

Updates:

  • Promote sections API to general availability.

Breaking changes:

  • Remove GuidanceInstruction.travelTime.
  • Rename NavigationError to NavigationFailure and convert to an abstract class.
  • Rename NavigationStartError to NavigationFailure.NavigationStartFailure.
  • Rename OnDestinationReachedListener to DestinationReachedListener.
  • Rename OnGuidanceUpdateListener to GuidanceUpdateListener.
  • Rename OnGuidanceViewBoundariesChangeListener to GuidanceViewBoundariesChangeListener.
  • Rename OnHorizonUpdatedListener to HorizonUpdatedListener.
  • Rename OnLaneGuidanceUpdateListener to LaneGuidanceUpdatedListener.
  • Rename OnLanguageChangedListener to LanguageChangedListener.
  • Rename OnLocationContextUpdateListener to LocationContextUpdatedListener.
  • Rename OnLocationMapMatchedListener to LocationMapMatchedListener.
  • Rename OnNavigationErrorListener to NavigationFailureListener.
  • Rename OnNavigationStartedListener to NavigationStartedListener.
  • Rename OnProgressUpdateListener to ProgressUpdatedListener.
  • Rename OnReplannedRouteProposedListener to ReplannedRouteProposedListener.
  • Rename OnRouteDeviationListener to RouteDeviationListener.
  • Rename OnRouteUpdatedListener to RouteUpdatedListener.
  • Rename OnRoutesChangedListener to RoutesChangedListener.
  • Rename OnWaypointVisitedListener to WaypointVisitedListener.
  • Rename RouteDeviationListener.onRouteDeviated to RouteDeviationListener.onRouteDeviation.
  • Rename RouteUpdateError to NavigationFailure.RouteUpdateError.
  • Rename TomTomNavigation.addOnDestinationReachedListener to TomTomNavigation.addDestinationReachedListener and TomTomNavigation.removeOnDestinationReachedListener to TomTomNavigation.removeDestinationReachedListener.
  • Rename TomTomNavigation.addOnGuidanceUpdateListener to TomTomNavigation.addGuidanceUpdateListener and TomTomNavigation.removeOnGuidanceUpdateListener to TomTomNavigation.removeGuidanceUpdateListener.
  • Rename TomTomNavigation.addOnHorizonUpdateListener to TomTomNavigation.addHorizonUpdatedListener and TomTomNavigation.removeOnHorizonUpdateListener to TomTomNavigation.removeHorizonUpdatedListener.
  • Rename TomTomNavigation.addOnLaneGuidanceUpdatedListener to TomTomNavigation.addLaneGuidanceUpdatedListener and TomTomNavigation.removeOnLaneGuidanceUpdatedListener to TomTomNavigation.removeLaneGuidanceUpdatedListener.
  • Rename TomTomNavigation.addOnLanguageChangedListener to TomTomNavigation.addLanguageChangedListener and TomTomNavigation.removeOnLanguageChangedListener to TomTomNavigation.removeLanguageChangedListener.
  • Rename TomTomNavigation.addOnLocationContextUpdateListener to TomTomNavigation.addLocationContextUpdatedListener and TomTomNavigation.removeOnLocationContextUpdateListener to TomTomNavigation.removeLocationContextUpdatedListener.
  • Rename TomTomNavigation.addOnLocationMapMatchedListener to TomTomNavigation.addLocationMapMatchedListener and TomTomNavigation.removeOnLocationMapMatchedListener to TomTomNavigation.removeLocationMapMatchedListener.
  • Rename TomTomNavigation.addOnNavigationErrorListener to TomTomNavigation.addNavigationFailureListener and TomTomNavigation.removeOnNavigationErrorListener to TomTomNavigation.removeNavigationFailureListener.
  • Rename TomTomNavigation.addOnNavigationStartedListener to TomTomNavigation.addNavigationStartedListener and TomTomNavigation.removeOnNavigationStartedListener to TomTomNavigation.removeNavigationStartedListener.
  • Rename TomTomNavigation.addOnProgressUpdateListener to TomTomNavigation.addProgressUpdatedListener and TomTomNavigation.removeOnProgressUpdateListener to TomTomNavigation.removeProgressUpdatedListener.
  • Rename TomTomNavigation.addOnReplannedRouteProposedListener to TomTomNavigation.addReplannedRouteProposedListener and TomTomNavigation.removeOnReplannedRouteProposedListener to TomTomNavigation.removeReplannedRouteProposedListener.
  • Rename TomTomNavigation.addOnRouteDeviationListener to TomTomNavigation.addRouteDeviationListener and TomTomNavigation.removeOnRouteDeviationListener to TomTomNavigation.removeRouteDeviationListener.
  • Rename TomTomNavigation.addOnRouteUpdatedListener to TomTomNavigation.addRouteUpdatedListener and TomTomNavigation.removeOnRouteUpdatedListener to TomTomNavigation.removeRouteUpdatedListener.
  • Rename TomTomNavigation.addOnRoutesChangedListener to TomTomNavigation.addRoutesChangedListener and TomTomNavigation.removeOnRoutesChangedListener to TomTomNavigation.removeRoutesChangedListener.
  • Rename TomTomNavigation.addOnWaypointVisitedListener to TomTomNavigation.addWaypointVisitedListener and TomTomNavigation.removeOnWaypointVisitedListener to TomTomNavigation.removeWaypointVisitedListener.
  • Replace java.net.URL with android.net.Uri.

New features:

  • Provide a mechanism for a client to fetch TPEG traffic events and subscribe to the traffic updates.

Updates:

  • Update GuidanceEngineFactory docs.
  • Update navigation language API documentation.

Fixes:

  • Increase overlap length if route projection sections do not overlap.
  • Provide message with applied distance
  • Switch TPEG Traffic’s initSessionUri type from String to android.net.Uri.
  • Throw an exception after timeout in TestOnLocationContextUpdateListener.

General

Breaking changes:

  • Mark Either monad as internal api.
  • Rename com.tomtom.sdk.routing.common.options to com.tomtom.sdk.routing.options.
  • Rename com.tomtom.sdk.routing.common.range to com.tomtom.sdk.routing.range.
  • Move com.tomtom.sdk.routing.common.*Error to com.tomtom.sdk.routing.error.

Updates:

  • Promote class Either and all of its extension methods to General Availability.
  • Promote class NavigationHttpInterceptor to General Availability.
  • Promote class ResponseData to General Availability.
  • Promote class ViewBoundaries to General Availability.
  • Promote extension method View.viewBoundaries() to General Availability.
  • Promote interface RequestObserver to General Availability.

Fixes:

  • Fix default colors in Navigation visualization addon.

version 0.3.1307 - 23/12/2022

Map

Breaking changes:

  • Merge radius and radiusUnit into Radius object in CircleOptions and Circle.
  • Remodel style loading failure to a more robust type.
  • Rename RadiusUnit.PIXEL_DENSITY to RadiusUnit.DENSITY_PIXEL.
  • Rename diagnostic events from Errors to Failures.
  • Switch between Full Onboard or Full Online.

New features:

  • Implement Marker.setPinIconAnchor() and Marker.setShieldImage() methods.

Fixes:

  • Remove NotoSans fonts to reduce SDK size.
  • Remove the marker even when it is not selected.

Search

Breaking changes:

  • Remodel StructuredSearchError into a proper restricted class hierarchy.
  • Renaming SearchError and its subclasses to Failures.
  • Renaming StructuredSearchError and its subclasses to Failures.
  • Remove ReverseGeocoderError. Replace it with SearchError.
  • Remove classes related poi (RelatedPoi, RequestedPoiRelationType and PoiRelationType).
  • Replace enum with value class for EntityType and SpreadingMode.

Fixes:

  • Remove CustomPoiDataProviderFactory and ExperimentalFeedbackApi from documentation.

Routing

Breaking changes:

  • Convert CarpoolLaneDirection enum to value class.
  • Convert ForkDirection enum to value class.
  • Convert ItineraryPointSide enum to value class.

Updates:

  • Mark Itinerary as data class.

Breaking changes:

  • Introduce EngineRegistry for engines access and bulk update.
  • Introduce OnLocationMapMatchedListener and the following methods NavigationController.addOnLocationMapMatchedListener and NavigationController.removeOnLocationMapMatchedListener.
  • Remove OnLocationMatchedListener and following methods NavigationController.addOnLocationMatchedListener and NavigationController.removeOnLocationMatchedListener.
  • Remove OnLocationPredictionsGeneratedListener and following methods NavigationController.addOnLocationPredictionsGeneratedListener and NavigationController.removeOnLocationPredictionsGeneratedListener.
  • Rename TileCacheRouteProjectionOptions and OfflineRouteProjectionOptions to RouteProjectionOptions. Move RouteProjectionOptions to the navigation:navigation module.
  • Replaced NavigationController interface with TomTomNavigation and exposed it through TomTomNavigationFactory.
  • Restructure NavigationSnapshot class parameters.

Updates:

  • Handle obsolete map references in route.
  • Mark TomTomNavigationService public methods with Public Preview.

Fixes:

  • Fix progress calculation to not skip waypoints.
  • Update kdoc in GuidanceEngineOptions.
  • Use projected routes in offline mapmatching engine.

General

Breaking changes:

  • Rename com.tomtom.sdk.common.Callback::onError → com.tomtom.sdk.common.Callback::onFailure

New features:

  • Add Field of View to camera options.
  • Add missing from user flag check when progress of fov scrollbar is updated.

version 0.3.1250 - 16/12/2022

Map

Breaking changes:

  • Convert cameraTrackingMode and cameraPosition in from methods to properties.
  • Migrate from custom Color class to platform ColorInt.
  • Replace AnimationDuration with kotlin.time.Duration.
  • Change Marker.tag type from Any? to String?
  • Change TomTomMapFactory visibility to internal.

Updates:

  • Сonvert GestureType to the "value class", imports should be updated.
  • Сonvert CameraTrackingMode to the "value class", imports should be updated.
  • Add method to remove elements by tag to CircleController, MarkerController, PolygonController and PolylineController.

Search

Breaking changes:

  • OfflineUnsupportedError is removed.
  • Remove evChargingStationSearch from Search.kt and leave it in EvChargingAvailabilityProvider.kt
  • Replace AutocompleteSearchOption with AutocompleteOption, AutocompleteSearchResponse with AutocompleteResponse and AutocompleteSearchResponse with AutocompleteResponse.
  • Use com.tomtom.quantity.Distance for CircleGeometry and ReverseGeocoderOptions.

Updates:

  • Move EvChargingAvailabilityProvider from Experimental API to Public Preview.

Routing

Breaking changes:

  • Rename Route.routeCoordinates property to Route.routePoints.
  • Rename RouteCoordinate to RoutePoint.

Updates:

  • Mark ForkPoint as data class
  • Mark RouteIncrementResult as data class

Breaking changes:

  • Add language parameter to TaggedMessage.
  • Align RoadInformation with the iOS code
  • Change GuidanceEngine.availableLanguages type to List of Locales.
  • Make point property in Announcement required
  • Rename NavigationHistorySnapshot.visitedRouteCoordinates property to NavigationHistorySnapshot.visitedRoutePoints.
  • Rename TileCacheMapMatchingEngineFactory to TileStoreMapMatchingEngineFactory.
  • Rename TileCacheRouteProjectionEngineFactory to TileStoreRouteProjectionEngineFactory.
  • Rename TileCacheRouteProjectionEngineOptions to TileStoreRouteProjectionEngineOptions.
  • Add prefix to resources in navigation ui

New features:

  • Change TTS language in navigation UI when navigation language is changed.
  • Change of navigation language is reflected in guidance announcements.
  • Introduce OnLanguageChangedListener to signal change of navigation language.
  • Route replanning after language change

Updates:

  • Add phoneticAlphabet parameter to Phonetics.
  • Hide GeneralRoadElements.AdminRoadClassType internal value property.
  • Hide GeneralRoadElements.FormOfWayType internal value property.
  • Hide GeneralRoadElements.RoadConditionType internal value property.
  • Hide Poi.Type internal value property.
  • Hide SafetyLocation.Type internal value property.
  • Hide SpeedLimits.Type internal value property.

Fixes:

  • Add proper filtering of arc keys in the route window.
  • If the first locations are not on the navigated route the progress is calculated for the beginning of the route.
  • SpeedView visibility change does not cause flickering.

General

Breaking changes:

  • Convert enums to value classes or abstract classes in the Quantity package.
  • Move route to routing:model and Rename com/tomtom/sdk/route/ to com/tomtom/sdk/routing/route/
  • Pluralise the units in the Quantity package (e.g. METER → Meters).
  • Remove toString from the Quantity class and replace it with format in the Quantity package.

New features:

  • Add Probability unit to the Quantity package
  • NavVis Addon: implement a stylization API for icons and pins of traffic markers.
  • NavVis Addon: implement a stylization API for waypoint markers.

Updates:

  • Hide UpdateErrorCode internal value property.
  • Hide InstallState internal value property.
  • Hide MapOperationType internal value property.
  • Hide RegionGraphNodeId internal value property.
  • Hide UpdateState internal value property.

version 0.3.1181 - 12/12/2022

Search

Breaking changes:

  • SearchResult has been refactored so position and address are now encapsulated under Place member.

New features:

  • Introduce NavigationController language change API

Updates:

  • Add availableLanguages property to GuidanceEngine API
  • Extend TrafficError with specific errors.

General

Breaking changes:

  • Changed package name from com.tomtom.sdk.common.location to com.tomtom.sdk.location
  • Change package name from com.tomtom.sdk.common.annotations.* to com.tomtom.sdk.annotations.annotations.*

Removals:

  • Remove Disposable

version 0.3.1156 - 05/12/2022

Map

New features:

  • Add VehicleController API that allows setting vehicle and show/hide restrictions on the map for the given vehicle. Add StandardStyles.VEHICLE_RESTRICTIONS style that can display aforementioned vehicle restrictions.

Fixes:

  • Update missing NotoSans fonts.

Search

Breaking changes:

  • Remove fuzzyLevel parameter from SearchOptions.
  • Remove offset parameter from SearchOptions.
  • Unify search and search along the route.

New features:

  • Add custom POI search support in hybrid mode. Custom search results are added to the beginning of the search result list.

Routing

Breaking changes:

  • Move guidance related common.route APIs under instruction

Breaking changes:

  • Reorder Instruction params to group defaulted params at the end of the constructor

Updates:

  • Update Guidance API docs
  • Expose TrafficEvent’s length

Fixes:

  • Fixed issue where distance was missing from guidance announcements when using UK units.

General

Breaking changes:

  • Change package from com.tomtom.kotlin.quantity.* to com.tomtom.quantity.*.
  • Change package from com.tomtom.sdk.common.featuretoggle.* to com.tomtom.sdk.featuretoggle.*
  • Rename com/tomtom/sdk/common/vehicle/ to com/tomtom/sdk/vehicle/

New features:

  • EvRange Addon: Support zoom level dependent style

version 0.3.1106 - 28/11/2022

Map

New features:

  • Added support for vector drawable resources.

Fixes:

  • Fix displaying code snippets in Map Display guides on Developer Portal.

Search

Breaking changes:

  • *ParkingDetailsApi renamed to *ParkingDetailProvider, ParkingInformationId to ParkingDetailId.
  • Rename acronyms in StandardCategoryId to camel case

Updates:

  • Display the distance in Search UI in a better format

Fixes:

  • Implement charging park connector details for onboard points of interest.

Routing

Breaking changes:

  • Rename InstructionPhoneticsType.IPA to InstructionPhoneticsType.Ipa and InstructionPhoneticsType.LHP to InstructionPhoneticsType.Lhp
  • Route stop source type converted to enum class.

Updates:

  • Allow all budget types for onboard range

Breaking changes:

  • Remove NavigationUiOptions.getPreferredUnits(), instead just use NavigationUiOptions.getUnits().

Updates:

  • Update NavigationConfiguration docs

Fixes:

  • Remove deprecation of properties in GuidanceAnnouncement

General

Breaking changes:

  • Change package for ViewBoundaries from com.tomtom.sdk.common.ui to com.tomtom.sdk.common.android.ui
  • Move Range and Budget to routing/common/range
  • Remove UnitSystem.AUTO, now preferred units must be implicitly used.
  • Rename NDSStoreAccessor to NdsStoreAccessor
  • Replace Disposable with AutoCloseable in data-management modules.

Updates:

  • Adding the note about missing consumption details in leg summary.
  • Mark common collections extension functions as internal

version 0.3.1056 - 18/11/2022

Map

New features:

  • Map Display Componentization feature toggle is now available in onboard mode

Search

Breaking changes:

  • Rename *ReverseGeocoderApi to *ReverseGeocoder and OnboardReverseGeocoderApi to OfflineReverseGeocoder.
  • Rename FuelPriceApi to FuelPriceProvider and OnlineFuelPriceApi to OnlineFuelPriceProvider.
  • Rename all SearchApi to *Search, Onboard to Offline*.
  • Renames ChargingStationAvailability to EvChargingAvailabilityProvider OnlineChargingStationAvailability to OnlineEvChargingAvailabilityProvider.

Updates:

  • Add parking prices displaying.

Routing

Fixes:

  • Fix waypoint optimization with route updates

Breaking changes:

  • Change TollgateInstruction.tollgateName type to TextWithPhonetics
  • Rename turnAngleInDegrees to turnAngle and change type to Angle

New features:

  • Add public interface for requesting traffic in an area

Updates:

  • Handle network locations in the map matcher and navigation process trigger.

Fixes:

  • Fix default guidance engine mode when online guidance v2 is selected.

General

New features:

  • NavVis Addon: implement on/off switch for traffic incidents visualization.

Updates:

  • In common modules and maps, mark public API that is intended to be used internally by SDK developers with @InternalTomTomSdkApi annotation.
  • Rename artifact com.tomtom.sdk:addon-evrange-visualization to com.tomtom.sdk.addons:visualization-ev-range
  • Rename artifact com.tomtom.sdk:addon-navigation-visualization to com.tomtom.sdk.addons:visualization-navigation
  • Rename artifact com.tomtom.sdk:common-android to com.tomtom.sdk.common:android
  • Rename artifact com.tomtom.sdk:common-annotations to com.tomtom.sdk.common:annotations
  • Rename artifact com.tomtom.sdk:common-collections to com.tomtom.sdk.common:collections
  • Rename artifact com.tomtom.sdk:common-core to com.tomtom.sdk.common:core
  • Rename artifact com.tomtom.sdk:common-coroutines to com.tomtom.sdk.common:coroutines-internal
  • Rename artifact com.tomtom.sdk:common-feature-toggle to com.tomtom.sdk.common:feature-toggle
  • Rename artifact com.tomtom.sdk:common-file-loader to com.tomtom.sdk.common:file-loader-internal
  • Rename artifact com.tomtom.sdk:common-functional to com.tomtom.sdk.common:functional
  • Rename artifact com.tomtom.sdk:common-geojson to com.tomtom.sdk.common:geojson
  • Rename artifact com.tomtom.sdk:common-http-framework to com.tomtom.sdk.common:http-framework
  • Rename artifact com.tomtom.sdk:common-http-handler to com.tomtom.sdk.common:http-handler-internal
  • Rename artifact com.tomtom.sdk:common-mapreferencesnds to com.tomtom.sdk.common:map-references-nds-internal
  • Rename artifact com.tomtom.sdk:common-mapreferences to com.tomtom.sdk.common:map-references
  • Rename artifact com.tomtom.sdk:common-net to com.tomtom.sdk.common:net-internal
  • Rename artifact com.tomtom.sdk:common-route to com.tomtom.sdk.common:route
  • Rename artifact com.tomtom.sdk:common-tile-data-provider to com.tomtom.sdk.common:tile-data-provider
  • Rename artifact com.tomtom.sdk:common-vehicle to com.tomtom.sdk.common:vehicle
  • Rename artifact com.tomtom.sdk:location-android to com.tomtom.sdk.location:provider-android
  • Rename artifact com.tomtom.sdk:location-api to com.tomtom.sdk.location:provider
  • Rename artifact com.tomtom.sdk:location-gms to com.tomtom.sdk.location:provider-gms
  • Rename artifact com.tomtom.sdk:location-mapmatched to com.tomtom.sdk.location:provider-map-matched
  • Rename artifact com.tomtom.sdk:location-proxy to com.tomtom.sdk.location:provider-proxy
  • Rename artifact com.tomtom.sdk:location-simulation to com.tomtom.sdk.location:provider-simulation
  • Rename artifact com.tomtom.sdk:maps-data-provider to com.tomtom.sdk.maps:data-provider
  • Rename artifact com.tomtom.sdk:maps-display-compose to com.tomtom.sdk.maps:map-display-compose
  • Rename artifact com.tomtom.sdk:maps-display to com.tomtom.sdk.maps:map-display
  • Rename artifact com.tomtom.sdk:gesture-detectors to com.tomtom.sdk.maps:gesture-detector
  • Rename artifact com.tomtom.sdk:maps-onboard-data-provider to com.tomtom.sdk.maps:data-provider-offline
  • Rename artifact com.tomtom.sdk:maps-display-onboard-style to com.tomtom.sdk.maps:style-provider-offline
  • Rename artifact com.tomtom.sdk:maps-onboard-tile-data-provider to com.tomtom.sdk.maps:tile-data-provider-offline
  • Rename artifact com.tomtom.sdk:navigation to com.tomtom.sdk.navigation:navigation
  • Rename artifact com.tomtom.sdk:navigation-horizon-engine-onboard to com.tomtom.sdk.navigation:horizon-engine-offline
  • Rename artifact com.tomtom.sdk:navigation-location-context-engine-common to com.tomtom.sdk.navigation:location-context-provider-engine-common-internal
  • Rename artifact com.tomtom.sdk:navigation-location-context-engine-hybrid to com.tomtom.sdk.navigation:location-context-provider-engine-hybrid
  • Rename artifact com.tomtom.sdk:navigation-location-context-engine-onboard to com.tomtom.sdk.navigation:location-context-provider-engine-offline
  • Rename artifact com.tomtom.sdk:navigation-location-context-engine-online to com.tomtom.sdk.navigation:location-context-provider-engine-tilestore
  • Rename artifact com.tomtom.sdk:navigation-map-matching-engine-common to com.tomtom.sdk.navigation:map-matching-engine-common-internal
  • Rename artifact com.tomtom.sdk:navigation-map-matching-engine-hybrid to com.tomtom.sdk.navigation:map-matching-engine-hybrid
  • Rename artifact com.tomtom.sdk:navigation-map-matching-engine-onboard to com.tomtom.sdk.navigation:map-matching-engine-offline
  • Rename artifact com.tomtom.sdk:navigation-map-matching-engine-online to com.tomtom.sdk.navigation:map-matching-engine-tilestore
  • Rename artifact com.tomtom.sdk:navigation-route-projection-engine-common to com.tomtom.sdk.navigation:route-projection-engine-common-internal
  • Rename artifact com.tomtom.sdk:navigation-route-projection-engine-online to com.tomtom.sdk.navigation:route-projection-engine-tilestore
  • Rename artifact com.tomtom.sdk:navigation-verbal-message-generation to com.tomtom.sdk.navigation:verbal-message-generation
  • Rename artifact com.tomtom.sdk:navigation-dynamic-routing-common to com.tomtom.sdk.navigation:route-replanner-common-internal
  • Rename artifact com.tomtom.sdk:navigation-dynamic-routing-online to com.tomtom.sdk.navigation:route-replanner-default
  • Rename artifact com.tomtom.sdk:navigation-dynamic-routing-hybrid to com.tomtom.sdk.navigation:route-replanner-hybrid
  • Rename artifact com.tomtom.sdk:navigation-dynamic-routing-api to com.tomtom.sdk.navigation:route-replanner
  • Rename artifact com.tomtom.sdk:navigation-service to com.tomtom.sdk.navigation:service
  • Rename artifact com.tomtom.sdk:navigation-ui to com.tomtom.sdk.navigation:ui
  • Rename artifact com.tomtom.sdk:routing-common to com.tomtom.sdk.routing:common
  • Rename artifact com.tomtom.sdk:range-client-api to com.tomtom.sdk.routing:range-calculator
  • Rename artifact com.tomtom.sdk:range-client-onboard to com.tomtom.sdk.routing:range-calculator-offline
  • Rename artifact com.tomtom.sdk:range-client-online to com.tomtom.sdk.routing:range-calculator-online
  • Rename artifact com.tomtom.sdk:routing-client-api-coroutines to com.tomtom.sdk.routing:route-planner-coroutines
  • Rename artifact com.tomtom.sdk:routing-client-api to com.tomtom.sdk.routing:route-planner
  • Rename artifact com.tomtom.sdk:routing-client-hybrid to com.tomtom.sdk.routing:route-planner-hybrid
  • Rename artifact com.tomtom.sdk:routing-client-onboard to com.tomtom.sdk.routing:route-planner-offline
  • Rename artifact com.tomtom.sdk:routing-client-online to com.tomtom.sdk.routing:route-planner-online
  • Rename artifact com.tomtom.sdk:routing-common-client-online to com.tomtom.sdk.routing:routing-common-client-online
  • Rename artifact com.tomtom.sdk:routing-verbal-messages to com.tomtom.sdk.routing:verbal-messages
  • Rename artifact com.tomtom.sdk:search-additional-data-client-online to com.tomtom.sdk.search:additional-data-online
  • Rename artifact com.tomtom.sdk:search-common to com.tomtom.sdk.search:common
  • Rename artifact com.tomtom.sdk:dynamic-data-client-api to com.tomtom.sdk.search:dynamic-data
  • Rename artifact com.tomtom.sdk:dynamic-data-client to com.tomtom.sdk.search:dynamic-data-online
  • Rename artifact com.tomtom.sdk:reverse-geocoding-client-api to com.tomtom.sdk.search:reverse-geocoder
  • Rename artifact com.tomtom.sdk:reverse-geocoding-client-hybrid to com.tomtom.sdk.search:reverse-geocoder-hybrid
  • Rename artifact com.tomtom.sdk:reverse-geocoding-client-onboard to com.tomtom.sdk.search:reverse-geocoder-offline
  • Rename artifact com.tomtom.sdk:reverse-geocoding-client-online to com.tomtom.sdk.search:reverse-geocoder-online
  • Rename artifact com.tomtom.sdk:search-client-api to com.tomtom.sdk.search:search
  • Rename artifact com.tomtom.sdk:search-client-hybrid to com.tomtom.sdk.search:search-hybrid
  • Rename artifact com.tomtom.sdk:search-client-onboard to com.tomtom.sdk.search:search-offline
  • Rename artifact com.tomtom.sdk:search-client-online to com.tomtom.sdk.search:search-online
  • Rename artifact com.tomtom.sdk:search-ui to com.tomtom.sdk.search:ui
  • Rename artifact com.tomtom.sdk:structured-search-client-api to com.tomtom.sdk.search:structured-search
  • Rename artifact com.tomtom.sdk:structured-search-client-onboard to com.tomtom.sdk.search:structured-search-offline
  • Rename artifact com.tomtom.sdk:telemetry-api to com.tomtom.sdk.telemetry:telemetry
  • Rename artifact com.tomtom.sdk:telemetry-sensoris to com.tomtom.sdk.telemetry:sensoris
  • Rename artifact com.tomtom.sdk:telemetry-tomtom to com.tomtom.sdk.telemetry:telemetry-default
  • Rename artifact com.tomtom.sdk:traffic-client-api to com.tomtom.sdk.traffic:traffic
  • Rename artifact com.tomtom.sdk:traffic-client-tpeg to com.tomtom.sdk.traffic:tpeg
  • Rename artifact com.tomtom.sdk:telemetry-sensoris to com.tomtom.sdk.telemetry:sensoris
  • Rename artifact com.tomtom.sdk:vehicle-client-api to com.tomtom.sdk.vehicle:vehicle-provider

version 0.3.1014 - 11/11/2022

Map

Updates:

  • Update TomTom logo.

Fixes:

  • Use view context instead of application context
  • Fix crash after the phone orientation change.

Search

New features:

  • Support geo-bias for polygons and multiple search areas.

Updates:

  • Improved search developer guide, added dynamic data documentation.

Routing

Breaking changes:

  • Convert AnnouncementPoints enum to value class.
  • Convert AvoidType to value class.
  • Convert ComputeTravelTimeFor enum to value class.
  • Convert ConsiderTraffic enum to value class.
  • Convert ExtendedSections enum to value class.
  • Convert ProgressPoints enum to value class.
  • Convert ReportType enum to value class.
  • Convert SectionType enum to value class.
  • Make maxFerryLength parameter experimental
  • Make message mandatory parameter of RoutingError.
  • Remove AnnouncementManeuver from com.tomtom.sdk.common.route.Announcement.
  • Remove maxFerryLength from RangeCalculationOptions, hardcode to 20km
  • Rename HybridRoutingApi to HybridRoutePlanner.
  • Rename OnboardRoutingApi to OfflineRoutePlanner.
  • Rename OnlineRoutingApi to OnlineRoutePlanner.
  • Rename RoutingApi to RoutePlanner.
  • Rename com.tomtom.routing.api to com.tomtom.routing.
  • Rename com.tomtom.routing.onboard to com.tomtom.routing.offline.
  • Rename com.tomtom.sdk.common.common.route.Instruction.isPossibleToCombineWithNext to combineWithNext.

New features:

  • Write online reachable offset to route summary

Fixes:

  • Requesting unsupported speed limit sections for non-motorized will not result in a no-route-found anymore.
  • Short routes were wrongly mapped to shortest.

Breaking changes:

  • Remove message property from com.tomtom.sdk.route.Announcement
  • Remove routing verbal message generator from public API.
  • Rename GuidanceEngineFactory method create to createStaticGuidanceEngine.
  • Use current location to resolve the Unit System when it is set to AUTO.
  • Move ChargingInformation to common.ev
  • Move com.tomtom.sdk.navigation.InstructionPhase to com.tomtom.sdk.navigation.guidance.
  • Refactor DynamicRoutingApi to RouteReplanner.
  • Remove announcementGenerators from com.tomtom.sdk.navigation.guidance.GuidanceEngineOptions.
  • Remove com.tomtom.sdk.navigation.guidance.AnnouncementGenerator from public API.
  • Rename HybridDynamicRoutingApi to HybridRouteReplanner.
  • Rename OnlineDynamicRoutingApi to DefaultRouteReplanner.
  • Rename RoutePoint to RouteStop.
  • Rename com.tomtom.navigation.dynamicrouting.* to com.tomtom.navigation.routereplanner.*
  • Replace Disposable interface with AutoClosable in Navigation and TTS modules.

New features:

  • Add option to define RouteProjectionEngine in NavigationConfiguration
  • Introduce TileCacheRouteProjectionEngineFactory to simplify creation of the RouteProjectionEngine
  • Add SafetyLocationDataPoller and DataSource interface
  • Add SafetyLocationProvider…

Updates:

  • Convert non-exhaustive enum classes to value classes

General

New features:

  • NavVis Addon: implement on/off switch for traffic incidents visualization.

Updates:

  • In common modules and maps, mark public API that is intended to be used internally by SDK developers with @InternalTomTomSdkApi annotation.

version 0.3.913 - 28/10/2022

Map

Breaking changes:

  • Moved and renamed com.tomtom.sdk.maps.display.location.LocationMarkerType to com.tomtom.sdk.maps.display.location.LocationMarkerOptions.Type
  • Moved and renamed com.tomtom.sdk.maps.display.ui.compass.VisibilityPolicy to com.tomtom.sdk.maps.display.ui.compass.CompassButton.VisibilityPolicy
  • Moved and renamed com.tomtom.sdk.maps.display.ui.currentlocation.VisibilityPolicy to com.tomtom.sdk.maps.display.ui.compass.CompassButton.VisibilityPolicy
  • Moved and renamed com.tomtom.sdk.maps.display.ui.currentlocation.VisibilityPolicy to com.tomtom.sdk.maps.display.ui.currentlocation.CurrentLocationButton.VisibilityPolicy
  • Moved and renamed com.tomtom.sdk.maps.display.ui.logo.VisibilityPolicy to com.tomtom.sdk.maps.display.ui.logo.LogoView.VisibilityPolicy

Search

Breaking changes:

  • Move the charging park and entry point to POI.

New features:

  • Implement TomTom’s Online Parking Availability API

Routing

New features:

  • Rename consumption field in summary

Breaking changes:

  • Rename OnboardHorizonEngineFactory to OfflineHorizonEngineFactory
  • Rename OnboardLocationContextProviderEngineFactory to OfflineLocationContextProviderEngineFactory
  • Rename OnboardMapMatchingEngineFactory to OfflineMapMatchingEngineFactory
  • Rename OnlineMapMatchingEngine to TileCacheMapMatchingEngine
  • Rename OnlineRouteProjectionEngineFactory to TileCacheRouteProjectionEngineFactory
  • Rename OnlineRouteProjectionEngineOptions to TileCacheRouteProjectionEngineOptions
  • Rename RouteProgressCalculationEngine to RouteProgressEngine
  • Rename RouteProgressCalculationEngineFactory to RouteProgressEngineFactory
  • Rename TomTomArrivalDetectionEngineFactory to DefaultArrivalDetectionEngineFactory
  • Rename TomTomLocationContextProviderEngineFactory to LegacyLocationContextProviderEngineFactory
  • Rename TomTomMapMatchingEngineFactory to LegacyMapMatchingEngineFactory
  • Rename OnErrorListener to OnNavigationErrorListener

Location

Fixes:

  • Filter network location updates.

General

Updates:

  • NdsStore listeners now use functional interfaces.
  • Make default constants public and update documentation

version 0.3.880 - 25/10/2022

Map

Breaking changes:

  • Migrate from Disposalbe to AutoCloseable in MapDisplay public api signature
  • Remove constructor for output objects from public API.

New features:

  • Introduced the onboard data provider for map tiles based on new data provider api
  • Add support for geopolitical view.

Updates:

  • When the map display componentization feature toggle is enabled, the old persistent tile cache used by httpframework is removed
  • Add Cancellable as return value to methods with callbacks, that should remove callbacks and/or cancel asynchronous execution.
  • Update Map Styles guide with satellite style section.
  • Update Map Styles guide with the hill shading section.

Fixes:

  • Fix the issue that locale and timezone was not handled properly for http headers
  • Fix the test for cancellation of request token in asset data provider.
  • Fix ScaleView blinks with wrong values
  • Put markers layers on the top of everything else

Search

Breaking changes:

  • Changed SearchResultId, added interface for fuel prices request.
  • Migrate from Disposable to AutoCloseable in Search and ReverseGeocoder public api signature.

New features:

  • Add EV connector and fuel type filters for search.
  • Add OnlineFuelPriceApi implementation that allows to request fuel prices.
  • Add support for min and max power for EV POI filtering.

Updates:

  • Added package for the dynamic data fuel price API.

Routing

Breaking changes:

  • Migrate from Disposable to AutoCloseable.
  • Remove ChargingParkLocation from public API

New features:

  • Add onboard range calculation pt 3/3: API

Breaking changes:

  • Use factories for TomTom navigation engines creation.
  • Add Vehicle field to Navigation snapshot.
  • Replace input parameters in MapMatchingEngine with NavigationSnapshot
  • Unify methods in MapMatchingEngine to remove the distinction between route and map matching.

New features:

  • Implement online guidance v2 mode
  • Trigger guidance with specific configuration for current country.

Updates:

  • Add API to update unit system of GuidanceEngine

Fixes:

  • Disable flaky test in GuidanceCollaborationTests.
  • Move TrafficApi to Public preview.

General

New features:

  • NavVis Addon: enable the user to select a route (during the route planning phase) even when clicking on parts of the route with a traffic line.
  • NavVis Addon: hide the departure marker and override the destination marker’s pin image; put an explanation in the documentation detailing how to customize destination and waypoint markers.
  • Navigation Visualization Add-on: stylization API now provides a way to control traffic markers' visibility depending on the camera’s ZL and tilt angle.

Updates:

  • Align add/remove listeners behaviour
  • Allow user to specify a cache policy for Map Visualization.
  • Cache data is stored now during the expected amount of time.

Fixes:

  • Fix Quantities rounding

version 0.3.782 - 14/10/2022

Search

Breaking changes:

  • Remove brand and category from ResultType

version 0.3.773 - 11/10/2022

Map

New features:

  • The componentization of map display is now available under map display componentization feature toggle

Updates:

  • Apply api-guidelines rules to public constants.

Search

Breaking changes:

  • Revert ev stations filter back to minPower and maxPower, use Power type.

Fixes:

  • Fix filtering using result types.
  • Fix for unsupported language tag.
  • Make point addresses findable.

Routing

Breaking changes:

  • Remove startPointIndex from route instruction.

New features:

* * Introduce Horizon Engine. * Periodic retriggering of guidance announcements.

Updates:

  • Improve message representation in GuidanceAnnouncement
  • Validate GuidanceAnnouncement at construction
  • DynamicRoutingApi interface now inherits from AutoCloseable interface.
  • Propagate more navigation errors to the NavigationStartedCallback.
  • Clarify documentation for MatchedLocation.location.course and MatchedLocation.direction

Fixes:

  • Navigation process continuously works even if the user is stopping.

General

Breaking changes:

  • Split Units.IMPERIAL to UnitSystem.US and UnitSystem.UK

New features:

  • Adds possibiltiy to remove an item from the map

Updates:

  • Navigation Visualization Add-on: default stylization values/constants are now public.
  • Renamed Units → UnitSystem

version 0.3.678 - 30/09/2022

Search

New features:

  • Hybrid POI categories request.
  • Supporting for requestPoiDetails in hybrid search mode.

Fixes:

  • Fix search to use predictive input instead of exact.

Routing

New features:

  • Introduce routing coroutines module.
  • Enable vehicle (truck) onboard routing

Updates:

  • Phonetic alphabet is updated in Route created from online response

Fixes:

  • Fix online routing request language parameter.
  • Fixing route planning cacellation

New features:

  • Pass Route to the VehicleHorizon
  • Speed view dark mode

Updates:

  • Tests are refactored and added regression testing of NAV-92134

Location

Updates:

  • SimulationLocationEngine supports using current timestamps

General

New features:

  • Adds possibility to observe the completion
  • Improve performance of caching, introducing an in-memory cache in HttpHandler.

Updates:

  • Remove EV Range Add-on color resources
  • Improve guidance in the navigation use case tutorial.

version 0.3.614 - 22/09/2022

Map

New features:

  • Introduces an asset data provider based on MapDisplayDataProvider interface that handles asset requests by map display engine using FileLoader.

Fixes:

  • Fixed map rotation focal point and focal point drifting on zoom in/out

Search

New features:

  • Match protobuf file on library side to support alpha2 codes

Updates:

  • Make hybrid reverse geocoder use online and onboard APIs.

Fixes:

  • Fix documentation links for RectangleGeometry, CircleGeometry and PolygonGeometry in SearchOptions.
  • Fixed online brand name filtering for the cases with comma, ampersand and trailing spaces.

Routing

New features:

  • Add first step of onboard routing conversion for vehicles

New features:

  • Extended guidance engine to allow disabling of guidance announcements
  • Extended guidance engine with support for compact announcements.
  • Horizon Engine API.

Updates:

  • Decision by steering for a better route proposal
  • Updated documentation of DynamicRoutingAPI
  • Decision by steering for better proposal

Fixes:

  • Fix sharp and slight turn announcements for far away maneuvers

General

New features:

  • Navigation Visualization Add-on: images/icons are now stored as resources instead of assets. With this change, the device’s density dpi configuration is taken into account when loading images/icons.

version 0.3.571 - 15/09/2022

Map

Fixes:

  • Fix update camera position for latitudes lower than -85.0 and greater than 85.0.
  • Improved rotation detection threshold

Routing

New features:

  • Interface for incremental route content update

New features:

  • Next Guidance Instruction changes only when the maneuver path for the previous instruction is passed.

Fixes:

  • Fixed an issue where driving onto other RouteLeg resulted in route progress jump and waypoints on the previous RouteLeg being marked as visited.

General

Breaking changes:

  • Use com.tomtom.kotlin.quantity.Distance instead of com.tomtom.sdk.common.measures.Distance

version 0.3.531 - 09/09/2022

Search

Fixes:

  • The search properties passed to setupSearch now are used.

Routing

Breaking changes:

  • Expose charging connection information in routing client API

New features:

  • Hybrid client supports iterative route planning.

Fixes:

  • Guidance UI only shows combined instructions for Main and Confirmation phases

General

Updates:

  • Update navigation start tutorial video asset.

Fixes:

  • Fix UI controls overlapping for navigation use case tutorial.

version 0.3.509 - 02/09/2022

Map

New features:

  • Extend Polyline to support different widths across zoom levels.

Updates:

  • Created demo screen for showcasing styles switching and layers configuration. Has a different UI in landscape mode

Search

New features:

  • Hybrid reverse geocoder api.

Routing

Breaking changes:

  • Make consumption fields optional and use quantities in the route summary.

Updates:

  • Clarify vehicle length in documentation.

Fixes:

  • Fix early announcements for "Bear Left/Right" instructions
  • Fix roundabout exit instruction icons in onboard mode
  • Trigger arrival announcement, when it is just after the other instruction.

Location

Updates:

  • Added permission requirement annotation. Caught security exception in maps-demo-app.

General

New features:

  • Navigation Visualization Add-on: support for on-route traffic lines with different widths across zoom levels

version 0.3.482 - 26/08/2022

Map

New features:

  • Added copyrights and terms & conditions screen to maps and navigation demo app.

Fixes:

  • Maneuvers arrows issue fixed.
  • Updated CameraTrackingMode documentation.

Search

Breaking changes:

  • 'additionalDataSearch' renamed to requestGeometryData. Related classes: ..Options, ..Callback, ..Result changed accordingly. AdditionalDataSearchError removed, SearchError is used instead.
  • Added requestPoiDetails API. The Poi properties type have been changed for: categoryIds and openingHours.
  • Reverse geocoder now requires Context for its creation.
  • Upgrade poi categories API to new version

New features:

  • The POI details in onboard mode have opening hours (were available).
  • RequestPoiDetails API has been implemented for the onboard mode.
  • Implement online POI Details
  • Return opening hours in online POI details
  • Implement onboard poi category search

Updates:

  • Onboard POI category search in maps demo app

Fixes:

  • Fix for invalid language query parameter in the search request.
  • Fix to show opening hours with POI details in online mode.
  • Support providing search API to SearchFragment before onCreate is called

Routing

Breaking changes:

  • Add a summary field to RouteLeg
  • Allow dimensions on all motorized vehicles
  • Change maxSpeed type to nullable
  • Remove leftover ConsumptionUnit type

New features:

  • Add Electric Vehicle Routing Options and Vehicle Model Id
  • EV routing response builder
  • Expose traffic length and traffic delay information in the Onboard Route summary.
  • Hybrid routing API.
  • Onboard routing errors

Updates:

  • Fix typo in Planning Routes documentation
  • Update ApiKeyError documentation

Fixes:

  • Hybrid routing client notifies the callback of planned routes.
  • Remove dead code

New features:

  • Display next instruction after roundabout exit in NIP
  • Show forward arrow in Guidance view during follow phase for instruction.

Updates:

  • Implement option to adapt TTS language to a message language
  • Update radius threshold for waypoint arrival check based on road type.

Fixes:

  • Fix an issue that causes route progress calculation to be vulnerable to loops in the route in certain situations.
  • Fix calculating remaining coordinates for replanning.
  • Fixed crash in NavigationFragment during lifecycle when TomTomNavigation was not set
  • Improve combination of instructions (instructions are only combined when main announcement for second instruction will not be made).
  • Populate better route proposal in NavigationSession.
  • Remove a better route proposal when it is no longer tracked
  • Use freeway icon if the MergeGuidancInstruction.mergeSide is null.
  • Remove better proposal if no longer tracked

General

New features:

  • Add range visualization add-on.
  • Navigation Visualization Add-on: Implements stylization API for the on-route traffic incidents.

version 0.3.344 - 12/08/2022

Map

New features:

  • Add PolygonOverlay primitive.
  • Added Satellite Imagery Style

Fixes:

  • Persist state of the map between fragment view recreations.

Search

Breaking changes:

  • Support onboard NDS category filtering

Routing

Updates:

  • Add 'route to include' to range options
  • If exit direction in instruction is not specified explicitly, derive it from the driving side.

Breaking changes:

  • Add currentPhase to OnGuidanceUpdateListener
  • RouteReplanningPolicy is removed and ContinuousReplanningMode is altered
  • Move route selection logic to handler

New features:

  • Add language support to OnboardLocationContextProviderEngine

Updates:

  • Extract a vehicle type from route plan options.

Fixes:

  • Fix for missing mandatory turn instruction announcements in onboard mode
  • Route update should fail when active route cannot be updated

General

New features:

  • Adds a method to install or update an NDS map region to the latest version.

Fixes:

  • Fixed incorrect placing of the PublicPreview notice in the documentation.

version 0.3.303 - 05/08/2022

Map

Fixes:

  • Fix write to parcel TimeToLive cache policy.
  • Introduced API for mark route as followable.

Search

Breaking changes:

  • Few changes to auto-complete API.
  • Fusing TTOM standard category and map specific NDS category into one.
  • Some fields changed/removed for the search along route options and response.
  • Various improvements for SearchResult.

Fixes:

  • Fix for the onboard search mode: the search area along the route appeared twice wider than expected.

Routing

Breaking changes:

  • Distance and Energy budgets can now be used
  • Move Routing Options to routing-common
  • Move RoutingError to routing.common
  • Rename PlanRouteOptions to RoutePlanningOptions
  • Use proper constructors for the different types of vehicles

New features:

  • Routing request language

Updates:

  • Add calculateRange stubs
  • Update vehicle section in route planning guide
  • Use basic routing API if no extended guidance features are requested

Fixes:

  • Fixed mapping of signpost phonetic text for online instructions

Breaking changes:

  • Remove unused fields from GuidanceAnnouncement
  • Add 'Route' as param to OnDestinationReachedListener.onDestinationReached callback.

Updates:

  • Use a type-safe wrapper for representing NDS Arc keys.
  • Extend MapMatchingResult

Fixes:

  • Fix extra at the end of the road messages added to guidance announcements in onboard mode
  • Fix constant rerouting when starting a little far from the route.
  • Fixed crash in onboard message generation
  • Include destination progress data in the RouteProgress.remainingRoutePointsProgress.

General

Breaking changes:

  • Replace common.time.Duration with kotlin.time.Duration.

New features:

  • Displays markers on the on-route traffic incidents for the navigation visualization add-on.

version 0.3.249 - 29/07/2022

Map

Breaking changes:

  • Rename compose module from display-compose to maps-display-compose

Fixes:

  • Fix update logic of marker pin icon
  • Fix of map crash on orientation change

Search

Breaking changes:

  • Poi fields added/changed/removed.
  • Removed AdditionalDataSearchOptions.Builder in favour of constructor with default parameters
  • Removed AlongRouteSearchOptions.Builder in favour of constructor with default parameters
  • Removed AutocompleteSearchOptions.Builder in favour of constructor with default parameters
  • Removed FuzzySearchOptions.Builder in favour of constructor with default parameters
  • Migrate PoiCategory to Category

Routing

Breaking changes:

  • Move TravelMode into Vehicle
  • PlanRouteOptions gets an additional field dedicated to leg specific information. User provided supporting points option should be passed to the new RouteLegOptions field.
  • Provide country name for border crossing instructions
  • Provide phonetics in addition to plain text for intersection name in route instructions
  • Replaced RoadInformation.roadName, roadNamePhonetics, roadNumbers, roadNumbersPhonetics with TextWithPhonetics
  • Replaced Signpost.exitNumber, exitNumberPhonetic, exitName, exitNamePhonetic, towardName, towardNamePhonetic with TextWithPhonetics
  • Rewrite API for PlanRoute
  • Use unit system for vehicle & consumption values
  • Move chargeLevel from ElectricVehicleConsumption to ElectricEngine, move currentFuel from CombustionConsumption to CombustionEngine

Fixes:

  • Fix RouteType links in documentation
  • Fix route planning when alternatives are specified

Breaking changes:

  • Introduced new types for GuidanceInstruction.roadInformation, signpost
  • Provide country name for border crossing instructions

New features:

  • Remove nextManeuver from GuidanceAnnouncement and add combine flag to GuidanceInstruction

Updates:

  • Add change of speed bubble ui logic and assets
  • Improvements on audio messages for onboard mode
  • Add support for multiple languages and unit systems for onboard audio messages
  • Arrival panel from now takes the destination name from itinerary destination or last instruction street name

Fixes:

  • Fixed crash that happens shortly before arrival when there was previous route refresh

General

New features:

  • An API to query the structure of the onboard

version 0.3.196 - 20/07/2022

Map

Breaking changes:

  • TileDataProvider no longer provided to MapOptions, but to TomTomMapConfig instead.

New features:

  • Add TextureView support for map display.
  • Added camera tracking route overview mode
  • MapVisualisation TileDataProvider integrated with StoreAccessSync and enabled for map updates.

Updates:

  • Map orientation follows the current position heading.
  • Make map to have different sky colors for light and dark mode.
  • Re-order layers in layer mapping file

Fixes:

  • Fix slow panning map and map interaction around the north and south pole.
  • Map scaling to the wrong point fixed.
  • Fix of crash for multiple compose maps on single screen

Search

Breaking changes:

  • Field 'functions' removed from EntryPoint.
  • OpeningHoursMode is changed to value class for maintaining backwards compatibility while adding new values.

New features:

  • Provide polygon geometry data in reverse geocoder response
  • Provide multipolygon geometries in reverse geocoder

Fixes:

  • Fix for reverse geocoding failure for international waters.
  • Handle unidentified road use type while reverse geocoding.

Routing

Breaking changes:

  • Fixing the vehicle hierarchy
  • Introduce Route Summary
  • Removed CombustionEngine.Builder in favour of constructor with default parameters
  • Removed ElectricEngine.Builder in favour of constructor with default parameters
  • Removed PlanRouteOptions.Builder in favour of constructor with default parameters
  • Removed Vehicle.Builder in favour of constructor with default parameters
  • Removed VehicleDimensions.Builder in favour of constructor with default parameters
  • Removed VehicleEfficiency.Builder in favour of constructor with default parameters
  • Rename RoutingOptions, -Result, -Callback to PlanRouteResult etc.
  • Roundabout direction values changed to "Cross", "Right", "Left", "Back".

New features:

  • Add Landmark to route instruction
  • Add side street and traffic light offsets to route instructions.
  • Added quantized turn angle to roundabout and exit roundabout instructions.
  • Provide road types in instruction road information.

Updates:

  • PlanRouteOptions related classes were moved, please refer to "Planning a route" guide

Fixes:

  • Update documentation links for PlanRouteRequest

Breaking changes:

  • Remove junctionType from Route and Navigation instructions
  • Remove maneuverType from Route and Navigation instructions
  • Accept RouteProgress in MapMatchingEngine for route matching
  • Changed Route id type from String to RouteId
  • Removed builder from NavigationConfiguration in favour of constructor with default values
  • Removed builder from NavigationUiOptions in favour of constructor with default values
  • Roundabout direction values changed to "Cross", "Right", "Left", "Back".

New features:

  • Add map-matching a point to the route.
  • Add navigation history
  • Added quantized turn angle to roundabout and exit roundabout guidance instructions.
  • Currently visited waypoint logic implemented in RouteTrackingEngine
  • Integrate map access sync with onboard map matching
  • Introduced RouteProgressCalculationEngineFactory as a default way of creating an implementation of the engine.
  • Introduced RouteTrackingEngineFactory as a default way of creating default implementation of the engine
  • Show intersection name in next instruction panel for Japan
  • IsWaypointCurrentlyVisited exposed in NavigationSnapshot
  • Add support for position predictions in OnboardMapMatchingEngine

Updates:

  • Replace ReplanningParameters with NavigationSnapshot in the RouteReplanningEngine.
  • Throw IllegalStateException if more than one navigation is started.

Fixes:

  • Fix Navigation Quickstart guide description of the used LocationEngine.
  • Fix road shields overlapping motorway exit.
  • Location is properly reported even when outside current route

General

New features:

  • Adds on-route traffic incidents display for the navigation visualization add-on.
  • Telemetry handles user consent
  • Navigation sends telemetry probe data on location update

Updates:

  • Temporarily add TomTom’s Quantity library to this project.
  • Describe how to add new e2e module tests for CI in TESTING.md file .

Fixes:

  • Do not obfuscate Quantity lib

version 0.2.2464 - 22/06/2022

Search

Fixes:

  • Set the language in the proto builder

Breaking changes:

  • Replace RouteDeviationEngine with RouteTrackingEngine

version 0.2.1457 - 20/06/2022

Map

Breaking changes:

  • Changed LaneBoundaryType.LONG_DASHE_LINE to LaneBoundaryType.LONG_DASHED_LINE

Updates:

  • Switch to V2.1 styles.

Fixes:

  • Add threading control to the getMapAsync() method
  • Fix missing mapping file for onboard style in navigation demo app
  • Fix invalid StyleDescriptor documentation regarding mapping file fallback for dark style.

Search

Breaking changes:

  • Return SearchApi from OnlineSearchApi
  • Reverse geocoder API refinement.
  • Switch from exceptions to errors in Reverse Geocoder API
  • Switch from exceptions to errors in Search API

New features:

  • Filter onboard search results by brand names.
  • The filter by POI categories for the onboard search results is available.
  • The filter by countries for the onboard search results is activated.
  • Add onboard search along the route

Updates:

  • Make SearchApi and ReverseGeocoderApi disposable.
  • Add an extension to SearchResult to convert to a Place
  • SearchUI improvements

Fixes:

  • Use inSeconds to get the max detour time

Routing

Breaking changes:

  • Added new Instruction interface, replacing previous single Instruction data class with implementations for each Instruction type and introduce new properties for road information, signpost.
  • Remove UNDEFINED value from AlternativeType enum
  • Remove UNDEFINED value from Hilliness enum
  • Remove UNDEFINED value from SectionType enum
  • Remove UNDEFINED value from VehicleAdrTunnelRestrictionCode enum
  • Remove UNDEFINED value from VehicleEngineType enum
  • Remove UNDEFINED value from VehicleLoadType enum
  • Remove UNDEFINED value from Windingness enum
  • Remove UNKNOWN and NONE value from AnnouncementManeuver enum
  • Remove UNKNOWN and NONE value from Maneuver enum
  • Remove UNKNOWN value from DrivingSide enum
  • Remove UNKNOWN value from LaneSeparator enum
  • Remove UNKNOWN value from MagnitudeOfDelay enum
  • Removed legacy Instruction properties: instructionType, countryCode, street, roadNumbers, exitNumber, signpostText, turnAngleInDecimalDegrees, roundaboutExitNumber, message, combinedMessage, maneuver, verbalMessage, verbalMessagePhonetics, extras).
  • Replace RoutingException with RoutingError

New features:

  • Added RoutingApiKeyException to inform about problems with API key when sending a request
  • Avoid areas onboard

Updates:

  • Made "language" parameter in RoutingOptions nullable. When not specified the device language will be used.

Breaking changes:

  • Add new GuidanceInstruction interface replacing previous single GuidanceInstruction data class with implementations for each Guidance Instruction type.
  • Changed the return type of methods in MapMatchingEngine to MapMatchingResult
  • Removed legacy GuidanceInstruction properties: instructionType, countryCode, street, roadNumbers, exitNumber, signpostText, turnAngleInDecimalDegrees, roundaboutExitNumber, message, combinedMessage, maneuver, maneuverType, verbalMessage, verbalMessagePhonetics, extras).
  • Replaced TextToSpeechEngineException with TextToSpeechEngineError
  • Made SpeedUnitsConverter class non-public

New features:

  • OnWaypointVisitedListener exposed on API and called
  • Added the possibility to specify the language in GuidanceOptions. If not specified device language will be used.
  • Introduction of stand alone route progress engine.
  • Pass only unvisited waypoints when on route replanning/refreshing
  • NavigationView added
  • Added setUnits method to NavigationFragment
  • Calculate progress information for remaining waypoints
  • Instruction messages are produced in GO SDK onboard mode (AmiGO spec)
  • Add onboard map matching engine

Updates:

  • "Method documentation was made clearer in NavigationController"
  • Improve performance of StandaloneRouteProgressCalculateionEngine with binary search
  • Replace fonts with Noto Sans.
  • Waypoints navigation documentation
  • Reset distance along route each time, except DEVIATION reason
  • Publish navigation UI components tutorial

Fixes:

  • Instructions are no longer necessary to calculate Waypoint offset
  • Stop Proguard from removing instructions package

Location

Fixes:

  • On API 31+ check existence of LocationManager.NETWORK_PROVIDER

General

Breaking changes:

  • Member 'orchestrator' (of type NdsStoreAccessSync, in NdsStore) renamed to "sync".
  • NdsStoreAccessSync uses IllegalStateException now instead of a custom one.

New features:

  • Android Telemery API

Updates:

  • Rename PublicPreview…​Feature → PublicPreview…​Api
  • Improved KDoc comments around NdsStoreAccessSync and related classes.
  • Move testing guide for contributors to TESTING.md file

version 0.2.1331 - 03/06/2022

Map

Breaking changes:

  • Migrated to private resources in maps:display module

New features:

  • Log diagnostic information to AppCenter

Updates:

  • Add OnMarkerSelectedListener to the MarkerController to remove hindering dependencies from DefaultMarkerController

Search

Breaking changes:

  • Highlight matching text in search results

New features:

  • Onboard search feature toggle. Demo for search in bounding box.

Fixes:

  • Set a default limit of search results

Routing

New features:

  • Expose extended route representation in routing module

Updates:

  • Deprecated NIE fields are removed
  • Calculate route coordinates lazily, bring back route geometry field
  • Calculate offsets for routeCoordinates with use of exten…

Removals:

  • Remove unsupported ModeOfTransport

Breaking changes:

  • Added a possibility to use Routing API or Extended Routing API depending on URL and Routing Options.

New features:

  • Waypoint arrival detection added to ArrivalDetectionEngine

Updates:

  • Add location predictions to the MatchedLocation

Fixes:

  • Adjusted Proguard settings to not remove public classes
  • RouteProgress’s arrivalTime is actually remaining time

General

New features:

  • Publish initial set of onboard components.

version 0.2.1260 - 27/05/2022

Search

Deprecated:

  • The following calls in Search API are now discontinued: downloadPoiPhoto, poiDetailsSearch

Updates:

  • Added possibility to specify system of measurement in Search UI module

General

Updates:

  • Added support for Chinese and simplified Chinese

Android version 0.2.1234

Bug fixes:

  • Fix for a random crash occurring when the map was deallocated
  • Fix for a route color not changing to asserted one

Android version 0.2.1202

Bug fixes:

  • Fix for a discrepancy in directional arrows when approaching destination
  • Fix for occasional freezes after deviation
  • Fix for map glitches while changing Light / Dark mode with Smooth Style Reload
  • Fix for route replanning not happening for a long time after deviation
  • Fix for shifted turn manoeuvre arrows on long routes

Android version 0.2.1189

New:

  • Added callbacks to Navigation start and update methods

Bug fixes:

  • Fix for directional arrows drawn partially for some instructions
  • Fix for TomTomMap.setLanguage(String) not setting language correctly

Android version 0.2.1173

Updates:

  • Lifted usage of bearing in routing requests where heading is required
  • Removed various NavigationExceptions inheritors from sealed class

Bug fixes:

  • Fix for incorrect path to the Android artefacts in project set up guide

Android version 0.2.1145

Updates:

  • Improved location predictions filtering
  • Added documentation guide for pins shrinking and fading

Bug fixes:

  • Fix for misplaced chevron from the actual position on the map
  • Fix for occasional discrepancies in directional arrows

Android version 0.2.1115

Bug fixes:

  • Fix for no arrival announcement
  • Fix for a crash when map tiles download was started on a phone with no network connection
  • Fix for missing and not restored traffic flow and incidents after changing map style
  • Fix for road labels overlapped by directional arrows

Android version 0.2.1097

New features:

  • Update of map’s style file
  • Apply translated navigation UI strings

Updated features:

  • Replanning on deviation should be executed even when there is no internet connection
  • Chevron rotating when using GmsLocationEngine

Bug fixes:

  • Missing fonts on MapView
  • Change style between light and dark not change polar caps
  • Control points not working
  • With Free driving and landscape mode, street name will be out of screen
  • Map tile loading is not smooth when swiping/pan up the map
  • Failing re-route on deviation
  • Lengthy routes calculated with Meters irrespective of Units set
  • Back-to-Route Triggering Taking Too Long
  • Current speed is greater then 0km/h when the car stops