init(carIdentifier:displayName:year:make:model:color:headUnit:supportedChargingConnectors:)

Declaration

init(carIdentifier: String, displayName: String?, year: String?, make: String?, model: String?, color: CGColor?, headUnit: INCar.HeadUnit?, supportedChargingConnectors: [INCar.ChargingConnectorType])

Parameters

• carIdentifier:

  A unique identifier for the electric vehicle.

• displayName:

  A user-defined name for the electric vehicle that the system displays.

• year:

  The year of the electric vehicle’s manufacture.

• make:

  The electric vehicle’s manufacturer. Maps displays this value when it presents information about the electric vehicle.

• model:

  The manufacturer’s model name for the electric vehicle. Maps displays this value when it presents information about the electric vehicle.

• color:

  The color of the electric vehicle.

• headUnit:

  An instance of Headunit Swift.class that contains the Bluetooth and iAP2 identifiers of the electric vehicle’s physical head unit.

• supportedChargingConnectors:

  An array of the electric vehicle’s supported charging connectors.

Discussion

The carIdentifier is a unique value that your app provides, and must not be the vehicle’s VIN or equivilent identifier. For the best user experience—and to prevent orphaned or duplicate vehicles in the user’s My Vehicles collection—your app must always provide the same identifier for the same vehicle.

Use carIdentifier when handling INGetCarPowerLevelStatusIntent requests so that the response can match the appropriate vehicle in the user’s Virtual Garage.