This version is deprecated and will be removed on April 30, 2024. Explore the latest version .

APIs/Connected Vehicle API
APIs/Connected Vehicle API

Navigation

Send navigation point of interest

Deprecated. This endpoint will be removed in the next version.

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

KeyDescription

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.

FieldDescription

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.

FieldDescription

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 -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"
    }
  ]
}