TomTomSDKMapDisplay

Represents camera events.

See more

public enum CameraEvent

extension CameraEvent: Event

extension MichiCameraClient: NKTCameraOperatorDelegate

A protocol that defines camera actions.

See more

public protocol CameraActions

Indicates the class of a road classified by speed limit.

See more

public enum CameraOperatorRoadClass

The camera configuration for a given distance to the next instruction on the route. Intermediate values are obtained by linear interpolation between the corresponding points.

See more

public struct ControlPoint

extension ControlPoint: Equatable

Storage configration for follow camera operator.

See more

public struct FollowCameraOperatorConfig

extension FollowCameraOperatorConfig: Equatable

A type that represents CameraProperties: position, zoom, tilt and rotation

See more

public struct CameraProperties

A type that represents camera tracking modes.

See more

public enum CameraTrackingMode : Equatable

The CameraUpdate class specifies the map view’s camera position, zoom, tilt, rotation and more.

There are two ways to set a camera update:

• Call TomTomMap.applyCamera(_:, animationDuration:, completion:) or TomTomMap.moveCamera(_:) which sets the camera update with a corresponding animation for the former or no animation for the latter.

• Set it directly through the MapView, i.e.: mapView.cameraUpdate = CameraUpdate(position: .AMSTERDAM, zoom: 11).

Each method has its limitations:

• When calling applyCamera(_:, animationDuration:, completion:) and moveCamera(_:) through the TomTomMap, there are certain CameraUpate properties that can and cannot be used in conjunction with others:

init(position:zoom:tilt:rotation:positionMarkerVerticalOffset:scale:fieldOfView:):

• zoom - cannot be used together with scale.
• scale - cannot be used together with zoom.

init(zoomBy:zoomIn:zoomOut:tiltBy:rotateBy:moveBy:fieldOfViewChangeBy:):

• zoomBy - cannot be used together with zoomIn or zoomOut.
• zoomIn- cannot be used together with zoomOut or zoomBy.
• zoomOut- cannot be used together with zoomIn or zoomBy.

• moveBy - cannot be used together with any of the other properties.

  • When setting directly the cameraUpdate field through the MapView, no animation is applied and only these specific properties can be set:

• position.

• zoom - cannot be used together with scale.

• tilt.

• rotation.

• scale - cannot be used together with zoom.

• fieldOfView.

• moveBy - cannot be used together with any of the other properties.

See more

public struct CameraUpdate : Equatable

A type that represents a set of coordinates and the padding around them.

See more

public struct FitToCoordinatesOptions : Equatable

Defines map visible region as CLLocationCoordinate2D coordinates.

See more

public struct VisibleRegion

Defines the gesture state.

See more

public enum GestureState

extension GestureMessage: Equatable

An OptionSet that defines available gestures for ExclusiveGestureManager.

See more

public struct GestureType : OptionSet, Hashable

extension DoubleTapAndPanGestureContainer: UIGestureRecognizerDelegate

extension DoubleTapGestureContainer: UIGestureRecognizerDelegate

extension LongPressGestureContainer: UIGestureRecognizerDelegate

extension PanGestureContainer: UIGestureRecognizerDelegate

extension PinchGestureContainer: UIGestureRecognizerDelegate

extension RotateGestureContainer: UIGestureRecognizerDelegate

extension TapGestureContainer: UIGestureRecognizerDelegate

extension TiltGestureContainer: UIGestureRecognizerDelegate

extension TwoFingerTapGestureContainer: UIGestureRecognizerDelegate

Describes possible cases of MapInteractionEvent.

See more

public enum MapInteraction

extension MapInteraction: Event

Class to add a key for the map. The key must be injected before a MapView can be used.

• Example: “” func application(_: UIApplication, didFinishLaunchingWithOptions _: [UIApplication.LaunchOptionsKey: Any]?) -> Bool { MapsDisplayService.apiKey = “MAP_KEY” […] return true }

- Important: This is a Public Preview API. It may be changed or removed at any time.

See more

final public class MapsDisplayService

