Release notes

version 0.3.34 - 01/07/2022

Breaking changes:

  • All classes related to poi details were removed from the API.

Updates:

  • Enable both brand and category result types for auto-complete as the default option.

Fixes:

  • Decreased default radius value for the reverse geocoding.

Routing

Updates:

  • Onboard client can handle supporting points

Fixes:

  • Avoid areas in Onboard Routing

Breaking changes:

  • Replaced 'isFollowed(NavigationSnapshot): Boolean' method in RouteTrackingEngine with 'obtainTrackedRoutes(NavigationSnapshot): List<String\>'

New features:

  • Multiple annoncements for onboard instructions

Updates:

  • Remove duplicates from the Route.geometry and Route.routeCoordinates.

Fixes:

  • Fix progress jump in StandaloneRouteProgressCalculationEngine while driving on an overlapping route.

General

Breaking changes:

  • RoutingOptions SupporingPoints are split by leg.

Updates:

  • Change GeoCoordinate.fractionTo method return type to Double.
  • Generate API reference for addons:visualization:navigation

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