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.

Navigation

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.

Navigation

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.

Navigation

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.

Navigation

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

Navigation

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.

Navigation

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.

Navigation

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

Navigation

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.

Navigation

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

Navigation

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

Navigation

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

Navigation

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.

Navigation

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

Navigation

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

Navigation

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.

Navigation

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

Navigation

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

Navigation

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

Navigation

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.

Navigation

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.

Navigation

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

Navigation

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.

Navigation

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

Navigation

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

Navigation

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

Navigation

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

Navigation

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.

Navigation

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

Navigation

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