<!--
{
  "availability" : [
    "iOS: 27.0.0 -",
    "iPadOS: 27.0.0 -",
    "macCatalyst: 27.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "CarPlay",
  "identifier" : "/documentation/CarPlay/CPRouteDetail",
  "metadataVersion" : "0.1.0",
  "role" : "Class",
  "symbol" : {
    "kind" : "Class",
    "modules" : [
      "CarPlay"
    ],
    "preciseIdentifier" : "c:objc(cs)CPRouteDetail"
  },
  "title" : "CPRouteDetail"
}
-->

# CPRouteDetail

```
@MainActor class CPRouteDetail
```

## Overview

alongside standard routing details. This includes environmental data, vehicle consumption metrics,
costs, and custom information specific to your app’s routing capabilities.

Route information appears in the route selection interface and during active navigation, helping users
make informed decisions about their journey. The system automatically formats and displays this
information using appropriate styling and placement.

\discussion Use route information to differentiate between routing options and provide transparency
about journey characteristics. For example, display toll costs to help users choose between paid
expressways and free alternatives, or show battery consumption for electric vehicles to ensure
destination reachability.
\note Route information is supplementary to core routing details (distance, time, maneuvers). The
system may choose to display some or all information based on available space and user context.

## Topics

### Initializers

[`convenience init(HOV: String)`](/documentation/CarPlay/CPRouteDetail/init(HOV:)-hin7)

[`convenience init(batteryLevel: Double)`](/documentation/CarPlay/CPRouteDetail/init(batteryLevel:))

Creates additional route information for battery percentage.

[`convenience init(carbonFootprint: Measurement<UnitMass>)`](/documentation/CarPlay/CPRouteDetail/init(carbonFootprint:))

Creates additional route information for carbon footprint.

[`init?(coder: NSCoder)`](/documentation/CarPlay/CPRouteDetail/init(coder:))

[`convenience init(ecoScore: Double)`](/documentation/CarPlay/CPRouteDetail/init(ecoScore:))

Creates additional route information for an eco-score rating.

[`convenience init(emissions: Measurement<UnitMass>)`](/documentation/CarPlay/CPRouteDetail/init(emissions:))

Creates additional route information for emissions data.

[`convenience init(fuelEnergy: Measurement<UnitEnergy>)`](/documentation/CarPlay/CPRouteDetail/init(fuelEnergy:))

Creates additional route information for fuel energy content.

[`convenience init(fuelLevel: Measurement<UnitVolume>)`](/documentation/CarPlay/CPRouteDetail/init(fuelLevel:))

Creates additional route information for a fuel level.

[`convenience init(fuelMass: Measurement<UnitMass>)`](/documentation/CarPlay/CPRouteDetail/init(fuelMass:))

Creates additional route information for fuel mass.

[`convenience init(hov: String)`](/documentation/CarPlay/CPRouteDetail/init(hov:)-6ivii)

Creates additional route information for High-Occupancy Vehicle (HOV) lane access.

[`convenience init(info: String)`](/documentation/CarPlay/CPRouteDetail/init(info:))

Creates additional route information with a freeform informational string.

[`convenience init(kilowattHours: Measurement<UnitEnergy>)`](/documentation/CarPlay/CPRouteDetail/init(kilowattHours:))

Creates additional route information for battery energy in kilowatt-hours.

[`convenience init(parking: String)`](/documentation/CarPlay/CPRouteDetail/init(parking:))

Creates additional route information describing parking at the destination.

[`convenience init(rating: Double)`](/documentation/CarPlay/CPRouteDetail/init(rating:))

Creates additional route information for a route rating.

[`convenience init(symbolName: String, value: String)`](/documentation/CarPlay/CPRouteDetail/init(symbolName:value:))

Creates custom additional route information with a symbol name and value.

[`convenience init(tollAmount: Double, locale: Locale)`](/documentation/CarPlay/CPRouteDetail/init(tollAmount:locale:))

Creates additional route information for a toll amount.

[`convenience init(trafficLights: Int)`](/documentation/CarPlay/CPRouteDetail/init(trafficLights:))

Creates additional route information for the number of traffic lights along the route.

[`convenience init(warning: String)`](/documentation/CarPlay/CPRouteDetail/init(warning:))

Creates additional route information for route warnings.

### Instance Properties

[`var symbolTintColor: UIColor?`](/documentation/CarPlay/CPRouteDetail/symbolTintColor)

The symbolTintColor to apply to the label.

## Relationships

### Conforms To

[`NSCoding`](/documentation/Foundation/NSCoding)

[`NSObjectProtocol`](/documentation/ObjectiveC/NSObjectProtocol)

[`NSCopying`](/documentation/Foundation/NSCopying)

[`CVarArg`](/documentation/Swift/CVarArg)

[`CustomStringConvertible`](/documentation/Swift/CustomStringConvertible)

[`CustomDebugStringConvertible`](/documentation/Swift/CustomDebugStringConvertible)

[`Hashable`](/documentation/Swift/Hashable)

[`Sendable`](/documentation/Swift/Sendable)

[`Equatable`](/documentation/Swift/Equatable)

[`NSSecureCoding`](/documentation/Foundation/NSSecureCoding)

### Inherits From

[`NSObject-swift.class`](/documentation/ObjectiveC/NSObject-swift.class)

---

Copyright &copy; 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)