CopyrightsServiceProtocol defines a method used to obtain the copyright informations.

See more

public protocol CopyrightsService

Default implementation of CopyrightsService.

See more

final public class TomTomCopyrightsService : CopyrightsService

extension MichiLocationClient: NKTPositionMarkerClickedDelegate

Types of the location marker visualization.

See more

public enum LocationIndicator : Equatable

Type to control location features.

See more

public protocol LocationActions

extension DefaultLocationService: LocationProviderObservable

The cache which is being used while fetching map tiles.

See more

public enum OnlineCachePolicy

extension OnlineCachePolicy: Equatable

MapActions defines a set of methods closely connected to the map.

See more

public protocol MapActions

MapGestureDisableOption An option set defining the map gestures to be disabled.

See more

public enum MapGestureDisableOption

Allows the user to configure the initial parameters of the map.

MapOptions is used in conjunction with MapViewinitialization, i.e: When creating a MapView, it is possible to pass a MapOptions object to configure the MapView before it is showing on the screen, for example, creating a MapView object with the default TomTom style, and a dark style mode: let mapOptions = MapOptions(mapStyle: .defaultStyle, apiKey: "your-key", styleMode: .dark) let mapView = MapView(mapOptions: mapOptions)

Creating a MapView without passing a MapOptions object, will result in the MapView being created using the deafult values. In such case, the API Key that will be used for the map will be taken from MapsDisplayService.apiKey.

See more

public class MapOptions : NSObject

The OnDiskCachePolicy sets rules for caching: time interval of storing the cache, maximum cache size, etc.

See more

public enum OnDiskCachePolicy : Equatable

Holder struct for main and dark version of the style definition. If darkStyle is not provided, setting TomTomMap.styleMode has no effect.

See more

public struct StyleContainer

extension StyleContainer: Equatable

The map style definition. For style file format see map style specification. Style Specification is a formal definition of all properties that define the map’s appearance.

See more

public enum StyleDefinition

extension StyleDefinition: Equatable

Defines size for chevron or pointer for particular zoom level.

See more

public struct PositionMarkerSize

extension PositionMarkerSize: Equatable

Defines the map styles available to the user.

See more

public enum StyleMode

The Layer protocol that represents map layer.

See more

public class Layer

Type of this layer.

See more

public enum LayerType

The Metadata is used to carry extra information.

See more

public struct Metadata

Tile source definition. Details can be found: https://github.com/mapbox/tilejson-spec

public struct TilesDefinition

The SourceCollection

See more

public struct SourceCollection

This class provides a container for tiles sources information and map layers.

See more

public final class Style

extension StyleFetcherError: Equatable

extension StyleFetcherError: LocalizedError

Base protocol for AnnotationOptions

public protocol AnnotationOptions

Base protocol for any Annotation: polygon, line, circle, marker etc.

See more

public protocol Annotation

A type that represents circle options.

See more

public struct CircleOptions : AnnotationOptions, Equatable

Represents the circle on the map.

See more

public class Circle : Annotation

extension GeoJSONMarkerOptions: Equatable

Scene level where the specified color should be used.

public typealias SceneLevel = Double

The offset of the line to be created.

public typealias OffsetUnits = Double

Dash length units.

public typealias DashLengthUnits = Double

Line cap placement

See more

public enum LineCapPlacement

Line join type.

See more

public enum LineJoinType

Line pattern type.

See more

public enum LinePatternType

Line unit.

See more

public enum LineUnit

Line pattern repeat.

See more

public enum LinePatternRepeat

Line outline style.

See more

public enum LineOutlineStyle

Line cap type.

See more

public enum LineCapType

Scene color.

See more

public struct SceneColor : Equatable

Width scene.

See more

public struct WidthScene : Equatable

Outline width scene.

See more

public struct OutlineWidthScene : Equatable

Reserve coordinate.

See more

public struct ReserveCoordinate : Equatable

Coordinate along line.

See more

public struct CoordinateAlongLine : Equatable

Line pattern.

See more

public struct LinePattern : Equatable

Pattern length scene.

