Release notes

version 0.2.2822 - 28/11/2022

Map

New features

  • Remove persistent tile cache when componentization is enabled

Updates

  • Rename Map to TomTomMap
  • Rename Map to TomTomMap
  • Rename Map to TomTomMap

New features

  • Add API for custom POIs in Onboard Search

Fixes

  • Fix distance formatting in SearchUI

Routing

Updates

  • Documentation for LaneGuidance, Double to Measurement<UnitLength&gt;.

Breaking changes

  • TomTomSDKNavigationEngine: Func NavigationErrorObserver.didArrivalEngineFail(with:) has been renamed to Func NavigationErrorObserver.arrivalEngineFailed(with:)
  • TomTomSDKNavigationEngine: Func NavigationErrorObserver.didGuidanceEngineFail(with:) has been renamed to Func NavigationErrorObserver.guidanceEngineFailed(with:)
  • TomTomSDKNavigationEngine: Func NavigationErrorObserver.didHorizonEngineFail(with:) has been renamed to Func NavigationErrorObserver.horizonEngineFailed(with:)
  • TomTomSDKNavigationEngine: Func NavigationErrorObserver.didLocationContextEngineFail(with:) has been renamed to Func NavigationErrorObserver.locationContextEngineFailed(with:)
  • TomTomSDKNavigationEngine: Func NavigationErrorObserver.didMapMatchingEngineFail(with:) has been renamed to Func NavigationErrorObserver.mapMatchingEngineFailed(with:)
  • TomTomSDKNavigationEngine: Func NavigationErrorObserver.didRouteProgressDetectionEngineFail(with:) has been renamed to Func NavigationErrorObserver.routeProgressDetectionEngineFailed(with:)
  • TomTomSDKNavigationEngine: Func NavigationErrorObserver.didRouteReplanningEngineFail(with:) has been renamed to Func NavigationErrorObserver.routeReplanningEngineFailed(with:)
  • TomTomSDKNavigationEngine: Func NavigationErrorObserver.didRouteTrackingEngineFail(with:) has been renamed to Func NavigationErrorObserver.routeTrackingEngineFailed(with:)
  • TomTomSDKNavigationEngine: Func NavigationErrorObserver.didStartFail(with:) has been renamed to Func NavigationErrorObserver.navigationStartFailed(with:)

Updates

  • Update documentation for NavigationConfigurationBuilder

General

Updates

  • Move guidance related common.route APIs under instruction.
  • TomTomSDKCommon: Protocol MapDisplayDataProvider has been removed
  • TomTomSDKCommon: Protocol MapDisplayDataRequestToken has been removed
  • TomTomSDKCommon: Protocol MapTileDataProviding has been removed
  • TomTomSDKCommon: Struct MapTile has been removed
  • TomTomSDKCommon: Struct MapTileOptions has been removed

Fixes

  • Rename mapsKey parameter to apiKey

version 0.2.2746 - 18/11/2022

Search

Fixes

  • Distance formatting for the SearchUI uses dedicated rules for rounding and conversion to the smaller or larger distance units.

General

