NavigationMapView
open class NavigationMapView : UIView
NavigationMapView
is a subclass of UIView
, which draws MapView
on its surface and provides convenience functions for adding Route
lines to a map.
-
The minimum preferred frames per second at which to render map animations.
This property takes effect when the application has limited resources for animation, such as when the device is running on battery power. By default, this property is set to
PreferredFPS.normal
.Declaration
Swift
public var minimumFramesPerSecond: PreferredFPS
-
Maximum distance the user can tap for a selection to be valid when selecting an alternate route.
Declaration
Swift
public var tapGestureDistanceThreshold: CGFloat
-
A collection of street road classes for which a congestion level substitution should occur.
For any street road class included in the
roadClassesWithOverriddenCongestionLevels
, all route segments with anCongestionLevel.unknown
traffic congestion level and a matchingMapboxDirections.MapboxStreetsRoadClass
will be replaced with theCongestionLevel.low
congestion level.Declaration
Swift
public var roadClassesWithOverriddenCongestionLevels: Set<MapboxStreetsRoadClass>?
-
NavigationCamera
, which allows to control camera states.Declaration
Swift
public private(set) var navigationCamera: NavigationCamera! { get }
-
Controls whether to show congestion levels on alternative route lines. Defaults to
false
.If
true
and there’re multiple routes to choose, the alternative route lines would display the congestion levels at different colors, similar to the main route. To customize the congestion colors that represent different congestion levels, override thealternativeTrafficUnknownColor
,alternativeTrafficLowColor
,alternativeTrafficModerateColor
,alternativeTrafficHeavyColor
,alternativeTrafficSevereColor
property for theNavigationMapView.appearance()
.Declaration
Swift
public var showsCongestionForAlternativeRoutes: Bool
-
MapView
, which is added on top ofNavigationMapView
and allows to render navigation related components.Declaration
Swift
public private(set) var mapView: MapView! { get }
-
The object that acts as the navigation delegate of the map view.
Declaration
Swift
public weak var delegate: NavigationMapViewDelegate?
-
A type that represents a
UIView
that isCourseUpdatable
.Declaration
Swift
public typealias UserCourseView = UIView & CourseUpdatable
-
A
UserCourseView
used to indicate the user’s location and course on the map.The
UserCourseView
‘sUserCourseView.update(location:pitch:direction:animated:)
method is frequently called to ensure that its visual appearance matches the map’s camera.Declaration
Swift
public var userCourseView: UserCourseView { get set }
-
Initializes a newly allocated
NavigationMapView
object with the specified frame rectangle.Declaration
Swift
public override init(frame: CGRect)
Parameters
frame
The frame rectangle for the
NavigationMapView
. -
Initializes a newly allocated
NavigationMapView
object with the specified frame rectangle and type ofNavigationCamera
.Declaration
Swift
public init(frame: CGRect, navigationCameraType: NavigationCameraType = .mobile)
Parameters
frame
The frame rectangle for the
NavigationMapView
.navigationCameraType
Type of
NavigationCamera
, which is used for the current instance ofNavigationMapView
. -
Returns a
NavigationMapView
object initialized from data in a given unarchiver.Declaration
Swift
public required init?(coder: NSCoder)
Parameters
coder
An unarchiver object.
-
Setups the Predictive Caching mechanism using provided Options.
This will handle all the required manipulations to enable the feature and maintain it during the navigations. Once enabled, it will be present as long as
NavigationMapView
is retained.Declaration
Swift
public func enablePredictiveCaching(options predictiveCacheOptions: PredictiveCacheOptions)
Parameters
options
options, controlling caching parameters like area radius and concurrent downloading threads.
-
Updates the map view’s preferred frames per second to the appropriate value for the current route progress.
This method accounts for the proximity to a maneuver and the current power source. It has no effect if
NavigationCameraState
is in.following
mode.Declaration
Swift
public func updatePreferredFrameRate(for routeProgress: RouteProgress)
-
Updates
UserCourseView
to provided location.Declaration
Swift
public func updateUserCourseView(_ location: CLLocation, animated: Bool = false)
-
Showcases route array. Adds routes and waypoints to map, and sets camera to point encompassing the route.
Declaration
Swift
public func showcase(_ routes: [Route], animated: Bool = false)
Parameters
routes
List of
Route
objects, which will be shown onMapView.
animated
Property, which determines whether camera movement will be animated while fitting first route.
-
Adds the route waypoints to the map given the current leg index. Previous waypoints for completed legs will be omitted.
Declaration
Swift
public func showWaypoints(on route: Route, legIndex: Int = 0)
-
Shows the step arrow given the current
RouteProgress
.Declaration
Swift
public func addArrow(route: Route, legIndex: Int, stepIndex: Int)
-
Removes the step arrow from the map.
Declaration
Swift
public func removeArrow()
-
Receives coordinates for searching the map for buildings. If buildings are found, they will be highlighted in 2D or 3D depending on the
in3D
value.Declaration
Swift
public func highlightBuildings(at coordinates: [CLLocationCoordinate2D], in3D extrudesBuildings: Bool = true, completion: ((_ foundAllBuildings: Bool) -> Void)? = nil)
Parameters
coordinates
Coordinates which represent building locations.
extrudesBuildings
Switch which allows to highlight buildings in either 2D or 3D. Defaults to true.
completion
An escaping closure to be executed when the
MapView
feature querying for allcoordinates
ends. A singleBoolean
argument in closure indicates whether or not buildings were found for all coordinates. -
Removes the highlight from all buildings highlighted by
highlightBuildings(at:in3D:)
.Declaration
Swift
public func unhighlightBuildings()
-
Find and cache the index of the upcoming [RouteLineDistancesIndex].
Declaration
Swift
public func updateUpcomingRoutePointIndex(routeProgress: RouteProgress)
-
Updates the route style layer and its casing style layer to gradually disappear as the user location puck travels along the displayed route.
Declaration
Swift
public func updateRoute(_ routeProgress: RouteProgress)
Parameters
routeProgress
Current route progress.