NavigationMapView
open class NavigationMapView : UIView
extension NavigationMapView: UIGestureRecognizerDelegate
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.unknowntraffic congestion level and a matchingMapboxDirections.MapboxStreetsRoadClasswill be replaced with theCongestionLevel.lowcongestion 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
trueand 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,alternativeTrafficSevereColorproperty for theNavigationMapView.appearance().Declaration
Swift
public var showsCongestionForAlternativeRoutes: Bool -
Controls whether to show fading gradient color on route lines between two different congestion level segments. Defaults to
false.If
true, the congestion level change between two segments in the route line will be shown as fading gradient color instead of abrupt and steep change.Declaration
Swift
public var crossfadesCongestionSegments: Bool -
List of Mapbox Maps font names to be used for any symbol layers added by the Navigation SDK. These are used for features such as Route Duration Annotations that are optionally added during route preview. See https://docs.mapbox.com/ios/maps/api/6.3.0/customizing-fonts.html for more information about server-side fonts.
Declaration
Swift
@objc dynamic public var routeDurationAnnotationFontNames: [String] -
MapView, which is added on top ofNavigationMapViewand 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? -
PointAnnotationManager, which is used to manage addition and removal of final destination annotation.PointAnnotationManagerwill become valid only after fully loadingMapViewstyle.Declaration
Swift
public var pointAnnotationManager: PointAnnotationManager? -
A
UserCourseViewused 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 } -
Specifies how the map displays the user’s current location, including the appearance and underlying implementation.
By default, this property is set to
UserLocationStyle.courseView, the bearing source is location course.Declaration
Swift
public var userLocationStyle: UserLocationStyle { get set } -
A
TileStoreinstance used by map view.Declaration
Swift
open var mapTileStore: TileStore? { get } -
Initializes a newly allocated
NavigationMapViewobject with the specified frame rectangle.Declaration
Swift
public override init(frame: CGRect)Parameters
frameThe frame rectangle for the
NavigationMapView. -
Initializes a newly allocated
NavigationMapViewobject with the specified frame rectangle and type ofNavigationCamera.Declaration
Swift
public init(frame: CGRect, navigationCameraType: NavigationCameraType = .mobile, tileStoreLocation: TileStoreConfiguration.Location? = .default)Parameters
frameThe frame rectangle for the
NavigationMapView.navigationCameraTypeType of
NavigationCamera, which is used for the current instance ofNavigationMapView.tileStoreLocationConfiguration of
TileStorelocation, where Map tiles are stored. Usenilto disable onboard tile storage. -
Returns a
NavigationMapViewobject initialized from data in a given unarchiver.Declaration
Swift
public required init?(coder: NSCoder)Parameters
coderAn 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
NavigationMapViewis retained.Declaration
Swift
public func enablePredictiveCaching(options predictiveCacheOptions: PredictiveCacheOptions)Parameters
optionsoptions, 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
NavigationCamerais inNavigationCameraState.followingstate.Declaration
Swift
public func updatePreferredFrameRate(for routeProgress: RouteProgress)Parameters
routeProgressObject, which stores current progress along specific route.
-
Updates
UserLocationStyleto provided location.Declaration
Swift
public func moveUserLocation(to location: CLLocation, animated: Bool = false)Parameters
locationLocation, where
UserLocationStyleshould be shown.animatedProperty, which determines whether
UserLocationStyletransition to new location will be animated.
-
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
routesList of
Routeobjects, which will be shown onMapView.animatedProperty, which determines whether camera movement will be animated while fitting first route.
-
Adds main and alternative route lines and their casings on
MapView. Prior to showing, previous route lines and their casings will be removed.Declaration
Swift
public func show(_ routes: [Route], legIndex: Int? = nil)Parameters
routesList of
Routeobjects, which will be shown onMapView.legIndexIndex, which will be used to highlight specific
RouteLegon main 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)Parameters
routeRoute, on which a certainWaypointwill be shown.legIndexIndex, which determines for which
RouteLegWaypointwill be shown. -
Removes all existing
Routeobjects fromMapView, which were added byNavigationMapView.Declaration
Swift
public func removeRoutes() -
Removes all existing
Waypointobjects fromMapView, which were added byNavigationMapView.Declaration
Swift
public func removeWaypoints() -
Shows the step arrow given the current
RouteProgress.Declaration
Swift
public func addArrow(route: Route, legIndex: Int, stepIndex: Int)Parameters
routeRouteobject, for which maneuver arrows will be shown.legIndexZero-based index of the
RouteLegwhich contains the maneuver.stepIndexZero-based index of the
RouteStepwhich contains the maneuver. -
Removes the
RouteSteparrow from theMapView.Declaration
Swift
public func removeArrow()
-
Shows a callout containing the duration of each route. Useful as a way to give the user more information when picking between multiple route alternatives. If the route contains any tolled segments then the callout will specify that as well.
Declaration
Swift
public func showRouteDurations(along routes: [Route]?) -
Removes all visible route duration callouts.
Declaration
Swift
public func removeRouteDurations()
-
Attempts to localize labels into the system’s preferred language.
This method automatically modifies the
SymbolLayer.textFieldproperty of any symbol style layer whose source is the Mapbox Streets source. The user can set the system’s preferred language in Settings, General Settings, Language & Region.This method avoids localizing road labels into the system’s preferred language, in an effort to match road signage and the turn banner, which always display road names and exit destinations in the local language. If this
NavigationMapViewstands alone outside aNavigationViewController, you should call theMapboxMap.onEvery(_:handler:)onmapView, passing inMapEvents.EventKind.styleLoaded, and call this method inside the closure. The map view embedded inNavigationViewControlleris localized automatically, so you do not need to call this method on the value ofNavigationViewController.navigationMapView.Declaration
Swift
public func localizeLabels()
-
Shows voice instructions for specific
Routeobject.Declaration
Swift
public func showVoiceInstructionsOnMap(route: Route)Parameters
routeRouteobject, along which voice instructions will be shown.
-
Receives coordinates for searching the map for buildings. If buildings are found, they will be highlighted in 2D or 3D depending on the
in3Dvalue.Declaration
Swift
public func highlightBuildings(at coordinates: [CLLocationCoordinate2D], in3D extrudesBuildings: Bool = true, completion: ((_ foundAllBuildings: Bool) -> Void)? = nil)Parameters
coordinatesCoordinates which represent building locations.
extrudesBuildingsSwitch which allows to highlight buildings in either 2D or 3D. Defaults to true.
completionAn escaping closure to be executed when the
MapViewfeature querying for allcoordinatesends. A singleBooleanargument in closure indicates whether or not buildings were found for all coordinates. -
Removes the highlight from all buildings highlighted by
highlightBuildings(at:in3D:completion:).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 travelAlongRouteLine(to coordinate: CLLocationCoordinate2D?)Parameters
coordinateCurrent position of the user location.
Install in Dash
NavigationMapView Class Reference