See more

public struct PatternLengthScene : Equatable

Pattern begin offset scene.

See more

public struct PatternBeginOffsetScene : Equatable

Represents the line on the map.

See more

public class Line : Annotation

Line options.

See more

public struct LineOptions : AnnotationOptions, Equatable

A type that represents marker options.

See more

public struct MarkerOptions : AnnotationOptions, Equatable

Represents the marker on the map.

See more

public class Marker : Annotation

Text anchoring

See more

public enum TextAnchoring

Options that define label inside marker. Can be used with MarkerOptions.

See more

public struct MarkerLabelOptions : AnnotationOptions, Equatable

Options that defines inner polygon. Can be used with PolygonOverlayOptions.

See more

public class InnerPolygonOptions : AnnotationOptions

A polygon overlay can be built by setting the outer area color and adding inner polygons. Only one inner polygon is supported, but the inner polygons can be nested. Example:

   let innerOptions = InnerPolygonOptions(fillColor: .red
                                      coordinates: coordinates)

   innerOptions.nestedPolygonOptions = InnerPolygonOptions(
       fillColor: UIColor.blue,
       coordinates: coordinates
   )

   let polygonOptions = PolygonOverlayOptions(outerColor: .green,
                                          innerPolygonOptions: innerOptions)

   try? mapView.map.addPolygonOverlay(options: polygonOptions)

}

See more

public class PolygonOverlay : Annotation

Options for creating a PolygonOverlay.

See more

public class PolygonOverlayOptions : AnnotationOptions

Type that represents texture options.

See more

public struct TextureOptions : Equatable

Polygon options.

See more

public struct PolygonOptions : AnnotationOptions, Equatable

Represents the polygon on the map.

See more

public class Polygon : Annotation

The PolygonError enum contains possible errors that can occurs during Polygon init.

See more

public enum PolygonError : Error

extension PolygonError: LocalizedError

A protocol that defines map annotation actions.

See more

public protocol AnnotationsActions

Annotation service error.

See more

public enum AnnotationServiceError : Error

extension AnnotationServiceError: LocalizedError

RenderedFeature class

See more

public struct RenderedFeature

Rendered features query.

See more

public struct RenderedFeatureQueryOptions

Rendered Feature Actions protocol.

See more

public protocol RenderedFeatureActions

A Route representation which can be added and displayed on the map.

To show a Route on the map, call the TomTomMap.addRoute(RouteOptions) method. You can configure its shape and appearance with the RouteOptions class. Drawing a Route on the map requires a list with coordinates of the Route points.

See more

public class Route

RouteDelegate.

See more

public protocol RouteDelegate : AnyObject

The coordinate region.

See more

public struct CoordinateBounds

Enumeration of route errors.

See more

public enum RouteError : LocalizedError

Protocol allowing management of the route representation on the map.

See more

public protocol RouteActions

Route instruction.

See more

public struct RouteInstruction

Class that contains configuration of the route that will be drawn on the map.

Example:

let routeOption: RouteOptions = RouteOptions(coordinates: route.geometry)
guard let mapRoute = try? self.mapView.map.addRoute(routeOption) else { return }

See more

public struct RouteOptions

A model that represents a part of the road under some special conditions, i.e., a tunnel or a non-drivable road, with a respective range. This model describes these road segments, and then passes these segments to RouteOptions as part of the route’s configuration that is drawn on the map.

See more

public struct RouteSection

extension DefaultRouteService: MapInteractionObserver

The traffic category icon.

See more

public enum TrafficIconCategory

The traffic magnitude.

See more

public enum TrafficMagnitude

Represents traffic incident details.

See more

public struct TrafficIncident

Protocol that defines method that will be performed when user clicked on traffic incidents icon.

See more

public protocol TrafficIncidentObserver : Observer

Defines available actions according to vehicle restriction feature.

See more

public protocol VehicleActions

The MapView object to wrap the underlying map renderer.

It contains the map created by the renderer in the view hierarchy and provides UI and view life-cycle functionalities. The view can be created programmatically, via xib or storyboards.

