Every image comes with its points, so a close-up is a crop around one of them. These are the front wheels of eight cars, each cut from its side view at rim-front-left.
A used car with its condition notes, each tied to a point. Switch the angle: the notes move with the car, and a point that cannot be seen is left out.
hoodheadlight-leftrim-front-leftrim-rear-lefttrunkAdd hotspots=true to any studio image or 360° ring. Each point comes with an id and its position as a fraction of the image, so it lands in the right place at every size and crop.
GET /api/Mercedes-Benz/C-Class/2026/Sedan/AMG Line/front_left?hotspots=true
{
"view": "front_left",
"image_url": "https://api.vehicleimagery.com/image/…",
"hotspots": [
{ "id": "rim-front-left", "x": 0.63, "y": 0.635 },
{ "id": "rim-rear-left", "x": 0.869, "y": 0.616 },
{ "id": "headlight-left", "x": 0.521, "y": 0.418 },
{ "id": "mirror-left", "x": 0.773, "y": 0.262 },
{ "id": "grille", "x": 0.311, "y": 0.519 },
…
]
}dot.style.left = spot.x * 100 + '%';
dot.style.top = spot.y * 100 + '%';Which of them a car has depends on the model. A point hidden in a view is left out of that view's list.
rim-front-leftrim-front-rightrim-rear-leftrim-rear-rightheadlight-leftheadlight-righttaillight-lefttaillight-rightmirror-leftmirror-rightgrillelogo-frontlogo-rearhoodrooftrunkexhaustdoor-handle-leftThe points are the anchor; what hangs on them is yours. They work with every other option, from paint to plate to background.
Wheels, headlights, tail lights, mirrors, grille, badges, bonnet, roof, boot and exhaust, depending on the model. Each image lists only the points that can be seen in it.
Multiply x by the width and y by the height you show the image at. Both are fractions of the delivered image, so they hold for every size, ratio and fit.
Yes. With hotspots=true every frame of a ring carries its own list, so the points turn with the car.
No. They belong to the angle: the same angle gives the same points in every colour, with every plate and background.
Yes, they are part of the API v2 add-on, on studio angles and 360° spins.
Tell us what you want to show on the car and where. We send back real examples from your own stock, with the points in every angle.
