Alexa.Automotive.VehicleData Interface 1.0


Implement the Alexa.Automotive.VehicleData interface in your Alexa skill for connected vehicles to identify the make, model, year, and other information about a vehicle. For details, see Connected Vehicle Skills for Alexa.

The VehicleData interface is different than other Alexa interfaces in that you aren't directly supporting voice user interactions with Alexa. There are no utterances associated with this interface. Instead, enable Alexa to provide vehicle-specific options, and to identify the correct vehicle when the user makes a request with an ambiguous target vehicle. The VehicleData interface defines no properties or directives, and doesn't participate in state or change reporting. Instead, you provide vehicle data in your discovery response.

For the list of languages that the VehicleData interface supports, see List of Alexa Interfaces and Supported Languages. For the definitions of the message properties, see Alexa Interface Message and Property Reference.

Discovery

You describe endpoints that support Alexa.Automotive.VehicleData using the standard discovery mechanism described in Alexa.Discovery.

Include only one instance of the VehicleData interface in your discover response, as a capability for the endpoint that represents the vehicle itself.

In addition to the usual discovery response fields, for VehicleData, include a configuration object that contains the following fields.

Field Description Type Required
year The year of the vehicle. Integer Yes
engineType The vehicle engine type. The default value is GAS.
Valid values: GAS, ELECTRIC, HYBRID.
String No
resources Friendly names for the make, model, and trim of the vehicle. For details about friendly names, see Friendly Name Resources and Assets. Object Yes
resources.make A friendly name for the make of the vehicle. A label object. Yes
resources.model A friendly name for the model of the vehicle. A label object. Yes
resources.trim A friendly name for the trim level of the vehicle. A label object. No
analytics.segments Information used for analytics, such as the operating system and hardware architecture of the vehicle. An array of objects that each contain a key/value. No

Discover response example

The following example shows a Discover.Response message for a car that supports the VehicleData and Alexa.PowerController interfaces.

For the full list of recommended interfaces for a car, see Interfaces for connected vehicle skills.

For another Discover.Response example, see Discovery for connected vehicle skills.

Copied to clipboard.

{
    "event": {
        "header": {
            "namespace": "Alexa.Discovery",
            "name": "Discover.Response",
            "payloadVersion": "3",
            "messageId": "Unique identifier, preferably a version 4 UUID"
        },
        "payload": {
            "endpoints": [{
                "endpointId": "Unique ID of the vehicle endpoint",
                "additionalAttributes": {
                    "serialNumber": "Serial number of the vehicle"
                },
                "endpointResources": {
                    "manufacturerName": {
                        "@type": "text",
                        "value": {
                            "text": "Manufacturer name of the vehicle",
                            "locale": "en-US"
                        }
                    },
                    "description": {
                        "@type": "text",
                        "value": {
                            "text": "Description to be shown in the Alexa app",
                            "locale": "en-US"
                        }
                    },
                    "friendlyNames": [{
                            "@type": "text",
                            "value": {
                                "text": "Device name that appears in the Alexa app, such as car",
                                "locale": "en-US"
                            }
                        },
                        {
                            "@type": "text",
                            "value": {
                                "text": "Additional device name, such as smart car",
                                "locale": "en-US"
                            }
                        }
                    ]
                },
                "displayCategories": ["VEHICLE"],
                "cookie": {},
                "capabilities": [{
                        "type": "AlexaInterface",
                        "interface": "Alexa.Automotive.VehicleData",
                        "version": "1.0",
                        "configuration": {
                            "year": 2020,
                            "engineType":"ELECTRIC",
                            "resources": {
                                "make": {
                                    "@type": "text",
                                    "value": {
                                        "text": "Chevrolet",
                                        "locale": "en-US"
                                    }
                                },
                                "model": {
                                    "@type": "text",
                                    "value": {
                                        "text": "Silverado",
                                        "locale": "en-US"
                                    }
                                },
                                "trim": {
                                    "@type": "text",
                                    "value": {
                                        "text": "LTZ",
                                        "locale": "en-US"
                                    }
                                }
                            },
                            "analytics": {
                                "segments": [{
                                        "key": "OPERATING_SYSTEM",
                                        "value": "AndroidOreao_8.1"
                                    },
                                    {
                                        "key": "HARDWARE_ARCHITECTURE",
                                        "value": "x86_64"
                                    },
                                    {
                                        "key": "MICROPHONE_TYPE",
                                        "value": "7mic array centrally located"
                                    },
                                    {
                                        "key": "GEOGRAPHY",
                                        "value": "NA"
                                    },
                                    {
                                        "key": "ALEXA_APPLICATION_VERSION",
                                        "value": "2.2.1X"
                                    }
                                ]
                            }
                        }
                    },
                    {
                        "type": "AlexaInterface",
                        "interface": "Alexa.PowerController",
                        "version": "3",
                        "properties": {
                            "supported": [{
                                "name": "powerState"
                            }],
                            "proactivelyReported": true,
                            "retrievable": true
                        }
                    },
                    {
                        "type": "AlexaInterface",
                        "interface": "Alexa",
                        "version": "3"
                    }
                ]
            }]
        }
    }
}

Was this page helpful?

Last updated: Jun 27, 2024