# Pierwsze kroki ## Architektura rozwiązania Dokumentacja VirtualCar360 opisuje funkcjonalności, które pozwalają prezentować pojazdy na stronach dealerskich, marketplace’ach, portalach ogłoszeniowych oraz w wewnętrznych systemach sprzedażowych. Rozwiązanie składa się z kilku głównych obszarów: standardowego **Playera**, interaktywnego **Playera 360**, materiałów **Video**, **Certyfikatu** oraz **API**, które pozwala pobierać zdjęcia, dane galerii, hotspoty i linki do materiałów multimedialnych. VirtualCar360 może być wykorzystywany zarówno jako gotowy komponent do osadzenia na stronie, jak i jako źródło danych dla własnych systemów klienta. Dzięki temu integracja może być bardzo prosta; przez osadzenie Playera, albo bardziej zaawansowana, oparta o pełne wykorzystanie API. ## Player Player VirtualCar360 to gotowy widget przeznaczony do osadzania na stronach internetowych, może automatycznie pobierać dane pojazdu po **carId** lub **numerze VIN** albo po **numerze rejestracyjnym**. Dzięki temu można łatwo powiązać go z ofertą znajdującą się już w systemie dealera lub na stronie internetowej. Najczęściej wykorzystywany jest jako `iframe`, dzięki czemu integracja może być bardzo szybka i nie wymaga budowania własnego interfejsu galerii od podstaw. Player prezentuje zdjęcia samochodu w formie atrakcyjnej, interaktywnej galerii. Standardowo może wyświetlać zdjęcia pojazdu z zamkniętymi drzwiami, a w zależności od dostępnych materiałów również zdjęcia z otwartymi drzwiami, panoramę wnętrza, interaktywnymi zdjęciami wykonanych z gimbala, oraz zdjęciami dodatkowymi. może być wykorzystywany w kilku miejscach strony: * na listingu ofert, * jako dodatkowy element opisu pojazdu, * jako główny slider na stronie szczegółów pojazdu, * jako interaktywna galeria zdjęć samochodu. Użytkownik może wygodnie przeglądać zdjęcia, powiększać je i analizować detale pojazdu. Jest to szczególnie ważne w sprzedaży online, gdzie jakość prezentacji zdjęć bezpośrednio wpływa na zaufanie klienta i atrakcyjność oferty. Player może również obsługiwać dodatkowe funkcje, takie jak: * wyświetlanie innych ofert z tej samej lokalizacji, * prezentacja certyfikatu samochodu, * obsługa zdjęć dodatkowych, * powiększanie zdjęć, * prezentacja hotspotów naniesionych na zdjęcia, * wyświetlanie klasyfikowanych oznaczeń i detali pojazdu. Hotspoty pozwalają oznaczać konkretne miejsca na zdjęciach. Mogą wskazywać elementy wyposażenia, detale pojazdu, uszkodzenia, cechy inspekcji albo inne informacje istotne dla klienta końcowego. Hotspoty mogą być klasyfikowane i powiększane, co ułatwia dokładną analizę pojazdu bez konieczności fizycznych oględzin. Do hotspotu mogą być przypisane zdjęcia dodatkowe. Przykładowo, jeżeli na zdjęciu samochodu zaznaczony jest reflektor, hotspot może zawierać dodatkowe powiększone zdjęcie tego reflektora. Jeżeli zaznaczona jest rysa na karoserii, hotspot może pokazywać dokładne zdjęcie tego miejsca w większym zbliżeniu. Dzięki hotspotom Player nie jest tylko zwykłą galerią zdjęć, ale interaktywnym narzędziem do prezentacji szczegółów pojazdu. Pozwala to lepiej pokazać stan samochodu, elementy wyposażenia oraz detale, które są ważne dla klienta końcowego. Wygląd oraz zachowanie Playera można konfigurować. Szczegółowy opis dostępnych ustawień znajduje się w dalszej części dokumentacji, w sekcji **Customization**. ## Player 360 Player 360 służy do interaktywnej prezentacji obrotu samochodu. Użytkownik może samodzielnie obracać pojazd, przesuwać widok oraz powiększać zdjęcia, aby dokładnie obejrzeć karoserię i najważniejsze detale. Pełny obrót pojazdu może powstać z 4 lub 8 zdjęć samochodu przy wykorzystaniu autorskiej technologii AI. Na tej podstawie generowana jest płynna interakcyjna animacja obrotu, która daje efekt pełnej prezentacji 360° bez konieczności wykonywania bardzo dużej liczby zdjęć źródłowych. Ważną cechą Playera 360 jest to, że podczas powiększania wykorzystywane są oryginalne zdjęcia samochodu. Dzięki temu użytkownik może korzystać z płynnej animacji, a jednocześnie oglądać szczegóły pojazdu w jakości zdjęć źródłowych. Player 360 podnosi jakość prezentacji oferty i pozwala klientowi lepiej ocenić pojazd zdalnie. To rozwiązanie szczególnie przydatne dla dealerów, którzy chcą zapewnić doświadczenie podobne do oglądania samochodu na żywo. ## Video VirtualCar360 umożliwia również generowanie i udostępnianie filmów prezentujących pojazd. Materiały wideo mogą powstawać na podstawie 4 lub 8 ujęć samochodu, podobnie jak prezentacje 360°. Filmy są przygotowywane jako gotowe materiały sprzedażowe, które można wykorzystać na stronie internetowej, w ogłoszeniach, kampaniach marketingowych lub kanałach social media. Materiały video mogą być hostowane na kilku platformach: * na platformie VirtualCar360, * na Vimeo, * na kanale YouTube klienta. Linki do filmów można pobrać przez API razem z danymi galerii pojazdu. Dzięki temu jedna sesja zdjęciowa może zasilać wiele kanałów prezentacji: galerię zdjęć, Player, Player 360 oraz gotowe materiały video. ## Certyfikat VirtualCar360 umożliwia również udostępnianie certyfikatu pojazdu, który może prezentować dodatkowe informacje o samochodzie, wyniki inspekcji, ocenę stanu pojazdu lub inne dane zwiększające wiarygodność oferty. Certyfikat może być widoczny bezpośrednio w Playerze jako element prezentacji samochodu. Dzięki temu klient końcowy może zapoznać się z certyfikatem bez opuszczania galerii pojazdu. Dodatkowo certyfikat można pobrać i udostępnić niezależnie od Playera. Dostępne są różne formy prezentacji: widget do osadzenia na stronie za pomocą iframe, onepage, czyli pełna strona certyfikatu, PDF do pobrania lub przekazania klientowi. Wersje widget, onepage oraz PDF mogą być dostępne w wielu językach. Pozwala to wykorzystać certyfikat zarówno na lokalnych stronach dealerskich, jak i w komunikacji z klientami zagranicznymi. Dedykowany endpoint certyfikatu jest szczególnie przydatny wtedy, gdy certyfikat ma zostać pokazany poza Playerem, na przykład w osobnej sekcji strony pojazdu, w systemie CRM, w panelu administracyjnym albo jako link do pobrania dokumentu PDF. Podobnie jak galerie pojazdów, mogą być pobierane po numerze VIN. Dzięki temu można łatwo powiązać certyfikat z konkretną ofertą pojazdu znajdującą się już w systemie dealera, CRM lub na stronie internetowe ## API API VirtualCar360 pozwala pobierać dane galerii pojazdów bezpośrednio do własnej aplikacji, strony internetowej lub systemu ogłoszeniowego. Jest to najlepszy wybór wtedy, gdy chcesz zbudować własny interfejs prezentacji zdjęć albo zintegrować dane VirtualCar360 z istniejącą platformą. Za pomocą API można pobrać między innymi: * dane galerii pojazdu, * zestawy zdjęć, * zdjęcia zewnętrzne pojazdu, * zdjęcia dodatkowe, * linki do materiałów video, * hotspoty, * informacje potrzebne do wyświetlenia galerii lub prezentacji 360°. API może być wykorzystywane między innymi do: * budowania listingów ofert, * pobierania zdjęć pojazdów do własnej strony internetowej, * archiwizacji zdjęć samochodów, * importowania danych pojazdów do własnych systemów administracyjnych, * integracji z systemami CRM, * integracji z systemami dealerskimi, * zasilania zewnętrznych narzędzi, takich jak WebWizard lub inne systemy klienta, * pobierania linków do materiałów video, * pobierania danych potrzebnych do własnej prezentacji pojazdu. Galerie można wyszukiwać między innymi po numerze VIN lub numerze rejestracyjnym pojazdu. API umożliwia pobranie najnowszej galerii albo listy galerii przypisanych do danego pojazdu. Dostęp do API wymaga klucza API. Klucze są zwykle przypisywane do konkretnej lokalizacji, salonu lub konta dealerskiego. W przypadku większych organizacji możliwe jest również przygotowanie klucza grupowego, który agreguje dane z wielu lokalizacji i pozwala obsługiwać kilka kont w ramach jednej integracji. Taki model sprawdza się szczególnie w przypadku dealerów wielooddziałowych, grup dealerskich oraz integracji, w których jedna strona internetowa prezentuje oferty z wielu lokalizacji. ## Typowy proces integracji 1. Uzyskaj klucz API dla wybranej lokalizacji lub klucz grupowy dla wielu lokalizacji. 2. Skonfiguruj środowisko integracyjne. 3. Wyszukaj galerię pojazdu po numerze VIN lub numerze rejestracyjnym. 4. Pobierz dane galerii, zestawy zdjęć, hotspoty oraz linki do materiałów video. 5. Wyświetl zdjęcia we własnej aplikacji albo osadź gotowy Player. 6. Skonfiguruj wygląd i zachowanie Playera zgodnie z wymaganiami strony. 7. Przetestuj integrację na wybranych pojazdach. 8. Przejdź na środowisko produkcyjne. 9. Wykorzystaj profesjonalną prezentację zdjęć, video i Playera 360, aby szybciej oraz skuteczniej sprzedawać pojazdy online. VirtualCar360 pozwala szybko wzbogacić ofertę pojazdu o profesjonalne zdjęcia, interaktywny obrót 360°, materiały video, hotspoty i certyfikaty. Dzięki temu integracja nie ogranicza się wyłącznie do pobierania zdjęć, umożliwia zbudowanie pełnej, nowoczesnej prezentacji samochodu online.