Updates

  • Rename FeatureToggleService → FeatureToggle
  • Rename LocationEngine → LocationProvider
  • Rename DefaultCLLocationEngine → DefaultCLLocationProvider
  • Rename SimulatedLocationEngine → SimulatedLocationProvider
  • Rename LocationEngineObservable → LocationProviderObservable
  • Rename LocationActions.activateLocationEngine() → LocationActions.activateLocationProvider()
  • Rename LocationActions.deactivateLocationEngine() → LocationActions.deactivateLocationProvider()
  • Rename LocationActions.locationEngine → LocationActions.locationProvider
  • Rename EngineActions.locationEngine → EngineActions.locationProvider
  • Rename EngineActions.mapMatchedLocationEngine → EngineActions.mapMatchedLocationProvider
  • Rename Navigation.locationEngine → Navigation.locationProvider
  • Rename Navigation.mapMatchedLocationEngine → Navigation.mapMatchedLocationProvider
  • Rename NavigationConfiguration.locationEngine → NavigationConfiguration.locationProvider
  • Rename DataStoreUpdater.updateLocationEngine → DataStoreUpdater.updateLocationProvider
  • Rename TPEGTrafficService.updateLocationEngine → TPEGTrafficService.updateLocationProvider
  • Rename module TomTomSDKHTTPFramework → TomTomSDKNetworking
  • Rename module TomTomSDKLocation → TomTomSDKLocationProvider
  • Rename module TomTomSDKMapsDisplay → TomTomSDKMapDisplay
  • Rename module TomTomSDKOnboardStyleProvider → TomTomSDKStyleProviderOffline
  • Rename module TomTomSDKNavigationView → TomTomSDKNavigationUI
  • Rename module TomTomSDKSystemTextToSpeechEngine → TomTomSDKDefaultTextToSpeech
  • Rename module TomTomSDKOnboardMapDisplayDataProvider → TomTomSDKMapDisplayDataProviderOffline
  • Rename module TomTomSDKDynamicRoutingApi → TomTomSDKRouteReplanner
  • Rename module TomTomSDKOnlineDynamicRoutingApi → TomTomSDKRouteReplannerDefault
  • Rename module TomTomSDKInternalDynamicRoutingApi → TomTomSDKRouteReplannerInternal
  • Rename module TomTomSDKHybridDynamicRouting → TomTomSDKRouteReplannerHybrid
  • Rename module TomTomSDKOnlineDynamicData → TomTomSDKDynamicDataOnline
  • Rename module TomTomSDKOnboardDataManagement → TomTomSDKDataManagementOffline
  • Rename module TomTomSDKRouting → TomTomSDKRoutePlanner
  • Rename module TomTomSDKOnlineRouting → TomTomSDKRoutePlannerOnline
  • Rename module TomTomSDKOnboardRouting → TomTomSDKRoutePlannerOffline
  • Rename module TomTomSDKHybridRouting → TomTomSDKRoutePlannerHybrid
  • Rename module TomTomSDKOnlineReverseGeocoder → TomTomSDKReverseGeocoderOnline
  • Rename module TomTomSDKOnboardReverseGeocoder → TomTomSDKReverseGeocoderOffline
  • Rename module TomTomSDKHybridReverseGeocoder → TomTomSDKReverseGeocoderHybrid
  • Rename module TomTomSDKNavigationVisualizationAddon → TomTomSDKAddonNavigationVisualization
  • Rename module TomTomSDKRangeVisualizationAddon → TomTomSDKAddonRangeVisualization
  • Rename module TomTomSDKUIComponents → TomTomSDKCommonUI
  • Rename module TomTomSDKTPEGTraffic → TomTomSDKTrafficTPEG
  • Rename module TomTomSDKOnlineRouteProjectionEngine → TomTomSDKRouteProjectionEngineTileStore
  • Rename module TomTomSDKOnboardStructuredSearch → TomTomSDKStructuredSearchOffline
  • Rename module TomTomSDKOnboardVehicleHorizonEngine → TomTomSDKHorizonEngineOffline

Fixes

  • improving links in documentation

version 0.2.2702 - 10/11/2022

Map

Fixes

  • Update watermarks with the new icons

Removals

  • Remove OnboardDataStoreUpdateContextEngine (deprecated by DataStoreUpdater)

General

Updates

  • Make utility network-related classes from TomTomSDKCommon module internal
  • Make TomTomSDKCommmon.ValueFormattingResult internal and make all methods of TomTomSDK.ValueWithUnitFormatter internal
  • Clarify API state of Common/Measurements.

Removals

  • Remove IDGenerator class from the public API of TomTomSDKCommon module
  • Remove obsolete internal API: AudioConfigurationProvider protocol from the TomTomSDKCommon module

Fixes

  • DemoViewModel doesn’t create 2 NavigationTileStores anymore; GeoArea-related classes' visibility also fixed.

