Common

A collection of information that describes geographical location

Specifies if the vehicle should be subjected to ADR tunnel restrictions.

Specifies the ratio by which energy is converted for altitude changes.

Specifies the energy that is gained or lost by altitude changes.

A vehicle of type bicycle.

The smallest rectangular area within which all the coordinates lie.

Defines a POI brand.

A vehicle of type bus.

Represents a cancellation handler over an asynchronous operation. Cancellation may be immediate or simply requested to happen sometime in the future.

A typical usage for Cancellable is to return it from the asynchronous completion-based API.

let cancellable = asynchronousFunction(completion: completion)
if shouldCancel {
   cancellable.cancel()
}

A vehicle of type car.

Trait interface for vehicles that may have restrictions due to load.

Indicates the category to which a traffic event belongs.

Indicates the cause of a traffic event.

Indicates the cause of the traffic event. Codes are chosen according to the TPEG-TEC standard.

Describes capacity and current charge of the EV. Refer to the original type ElectricEngine.ChargeLevel for more information.

Describes connector information of an electric engine.

Information on how much to charge at a charging station.

Describes connector information of an electric engine. Refer to the original type ElectricEngine.ChargingParameters for more information.

Contains information about an EV charging park.

A charging point corresponds to an EVSE (Electric Vehicle Supply Equipment). This can be thought of as the charging facility capable of accomodating one car.

A charging station has several charging points, of which only several points can be used at the same time.

A combustion vehicle engine for route planning and consumption estimation.

Describes parameters used to determine the vehicle power and consumption. Refer to the original type CombustionEngine.Consumption for more information.

Specifies the efficiency of the vehicle. Refer to the original type CombustionEngine.Efficiency for more information.

A class for restricting protocol conformance to TomTomSDK components.

Protocols that inherit this protocol are considered locked and can be conformed to and implemented only inside the TomTomSDK.

// An example of protocol that provides necessary functionality in the TomTomSDK.
public protocol Planner: ConformanceLocked {
    func plan()
}

// An abstraction from the client side that provides the same interface but is not locked.
// Every TomTomSDK protocol might need this protocol clone.
// Use this type to pass it in the application and in tests.
protocol ClientPlanner {
   // The method should have the same signature
   func plan()
}

// Wrapper implementation on the client side that will contain TomTomSDK dependency
// but conform to the non-locked protocol
class ClientWrapperPlanner: ClientPlanner {
    let planner: Planner
    init(_ planner: Planner) {
        self.planner = planner
    }

    func plan() {
        planner.plan()
    }
}

// An example of the production code that needs to be tested.
// Use `ClientPlanner` in your production code, so you can mock it.
struct PlannerViewModel {
   init(_ planner: ClientPlanner) { }
   //
   // ...
}

// In production code
let planner: Planner = ... // getting real planner
PlannerViewModel(ClientWrapperPlanner(planner))

By depending on `ClientPlanner` a `PlannerViewModel` instance can be tested
by mocking all its dependencies. To mock its dependencies, replace `ClientWrapperPlanner` with a
mocked implementation of `ClientPlanner`.

Information about one of the connectors available in the ChargingPark.

The connector type.

This list is based on the supported connector types by online search, documented at the following link: https://developer.tomtom.com/search-api/documentation/product-information/supported-connector-types

Describes the type of electric current

Describes the detailed Hazard information.

Indicates the driving side on the road.

Indicates the effect the traffic event has on the traffic flow. Codes are chosen according to the TPEG-TEC standard.

A electric vehicle engine for route planning and consumption estimation.

Describes capacity and the consumption of the EV. Refer to the original type ElectricEngine.Consumption for more information.

Specifies the efficiency of the vehicle. Refer to the original type ElectricEngine.Efficiency for more information.

Represents the types of the vehicle engine (e.g., electric).

A representation of an entry point for a POI.

Wrapper to provide equatable conformance to Apple objects inside of the SDK.

Defines publishable and subscribable action.

The Feature structure encapsulates a GeoJSON Feature - a geospatial object with associated properties. GeoJSON supports the following geometry types: Point, LineString, Polygon, MultiPoint, MultiLineString, MultiPolygon, and GeometryCollection. Features in GeoJSON contain a Geometry object and additional properties.

Defines fuel types supported in the fuzzy search.

Generic container for GeoJSON geometry types.

GeoJSON is a geospatial data interchange format based on JavaScript Object Notation (JSON). It defines several types of JSON objects and the manner in which they are combined to represent data about geographic features, their properties, and their spatial extents. For more info on the GeoJSON format see the following document.

GeoJSONGeometry is an enumeration representing the seven geometry types defined in the GeoJSON format. Each case of the enum wraps a corresponding structure that provides detailed geometric data.

Fundamental geometry construct. All other GeoJSON geometry types are built based on it.

The Geometry struct represents a single geometric entity according to the GeoJSON specification.

The GeometryCollection struct represents a collection of Geometry objects as defined by the GeoJSON specification. It provides a way to group multiple geometries together, regardless of their types.

