Skip to content
Last updated

FAQ

This page answers common questions about VirtualCar360, Player, Player 360, video, certificates and API integration.


General

What is VirtualCar360?

VirtualCar360 is a solution for presenting vehicles online using photos, 360° galleries, interactive Players, hotspots, video materials, certificates and API integrations.

What is the difference between the Player and the API?

The Player is a ready-made component embedded as an iframe. The API is used to retrieve data such as galleries, photos, hotspots and video links for custom implementations.

When should I use the Player?

Use the Player when you want to quickly embed a complete vehicle presentation without building a custom gallery.

When should I use Player 360?

Use Player 360 when you want to present a smooth interactive 360° rotation of a vehicle.

When should I use the API?

Use the API when you want to build your own gallery, import data into another system, archive photos or integrate with CRM, DMS or a classified portal.


Access and authorization

How do I get an API key?

Contact VirtualCar360 support. The key can be assigned to one location or multiple locations as a group key.

Is the API key required?

Yes. API calls require the key query parameter. Player URLs also require a key when they retrieve data from VirtualCar360.

Can one key work for multiple locations?

Yes. A group key can be configured by support for multi-location or multi-brand organizations.


Player

How do I embed the Player?

<iframe
  src="https://virtualcar360.pl/player/?vin=WBA1234567890&key=YOUR_API_KEY"
  width="100%"
  height="600"
  frameborder="0"
  allowfullscreen
></iframe>

Does the Player require a backend?

No. For simple embedding, the Player can be used directly as an iframe.

Can the Player load by VIN?

Yes. Use the vin parameter.

Can the Player load by registration number?

Yes. Use the numberplates parameter.

Can the Player load by carId?

Yes. carId points to a specific Player presentation.

Does the Player support hotspots?

Yes, if hotspots are available for the gallery.

Can the Player show certificates?

Yes, if a certificate is available and configured for the vehicle.


Player 360

What is Player 360?

Player 360 is a Player variant for smooth interactive vehicle rotation.

How many frames does Player 360 use?

Depending on configuration, Player 360 can use 180 or 360 frames.

Are all frames real photos?

No. Intermediate frames can be generated by AI from 4 or 8 original vehicle shots.

Do AI-generated frames have hotspots?

No. Hotspots can be available only on original photos.

How does zoom work?

When zooming, the Player moves to the nearest original photo and zooms into that source image.


Video

Is video available by default?

Not always. Contact support to enable video generation.

What does the default video show?

It shows a 360° vehicle rotation, usually around 20 seconds long, generated from 4 or 8 photos.

Where is video stored?

In VirtualCar360 and on Vimeo. On request, it can also be uploaded to the customer's YouTube channel.


Certificate

Can certificates be retrieved by VIN?

Yes. The Certificate API retrieves certificates by VIN.

What does the Certificate API return?

It returns URLs for widget, onepage and available pdf files.

Can I embed a certificate in iframe?

Yes. Use the widget URL for embedding.


Troubleshooting

Check the API key, vehicle identifier, location access and whether the vehicle has a gallery.

The API returns 404. What does it mean?

Usually no data was found for the provided VIN, registration number or carId.

Video is missing. Why?

Video may not be enabled, may not have been generated yet or YouTube integration may not be configured.

The PDF URL may be temporary. Fetch a fresh certificate response from the API.