version 0.2.2581 - 28/10/2022

Map

Updates

  • Add new destination marker image and set default departure marker icon as nil

Search

New features

  • Implement fuel prices search in TomTomSDKOnlineDynamicData module

Updates

  • Add fuel prices API to TomTomSDKDynamicData module

Fixes

  • Fixed broken links in the public documentation for Search and Reverse Geocoder
  • Fixed API reference links in the Search documentation.

Routing

Updates

  • Remodel consumption and add reachable offset in route summary.

General

New features

  • Add an API to cancel the NDS map operations (NDSStore.cancelAllMapOperations).
  • Remove usage of persistent tile cache for tiles when componentization is enabled
  • Current map operation and error handling

Updates

  • Minimize usage of setter function

Fixes

  • Fix hang or crash on error from NDSStore.schedule

version 0.2.2481 - 21/10/2022

Map

Fixes

  • Set chevron as default location indicator

New features

  • Add support for region configurations.

Updates

  • Move Traffic API to Public Preview.
  • Support dynamic unit changes in GuidanceEngine

Fixes

  • Fix incorrect country announcement when crossing border

Location

New features

  • Implement Area class.

General

New features

  • Make RegionGraphNodeID implement Comparable.

version 0.2.2436 - 14/10/2022

Map

Fixes

  • Fix zoom to routes during orientation.
  • Fix marker textbox shadow
  • Display shields

Routing

Updates

  • Route.Phonetics has been updated to support phoneticAlphabet.

New features

  • Add Dynamic Routing protocol to replan route.
  • Adding periodic announcements.

Fixes

  • Now when changing the LocationEngine, the position of the chevron will correctly reset.

General

New features

  • Add an API to uninstall the NDS map region (MapOperationType.uninstall).
  • [NAV-86120] Implement DCAS-based Transport

Updates

  • Added hill shading to documentation.

version 0.2.2314 - 10/10/2022

New features

  • Expose up-to-date state of a region

General

New features

  • Add support for installing and updating of the onboard NDS map regions to the OnboardDataManagement component (see NDSStore.schedule).

Fixes

  • Notify RegionGraphObserver on map region state changes.

version 0.2.2257 - 30/09/2022

Map

Fixes

  • Use more strict types in the public API
  • Fix typo in TomTomSDKMapsDisplay.MarkerLabelOptions

Search

New features

  • Updated documentation for the Hybrid Reverse Geocoder
  • Hybrid implementation for the POI Categories search

Updates

  • Hybrid implementation for the Along Route search
  • Implemented Hybrid fuzzy Search API

Fixes

  • Use SearchResultType.street for results filtering instead of the SearchResultType.address for OnboardSearch

Routing

New features

  • [BREAKING] Introduce flat RoutePoint structure and parse charging information from RoutePoint instead of LegSummary

Fixes

  • Hiding bindings' types to avoid class name with third parties.

New features

  • Enable/disable announcement generation option

Location

Updates

  • SimulatedLocationEngine supports using current timestamps

version 0.2.2163 - 22/09/2022

Map

New features

  • Add placement anchor to MarkerOptions

Search

New features

  • Adding hybrid autocomplete search query

Updates

  • Change the public API of HybridReverseGeocoder module; Module now needs to apiKey and MapDataStore at initialization

Routing

New features

  • Plan EV Route using planRoute api

Updates

  • Use new onboard-directions increment interface
  • Use new go-sdk-onboard-directions interface

Fixes

  • Handle LHP phonetics

Version: 0.2.2095 - 16/09/2022

Map

Fixes

  • Fixed style container API key dependency issue

Search

New features

  • Publish HybridReverseGeocoder module

Fixes

  • Fixed API documentation generation for the Reverse Geocoder
  • Fixed links in the autocomplete documentation

Routing

Updates

  • Improve error handling in snippets.

Fixes

  • Do not pass customEndpoint as parameter in request.

New features

  • Expose installed state of a region

