> For the complete documentation index, see [llms.txt](https://docs.mapbox.com/ios/navigation/llms.txt)

# Route alerts

Route alerts are notifications about upcoming events or points of interest along the selected route. Unlike visual and spoken instructions, which are necessary to guide the user along the route, route alerts are strictly informational. If you choose to use route alerts as part of a guided navigation session, you are in control of when and how to display or announce these alerts to the user.

## Route alert

In Mapbox Navigation SDK for iOS route alert is exposed as [`RouteAlert`](https://docs.mapbox.com/ios/navigation/api/3.28.1/navigation/documentation/mapboxnavigationcore/routealert/) struct and contains information about:

-   [`roadObject`](https://docs.mapbox.com/ios/navigation/api/3.28.1/navigation/documentation/mapboxnavigationcore/routealert/roadobject/), which describes upcoming route alert (which in turn contains [`RoadObject.Kind`](https://docs.mapbox.com/ios/navigation/api/3.28.1/navigation/documentation/mapboxnavigationcore/roadobject/), which describes kind of the road object)
-   [`distanceToStart`](https://docs.mapbox.com/ios/navigation/api/3.28.1/navigation/documentation/mapboxnavigationcore/routealert/distancetostart/): distance from the current position to the alert, in meters

## Get notified about route alerts

Subscribe to [`NavigationController.routeProgress`](https://docs.mapbox.com/ios/navigation/api/3.28.1/navigation/documentation/mapboxnavigationcore/navigationcontroller/routeprogress/) to be notified when the route progress object changes, which in turn contains route alerts related information in [`RouteProgress.upcomingRouteAlerts`](https://docs.mapbox.com/ios/navigation/api/3.28.1/navigation/documentation/mapboxnavigationcore/routeprogress/upcomingroutealerts/).

## Route alerts

Route alert types are defined in [`RoadObject.Kind`](https://docs.mapbox.com/ios/navigation/api/3.28.1/navigation/documentation/mapboxnavigationcore/roadobject/kind-swift.enum/). Some available types of route alerts include:

-   Incidents on a route
-   Toll booths and electronic gates
-   Country border crossings
-   Tunnels
-   Rest stops
-   Restricted areas
-   Bridges

> **Related content (example): [Route alerts](https://github.com/mapbox/mapbox-navigation-ios/blob/main/Examples/AdditionalExamples/Examples/Route-Alerts.swift)**
> 
> Subscribe to route alert update events.