APIs/Connected Vehicle API
APIs/Connected Vehicle API
Navigation
Send navigation point of interest
Endpoint used to send points of interest to the vehicle’s infotainment system. The points will be saved under the dashboard library. You can start navigation against the position and also send a name and phone number of the destination. This will only work if the vehicle has internet access via either external sim card, Bluetooth or wifi.
post
https://api.volvocars.com/connected-vehicle/v1/vehicles/{vin}/commands/navi-point-of-interest
Scopes
openid
conve:navigation
Headers
| Key | Description |
| Key content-type | Description The mediatype of what should be returned. The valid values are: application/vnd.volvocars.api.connected-vehicle.navipointofinterest.v1+json |
| Key authorization | Description The access token issued by Volvo ID identity system. |
| Key vcc-api-key | Description Your application’s VCC API Key. |
All these header values are mandatory. They must exist in every request.Request body
The request body data needed to perform the invocation command is latitude, longitude, name, phone.
| Field | Description |
| Field latitude | Description Is mandatory and should be a value between -180 and 180. |
| Field longitude | Description Is mandatory and should be a value between -90 and 90. |
| Field name | Description Is mandatory and should be a value with at least 3 characters and maximum 17 characters. |
| Field phone | Description Is optional and should be a value with maximum 17 characters. |
Response body
The response’s data node provides the details for the queried request.
| Field | Description |
| Field status | Description Response status code. |
| Field operationId | Description Id to log and track the request. |
| Field async.status | Description Status of the request sent to the car. Always COMPLETED. |
| Field async.id | Description Request id. |
| Field async.href | Description URL of the request to see the details and status of the command. |
| Field async.expires | Description The expiry date for getting the details about the request. The invocation log is stored for one year. |
Examples
curl -v -X POST 'https://api.volvocars.com/connected-vehicle/v1/vehicles/{vin}/commands/navi-point-of-interest' \
-H 'content-type: application/vnd.volvocars.api.connected-vehicle.navipointofinterest.v1+json' \
-H 'authorization: Bearer <your-access-token>' \
-H 'vcc-api-key: <your-vcc-api-key>' \
-d '{\"pointsOfInterest\": [{\"latitude\": 80.30,\"longitude\": 73.31,\"name\": \"Home sweet home\",\"phone\": \"+46707001337432\"}]}'Body
{
"pointsOfInterest": [
{
"latitude": 80.3,
"longitude": 73.31,
"name": "Home sweet home",
"phone": "+46707001337432"
}
]
}