Fixes

  • Now when changing the LocationEngine, the position of the chevron will correctly reset.

version 0.2.2025 - 09/09/2022

Map

New features

  • Anchored rotation

Search

New features

  • Hybrid implementation of the Reverse Geocoder in the HybridReverseGeocoderService

Routing

Updates

  • Next instruction based on route path
  • Allow builders in copy functions to fail.
  • Use heading for route planning in sample app.

Fixes

  • Add missing signpost information and display it on NIP

Fixes

  • Add missing exit number information to NIP

version 0.2.1989 - 02/09/2022

Map

Fixes

  • Hiding hill shading by default
  • Remove ClassicSimultaneousGestureHandler and rename ModernSimultaneousGestureHandler to SimultaneousGestureHandler
  • Fix for map gestures

Search

Updates

  • Added E2E tests for Online Search
  • Added considering geoBias for CircleGeometry search and RectangleGeometry search

Routing

Updates

  • Replace Routing.LatLngBounds with Common.BoundingBox
  • Provide default arguments for Itinerary.waypoints.
  • Add heading to ItineraryPoint to use in future RoutePlanningOptions.
  • Expose traffic length information in the Route Summary

Fixes

  • TomTomRouteReplanningEngine uses vehicle heading for route refresh.
  • Only request alternatives in replanning when necessary.
  • Correct documentation for traffic incidents on routes with supporting points.
  • Expose Traffic Delay information in the onboard route and route leg summary.
  • Fixed two documentation snippets.

New features

  • Introduce TomTom Dynamic guidance engine

Updates

  • Display follow icon when the next manoeuvre is far away
  • Implement option to adapt TTS language to a message language

Fixes

  • Fix early announcements for "Bear" instructions

General

Updates

  • Completed the first round of iterations to improve the documentation to build a navigation app

version 0.2.1903 - 26/08/2022

General

New features

  • Expose onboard map structure (in English only)

Fixes

  • Camera tracking mode developer portal guide isn’t up to date

version 0.2.1869 - 19/08/2022

Map

Updates

  • Implemented style URL builder class

Fixes

  • Fixed route overview position marker vertical offset

Search

New features

  • Search POI along route by POI categories
  • Search POI along route by POI categories
  • Search POI along route by POI categories
  • Onboard POI category search
  • Onboard POI category search

Updates

  • Added possibililty to convert SearchResult to Place
  • Property Distance in Place uses Measurement<UnitLength&gt;
  • Modify names and types for the search public API properties with repsent Sets

Routing

New features

  • Routing request language

Fixes

  • Add phonetic alphabet to route generated in online mode
  • Adds missing toll payment type to toll road sections.
  • If exit direction in instruction is not specified explicitly, derive it from the driving side.
  • Request extendedSections by using ProgressPoints.

New features

  • Show next intersection name in Japan
  • Show next intersection name in Japan
  • Show next intersection name in Japan

Fixes

  • add missing road numbers for online mode
  • Fix missing manoeuvre mappings
  • Fixed the issue with ETA going down fast at the end of a long Trip.

General

Fixes

  • fix build error

version 0.2.1773 - 12/08/2022

Search

Fixes

  • Additional data API restored as part of SearchService

version 0.2.1732 - 05/08/2022

Map

New features

  • add new styles for Satellite

Search

Updates

  • Use OptionSet for resultTypes property in AutocompleteQuery struct.
  • update AutocompleteQuery struct, remove AutocompleteQueryBuilder class.

Fixes

  • Fix API documentation formatting for AlongRouteQuery struct.

New features

  • Add OnboardDataStoreUpdateContextEngine notifying map updater of position/route

Fixes

  • Fixed issue where sometimes deviation was not detected, and the route was never updated.

General

Updates

  • Remove "Go" prefix from classes.

Fixes

  • Fixed a bug where the map object and the corresponding store access handle were not refreshed after a map update.
  • Remove CLLocationCoordinate2D conformance to Hashable, Decodable and Encodable.

