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

# init(symbolName:value:)

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

```
convenience init(symbolName: String, value: String)
```

## Parameters

`symbolName`

An SF Symbol name to display alongside the value. Choose simple, recognizable
icons that clearly communicate the information type. Symbol images are rendered as templates
and automatically adapt to the current appearance mode (light/dark). Must not be nil.

`value`

A pre-formatted string to display. The string should be concise and include any
necessary units or symbols. The system does not perform additional formatting on custom
values, so ensure proper localization and unit conversion in your app.

## Return Value

A new @c CPRouteDetail instance with the custom symbol and value

## Discussion

Use this method to display app-specific route information that doesn’t fit the predefined
categories. You provide a custom SF Symbol name and a formatted string value that will be
displayed together.

\discussion Custom route information provides flexibility for specialized use cases not covered
by predefined types. However, the system may not display custom items in as many contexts as
predefined information types (toll, fuel, battery, etc.), which receive optimized placement and
visual treatment. Use custom information sparingly for truly unique routing characteristics.
\note Custom route information should be used only when predefined types are insufficient. Consider
whether your use case might be addressed by future additions to the framework. If you find
yourself creating many custom information types, consider filing enhancement requests for
new predefined types that would benefit other developers.

---

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)