For example, displaying a simple MapView programmatically using a constraints-based layout:

Initialization:

lazy var mapView: MapView = {
  let mapOptions = MapOptions(mapStyle: .defaultStyle, apiKey: "your-key")
  let mapView = MapView(mapOptions: mapOptions)
  return mapView
}()

Layout:

mapView.translatesAutoresizingMaskIntoConstraints = false
view.addSubview(mapView)
NSLayoutConstraint.activate([
  mapView.widthAnchor.constraint(equalTo: view.widthAnchor),
  mapView.heightAnchor.constraint(equalTo: view.heightAnchor),
])

Setting up the receival of life-cycle events and updates, as well as setting the initial zoom and position of the map view:

mapView.delegate = self
mapView.cameraUpdate = .init(position: .AMSTERDAM, zoom: 13)

There will also be a need to conform your UIViewController to MapViewDelegate and implement the required methods.

See more

@objc
open class MapView : UIView

Enumeration of TomTomMap View errors.

See more

public enum MapViewError : LocalizedError

MapMetalRendererFrameCaptureDelegate exposes possibility to get currently drawn frame as a texture. Using this delegate may have impact of performance rendering.

See more

public protocol MapRendererFrameCaptureDelegate : AnyObject

The MapViewDelegate protocol defines a set of methods that can be implemented to receive events and updates related to the MapView life cycle.

See more

public protocol MapViewDelegate : AnyObject

extension CurrentLocationButtonViewModel: LocationProviderObservable

extension AggregatingMapMetricsMonitorService: MapMetricsMonitorService

extension AggregatingMapMetricsMonitorService: MapMetricsObserver

extension AggregatingMapMetricsMonitorService: ContinuousMapMetricsMonitorService

extension DefaultMapMetricsMonitorService: MapMetricsMonitorService

extension DefaultMapMetricsMonitorService: MapMetricsObserver

The MapDisplayDataProvider protocol that can be used to add custom data providers. FileOutput - Default logger output - prints logs using Swift.print

See more

public protocol MapDisplayDataProvider

A cancellable task of a data provider which gathers the resource.

See more

public protocol MapDisplayDataRequestToken

Protobuf-encoded map tile data. The format of the tile data is formally described using the protobuf schema available on: https://developer.tomtom.com/map-display-api/documentation/vector/content#schema-data

See more

public struct MapTile

Describes options to request map tiles for given zoom and coordinate.

Detailed explanation of values can be found on: https://developer.tomtom.com/map-display-api/documentation/zoom-levels-and-tile-grid

See more

public struct MapTileOptions : Equatable

Responsible for creating instances of MapDisplayDataProvider for handling online map tile requests.

See more

public enum OnlineTileDataProviderFactory

Methods for managing map interactions and events.

See more

public protocol MapDelegate : AnyObject

The methods that an object adopts to manage callout views for a MapView.

See more

public protocol MapDataSource : AnyObject

The TomTomMap class serves as the foundational class, acting as the primary gateway for integrating a multitude of map-related features. It offers a rich set of functionalities enabling developer interaction with the map and customizing its behavior.

TomTomMap can be accessed in several ways through the MapView class:

• Through the property mapView.map.
• By calling mapView.getMapAsync, i.e., mapView.getMapAsync { map in // do something with map }
• By assigning mapView.onMapReadyCallback, i.e., mapView.onMapReadyCallback = { map in // do something with map }
• By defining mapView(_:, onMapReady:) through the MapDelegate, i.e., func mapView(_: MapView, onMapReady map: TomTomMap) { // do something with the map } In most cases, the preferred way to access the map would be through the property mapView.map, but in some cases where the map should be ready first, such as when calling showVehicleRestrictions(vehicle:) the preferred way would be mapView.getMapAsync or mapView.onMapReadyCallback.

See more

public class TomTomMap : AnnotationsActions, RouteActions, MapActions

extension TomTomMap: CameraActions

extension TomTomMap: RenderedFeatureActions

extension TomTomMap: VehicleActions, LocationActions