version 0.2.1661 - 29/07/2022

Map

New features

  • MapVisualisation tile provider integrated with StoreAccessSync.

Updates

  • NDSStore and NDSStoreAccess are now passed behind corresponding protocols instead of as concrete classes.
  • NDSStore and NDSStoreAccess are now passed behind corresponding protocols instead of as concrete classes.

Search

Updates

  • Added charging park to the Fuzzy Search response

Removals

  • JSON types removed from the Online Search API

Routing

Fixes

  • Disabled activity indicator when avoidance route gets loaded

New features

  • SoftDR (extrapolate) support in OnboardMapMatchingEngine
  • Prediction support in OnboardMapMatchingEngine
  • SoftDR (extrapolate) support in OnboardMapMatchingEngine
  • Prediction support in OnboardMapMatchingEngine

Updates

  • Now RouteReplanningEngine has only a generic replan method instead of replanToRefresh or replanOnDeviation.
  • Removed onError closure callback from start method in Navigation class. Added didStartOnRoute interface in TomTomNavigationDelegate. Added didStartFailWithError inteface in TomTomNavigationErrorDelegate
  • Now RouteReplanningEngine has only a generic replan method instead of replanToRefresh or replanOnDeviation.

Fixes

  • Fix missing map references after replanning route.

General

New features

  • Added TTMeasurement Decorator for Measurement object, this enables easy conversion and initialization for Measurements.
  • Added TTMeasurement Decorator for Measurement object, this enables easy conversion and initialization for Measurements.

Removals

  • Measurement convenience initializers. This would possibly create conflicts with other SDKs.
  • Measurement convenience initializers. This would possibly create conflicts with other SDKs.

version 0.2.1607 - 20/07/2022

Fixes

  • Fix missing map references after replanning route.

version 0.2.1588 - 15/07/2022

Map

Fixes

  • Onboard map not shown on devices with non-latin1 locale

General

Updates

  • A new tutorial to build a navigation app was created.

version 0.2.1538 - 08/07/2022

Map

Fixes

  • Fixed missing country names on map by setting a default language
  • Improve naming in the public API types and methods List of changes:
  • Fixed issue when single tap was reported along to long press gesture

Search

Updates

  • Added mappings for the onboard reverse geocoder response for the folowwing properties: municipalitySubdivision,neighborhoodName and countrySubdivisionCode

Routing

Updates

  • Made "language" parameter in RoutingOptions default to device language.

New features

  • Added the possibility to specify the language in TomTomGuidanceEngine. If not specified device language will be used.

Updates

  • Add predictions property to MapMatchingResult struct

Fixes

  • Fixed crash where having 12H instead of 24H set up in date settings would cause the app to randomly crash when starting navigation.
  • Return the correct error for computation timeout.

General

Updates

  • Api reference documentation updated for TomTomSDKRoute module.

version 0.2.1455 - 01/07/2022

Map

New features

  • Dedicated sky color for light/dark mode
  • createDirectionUpFollowCameraOperator() is expose in GO SDK

New features

  • Now when a location is map matched, it will also return additional information about the route i’ds being followed.

Fixes

  • Added unit system setting on navigation Views. Now it is possible to set different imperial or metric units.

General

Updates

  • Project setup guides updated with information about required credentials for navigation modules
  • Separate project setup guides for maps and navigation.

Fixes

  • Fix crash when removing observer twice.

version 0.2.1400 - 21/06/2022

Routing

Updates

  • Improve documentation of RoutingService/RoutingOptions

version 0.2.1384 - 17/06/2022

Map

Updates

  • Added Support for V2.1 styles
  • Update layer_mapping.json
  • Update to CameraOptions and CameraProperties documentation
  • Replace Objective-C types used in public Swift API

Fixes

  • Error Handler for Invalid Zoom Level Configurations

Search

