CameraTrackingMode

public enum CameraTrackingMode : Equatable

A type that represents camera tracking modes.

  • The camera does not track the current position (aka the current location).

    Declaration

    Swift

    case none
  • The follow(_:) operator tracks the current position and heading, adjusting the camera so that the position marker is located in the lower middle section of the safe area and is always pointing up. In other words, the operator ensures that the camera is following the current position and pointing in the driving direction.

    At a less detailed scale than 1:2.400.000, the operator behaves like the CameraTrackingMode.follow(_:).

    You can also define a custom follow operator behavior by creating a new instance of the CameraTrackingMode.follow(_:) case with a custom FollowCameraOperatorConfig.

    Default FollowCameraOperatorConfig values are:

    • controlPointsMap: [:]
    • minZoom: 0.0
    • maxZoom: 18.3

    Declaration

    Swift

    case follow(_: FollowCameraOperatorConfig? = FollowCameraOperatorConfig.DEFAULT_FOLLOW_CAMERA_OPERATOR_CONFIG)

    Parameters

    configuration

    Configration for follow camera operator.

  • The followNorthUp(_:) operator tracks the current position and heading, adjusting the camera so that the position marker is located in the lower middle section of the safe area and is always pointing up. In other words, the operator ensures that the camera is following the current position and pointing in the driving direction.

    You can also define a custom follow operator behavior by creating a new instance of the CameraTrackingMode.followNorthUp(_:) case with a custom FollowCameraOperatorConfig.

    Default FollowCameraOperatorConfig values are:

    • controlPointsMap: [:]
    • minZoom: 0.0
    • maxZoom: 18.3

    Declaration

    Swift

    case followNorthUp(_: FollowCameraOperatorConfig? = FollowCameraOperatorConfig.DEFAULT_FOLLOW_CAMERA_OPERATOR_CONFIG)

    Parameters

    configuration

    Configration for follow camera operator.

  • The followRoute(_:) operator tracks the current position, adjusting the camera so that the position marker is in the lower middle section of the safe area and is always pointing up. In other words, the operator ensures the camera is following the current position and is pointing in the driving direction.

    Additionally, the operator also tracks the current route and adjusts the scale and tilt to best highlight the part of the route currently being driven, or the next upcoming guidance instruction.

    At a less detailed scale than 1:2.400.000, the operator behaves like the CameraTrackingMode.followDirection(_:).

    You can also define a custom follow route operator behavior by creating a new instance of the CameraTrackingMode.followRoute(_:) case with a custom FollowCameraOperatorConfig. This operator adjusts the scale and tilt to maximize the visibility of the incoming route instructions, according to the configuration provided in FollowCameraOperatorConfig.ControlPoint.

    Default FollowCameraOperatorConfig values are:

    • controlPointsMap: [:]
    • minZoom: 13.8
    • maxZoom: 18.3
    • defaultTilt: 66.0
    • defaultFieldOfView: 45.0

    Declaration

    Swift

    case followRoute(_: FollowCameraOperatorConfig? = FollowCameraOperatorConfig.DEFAULT_FOLLOW_ROUTE_CAMERA_OPERATOR_CONFIG)

    Parameters

    configuration

    Configration for follow camera operator.

  • The followRouteDirection(_:) operator tracks the current position, adjusting the camera so that the position marker is in the lower middle section of the safe area and is always pointing up. In other words, the operator ensures the camera is following the current position and is pointing in the driving direction.

    Additionally, the operator also tracks the current route and adjusts the scale and tilt to best highlight the part of the route currently being driven, or the next upcoming guidance instruction.

    At a less detailed scale than 1:2.400.000, the operator behaves like the CameraTrackingMode.followNorthUp(_:).

    You can also define a custom follow route operator behavior by creating a new instance of the CameraTrackingMode.followRouteDirection(_:) case with a custom FollowCameraOperatorConfig. This operator adjusts the scale and tilt to maximize the visibility of the incoming route instructions, according to the configuration provided in FollowCameraOperatorConfig.ControlPoint.

    Default FollowCameraOperatorConfig values are:

    • controlPointsMap: [:]
    • minZoom: 13.8
    • maxZoom: 18.3
    • defaultTilt: 66.0
    • defaultFieldOfView: 45.0

    Declaration

    Swift

    case followRouteDirection(
        FollowCameraOperatorConfig? = FollowCameraOperatorConfig
            .DEFAULT_FOLLOW_ROUTE_CAMERA_OPERATOR_CONFIG
    )

    Parameters

    configuration

    Configration for follow camera operator.

  • The followDirection(_:) operator tracks the current position, adjusting the camera so that the position marker is in the center of the safe area. The heading of camera is fixed to 0 (north), meaning that the position marker changes its orientation, but the map does not rotate. The tilt is set to 0.

    At a less detailed scale than 1:2.400.000, the operator behaves like the CameraTrackingMode.followNorthUp(_:).

    You can also define a custom follow direction operator behavior by creating a new instance of the CameraTrackingMode.followDirection(_:) case with a custom FollowCameraOperatorConfig.

    Default FollowCameraOperatorConfig values are:

    • controlPointsMap: [:]
    • minZoom: 11.7
    • maxZoom: 18.3

    Declaration

    Swift

    case followDirection(_: FollowCameraOperatorConfig? = FollowCameraOperatorConfig.DEFAULT_FOLLOW_DIRECTION_CAMERA_OPERATOR_CONFIG)

    Parameters

    configuration

    Configration for follow camera operator.

  • The followRouteNorthUp(_:) operator tracks the current position, adjusting the camera so that the position marker is in the center of the safe area. The camera heading is fixed to the north, meaning the position marker changes its orientation, but the map does not rotate. The tilt is set to 0 (top down view).

    Additionally, the operator also tracks the current route and adjusts the scale and tilt to best highlight the part of the route being currently driven, or the next upcoming guidance instruction.

    You can also define a custom follow route operator behavior by creating a new instance of the CameraTrackingMode.followRouteNorthUp(_:) case with a custom FollowCameraOperatorConfig. This operator adjusts the scale and tilt to maximize the visibility of the incoming route instructions, according to the configuration provided in FollowCameraOperatorConfig.ControlPoint.

    Default FollowCameraOperatorConfig values are:

    • controlPointsMap: [:]
    • minZoom: 13.8
    • maxZoom: 18.3
    • defaultTilt: 66.0
    • defaultFieldOfView: 45.0

    Declaration

    Swift

    case followRouteNorthUp(_: FollowCameraOperatorConfig? = FollowCameraOperatorConfig.DEFAULT_FOLLOW_ROUTE_CAMERA_OPERATOR_CONFIG)

    Parameters

    configuration

    Configration for follow camera operator.

  • The operator tries to fit the routes in the current view, by changing the camera zoom and look-at parameters. It constantly adjusts these parameters in order to keep the remaining part of the route(s) in view. Tilt and heading parameters are set to 0 in this camera mode.

    Declaration

    Swift

    case routeOverview
  • The follow operator tracks the current position and heading, adjusting the camera so that the position marker is located in the lower middle section of the safe area and is always pointing up. In other words, the operator ensures that the camera is following the current position and pointing in the driving direction.

    At a less detailed scale than 1:2.400.000, the operator behaves like the CameraTrackingMode.follow(_:).

    You can also define a custom follow operator behavior by creating a new instance of the CameraTrackingMode.follow(_:) case with a custom FollowCameraOperatorConfig.

    Default FollowCameraOperatorConfig values are:

    • controlPointsMap: [:]
    • minZoom: 0.0
    • maxZoom: 18.3

    Declaration

    Swift

    @available(*, deprecated, renamed: "followNorthUp(﹚", message: "This API is deprecated and will be removed with the next major release.")
    public static let follow: CameraTrackingMode
  • The followDirection operator tracks the current position, adjusting the camera so that the position marker is in the center of the safe area. The heading of camera is fixed to 0 (north), meaning that the position marker changes its orientation, but the map does not rotate. The tilt is set to 0.

    At a less detailed scale than 1:2.400.000, the operator behaves like the CameraTrackingMode.followNorthUp(_:).

    You can also define a custom follow direction operator behavior by creating a new instance of the CameraTrackingMode.followDirection(_:) case with a custom FollowCameraOperatorConfig.

    Default FollowCameraOperatorConfig values are:

    • controlPointsMap: [:]
    • minZoom: 11.7
    • maxZoom: 18.3

    Declaration

    Swift

    @available(*, deprecated, renamed: "followDirection(﹚", message: "This API is deprecated and will be removed with the next major release.")
    public static let followDirection: CameraTrackingMode
  • The followRoute operator tracks the current position, adjusting the camera so that the position marker is in the lower middle section of the safe area and is always pointing up. In other words, the operator ensures the camera is following the current position and is pointing in the driving direction.

    Additionally, the operator also tracks the current route and adjusts the scale and tilt to best highlight the part of the route currently being driven, or the next upcoming guidance instruction.

    At a less detailed scale than 1:2.400.000, the operator behaves like the followRoute.

    You can also define a custom follow route operator behavior by creating a new instance of the CameraTrackingMode.followRoute(_:) case with a custom FollowCameraOperatorConfig. This operator adjusts the scale and tilt to maximize the visibility of the incoming route instructions, according to the configuration provided in FollowCameraOperatorConfig.ControlPoint.

    Default FollowCameraOperatorConfig values are:

    • controlPointsMap: [:]
    • minZoom: 13.8
    • maxZoom: 18.3
    • defaultTilt: 66.0
    • defaultFieldOfView: 45.0

    Declaration

    Swift

    @available(*, deprecated, renamed: "followRouteDirection(﹚", message: "This API is deprecated and will be removed with the next major release.")
    public static let followRoute: CameraTrackingMode