GeoJSON represented by GeometryData.

A hazard.

Categories of hazards.

Identifies a hazard.

The location information for the hazard.

The severity of a hazard describes its criticality with respect to the danger. The severity may get lower over time as the hazardous situation becomes more secure (e.g., police regulating traffic).

Describes the type of Hazard data.

Represents types of cargo that may be classified as hazardous materials and restricted from some roads. Available values are UN Hazmat classes 1 through 9, plus generic classifications for use in other countries. For more information about the Hazmat classes, refer to: https://www.iafc.org/topics-and-tools/hazmat/fusion-center/transportation-commodities/dot-hazard-classification-system

An array of two or more GeoJSON positions.

Protocol that defines log destination, such as file, console, etc.

For more information on log configurator see LogConfigurator.

For more information on log configuration see LogConfiguration.

Identifier of the map.

Position of the map.

A reference of a map ID and arc information.

Extending standard structures like Measurement with properties like var meters is convenient:

• it avoids extracting value without explicit conversion to a certain unit
• it simplifies getting value from an optional Measurement

But it is also risky because these extensions might conflict with extensions from other libraries or Apple. This decorator mitigates the risk of conflicts while providing a short, readable code.

Typical use cases are:

• extracting value from a value representing a unit of measure: let optionalDistanceInMeters = distance?.tt.meters
• performing computations on values representing units of measure: cumulativeDistance += anotherDistance.tt
• comparing values representing units of measure: if delay < .tt.seconds(5) {}
• combining value extraction and typecast: let intValue = distance.tt.intValue(in: .meters)

MetadataProvider stores during app lifecycle additional metadata for HTTP requests to TomTom Network APIs and implements adding this additional metadata to HTTP request’s headers

A vehicle of type motorcycle.

Trait interface for vehicles that may have electric and/or combustion engines. These vehicles may also be subject to restrictions based on their size or weight.

Both engines should be set for a hybrid vehicle. Setting no engine is also fine if consumption is irrelevant for a calculation, such as when requesting a range based on time or distance budgets.

An array of line string geometries. Each line string is represented by a one-dimensional GeoJSON position array.

An array of GeoJSON positions.

An array of polygon geometries.

Total number of lanes on the road in both directions.

Observable is an interface for a container of observers. It allows sending notifications on certain events to all of the added observers.

We provide the implementation of this protocol: TomTomSDKCommon/ObservableHandler.

A thread-safe implementation of the Observable container.

Any method can be called from any queue. The notification of observers, completions, and other closures will be executed on a dispatch queue provided in the init method.

Any concrete observer should conform to this protocol so we can create a weak reference to it.

Defines the OpeningHours of a POI.

An option that defines for what days opening hours would be requested.

A pedestrian.

Represents information about specific place.

Point of Interest information for a search result.

POI category ID.

Defines the POI identifier (POIID) required to fetch POI details.

A single GeoJSON position.

An array of linear ring geometries. Each linear ring is represented by a one-dimensional GeoJSON position array. For polygons with multiple rings, the first must be the exterior ring and any others must be interior rings or holes.

Region ID for a region inside a map.

A coarse-grained classification of roads according to road purpose and capacity. In general, it is associated with specific horizon data.

Indicates the class of a road.

Road pavement condition types.

Provides information about the properties of the road at the current location.

Represents a road shield, a sign used to indicate the route number and the road’s classification.

Indicates the subclass of a road.

Classifies roads according to their purpose and function. The road-type classification can be used for efficient traffic flow management, avoidance of specific routes based on selected criteria, and visual differentiation of road segments on the map.

Define a common safety location.

Identifies a safety location.

Defines the source of the produced search result.

Speed limit consisting of a speed limit type and a speed limit value.

Defines standard the POI category identifiers. The enum value provides the semantic of the POI category. Multiple POICategoryID can have the same StandardCategoryID value.

A vehicle of type taxi.

Representation of a traffic event. Traffic events represent unusual situations on the road, like traffic congestion, accidents or road works.

A vehicle of type truck.

Unit specifying the electric efficiency, e.g., in kilowatt hours per kilometer.

Unit specifying the energy density (of fuel). For example, energy density is 34.2 MJ/l for gasoline and 35.8 MJ/l for diesel fuel.

Unit specifying the fuel usage (of a vehicle) over time.

A quantity describing a ratio, also commonly used for probabilities. (For example, 10%.)

Units system

A vehicle of type van.

Specifies the vehicle (or lack of one).

Describes dimensions of the vehicle.

VehicleError used for exceptions indicating vehicle errors.

Describes vehicle model identifier.

Represents the “vehicle type” parameter in a request to the Routing API.

Specifies the ratio by which energy is converted during velocity changes.

Specifies the minimum (inclusive) and maximum (exclusive) voltage values. The lower bound value should be a non-negative number (positive or zero). The upper bound value should be greater than the lower bound, or if set to zero, it will be treated as infinity. If not specified, a range of [0, infinity] is assumed.

Indicates the severity of the traffic event. Values are chosen according to the TPEG-TEC standard.