Release Notes
version 0.39.1 - 28/11/2023
General
Fixes
- Fix crash on start-up in online-only mode
version 0.39.0 - 27/11/2023
General
Breaking changes
- Change a public API
com.tomtom.sdk.common.SystemClock
to internal. Add documentation tocom.tomtom.sdk.common.SystemClock
. - Fix api states for feature toggles.
- Removed package
com.tomtom.sdk.map.display.dataprovider.featuretoggle
[RemovedPackage] - Removed package
com.tomtom.sdk.map.display.featuretoggle
[RemovedPackage] - Removed package
com.tomtom.sdk.routing.featuretoggle
[RemovedPackage]
- Removed package
- Move
com.tomtom.sdk.vehicle.DefaultVehicleProvider
to internal. Default vehicle provider is expected to be created viacom.tomtom.sdk.vehicle.VehicleProviderFactory.create
(). - Remove unused
NavigationTileFeatureType
.
Updates
- Add external build configurations to public examples.
- Add missing API documentation for Force.
- Add missing documentation for several classes in Quantity.
Location
Breaking changes
- Hide internal property value in
com.tomtom.sdk.location.EntryType
.
Updates
com.tomtom.sdk.location.EntryPoint
andcom.tomtom.sdk.location.EntryType
are now available in General Availability.- Add missing documentation for
GeoPoint
.
Map
Breaking changes
- Add
ActiveRouteChangedListener
and update logic forRouteUpdated
in NavViz. - Change the type of
safetyLocationId
incom.tomtom.sdk.map.display.visualization.navigation.horizon.safetylocation.SafetyLocationElement
fromcom.tomtom.sdk.navigation.horizon.elements.safetylocation.SafetyLocationId
tocom.tomtom.sdk.safetylocations.model.SafetyLocationId
. - Make
NavigationTileStoreAccess
ctor internal.
New Features
- Add to the
elastic-data-provider
module methods for prefetching areas and routes.
Fixes
- Make Map ScaleView default to a unit based on the user's locale.
Updates
- Added a configurable minimum zoom level for the
TrafficDataProvider
.
Navigation
Breaking changes
- Fix API state of horizon RPC adapter.
- Refactor the
com.tomtom.sdk.navigation.RouteUpdateReason
to contain only thecom.tomtom.sdk.navigation.RouteUpdateReason.Refresh
andcom.tomtom.sdk.navigation.RouteUpdateReason.Increment
values. To observe route changes caused by the removed reasons use thecom.tomtom.sdk.navigation.RouteAddedListener
,com.tomtom.sdk.navigation.RouteRemovedListener
, andcom.tomtom.sdk.navigation.ActiveRouteChangedListener
. - Remove package
com.tomtom.sdk.navigation.horizon.elements.region
. Remove constructorcom.tomtom.sdk.navigation.horizon.elements.countryinformation.CountryInformationElement
(int,int,long,long,String,String,int,com.tomtom.quantity.Speed.Unit
,java.util.List<`com.tomtom.sdk.navigation.horizon.elements.countryinformation.RegionalSpeedLimit`>). Usecom.tomtom.sdk.navigation.horizon.elements.countryinformation.CountryInformationElement.countryName
instead ofcom.tomtom.sdk.navigation.horizon.elements.region.RegionElement.country
. Usecom.tomtom.sdk.navigation.horizon.elements.countryinformation.CountryInformationElement.regionName
instead ofcom.tomtom.sdk.navigation.horizon.elements.region.RegionElement.subCountry
. - Remove SafetyLocationType and SafetyLocationId from
com.tomtom.sdk.navigation.horizon.elements.safetylocation
package since they are no longer needed (previously they were used incom.tomtom.sdk.navigation.horizon.elements.safetylocation.SafetyLocationElement
). - Remove the
com.tomtom.sdk.navigation.ReplannedRouteProposedListener
. Use thecom.tomtom.sdk.navigation.RouteAddedListener
instead to listen for the better route proposal being added to the navigation session. The proposed route is added with thecom.tomtom.sdk.navigation.RouteAddedReason.BetterRouteProposed
reason. - Remove the
com.tomtom.sdk.navigation.RouteDeviationListener
. Use thecom.tomtom.sdk.navigation.RouteTrackingStateUpdatedListener
instead to listen for the followed and unfollowed routes. To check if the user deviated from the route, you can use the RouteTrackingState.hasDeviated property. - Removed
LocationContextEngine
interface. - Removed class
com.tomtom.sdk.navigation.mapmatching.common.RouteWindow
. Removed method`com.tomtom.sdk.navigation.mapmatching.common.RouteWindow.kt.toRouteWindow`(RouteSnapshot, Distance, Distance)Removed method`com.tomtom.sdk.navigation.routeprojection.unified.UnifiedRouteProjectionEngineFactory.create
(StoreAccessProvider, RouteProjectionEngineOptions)` - Rename
com.tomtom.sdk.navigation.horizon.elements.countryinformation.CountryInformationElement.countryCode
tocom.tomtom.sdk.navigation.horizon.elements.countryinformation.CountryInformationElement.countryCodeIso3
. - Use
com.tomtom.sdk.safetylocations.model.SafetyLocation
incom.tomtom.sdk.navigation.horizon.elements.safetylocation.SafetyLocationElement
instead ofsafetyLocationId
,startPosition
,endPosition
,boundingBox
,type
,speedLimit
,recommendedWarningDistance
, andisZone
properties.
Fixes
- Fix crash for re-creating openLR decoder.
Updates
OffboardNavigationTileStore
now supports prefetching navigation tiles along a given polyline.- Improve API documentation for
com.tomtom.sdk.navigation.guidance.instruction.GuidanceInstruction
. - Promote
LocationContext
to GA. - Update API documentation:
com.tomtom.sdk.navigation.GuidanceUpdatedListener
.
Routing
Fixes
- Leaking of native-allocated memory. This should prevent the crashes related to
std::bad_alloc
, related to running out of memory.
Search
Fixes
- Fix for a crash while creating of online search engine instance with custom pois support.
- Fix searching with personal locations and custom poi.
version 0.38.0 - 21/11/2023
General
Breaking changes
- Announce updated properties via
VehicleUpdateListener
in packagecom.tomtom.sdk.vehicle
. - Remove adding specific vehicle property listeners of
VehicleProvider
in packagecom.tomtom.sdk.vehicle
. - Rename
DefaultVehicleProvider.updateVehicleState
toDefaultVehicleProvider.updateVehicle
in packagecom.tomtom.sdk.vehicle
.
Updates
- Add
updateVehicle
andsetVehicle
fromDefaultVehicleProvider
toVehicleProvider
interface in packagecom.tomtom.sdk.vehicle
. - Add missing API documentation for SystemClockTimeProvider.
- Add missing API documentation for UniqueId.
- Add missing API documentation for Uris.
- Add missing documentation for
ViewBoundaries
. - Add missing documentation for Feature.
- Add missing documentation for FeatureCollection.
- Add missing documentation for Polygon.
- Add missing documentation for Result.
- Improve inline documentation of
PropertyId
incom.tomtom.sdk.vehicle.property.PropertyId
. - Improve inline documentation of each
VehicleProperty
,ElectricEngineProperty
, andCombustionEngineProperty in `com.tomtom.sdk.vehicle.property
.
Location
Updates
- Add missing documentation for
AndroidLocationProvider
. - Add missing documentation for
AndroidLocationProviderConfig
. - Add missing documentation for
GeoBias
. - Add missing documentation for
GeoBounds
. - Add missing documentation for
GmsLocationProvider
. - Add missing documentation for
MapMatchedLocationProvider
. - Add missing documentation for
ProxyLocationProvider
andSimulationLocationProvider
. - Add missing information about
Place
. - Improve kDocs of
TimestampStrategy
,InterpolationStrategy
.
Map
Breaking changes
DataProviderFactory
is for internal use.
Fixes
- Fix API doc.
undefined
- Introduce on-route traffic developer portal documentation.
Updates
- Add performance test for display route with data and clear route.
- Expand demo app with search visualization EV station.
- Release note message.
- Update default Genesis style to 25.1., fix the default Orbis style to 0.2..
- Update Orbis map copyrights endpoint.
Navigation
Breaking changes
RouteStopProgress
component functions removed.RouteStopProgress
copy removed.- Downgrade API state from public preview to experimental for
com.tomtom.sdk.navigation.horizon.dataadapter.safetylocations.online.OnlineSafetyLocationsDataAdapterFactory
andcom.tomtom.sdk.navigation.horizon.dataadapter.SafetyLocationDataObject
as they depend on the experimental feature. APIs forsafetylocations
will be promoted in a later stage. - Remove
com.tomtom.sdk.navigation.horizon.HorizonOptions.minDistanceAhead
and addcom.tomtom.sdk.navigation.horizon.MainPathSearchOptions.minDistanceAhead
. - Remove default values for
RouteStopProgress
properties. - Remove location context provider engine from
Configuration
,TomTomNavigationFactory
, andNavigationContext
. - Remove public setters from
AdasisConfiguration
andTopology
configuration classes. - Remove the default value for
com.tomtom.sdk.navigation.horizon.ExplicitDistancePolicy.searchDistance
. - Remove the default value for
com.tomtom.sdk.navigation.horizon.PathSearchDistance.maxHorizonLength
. - Removed class
com.tomtom.sdk.navigation.mapmatching.common.MakeRouteWindowKt
. Removed methodcom.tomtom.sdk.navigation.mapmatching.common.MappersKt.toFallbackMapMatchingResult
(com.tomtom.sdk.navigation.LocationSnapshot
)` - Rename RouteStopsProgress to RouteStopProgress.
- Resolve dependency of public APIs on internal APIs in
com.tomtom.sdk.datamanagement
.
Fixes
- Avoid
ConcurrentModificationException
upon network availability changes.
Updates
Com.tomtom.sdk.navigation.addLanguageChangedListener(LanguageChangedlListener)
is now available in General Availability.Com.tomtom.sdk.navigation.LanguageChangedlListener
is now available in General Availability.Com.tomtom.sdk.navigation.removeLanguageChangedListener(LanguageChangedlListener)
is now available in General Availability.- Add missing API documentation for
AnnouncementMode
. - Bring
DataStoreSelectionStrategy
into public preview. - Describe
RouteAddedListener
,RouteRemovedListene`r, and `ActiveRouteChangedListener
in the documentation. Provide an example in the Building a navigation app tutorial on how to redraw a route when the replanning has been completed. - Improve kDocs of
AnnouncementType
. - Improve kDocs of
LaneGuidanceUpdate
. - Move Safety Locations API from experimental to PP.
- Promote
RouteStopProgress
to General Availability. - Refine horizon regional speed limit comment.
- Update API documentation:
com.tomtom.sdk.navigation.LaneGuidanceUpdatedListener
.
Routing
Breaking changes
- Extend
com.tomtom.sdk.routing.route.section.Section
with newcom.tomtom.sdk.routing.route.section.Section.sectionLocation
property. - Remove default values for ChargingOptions.
- Remove internal infrastructure functions from the public interface.
Deprecations
- Deprecate
com.tomtom.sdk.routing.route.section.Section.geometry
property in favor ofcom.tomtom.sdk.routing.route.section.Section.sectionLocation
.
Fixes
- Fix flaky CI tests.
- Mitigate crashes by sanitizing online route sections.
Updates
Com.tomtom.sdk.routing.route.Consumption
is now available in General Availability.
Search
Breaking changes
- Convert
EntryPoint
from data class to normal class. - Remove unneeded experimental generated data class class methods from POI.
Deprecations
- Deprecate unneeded generated data class class methods from Poi.
Fixes
- Fix searching with hybrid, where result type filters other than POI return nothing.
Updates
accessibleVehicleTypes
andfuelTypes
members in the classcom.tomtom.sdk.location.poi.Poi
are now available in General Availability.Search.sendFeedback
is now available in General Availability.
version 0.37.0 - 14/11/2023
General
Breaking changes
- Rename AdrTunnelRestrictionCodeProperty.option to AdrTunnelRestrictionCodeProperty.id in package
com.tomtom.sdk.vehicle.property.engine.electric
. - Rename AltitudeChangeEfficiencyProperty.option to AltitudeChangeEfficiencyProperty.id in package
com.tomtom.sdk.vehicle.property.engine
. - Rename AltitudeChangeEnergyProperty.option to AltitudeChangeEnergyProperty.id in package
com.tomtom.sdk.vehicle.property.engine.combustion
. - Rename AuxiliaryPowerProperty.option to AuxiliaryPowerProperty.id in package
com.tomtom.sdk.vehicle.property.engine.combustion
. - Rename AxleWeightProperty.option to AxleWeightProperty.id in package
com.tomtom.sdk.vehicle.property
. - Rename BatteryCurveProperty.option to BatteryCurveProperty.id in package
com.tomtom.sdk.vehicle.property.engine.electric
. - Rename ChargingConnectorsProperty.option to ChargingConnectorsProperty.id in package
com.tomtom.sdk.vehicle.property.engine.electric
. - Rename ChargingTimeOffsetProperty.option to ChargingTimeOffsetProperty.id in package
com.tomtom.sdk.vehicle.property.engine.electric
. - Rename CombustionEngineProperties.option to CombustionEngineProperties.id in package
com.tomtom.sdk.vehicle.property
. - Rename CommercialVehicleProperty to IsCommercialProperty in
com.tomtom.sdk.vehicle.property
. - Rename CommercialVehicleProperty.option to CommercialVehicleProperty.id in package
com.tomtom.sdk.vehicle.property
. - Rename CurrentChargeProperty.option to CurrentChargeProperty.id in package
com.tomtom.sdk.vehicle.property.engine.electric
. - Rename CurrentFuelProperty.option to CurrentFuelProperty.id in package
com.tomtom.sdk.vehicle.property.engine.combustion
. - Rename ElectricEngineProperties.option to ElectricEngineProperties.id in package
com.tomtom.sdk.vehicle.property
. - Rename FuelEnergyDensityProperty.option to FuelEnergyDensityProperty.id in package
com.tomtom.sdk.vehicle.property.engine.combustion
. - Rename HeightProperty.option to HeightProperty.id in package
com.tomtom.sdk.vehicle.property
. - Rename LengthProperty.option to LengthProperty.id in package
com.tomtom.sdk.vehicle.property
. - Rename LoadTypeProperty.option to LoadTypeProperty.id in package
com.tomtom.sdk.vehicle.property
. - Rename MaxChargeProperty.option to MaxChargeProperty.id in package
com.tomtom.sdk.vehicle.property.engine.electric
. - Rename MaxSpeedProperty.option to MaxSpeedProperty.id in package
com.tomtom.sdk.vehicle.property
. - Rename PropertyId.CommercialVehicle to PropertyId.IsCommercial in
com.tomtom.sdk.vehicle.property.PropertyId
. - Rename SpeedConsumptionProperty.option to SpeedConsumptionProperty.id in package
com.tomtom.sdk.vehicle.property.engine.combustion
. - Rename SpeedConsumptionProperty.option to SpeedConsumptionProperty.id in package
com.tomtom.sdk.vehicle.property.engine.electric
. - Rename VehicleUpdateOption to PropertyId in package
com.tomtom.sdk.vehicle
. - Rename vehicleUpdateOptions parameter to trackedProperties in addVehicleUpdatedListener method of DefaultVehicleProvider in package
com.tomtom.sdk.vehicle
. - Rename VelocityChangeEfficiencyProperty.option to VelocityChangeEfficiencyProperty.id in package
com.tomtom.sdk.vehicle.property.engine
. - Rename WeightProperty.option to WeightProperty.id in package
com.tomtom.sdk.vehicle.property
. - Rename WidthProperty.option to WidthProperty.id in package
com.tomtom.sdk.vehicle.property
.
Deprecations
- Deprecate and replace decimal bytes units with binary ones. Do the following to adapt your project to these API changes:
- Replace usage of the
Memory.Unit.Kilobytes
object with theMemory.Unit.Kibibytes
. - Replace usage of the
Memory.Unit.Megabytes
object with theMemory.Unit.Mibibytes
. - Replace usage of the
Memory.Unit.Gigabytes
object with theMemory.Unit.Gibibytes
. - Replace usage of the
Memory.inBytes()
api with theMemory.inWholeBytes()
. - Replace usage of the
Memory.inKilobytes()
api with theMemory.inKibibytes()
. - Replace usage of the
Memory.inMegabytes()
api with theMemory.inMibibytes()
. - Replace usage of the
Memory.inGigabytes()
api with theMemory.inGibibytes()
. - Replace usage of the
Memory.inWholeKilobytes()
api with theMemory.inWholeKibibytes()
. - Replace usage of the
Memory.inWholeMegabytes()
api with theMemory.inWholeMibibytes()
. - Replace usage of the
Memory.inWholeGigabytes()
api with theMemory.inWholeGibibytes()
. - Replace usage of the
Memory.bytes(value: Double)
api withMemory.bytes(value: Long)
orMemory.bytes(value: Int)
- Replace usage of the
Memory.kilobytes(value: Int)
api with theMemory.kibibytes(value: Int)
. - Replace usage of the
Memory.kilobytes(value: Long)
api with theMemory.kibibytes(value: Long)
. - Replace usage of the
Memory.kilobytes(value: Double)
api with theMemory.kibibytes(value: Double)
. - Replace usage of the
Memory.megabytes(value: Int)
api with theMemory.mibibytes(value: Int)
. - Replace usage of the
Memory.megabytes(value: Long)
api with theMemory.mibibytes(value: Long)
. - Replace usage of the
Memory.megabytes(value: Double)
api with theMemory.mibibytes(value: Double)
. - Replace usage of the
Memory.gigabytes(value: Int)
api with theMemory.gibibytes(value: Int)
. - Replace usage of the
Memory.gigabytes(value: Long)
api with theMemory.gibibytes(value: Long)
. - Replace usage of the
Memory.gigabytes(value: Double)
api with theMemory.gibibytes(value: Double)
.
- Replace usage of the
- Deprecate the extension Result<R, L>.toEither.
Map
Updates
com.tomtom.sdk.map.display.route.RouteSection
is now available in General Availability.
Navigation
Breaking changes
- Rename
com.tomtom.sdk.navigation.ui.NavigationUiOptions.units
tocom.tomtom.sdk.navigation.ui.NavigationUiOptions.unitSystemType
. - Replace
com.tomtom.sdk.common.measures.UnitSystem
withcom.tomtom.sdk.navigation.UnitSystemType
incom.tomtom.sdk.navigation.ui.NavigationUiOptions
. - Replace
TomTomNavigation::acceptProposedRoute
withTomTomNavigation::selectActiveRoute
.
New Features
- Add new route as active to the session when language is changed and inform integrator.
- Introduce the
ActiveRouteChangedListener
to inform about the active route changes in the navigation session. - Introduce the RouteAddedListener to inform about new routes added to the navigation session.
- Introduce the RouteRemovedListener to inform about routes removed from the navigation session.
- Use Virtual Horizon to get location context information beyond driver's visible horizon. A guide for how to retrieve horizon data has been made available in our Nav SDK documentation.
Fixes
- Display 'Fixed Speed Camera' type correctly.
Updates
Com.tomtom.sdk.navigation.TomTomNavigation.language
is now available in General Availability.Com.tomtom.sdk.navigation.TomTomNavigation.preferredLanguage
is now available in General Availability.Com.tomtom.sdk.navigation.TomTomNavigation.unitSystem
is now available in General Availability.- Add parcelable support to
com.tomtom.sdk.navigation.UnitSystemType
. - Change default guidance engine to DynamicGuidanceEngine.
- Copy the description of inherited properties from GuidanceInstruction.
- Log necessary information about navigation's configuration.
Routing
New Features
- Separate avoid tolls and vignettes.
Fixes
- LDEV now supports replanning after deviation.
Updates
- Allow requesting a route without instructions.
Search
Breaking changes
- Make toPlace in Search UI internal.
- Move Poi, PoiCategory, CategoryId, OpeningHours, OpeningHoursMode, ChargingPark, PoiId, Source, StandardCategoryId classes from Search to Location. And move FuelType to Vehicle.
Move or rename
com.tomtom.sdk.search.model.poi.Poi
tocom.tomtom.sdk.location.poi.Poi
Move or renamecom.tomtom.sdk.search.model.poi.PoiId
tocom.tomtom.sdk.location.poi.PoiId
Move or renamecom.tomtom.sdk.search.model.result.Source
tocom.tomtom.sdk.location.poi.Source
Move or renamecom.tomtom.sdk.search.model.poi.PoiCategory
tocom.tomtom.sdk.location.poi.PoiCategory
Move or renamecom.tomtom.sdk.search.model.poi.CategoryId
tocom.tomtom.sdk.location.poi.CategoryId
Move or renamecom.tomtom.sdk.search.model.poi.StandardCategoryId
tocom.tomtom.sdk.location.poi.StandardCategoryId
Move or renamecom.tomtom.sdk.search.model.poi.Brand
tocom.tomtom.sdk.location.poi.Brand
Move or renamecom.tomtom.sdk.search.model.time.OpeningHours
tocom.tomtom.sdk.location.poi.time.OpeningHours
Move or renamecom.tomtom.sdk.search.model.time.OpeningHoursMode
tocom.tomtom.sdk.location.poi.time.OpeningHoursMode
Move or renamecom.tomtom.sdk.search.model.fuel.FuelType
tocom.tomtom.sdk.vehicle.FuelType
Fixes
- Make search find streets and addresses when searched along with a search area.
- Use proper timezone for custom POI in the offline search engine.
Updates
- Remove annotation which is not in use anymore.
- The
ExperimentalHybridReverseGeocoderApi
annotation is not needed anymore, the API is already in GA
- The
Traffic
Updates
- Added new TrafficClient implementation.
version 0.36.0 - 03/11/2023
General
Breaking changes
- Rename AdrTunnelRestrictionCodeParameter to AdrTunnelRestrictionCodeProperty.
- Rename AltitudeChangeEfficiencyParameter to AltitudeChangeEfficiencyProperty and move to package
com.tomtom.sdk.vehicle.property.engine
. - Rename AltitudeChangeEnergyParameter to AltitudeChangeEnergyProperty and move to package
com.tomtom.sdk.vehicle.property.engine.electric
. - Rename AuxiliaryFuelPower to AuxiliaryPowerProperty and move to package
com.tomtom.sdk.vehicle.property.engine.combustion
. - Rename AuxiliaryPower to AuxiliaryPowerProperty and move to package
com.tomtom.sdk.vehicle.property.engine.electric
. - Rename BatteryCurve to BatteryCurveProperty and move to package
com.tomtom.sdk.vehicle.property.engine.electric
. - Rename ChargingConnectors to ChargingConnectorsProperty and move to package
com.tomtom.sdk.vehicle.property.engine.electric
. - Rename ChargingTimeOffset to ChargingTimeOffsetProperty and move to package
com.tomtom.sdk.vehicle.property.engine.electric
. - Rename CombustionEngineParameter to CombustionEngineProperty and move to package
com.tomtom.sdk.vehicle.property.engine
. - Rename CombustionEngineParameters to CombustionEngineProperties.
- Rename CurrentCharge to CurrentChargeProperty and move to package
com.tomtom.sdk.vehicle.property.engine.electric
. - Rename CurrentFuel to CurrentFuelProperty and move to package
com.tomtom.sdk.vehicle.property.engine.combustion
. - Rename ElectricEngineParameter to ElectricEngineProperty and move to package
com.tomtom.sdk.vehicle.property.engine
. - Rename ElectricEngineParameters to ElectricEngineProperties.
- Rename FuelEnergyDensity to FuelEnergyDensityProperty and move to package
com.tomtom.sdk.vehicle.property.engine.combustion
. - Rename LoadType to LoadTypeProperty.
- Rename MaxCharge to MaxChargeProperty and move to package
com.tomtom.sdk.vehicle.property.engine.electric
. - Rename MaxSpeed to MaxSpeedProperty.
- Rename package
com.tomtom.sdk.vehicle.parameters
tocom.tomtom.sdk.vehicle.property
. - Rename parameter updatedParameters to updatedProperties in method updateVehicleState of DefaultVehicleProvider.
- Rename SpeedConsumption to SpeedConsumptionProperty and move to package
com.tomtom.sdk.vehicle.property.engine.electric
. - Rename SpeedFuelConsumption to SpeedConsumption and move to package
com.tomtom.sdk.vehicle.property.engine.combustion
. - Rename VehicleHeight to HeightProperty.
- Rename VehicleLength to LengthProperty.
- Rename VehicleParameter to VehicleProperty.
- Rename VehicleUpdateOption.AuxiliaryFuelPower to VehicleUpdateOption.CombustionAuxiliaryPower.
- Rename VehicleUpdateOption.AuxiliaryPower to VehicleUpdateOption.ElectricAuxiliaryPower.
- Rename VehicleUpdateOption.SpeedConsumption to VehicleUpdateOption.ElectricSpeedConsumption.
- Rename VehicleUpdateOption.SpeedFuelConsumption to VehicleUpdateOption.CombustionSpeedConsumption.
- Rename VehicleWidth to WidthProperty.
- Rename VelocityChangeEfficiencyParameter to VelocityChangeEfficiencyProperty and move to package
com.tomtom.sdk.vehicle.property.engine
.
Fixes
- Reconnect to mqtt after a disconnection.
- Reduce number of dependencies in unified location decoder module.
Updates
- Add API docs to RangeCalculator implementations.
Map
New Features
- Add support of camera operators, camera updates and gestures for Premium map display.
Fixes
- Fix a
ElasticMapStore
crash upon screen rotation. - Fix missing link in API documentation.
Updates
- Map Display Copyrights component tests.
Navigation
Breaking changes
- Rename the module dependencies for
onboard-nds-store
. Do the following to adapt your project setup: - Replace
com.tomtom.sdk:onboard-nds-store
withcom.tomtom.sdk.datamanagement:nds-store
for the dependency setup in the gradle files.
Fixes
- Disable flaky test unifiedMapDataAccessHandleIsCreated.
- Fix manual route acceptance.
- Remove finalize from native offboard tile store.
Updates
- Remove Server3FeatureToggle.
Routing
Deprecations
- Deprecate value class
com.tomtom.sdk.routing.options.calculation.ComputeTravelTimeFor
.
Updates
- Com.tomtom.sdk.routing.route.section.traffic.MagnitudeOfDelay is now available in General Availability.
Search
Breaking changes
- Improve the API interface for custom POI provider.
Use
com.tomtom.sdk.search.customdata.CustomPoiProvider
instead ofcom.tomtom.sdk.search.customdata.CustomSearchDataProvider
. Usecom.tomtom.sdk.search.customdata.CustomPoi
instead ofcom.tomtom.sdk.search.model.customdata.CustomRecord.CustomPoi
. OfflineSearch, OnlineWithCustomPoiSearch and HybridSearch overloaded factory method create takesList<CustomPoiProvider>
instead ofList<CustomSearchDataProvider<CustomRecord.CustomPoi>>
Updates
- Add missing Poi category Ids.
- Promote structured search API public preview to General Availability.
version 0.35.0 - 31/10/2023
General
Breaking changes
- The
com.tomtom.sdk.datamanagement.nds.update.compositeregion.CompositeRegion
is no longer a data class. - The
com.tomtom.sdk.datamanagement.nds.update.compositeregion.CompositeRegionGraph
is no longer a data class. - The
com.tomtom.sdk.datamanagement.nds.update.compositeregion.CompositeRegionId.value
property is no longer a public one. - The
com.tomtom.sdk.datamanagement.nds.update.compositeregion.CompositeRegionOperation
is no longer a data class. - The
com.tomtom.sdk.datamanagement.nds.update.compositeregion.CompositeRegionState
is no longer a data class. - The
com.tomtom.sdk.datamanagement.nds.update.compositeregion.CompositeRegionStatesData
is no longer a data class. - The
com.tomtom.sdk.datamanagement.nds.update.compositeregion.CurrentCompositeRegionOperation
is no longer a data class.
Fixes
- Fixed increase in apk size due to number of dependencies.
- Remove superfluous closing brace from `NdsStore.create.
- Resolve a MissingResourceException when trying to use online safety locations with the horizon engine.
Updates
- Add nanodegrees unit to Angle and Angle getter to GeoPoint.
- Improve kdoc for the various
ConnectorType
values. - Log RuntimeFeature toggle changes.
- Mark all experimental API annotation class
Experimental*Api
as experimental.
Map
New Features
- Add the ability to set POI click listener for the ones found through Search feature.
- Extend SearchConfiguration API from Search visualization module.
- Implement setting style in premium map display.
- Introduce the Elastic Data Provider API for map visualization.
- Simple route visualization in premium map display.
Fixes
- Fix crash in premium map display when trying to access protobuf messages.
- Fix maneuver arrows.
Updates
- Add component tests for the
com.tomtom.sdk.map.display.map
. - Move the NavigationEventDispatcher and FollowCameraConfiguration to public preview.
- Promote to GA:
RouteOptions class with all the fields: -
geometry: List<GeoPoint>
-color: Int
-outlineWidth: Double
-widths: List<WidthByZoom>
-visible: Boolean
-progress: Distance
-instructions: List<Instruction>
-tag: String?
-departureMarkerVisible: Boolean
-destinationMarkerVisible: Boolean
-isFollowable: Boolean
-routeOffset: List<Distance>
-sections: List<RouteSection>
-departureMarkerPinImage: Image?
-destinationMarkerPinImage: Image?
-departure: GeoPoint?
-destination: GeoPoint?
RouteSection class with all the fields: -type: RouteSectionType
-indexRange: IntRange
-textureUri: Uri?
Navigation
Breaking changes
- Introduce
com.tomtom.sdk.navigation.TomTomNavigation.preferredLanguage
property for updating current navigation language. - Make
com.tomtom.sdk.navigation.TomTomNavigation.language
property read only. - Remove
com.tomtom.sdk.navigation.NavigationHistorySnapshot
class. - Remove
com.tomtom.sdk.navigation.replanning.MaintainRoutesMode
parameter from thecom.tomtom.sdk.navigation.TomTomNavigationFactory
factory method. - Remove
com.tomtom.sdk.navigation.replanning.MaintainRoutesMode
property from thecom.tomtom.sdk.navigation.hybrid.Configuration
. - Remove
com.tomtom.sdk.navigation.replanning.MaintainRoutesMode
property from thecom.tomtom.sdk.navigation.offline.Configuration
. - Remove
com.tomtom.sdk.navigation.replanning.MaintainRoutesMode
property from thecom.tomtom.sdk.navigation.offroad.Configuration
. - Remove
com.tomtom.sdk.navigation.replanning.MaintainRoutesMode
property from thecom.tomtom.sdk.navigation.online.Configuration
. - Remove
com.tomtom.sdk.navigation.replanning.MaintainRoutesMode
. - Rename
com.tomtom.sdk.navigation.TomTomNavigation.markWaypointAsVisited
. - Revise persistent cache configuration parameters.
- The
com.tomtom.sdk.datamanagement.navigationtile.NavigationTileStoreConfiguration
is no longer a data class. - Use common safety location data in horizon adapter.
New Features
- Introduce
com.tomtom.sdk.navigation.TomTomNavigation.deviationReplanningMode
property for updating current deviation replannig mode. - Introduce a new API NdsStore.findRegionsAlongPolyline.
Fixes
- "Build a navigation app" use case tutorial invokes navigation start on route click only if navigation is not already running.
- Call start and shutdown for mock tile server.
- Crash in TomTomNavigation.stop.
- Fix crash in traffic module due to missing method.
- Improvement in native pointer handling.
Updates
- "Build a navigation app" renamed to "Building a navigation app".
- Com.tomtom.sdk.navigation.DestinationArrivalListener is now available in General Availability.
- Com.tomtom.sdk.navigation.TomTomNavigation.addDestinationArrivalListener.
- Com.tomtom.sdk.navigation.TomTomNavigation.departFromWaypoint.
- Com.tomtom.sdk.navigation.TomTomNavigation.removeDestinationArrivalListener.
- Com.tomtom.sdk.navigation.WaypointArrivalListener is now available in General Availability.
- Move Artifactory instructions from the project setup guide.
- NavigationOptions is now in General Availability.
- Prefetch navigation tiles along the active route. Prefetching affects data consumption (downloading tiles) from the cloud when route is activated
- Promote
com.tomtom.sdk.navigation.TomTomNavigation.addWaypointArrivalListener
. - Promote
com.tomtom.sdk.navigation.TomTomNavigation.removeWaypointArrivalListener
. - RoutePlan is now in General Availability.
- Use common safety location data in SafetyLocations.
Routing
Breaking changes
- Make RangeCalculationOptions a normal class.
- Remove copy function from RoutePoint.
- Rename
com.tomtom.sdk.routing.route.section.traffic.MagnitudeOfDelay.UNDEFINED
to INDEFINITE.
Deprecations
- Deprecate copy.
- Deprecate extension function RoutePoint.angleTo.
- Deprecate extension function RoutePoint.distanceTo.
New Features
- Toll cost indication.
Updates
- Add information about charging stops to EV routes doc.
- Add unsupported route planning options to EV routing documentation.
- Com.tomtom.sdk.routing.route.RoutePoint is now available in General Availability.
- Convert CarpoolSection data class to normal class.
- Convert CarTrainSection data class to normal class.
- Convert CountrySection data class to normal class.
- Convert FerrySection data class to normal class.
- Convert LaneSection data class to normal class.
- Convert LowEmissionZoneSection data class to normal class.
- Convert MotorwaySection data class to normal class.
- Convert PedestrianSection data class to normal class.
- Convert RoadShieldSection data class to normal class.
- Convert TollRoadSection data class to normal class.
- Convert TollVignetteSection data class to normal class.
- Convert TrafficSection data class to normal class.
- Convert TunnelSection data class to normal class.
- Convert UnpavedSection data class to normal class.
- Convert UrbanSection data class to normal class.
- Convert VehicleRestrictedSection data class to normal class.
- Document Orbis unsupported options.
- Improve range documentation comments.
- Improve resilience to changes in Routing Service.
- Promote
com.tomtom.sdk.routing.options.calculation.ArrivalSidePreference
to GA. - Promote
com.tomtom.sdk.routing.options.RoutePlanningOptions.arrivalSidePreference
to GA. - Promote
com.tomtom.sdk.routing.route.section.traffic.SimpleCategory
to GA. - Property Route.destination is now available in General Availability.
- Property Route.geometry is now available in General Availability.
- Property Route.origin is now available in General Availability.
- Property Route.planningReason is now available in General Availability.
- Property Route.routePoints is now available in General Availability.
- Property Route.waypoints is now available in General Availability.
Search
Breaking changes
- Module: search:structured-search-client-onboard.
Removed package
com.tomtom.sdk.search.structuredsearch.offline.domain
[RemovedPackage]
Deprecations
- Deprecate the
SearchOptions
constructor for a search request containingmaxDetourDuration
. Use theSearchOptions
constructor for a search request which doesn't containmaxDetourDuration
instead. Do the following to adapt your project to these API changes: - Remove all usage of
maxDetourDuration
for a search request - Use the constructor for a search along the route request if
maxDetourDuration
needs to be set
Fixes
- Add missing tests for recents, improve deduplication logic.
- Ignore coordinate search results outside of the onboard map coverage area, as these results are not usable.
- Make offline results not mix the online search results when searched with personal locations.
- Return a single search result for the coordinate search.
- Revert fix for returning a single search result for the coordinate search. Need to handle query intents in a holistic way.
Updates
- Move experimental standard category IDs to GA.
- Use common tests for personal locations and custom POIs.
version 0.34.0 - 24/10/2023
General
Breaking changes
- From now on, use
com.tomtom.sdk.featuretoggle.TomTomOrbisMapFeature
instead ofcom.tomtom.sdk.featuretoggle.TomTomMapsPlatformFeature
, allowing you to toggle the TomTom Orbis Maps within your application. For additional details, please refer to this link. - The
com.tomtom.sdk.datamanagement.nds.update.CompletedMapOperation
is no longer a data class. - The
com.tomtom.sdk.datamanagement.nds.update.compositeregion.CompositeRegionChangedListener
has been renamed tocom.tomtom.sdk.datamanagement.nds.update.compositeregion.CompositeRegionListener
. - The
com.tomtom.sdk.datamanagement.nds.update.RegionGraphNodeState
is no longer a data class. - The
com.tomtom.sdk.datamanagement.nds.update.RegionsAroundPosition
is no longer a data class.
New Features
- NavigationTileStore: added persistent cache for downloaded NDS.Live tiles.
Fixes
- Resolved a MissingResourceException when trying to use online safety locations with the Horizon Engine.
Updates
- Promoted objects under
com.tomtom.sdk.datamanagement.locationdecoder
package to Public Preview. - Use Java's AutoCloseable explicitly.
Map
Fixes
- Fixed maneuver arrows.
Updates
- Stop map rendering in
onStop
rather then inonPause
. - Updated the POIVisualization modules to follow the naming convention for Poi.
Navigation
Breaking changes
NavigationOptions
is no longer a data class.RoutePlan
is no longer a data class.RouteTrackingEngine
now returns oneRouteTrackingState
instead of the list.RouteTrackingState
now contains a list of followed and unfollowed routes.RouteTrackingState
now contains thehasDeviated
property, which indicates whether the user has deviated from all of the routes.- All
Hazard
related classes are marked as Experimental. - Changed the type of
LocationContext.speed
fromcom.tomtom.quantity.Speed
? tocom.tomtom.quantity.Speed
. - Removed
com.tomtom.sdk.navigation.horizon.dataadapter.OpenLocationReference
class from public API. - Removed unneeded
toString()
,equals()
andhashCode()
fromHorionElementType
classes. - Rename
com.tomtom.sdk.navigation.DestinationReachedListener.onDestinationReached
(Route)to`com.tomtom.sdk.navigation.DestinationArrivalListener.onDestinationArrived
(Route)`. - Renamed
com.tomtom.sdk.navigation.DestinationReachedListener
tocom.tomtom.sdk.navigation.DestinationArrivalListener
. - Renamed
com.tomtom.sdk.navigation.horizon.HorizonSnapshotState.extensionCounter
tocom.tomtom.sdk.navigation.horizon.HorizonSnapshotState.updateCounter
. - Renamed
com.tomtom.sdk.navigation.TomTomNavigation.addDestinationReachedListener
(DestinationReachedListener)to`com.tomtom.sdk.navigation.TomTomNavigation.addDestinationArrivalListener
(DestinationArrivalListener)`. - Renamed
com.tomtom.sdk.navigation.TomTomNavigation.removeDestinationReachedListener
(DestinationReachedListener)to`com.tomtom.sdk.navigation.TomTomNavigation.removeDestinationArrivalListener
(DestinationArrivalListener)`. - Renamed horizon element
City
toCityElement
. - Renamed horizon element
CountryInformation
toCountryInformationElement
. - Renamed horizon element
DangerousGoodsRestriction
toDangerousGoodsRestrictionElement
. - Renamed horizon element
GeneralRoadProperties
toGeneralRoadPropertiesElement
. - Renamed horizon element
Hazard
toHazardElement
. - Renamed horizon element
PathGeometry
toPathGeometryElement
. - Renamed horizon element
Region
toRegionElement
. - Renamed horizon element
SafetyLocation
toSafetyLocationElement
. - Renamed horizon element
SpeedLimit
toSpeedLimitElement
. - Renamed horizon element
Street
toStreetElement
. - Renamed horizon element
TrafficSign
toTrafficSignElement
. - Renamed horizon element
VehicleRestriction
toVehicleRestrictionElement
. - Replaced
com.tomtom.sdk.navigation.WaypointArrivalListener.onWaypointReached
(RouteStop)with`com.tomtom.sdk.navigation.WaypointArrivalListener.onWaypointArrived
(RouteStop, Route)`. - Replaced
com.tomtom.sdk.navigation.WaypointArrivalListener.onWaypointVisited
(RouteStop)to`com.tomtom.sdk.navigation.WaypointArrivalListener.onWaypointDeparted
(RouteStop, Route)`.
New Features
- Added support for Bulgarian, Catalan, Slovak in spoken messages.
Fixes
- Fixed crash in traffic module due to missing method.
Updates
- Added back to road appearing check to repeat
instructionPhases
correctly. - Guidance triggering config updated.
- Improved
SynchronizedNavigationEngineRegistry
. - Improved inline documentation for
NavigationOptions
andRoutePlan
. - Merged map matching binding module with map matching common engine module.
Routing
Breaking changes
- Marked
com.tomtom.sdk.routing.online.common.model.description.VehicleEngineJsonModel
as internal. - Marked
com.tomtom.sdk.routing.online.common.model.description.VehicleLoadJsonModel
as internal. - Removed class
com.tomtom.sdk.routing.online.model.diagnostic.EffectiveSetting
. - Removed class
com.tomtom.sdk.routing.online.model.diagnostic.Report
. - Removed class
com.tomtom.sdk.routing.options.description.ReportType
.
Deprecations
- Deprecated
copy()
andcomponentN()
functions ofRouteLeg
class.
Fixes
- EV Routing supports only Car, Bus, Van, and Motorcycle vehicle types.
Updates
com.tomtom.sdk.routing.coroutines.flow.RoutingException
is now available in General Availability.com.tomtom.sdk.routing.options.guidance.RouteIncrementOptions
is now available in General Availability.com.tomtom.sdk.routing.route.ComputedAs
is now available in General Availability.com.tomtom.sdk.routing.route.PlanningReason
is now available in General Availability.com.tomtom.sdk.routing.route.RouteStop.SourceType
is now available in General Availability.com.tomtom.sdk.routing.route.RouteStop
is now available in General Availability.com.tomtom.sdk.routing.RoutePlanningResponse
is now available in General Availability.com.tomtom.sdk.routing.RoutingFailure.IncrementRouteContentsFailure
is now available in General Availability.com.tomtom.sdk.routing.RoutingFailure.InstructionGenerationFailure
is now available in General Availability.com.tomtom.sdk.routing.RoutingFailure.MapInaccessibleFailure
is now available in General Availability.- `com.tomtom.sdk.routing.RoutingFailure.MergeLaneSectionsFailure`is now available in General Availability.
com.tomtom.sdk.routing.RoutingFailure.RouteInstructionsFailure
is now available in General Availability.com.tomtom.sdk.routing.RoutingFailure.RouteReconstructionFailure
is now available in General Availability.- `com.tomtom.sdk.routing.RoutingFailure.RouteReplanningFailure`is now available in General Availability.
InstructionType
is now available in General Availability.RoutePlanner.planRouteAsFlow()
is now available in General Availability.- Clarified the documentation of the apiUri parameter.
- Converted
RouteLeg
data class to class. - Removed`RouteIncrementOptions` from Public Preview.
Search
New Features
- Support added for area personal locations in offline search.
Fixes
- Made additional data work with Orbis backend.
- Support added for coordinate search results in offline search response.
Updates
- Documented geopolitical view for offline and hybrid search.
version 0.33.1 - 10/10/2023
General
Breaking changes
- The
com.tomtom.sdk.datamanagemenr.nds.update.RegionGraph
is no longer data class. - Extract the
MapOperation
class from thecom.tomtom.sdk.datamanagemenr.nds.NdsStore
and change package tocom.tomtom.sdk.datamanagemenr.nds.update
. - Move the locale filed from
com.tomtom.sdk.datamanagemenr.nds.NdsStoreConfiguration
tocom.tomtom.sdk.datamanagement.nds.NdsStoreUpdateConfig
. - Remove
keystorePassword
field fromcom.tomtom.sdk.datamanagemenr.nds.NdsStoreConfiguration
. - Rename the
com.tomtom.sdk.datamanagemenr.nds.update.MapOperation.node
property to thecom.tomtom.sdk.datamanagemenr.nds.update.MapOperation.nodeId
. - Rename the
com.tomtom.sdk.datamanagemenr.nds.update.MapOperation.operation
property to thecom.tomtom.sdk.datamanagemenr.nds.update.MapOperation.type
. - Rename the
com.tomtom.sdk.datamanagemenr.nds.UpdateErrorCode
tocom.tomtom.sdk.datamanagement.nds.MapUpdateError
. - Rename the NdsStore API methods:
addOnUpdateListener
has been renamed toaddMapUpdatedListener
UpdateListener
has been renamed toMapUpdatedListener
removeOnUpdateListener
has been renamed toremoveMapUpdatedListener
addOnAutomaticUpdateFailureListener
has been renamed toaddAutomaticMapUpdateFailureListener
AutomaticUpdateFailureListener
has been renamed toAutomaticMapUpdateFailureListener
removeOnAutomaticUpdateFailureListener
has been renamed toremoveAutomaticMapUpdateFailureListener
. - The
com.tomtom.sdk.datamanagemenr.nds.NdsStoreConfiguration
is no longerdata class
. - The
com.tomtom.sdk.datamanagemenr.nds.update.CurrentMapOperation
is no longer data class. - The
com.tomtom.sdk.datamanagemenr.nds.update.MapOperation
is no longer data class. - The `com.tomtom.sdk.datamanagemenr.nds.update.RegionGraphNode`is no longer data class.
- The
com.tomtom.sdk.datamanagemenr.nds.update.UpdateInfo
is no longer data class. - The type of
RoadProperties.functionalRoadClass
is changed to Int? (nullable).
New Features
- Introduce a feature toggle for TomTom Maps Platform.
Fixes
- Fix logging in the release builds.
- Ignore lint test which fails for unknown reason.
- Prevent obfuscation of runtime features by adding proguard consumer rule.
Updates
- All DevPortal documentation groovy snippets converted to Kotlin.
- Fix crash in navigation-example-app for invalid routing options combinations.
- If NumberOfLanes value is out of valid range [0..15], the result is set as null instead of throwing exceptions.
- If RoadProperties.functionalRoadClass value is out of valid range [0..7], the result is set as null instead of throwing exceptions.
- The default value of numberOfLanes in the constructor of RoadProperties is removed.
Map
Breaking changes
- * in
RouteOptions
class rename property fromfollowable
toisFollowable
- inRouteSection
class remove propertiesstart
,end
,geometry
androuteOffset
- add propertyindexRange
to theRouteSection
class - convertedRouteOptions
andRouteSection
from data classes to normal ones - added unit tests forRouteSection
. - * in
RouteOptions
class rename propertydestinationMarkerCoordinate
todestination
* add propertydeparture
.
New Features
- Add a POI click listener for user interaction with POIs.
- Add map-display-premium-duo module.
- Search Visualization module implementation.
Fixes
- Active route colouring fix.
- Fix routing visualization flaky tests.
Updates
- * add the
textureUri
property to theRouteSection
class - changeMichiRouteMapper
class to draw textures on the map - changeRouteDrawer
class in maps-demo-app to draw tunnels and not drivible sections with custom textures. - Change type of the "properties" member in GeoJsonMarkerOptions and GeoJsonPolylineOptions.
- Extend CameraOptions API reference documentation.
- Use premium map display with disabled unity splash screen.
Navigation
Breaking changes
- Remove the BackToRouteOptions from the public API.
- Remove the RouteUpdateOptions from the public API.
- RouteReplanner methods expect NavigationSnapshot as the only parameter instead of RouteUpdateOptions, BackToRouteOptions, and RouteIncementOptions.
- RouteReplanner methods return RouteReplannerResponse instead of RoutePlanningResponse when the result is successful.
New Features
- Add rules for displaying Japan current road.
- Support city district, neighborhood and subCountry in horizon-based LocationContext.
Fixes
- Catch exceptions thrown from horizon core.
- Continuous route replanning endlessly replans a route with invalid route planning options after initial replanning failure.
- Fix crash in NDS.Live component that could happen when obfuscation is applied.
- Modify and enable ignored test.
Updates
- "Navigation use case" tutorial renamed to "Build a navigation app.".
- Improve NAV starting guide.
- On consequent deviations stick to route cut-off gets exponentially bigger.
- Promote the horizon engine API to Public Preview.
- The navigation orchestrator catches any exceptions thrown by engines during navigation.
Routing
Breaking changes
- Implement including a route in an onboard range.
Deprecations
- Deprecate
copy()
andcomponentN()
functions ofSpeedLimitSection
class. - Deprecate
SpeedLimitSection.speedLimitInKmh: Int
property in favor ofSpeedLimitSection.speedLimit: Speed
.
New Features
- Delivers junction views along route.
Fixes
- Charging options can only be used with RouteType.Fast.
- Explicitly forbid to create requests with chargingOptions and enabled waypointOptimization parameters.
- Avoid NPE with BorderCrossing routes missing some data.
Updates
- Add traffic dependency to range-client-onboard.
- Better error handling in RoutePlanningOptions.
- Clarify lane guidance section documentation.
- Convert
SpeedLimitSection
data class to normal class. - Promote Range APIs from Experimental to PP.
- Release note message.
- Verify that assembled LDEVR request doesn't contain computeTravelTimeFor parameter.
Search
New Features
- Online Search implementation with Personal Location data.
Fixes
- Fix list going out of screen in Personal Locations demo.
Updates
- Improve demo for Personal Locations with missing
Place
data.
version 0.32.7 - 04/10/2023
version 0.32.6 - 02/10/2023
General
Fixes
- Prevent obfuscation of runtime features by adding proguard consumer rule.
- Fix for missing NDK symbols during integration.
Navigation
Fixes
- Continuous route replanning endlessly replans a route with invalid route planning options after initial replanning failure.
version 0.32.0 - 13/09/2023
General
Breaking changes
- Rename com.tomtom.sdk.hazards.online.HazardSeverity.Low to com.tomtom.sdk.hazards.online.HazardSeverity.Minor.
Fixes
- Fix publishing consumer proguard rules preventing gosdk minification.
Updates
- Rename com.tomtom.sdk.navigation.horizon.dataadapter.hazards.online.HazardSeverity.Low to com.tomtom.sdk.navigation.horizon.dataadapter.hazards.online.HazardSeverity.Minor.
Location
Breaking changes
RoadType
unintentionally was made Generally Available - it is Public Preview.- Move com.tomtom.sdk.location.DrivingSide from com.tomtom.sdk.location:model to com.tomtom.sdk.location:location-route and rename to com.tomtom.sdk.location.road.DrivingSide.
- Move com.tomtom.sdk.location.FineGraindRoadType from com.tomtom.sdk.location:model to com.tomtom.sdk.location:location-route and rename to com.tomtom.sdk.location.road.FineGraindRoadType.
- Move com.tomtom.sdk.location.RoadType from com.tomtom.sdk.location:model to com.tomtom.sdk.location:location-route and rename to com.tomtom.sdk.location.road.RoadType.
- Remove the Road suffixes from the values in
FineGrainedRoadType
. - Rename
FineGrainedRoadType
toRoadType
. - Rename
RoadType
toRoadCategory
.
Updates
- Creat new module com.tomtom.sdk-location:location-route.
Map
New Features
- Expose copyrights caption.
Fixes
- After changing tracking mode zooming doesn't work.
- Fix for turn instruction highlighted arrow misplaced .
- Fix missing companion field in MapFragment.
- Fix proguard configuration not to remove nested classes of internal SDK classes.
- Fix the API key for accessing the sprite file is incorrect in vector map and traffic example.
Updates
- Simplify proguard configuration for map-display modules.
- Split map-display module into map-display and map-display-common.
- Use single MapView and MapFragment definition for each mapdisplay flavor.
Navigation
Breaking changes
- Change
roadType
toroadCategory
inRegionalSpeedLimit
. - Change LocationContext from data class to class and remove Road nested class.
- Change the property com.tomtom.sdk.navigation.locationcontext.LocationContext.road to nullable.
- Convert data classes in Horizon Engine to classes.
- Move com.tomtom.sdk.navigation.horizon.elements.generalroadproperties.NumberOfLanes to com.tomtom.sdk.location.road.NumberOfLanes.
- Move com.tomtom.sdk.navigation.horizon.elements.generalroadproperties.RoadCondition to com.tomtom.sdk.location.road.RoadCondition.
- Remove com.tomtom.sdk.navigation.horizon.elements.countryinformation.RegionalSpeedLimitType and replace the speed limit with com.tomtom.sdk.location.SpeedLimit.
- Remove com.tomtom.sdk.navigation.horizon.elements.speedlimit.SpeedLimitsType and replace the speed limit with com.tomtom.sdk.location.SpeedLimit.
- Remove com.tomtom.sdk.navigation.locationcontext.LocationContext.Road and replace it with com.tomtom.sdk.location.road.RoadProperties.
- Remove com.tomtom.sdk.navigation.locationcontext.SpeedLimit and replace references to it with references to com.tomtom.sdk.location.SpeedLimit.
- Remove isWeatherDependent and isTimeDependent field in RegionalSpeedLimitType.
- Remove road related properties in com.tomtom.sdk.navigation.horizon.elements.generalroadproperties.GeneralRoadProperties and replace those properties with com.tomtom.sdk.location.road.RoadProperties.
- Rename com.tomtom.sdk.navigation.horizon.elements.hazard.HazardSeverity.Low to com.tomtom.sdk.navigation.horizon.elements.hazard.HazardSeverity.Minor.
New Features
- Extend RouteProgress with remainingTrafficDelay.
- Introduce a new class com.tomtom.sdk.location.road.RoadProperties.
Fixes
- Do not replan when current car position is off-road near origin.
- Fix crash in traffic module that could happen if user applies obfuscation.
- Fix Protobuf related crash at navigation initialization.
Updates
- Improve the documentation of the properties of LocationContext.
- TomTomNavigation will throw on start and update if vehicle provider has not been properly configured.
Routing
Breaking changes
- Refactor interface RouteStop to class RouteStop.
- Remove Origin, Destination, Waypoint classes and replace them with RouteStop class.
- Remove startOfRoute and endOfRoute properties from Route class.
Fixes
- Enable runtime switching of endpoints when using OnlineRoutePlanner with custom
apiUri
. The customapiUri
parameter must contain only thebaseURL
(without the endpoint). The endpoint will be appended by the OnlineRoutePlanner automatically.
Updates
- Add waypoints property to Route class.
Search
New Features
- Add personal locations support to offline search.
Fixes
- Introduce missing TTOM standard POI categories.
Updates
- Update documentation for search common module.
version 0.31.1 - 31/08/2023
Routing
Fixes
- Fix for re-planning crash.
version 0.31.0 - 25/08/2023
General
Updates
- Update broken links and references in telemetry documentation.
Map
Updates
- Promote route visualization to GA.
- Replace horizon api by safety location.
- Replace navigation visualization data class from public API.
- Use generic interface where possible.
Breaking changes
- Prepare navigation visualization to promote to GA.
Routing
Fixes
- Fixes set_active_route_on_map test failing.
Navigation
Fixes
- Fix origin coordinate is wrongly set to 0.0,0.0 while navigating.
New Features
- Automatic replanning on deviation sticks to route if supporting points are provided in the initial planning.
- Trigger replan even though destination has been reached.
Breaking changes
- Replace LocationContext.Address with com.tomtom.sdk.location.Address.
Search
New Features
- Update documentation for reverse geocoder.
version 0.30.1 - 14/08/2023
Map
Breaking changes:
- Solve discrepancies with iOS of module routing visualization to promote to GA.
Updates:
- Expand the CameraTrackingMode type with the configurable classes that can contain FollowCameraOperatorConfig
- Promote FollowCameraOperatorConfig to publicpreview
Search
Updates:
*
Routing
Breaking changes:
- Remove context parameter from OfflineRoutePlanner.create() function.
Fixes:
- Fix waypoints not being updated on selecting alternative route for EV cars on long distance routes.
- Prevent setting vehicleHeading=360 when planning a route.
Navigation
Breaking changes:
- Group number of lanes properties in GeneralRoadProperties.
- Group tunnel and bridge properties together.
- Remove properties speedFog, speedSnow and speedRain from horizon API class SpeedLimits. Remove value Variable from horizon API value class SpeedLimitsType.
- Replace LocationTracesParser.fromAssets(String) method with extension function LocationTracesParser.fromAssets(Context, String).
New features:
- LocationTracesParser.fromInputStream(InputStream).
Updates:
- Improve inline documentation for off-road navigation.
- Promote Hybrid Navigation API to PP
Fixes:
- Always interpret the input speed limit values as kph.
- Fix origin coordinate is wrongly set to 0.0,0.0 while navigating.
- Initialize horizon engine if null in HybridTomTomNavigationFactory
version 0.29.0 - 08/08/2023
Map
New features:
- Draw a dotted line connecting the drivable and final destination.
- Geojson-based primitives use JsonObject for properties.
- NDS.Live bindings and implementation in NavigationTileStore
- Use unified engines with NDS.Live implementation of NavigationTileStore
Updates:
- Add versioning info on performance graph
Fixes:
- Ndslive bindings macOS kmp context failure
Search
New features:
- Add support for supported vehicle types in the search response for online mode.
Updates:
- Fix artifact id for custom online search.
Routing
Removals:
- Updated documentation for track import. Removed incorrect statement about user waypoints support.
Fixes:
- Prevent setting vehicleHeading=360 when planning a route.
Navigation
Breaking changes:
- Change in Public Preview code: com.tomtom.sdk.location.DrivingSide replaces com.tomtom.sdk.traffic.DrivingSide and com.tomtom.sdk.navigation.horizon.elements.countryinformation.DrivingSide
New features:
- Support tunnel and bridge names in Navigation UI
Updates:
- Add IntRange checking to the properties of GeneralRoadProperties
Fixes:
- Notification with the same distance to the next instruction will be sent only once.
version 0.28.0 - 01/08/2023
Map
Breaking changes:
- Add vehicle restrictions styles for onboard map.
New features:
- Unsupported GeoJSON Marker operations now throw an exception.
Updates:
- Add NavigationTileStoreConfiguration values bounds for prefetchedAreaRadiusMeters and cache sizes.
- Add big groups of markers in batches rather than one by one.
- Enable smooth style reloading feature by default.
- Release note message.
- Remove explicit font names from copyright notice.
- Update standard style version.
Fixes:
- Vehicle Restrictions within Routing Visualization
Search
Fixes:
- Throw NetworkOnMainThreadException when calling Search from the Main Thread.
Routing
Fixes:
- Create route points for legs with a single arc.
Navigation
New features:
- Add tunnel and bridge names in LocationContext.
Updates:
- Added close() method to TomTomNavigationService that needs to be called before unbindService().
- Fix namings and documentation in ReplannedRouteValidator and RouteMergerTest.
- Improve performance by not creating unnecessary lists in RouteMerger.
- Promote RouteTrackingState to PP.
- Update the documentation for RouteUpdatedListener.
Fixes:
- Fix crash in Route.init() that can happen during route refresh.
- Remove unnecessary dependency to online component from offline route projection.
version 0.27.0 - 25/07/2023
Map
New features:
- Add support for GeoJson Markers.
Updates:
- Promote hillshading APIs of StyleController to GA.
- Use time since boot to calculate duration of location marker’s animation and location accuracy policy.
Removals:
- Remove camera operators config from style.
Search
Fixes:
- Handle kNdsCategoryNotFound in android bindings
Routing
New features:
- Add the possibility to avoid specific charging parks when planning a route with automatically added charging stops.
Navigation
Breaking changes:
- Implement OffRoadTomTomNavigationFactory.
- Removed
- Removed
TomTomNavigationFactory
andNavigationConfiguration
. Use new navigation factories (e.g. OnlineTomTomNavigationFactory) instead.
Fixes:
- Improve documentation for addProgressUpdatedListener in TomTomNavigation.
General
Updates:
- Strip native binaries from debug information for JVM targets.
version 0.26.0 - 07/07/2023
Map
New features:
- Add support for GeoJson Polylines.
Updates:
- Follow DDD on NavigationVisualization module
- Log map tiles download times.
Routing
New features:
- Support arrival side preference in the offline route planner.
Navigation
Breaking changes:
- Rename packages
New features:
- Traffic section api, bindings and implementation
Updates:
- The close method also stops navigation.
- Update documentation for setting GuidanceUpdatedListener.
Fixes:
- Fix proguard rules forBackToRoutePointCalculator.
Location
New features:
- Make prediction generator more robust.
General
Fixes:
- Listener not triggered when changing engine type.
version 0.25.0 - 30/06/2023
Map
New features:
- Add support for number of axles for Vehicle restriction
- Expose camera operators customization on the SDK API
Updates:
- Move first number of safety location from style to API
- Update navigation visualization safety cameras UX spec
Fixes:
- Add missing font to Routing Visualization
- Fix flaky tests for map display binding
Search
Fixes:
- Add support for address ranges from online search in GOSDK online search.
- Use the search endpoint even when the category filter is set.
Navigation
Breaking changes:
- Data store maintenance is reset when navigation is stopped.
- Update signature of DataUpdatedListener to use a list of GeoBoundingBox within the component com.tomtom.sdk.navigation:horizon-data-adapter.
- Updated signature of OnlineHazardsHorizonDataAdapterFactory.create to consume Hazards object.
- Updated signature of OnlineSafetyLocationsDataAdapterFactory.create to consume SafetyLocations object.
Updates:
- Vehicle profile test case for horizon-engine-unified.
Fixes:
- Correct dependencies.
- DataStoreMaintenanceEngineFactory and DataStoreMaintenanceEngine are visible in SDK.
General
New features:
- Promote CompositeRegionsUpdater API to public preview
Updates:
- Convert quantity classes to Kotlin’s value classes.
- Refactor UnitBase abstract class to an interface.
version 0.24.0 - 23/06/2023
Map
Fixes:
- Remove redundant animation of the moveCamera() method.
Routing
New features:
- Extend routing options with arrival side preference.
Updates:
- Clarify avoid behavior for routing in documentation.
- Add missingn lez and unpaved sections to documentation
Fixes:
- Promote arrival side preference to public preview
Navigation
Updates:
- Add new factories for online, offline and hybrid navigation.
- Navigation handles updating of data stores internally.
Fixes:
- Correct dependencies.
- DataStoreMaintenanceEngineFactory and DataStoreMaintenanceEngine are visible in SDK.
- DefaultTomTomNavigation should properly implement AutoCloseable.
General
Updates:
- Mark interfaces as functional.
Fixes:
- Throw if the same listener is added multiple times.
version 0.23.1 - 21/06/2023
version 0.23.0 - 16/06/2023
Map
New features:
- Implement a decision point hint on route manager
- Release note message.
Updates:
- Add possibility to run performance test on different zoom levels.
- Bump style version to 24.2.*
- Minor optimisation and snippet fix.
Fixes:
- Fix crash on sprites loading when local cache file cant be opened.
- Fix false map interaction events
- Fix rare crash that happened on style load.
Search
Breaking changes:
- Replace position, address, entryPoints properties in CustomRecord.CustomPoi with Place class.
New features:
- Add support for address for custom POIs.
Updates:
- Move online custom POI support to Public Preview
Fixes:
- Fix for non-findable offline search native library.
Routing
New features:
- Expose information on when and where path alternative forks off the primary route.
- Extend routing options with arrival side preference.
Fixes:
- Fix routing sections mapping.
- Promote arrival side preference to public preview
- Release note message.
Navigation
Breaking changes:
- Refactor RouteTrackingEngine to handle RouteTrackingState.
- Renaming dependency
New features:
- Add waypoint arrival panel to navigation fragment
- Conversion from a bounding box to a list of tiles.
- Promote NavigationTileStore API to Public Preview.
- Rename OnlineLocationContextProvider engines according to convention and move APIs to Public Preview.
Updates:
- Add translations for waypoint arrival panel
- Declare click listener parameter for UI components as View.OnClickListener instead of an anonymous type.
- Filter out Lane Sections with no Direction to follow.
- Use NavigationConfiguration to createTomTomNavigation in the Navigation use case.
Fixes:
- Correct timestamps in predictions.
- Fix potential crash during navigation of Route planned with RouteInformationMode=FirstIncrement.
- Guidance instructions and maneuver icon displayed too early after the route has been refreshed.
General
Breaking changes:
- Enable RSA with OAEP encryption.
New features:
- Add optional charging parameters
- Extend DefaultVehicleProvider to support optional charging parameters.
Updates:
- Initialize vehicle snapshot through DefaultVehicleProvider constructor.
- Promot an Experimental Telemetry API to Public Preview.
Removals:
- Retire Navigation Visualization Addon
Fixes:
- Inconsistent use of function names.
- Incorrect bottom padding on the map.
- Minor DefaultVehicleProvider improvements
- UpdateVehicleState should properly handle updates that lead to inconsistent state of the vehicle.
version 0.22.4 - 06/06/2023
Map
New features:
- Add IC, JCT and traffic light icon for Japan map.
- Add Routing Visualization to maps-demo-app
- Create NavigationVisualization module within Maps
- Intersection name and traffic light icon visualization.
- Intersection name visualization for Japan map.
Updates:
- Add instruction length calculation for Routing API v2
- Load Orbis specific copyrights when Orbis feature is enabled.
- Migrate vehicle restriction to travelModeProfile
Fixes:
- Fixed table presentation for vehicle restriction page on dev portal.
- Make current location marker grey if location is not updated for a some time.
- Revert addon API to Public Preview
Search
New features:
- Support for custom POI search with online-only search mode.
Routing
Fixes:
- Hotfix an issue with route sections.
Navigation
Breaking changes:
- Remove LocationContextProviderEngines'
language
parameter, locale will be used from snapshot - Remove LocationProvider from the NavigationEngineRegistry and expose it on the TomTomNavigation interface as the mutable property: TomTomNavigation.locationProvider.
- Reverse order of the parameters in HorizonSnapshot.distanceTo method.
New features:
- Expose vehicle provider in TomTomNavigation
- Extend Route Replanning to compute instructions incrementally on the active route as required.
- Next waypoint can be manually marked as visited after it has been reached.
Updates:
- Improve inline documentation for navigation horizon module.
- Remove sticking to route on deviation
- Add platform-specific attributes to the bindings.
Fixes:
- Fix progress calculation on the overlapping route.
- Improve synchronization in NavigationEngineRegistry.
- Prevent repeated calls to RouteReplanner.incrementRouteContents when route length changes.
General
New features:
- Remove RouteProjection feature toggle.
Updates:
- Add performance test for orbis map and vehicle restrictions map.
- Unclear methods explanations.
Fixes:
- Incorrect bottom padding on the map.
- Replaced keys with placeholders.
version 0.18.4 - 02/06/2023
version 0.18.0 - 22/05/2023
Map
Updates:
- Update vehicle restrictions documentation with LEZ, hazmat, and supported restriction types.
Fixes:
- Fix the issue of sprites not being displayed for custom styles that contain URL encoded characters
- Make current location marker grey if location is not updated for a some time.
Search
Fixes:
- Use time zone correctly in opening hours
Routing
Updates:
- Adjust projection lower boundary.
Fixes:
- Add remaining charging plug types mapping.
- Hotfix an issue with route sections.
- Move RouteIncrementResult to onboard infrastructure package
- Setting internalAnnouncementPoints to none in case of the long-distance EV route.
Navigation
Breaking changes:
- Change id property type in com.tomtom.sdk.navigation.horizon.datasource.SafetyLocationData from string to SafetyLocationId inline class.
- Change safetyLocationId property type in com.tomtom.sdk.navigation.horizon.elements.SafetyLocation from string to SafetyLocationId inline class.
- Omit needless vehicle prefix for VehicleUpdateOption cases
New features:
- Add bindings for get-pruned-pectangles method.
- Add hybrid VH engine.
- Add utility function of getting geometry of an element in a horizon snapshot.
- Propagate guidance progress from instruction engine
Updates:
- Remove sticking to route on deviation
- Use limited parallelism in navigation.
Fixes:
- Fix checking if the route can be replanned if the number of different points is the same as provided threshold in the RouteReplannerConfiguration.
- Prevent repeated calls to RouteReplanner.incrementRouteContents when route length changes.
General
Breaking changes:
- Change the api of DefaultVehicleProvider’s setVehicle method
Fixes:
- Fix links on the FAQs page.
version 0.12.0 - 26/04/2023
Map
Breaking changes:
- Remove LaneLevelSegmentController class.
- Remove primitive accessors(markers, circles, polygons, polygonOverlays, polylines) from TomTomMap class.
New features:
- Add support for ADR & Hazmat for vehicle restrictions.
- Create Routing Visualization module within Maps
- Enables adding and removing request observers for diagnostic information in httphandler.
- Extend
Polyline
with pattern texture support. - Manual Map Management at update region set level.
- Introduce a hybrid data provider
Updates:
- Allow to pass null value to LocationController.setLocationProvider().
- Add handling of invalid URL and mapping file as a result error.
- Add missing NotoSans fonts.
- Add more debug information to route validation error.
- Add padding parameter to zoomToMarkers() method of MarkerController interface.
- Add the possibility of drawing the route section based on the geometry and route offset.
- Align the style across all the offline styles
- Extend layer API with layer visibility
- Promote MapOptions, MapView and MapFragment to general availability.
- Promote TomTomMap class to general availability.
- Update documentation of the com.tomtom.sdk.map.display.styleprovider.offline.StyleUriProvider to be used only with the offline map.
- Update style version to 24.1.* and add dark mode support to vehicle restriction style.
Fixes:
- Fix crash when traffic incident is tapped.
- Avoid Opt-in for experimental feature in addons
- Enable generation of documentation for StyleUriProvider
- Fix crash when switching between map fragments using offline mode
- Fix metadata handling on custom styles.
- Get unknown icon category back.
- Update the link text to indicate that the list of supported languages is for online maps
- Add a Kdoc for setLanguage fun of MapController
- Update the documentation for tomtom map config to specify how the contract for factory
Search
Breaking changes:
- ChargingConnectorAvailabilityDetails is renamed to ConnectorAvailabilityDetails
- ChargingAvailabilityId is renamed to availabilityId in EvChargingAvailabilityOptions
- ConnectorType is renamed to type in ConnectorAvailability
- ConnectorTypeSet is renamed to connectors in EvChargingAvailabilityOptions
- EvChargingStationSearch is renamed to requestEVChargingAvailability in EvChargingAvailabilityProvider
- Redesign AutocompleteSegment.
- Remove timeout from HybridReverseGeocoder, OnlineReverseGeocoder, and HybridSearch.
New features:
- Expose the provided fuel types in gas station POIs for offline search
- FuelPriceResponse now has fuelPriceId
- ParkingAvailabilityResponse now has parkingDetailId
- Provide accessible vehicle types for POIs in offline search
- Introduce accessibility of different types of vehicles at the Point of Interest.
Updates:
- Remove unused types
- Add tests for geobias when geometry search is used.
- Use limited parallelism in search.
Fixes:
- Add Locale to the constructor of SearchOptions for search along route scenario
- Return empty sets of phones and URLs when non are provided in the online response.
- Rely on the default view of online search instead of explicitly passing unified as geopolitical view.
- Support deserialization of charging park without any connector detail.
- When there are multiple search areas, utilize the first search area for offline search.
Routing
Breaking changes:
- Ignore unsupported computeBestOrder for EV routing request
- Ignore unsupported vehicleModelId for non-EV routing request
- Prepare api for other range boundary types
- Remove ConsumptionModel interface
- Remove RangeCalculationOptions from RangeCalculationFailure and RangeCalculationResult to align with route planning
- Remove coordinate precision
- RouteIncrementResult is removed from public API
- IncrementRouteResult renamed to advanceGuidanceProgress in RoutePlanner
New features:
- Low emission zone avoidance option added for the onboard client
- Low emission zone avoidance option added for the online client
- Low emission zone section added for the online client
- OnlineRoutePlanner charging parameters support.
Updates:
- Extend short lane sections from online routing to display lane guidance sooner.
Fixes:
- Always use non-scientific notation for floating-point parameters in request url
- Do not add vehicleModelId-specific parameters to route/range request
- Ensure that offset of arrival instruction does not exceed route length.
- Filter out lane sections which have empty lane list.
- Fixed onboard VehicleRestrictedSections
Navigation
Breaking changes:
- Change Horizon Engine API
- Change update vehicle profile api in binding
- Modify the restriction API to use types from Vehicle.
- Move TollgatePaymentType from package com.tomtom.sdk.routing.route.instruction.common to com.tomtom.sdk.routing.route.
- Refactor
- Remove message and messagePhonetics parameters from GuidanceAnnouncement.
- Rename ContinuousReplanningMode to BetterProposalAcceptanceMode
- Rename GuidanceUpdateListener to GuidanceUpdatedListener.
- Rename RouteUpdateReason.Unreachable tp RouteUpdateReason.Blockage and RouteReplanningReason.Unreachable to RouteReplanningReason.Blockage.
- Rename TomTomNavigation.addGuidanceUpdateListener method to TomTomNavigation.addGuidanceUpdatedListener.
- Rename TomTomNavigation.removeGuidanceUpdateListener method to TomTomNavigation.removeGuidanceUpdatedListener.
- Restructure the LocationContext class to contain the Address and Road classes.
- Rework locations in hazard.
New features:
- Add NdsStoreAccessPermit as a way to specify either the map license or keystore password and add it to NdsStoreConfiguration.
- Add option to RoutePlanningOptions for controlling instruction computation mode
- Add support for Finnish and Mexican Spanish in spoken messages.
- Add support for better route proposals of out-of-range EV routes.
- Add support for hazard warning in vehicle horizon.
- Create hazard models in horizon data source module.
- Enable vehicle profile update
- Ignore instructions when validating/merging route on route refresh
- Implement the vehicle and dangerous goods restriction elements.
- Improve NavigationTileStore configuration API.
- Introduce data store switch logic.
- Route replanning during navigation uses the most up-to-date vehicle profile information available.
- Truck restriction tests
- When leaving the charging stop with insufficient charge, GoSDK issues a route replan.
- Vehicle and dangerous goods restriction API
Updates:
- Add documentation about DangerousGoodsRestriction and VehicleRestriction.
- Add factory methods for creating a hybrid navigation.
- Add missing public preview notes in com.tomtom.sdk.navigation.horizon.* packages.
- Allow only one data source for a given Virtual Horizon’s data type.
- Configure navigation api path based on Orbis feature toggle state.
- Fix the default maximum main path searching distance to 2km.
- Make DetailedHazardInformation subclasses as data classes.
- Replace TomTom logo in the notification for navigation service.
- Reset maxAlternative option to zero in case of deviation route re-planing for Primary route.
- Restore validation of navigation start not being called twice.
- Retry plan route request for continuous re-planing with maxAlternatives set to 0 in case inner routing computation timeout error.
- Trigger navigation tile store updates in hybrid mode.
Fixes:
- Improve lane guidance view scaling.
- Avoid mixing online and offline projected route segments in hybrid navigation.
- Back to route accounts for supporting points.
- Better handling of larger font in ETA panel.
- Change margins of eta panel
- Check map access before reverse geocoding
- Chevron animation is not moving smoothly during map updates.
- Do not hide street view when a destination is reached.
- Do not show route updated notification if the route is not changed.
- Ensure that we have properly initialized engines no matter if map is changed or not.
- Filter out lane sections which have empty lane list.
- Fix MissingResourceException when generating verbal message.
- Fix TestProgressUpdatedListener.
- Fix crash caused by non-matching RouteLeg’s geometry and Section’s geometry after route refresh.
- Fix distance units in notifications.
- Fix division by zero in the route progress engine.
- Fix fix format of ETA.
- Fix fonts for navigation elements
- Fix lowEmissionZoneSections routeOffset calculation
- Fix predictions initialisation.
- Fix typo in style name.
- Fixes documentation for navigationProcessingThrottle parameter.
- Navigating with a waypoint result in the chevron not moving.
- Offroad positions for updating horizon
- Require last instruction for arrival detection
- The LocationProvider is no longer closed inside the NavigationEngineRegistry.updateEngines method, it has to be handled by the user of the SDK.
- OnDestinationReached may crash if there are no Instructions.
Location
Updates:
- Catch IOExceptions inside the DirectoryLoggerStrategy and throw IllegalStateException when the file creation fails.
Fixes:
- Fix location traces recorder using documents tree directory.
- Fix recorded TTP logs header.
- Remove bin file extension from the TTP file if the file is represented as RawDocumentFile.
General
Breaking changes:
- Rename artifact
New features:
- Add DefaultVehicleProvider support for vehicle model id.
- Add full form overloads for quantity functions using abbreviated units in their names
- NavVis Addon: Implement support for showing pattern textures on traffic lines
- NavVis Addon: Implement traffic lines transition from solid color to pattern on zoom level changes
- NavVisAddon: Enable speed cameras and add danger zones
- VehicleProvider charging parameters support.
Updates:
- Add use cases for VehicleProvider to documentation.
- Fix comment block formatting.
- Highlight that navigation fetches vehicle’s data from VehicleProvider during navigation.
- Improve logging for Vehicle SDK and UI.
- Make vehicle-client-api documentation visible to the customers.
- Remove ExperimentalTrafficApi annotation and move experimental part of the traffic API to public preview.
- Update offline map documentation.
- Vehicle SDK docs are visible on developer portal.
Fixes:
- Improve retrying http mechanism
- Remove unnecessary public functions from Vehicle SDK.
version 0.3.1617 - 10/02/2023
Map
Breaking changes:
- Remove ResourceCache configuration from MapOptions.
- Remove duration filter from OnlineCachePolicy.
New features:
- Add traffic support for Onboard-style-provider
- Enable fetching of onboard hill shading tiles.
- Map region language configuration
Updates:
- Promote OrbisMapFeature from @InternalTomTomSdkApi to @ExperimentalMapFeature.
- Promote SmoothStyleReloadFeature from @InternalTomTomSdkApi to @ExperimentalMapFeature.
- Updated style version to 24.0.x
Search
Breaking changes:
- Move entryPoints from Poi to Place.
- Remove FuelName and extend FuelType to replace it.
- Remove navigablePosition from reversegeocoder’s PlaceMatch and replace it with entryPoints in Place.
- Implement custom base URL for reverse geocoder.
- Rename ReverseGeocoder.EntityType to AreaType.
Routing
Updates:
- Promoting route planners API to general availability.
- Publish new guide on importing, exporting and modifying routes.
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
andBudget
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