Release notes

version 0.3.1056 - 23/11/2022

Map

New features:

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

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,

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.

version 0.3.1014 - 23/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