Updates

  • Added Search UI documentation
  • Add experimental API annotation to public APIs in GoSDKOnboardReverseGeocoder and GoSDKOnboardSearch
  • Add public preview API annotations to the GoSDKOnlineReverseGeocoder framework
  • Add public preview API annotation to APIs in the GoSDKSearch framework.
  • Add public preview API annotations to public API in the GoSDKOnlineSearch framework.

Routing

New features

  • Provide NDS map references in onboard routes
  • Provide NDS map references in onboard routes
  • Avoid areas in onboard routing
  • Avoid areas in onboard routing
  • Now, while planning a route, the correct form to calculate the route, regular or extended, is used depending on the options set.

Updates

  • Fixed misspelling in PedestrianSection struct name
  • Add carpool section type and urban section type to SectionType for the routing request.

Removals

  • Remove redundant trafficDelayInSeconds from
  • Remove redundant travelTimeInSeconds from
  • Remove redundant lengthInMeters
  • Remove unsupported TransportMode

Fixes

  • RouteSummaryView: fix frame with show correct view
  • Fix wrong distance to instruction after refreshing route.
  • Fixes unwanted departure guidance after route replanning.
  • Fix for distances to instructions being incorrect after updating navigatino with a better route.

General

Updates

  • Updated NK2 iOS component to Cross-platform BoM 77.19.10
  • Add carpool sections and urban sections to GoSDKRoute.Route

Fixes

  • Fixed crash when location predictions with negative speed are generated

Version 0.2.1182 - 27/05/2022

Map

Fixeses

  • Fixed a crash when map view is deallocated
  • Fixed a crash caused by mapKey placeholder not replaced when loading custom style
  • Fixed an incorrect route bringToFront behaviour resulting in inability to change route order to front one

Search

Deprecations

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

iOS version 0.2.1139

Updates:

  • information about missing layers exposed in Diagnostic API

iOS version 0.2.1126

Bug fixes:

  • Fix for a crash when the useMetalGraphicsBackend feature toggle is enabled
  • Fix for a crash when changing Custom style
  • Fix for incorrect route replanning reason ".unreachable"
  • Fix for a speed bubble colour not depended on current speed and speed limit
  • Fix for misspelled "Engine" in API DefaultMapMatchingEnigne

iOS version 0.2.1101

Updates:

  • Moved GoSDKCommon.Route related classes/protocols to new GoSDKRoute module

iOS version 0.2.1092

Bug fixes:

  • Fix for incorrect lane guidance after route replanning

iOS version 0.2.1050

Updates:

  • Improved documentation for map overlays
  • Added documentation for route replanning after deviation
  • Added voice instructions documentation
  • Added documentation guide for pins shrinking and fading

Bug fixes:

  • Fix for map springing back in opposite direction after panning
  • Fix for occasional discrepancies in directional arrows
  • Fix for polar cups not matching surrounding colour
  • Fix for Camera Operator zooming not working
  • Fix for logo visible briefly during map initialization

iOS version 0.2.1019

Bug fixes:

  • Fix for no arrival announcement

iOS version 0.2.967

New features:

  • Switch to online fonts
  • Search UI
  • Map overlays
  • Pin shrinking and fading
  • Update of map’s style file
  • Add "Route updated" notification to the UI component

Updated features:

  • Destruction of services
  • Change type of GeoLocation.timeMillis property to "Date"
  • Metric ranges for for visual instructions in NIP are not according to the spec
  • Imperial ranges for for visual instructions in NIP are not according to the spec
  • No route planning in progress screen

Bug fixes:

  • Documentation of AccuracyIndicatorType
  • Wrong location indicator after changing styleMode
  • Style Parsing Error with custom map style
  • Street name font size won’t change to driving view zoom level
  • Map gestures not working correctly
  • In Driving mode, panning of map always results in map moving down-side
  • First SLG infois not displayed in the route
  • Incorrect TTS translation for 1km
  • SLG triggering points are not same as android
  • Pan gesture works incorrectly when in camera follow the chevron mode
  • Verbal messages duplicated after route refresh