API і SDK EyeSpy360

Що таке віртуальні тури EyeSpy360™?


Захоплюючі 360-градусні оглядові огляди об’єктів нерухомості, човнів, готелів тощо, які користувачі створюють і публікують самостійно за допомогою швидкого та простого редактора віртуальних турів EyeSpy360 . Подивіться наше демонстраційне відео на https://www.eyespy360.com . Це дійсно дуже просто.


Що таке HTML-віджет EyeSpy360™?


Віджет EyeSpy360 — це API / SDK, який дозволяє додавати створення та публікацію віртуальних турів у ваш власний редактор списку нерухомості. Це так само просто, як додати один рядок коду:


 <script src="https://e3.eyespy360.com/widget/virtual-tours.1.0.2.js?key=1234&secret=ABCDEF&externalTourID=myPropertyID&target=virtualTourURL"></script> 


Для кого це?


Ви вже використовуєте систему керування списком нерухомості, де ваші користувачі створюють, редагують і публікують списки нерухомості. Ці списки містять описи та зображення, і ви хочете дати своїм користувачам можливість створювати кругові віртуальні тури.


Як це працює?


Ймовірно, у вас уже є поле URL-адреси віртуальної екскурсії для запису та форми редагування даних зі списком нерухомості. Якщо ні, спочатку створіть його. Додайте однорядковий код для вбудовування віджета EyeSpy360 і встановіть цільовий параметр на ідентифікатор поля введення HTML для URL-адреси віртуального туру, наприклад <input id="virtualTourURL" . Віджет автоматично розмістить кнопку редактора віртуального туру після поля введення.



Коли користувач натискає кнопку «Редактор туру», редактор туру EyeSpy360 з’являється на тій самій веб-сторінці у вигляді спливаючого вікна розміром 95% x 95%. Користувач завантажує 360-градусні зображення, пов’язує їх через входи та виходи, переглядає віртуальний тур і натискає «Опублікувати». Опублікована URL-адреса автоматично вводиться в поле форми URL-адреси віртуального туру, визначене параметром цільового віджета. Редактор туру закривається, коли користувач натискає кнопку «Закрити» у верхньому правому куті або якщо користувач клацає за межами редактора туру, де головний веб-сайт все ще відображається в 5% спливаючому полі.


Потім ви збережете значення URL-адреси віртуального туру у своїй базі даних разом із усіма іншими полями, які користувач змінив, оскільки користувач збереже свої зміни.


Параметри віджета


ключ, секрет - обов'язковий. Ключові та секретні поля відображаються в розділі «Налаштування -> Облікові дані API» на сторінці https://e3.eyespy360.com . Не маєте облікового запису EyeSpy360 ? Отримайте один БЕЗКОШТОВНО

externalTourID - обов'язковий. Унікальний ідентифікатор, наданий вами. Максимальна довжина 36 символів. Ви вже будете зберігати свої властивості в сховищі даних під певним унікальним ідентифікатором. Використовуйте це тут.

target - Обов'язковий. Ідентифікатор поля введення HTML, у яке редактор віртуального туру EyeSpy360 розмістить URL-адресу туру.

агент - необов'язково. Якщо ваша система управління майном розрахована на багато користувачів або навіть на кілька компаній, укажіть у цьому полі ім’я користувача або компанії. Це допоможе вам відстежувати, які тури належать якому агенту в серверній частині EyeSpy360 . Приклад: Jon Doe, Jane Doe, Doe Estates

екскурсія - за бажанням. Назва віртуального туру. Установіть для цього заголовок списку власності, щоб вашим користувачам не потрібно було знову вводити його в редакторі огляду. Приклад: Cavendish House

hl - необов'язковий. Мова інтерфейсу. Підтримувані значення: ar,bg,de,en,es,fr,nl,pt,ru,th,zh. За замовчуванням "en"


Налаштування кнопки віджета


Ви майже напевно захочете змінити вигляд кнопки «Редактор туру», щоб він відповідав зовнішньому вигляду вашого веб-сайту. Ви можете зробити це, застосувавши будь-який CSS, який вам подобається, до елемента eyespy360_btn. приклад:

 #eyespy360_btn {
  колір: червоний;
  font-weight: жирний;
  поле зліва: 10 пікселів;
}


Android Virtual Tour SDK


Ви також можете вставити EyeSpy360 Tour Editor безпосередньо у свою програму Android. Подивіться на SDK на https://github.com/eyespy360/Virtual-Tour-Android-SDK


iOS Virtual Tour SDK


Ви також можете вставити EyeSpy360 Tour Editor безпосередньо у свою програму iOS. Подивіться на SDK за адресою: https://github.com/eyespy360/Virtual-Tour-iOS-SDK


Вміст тесту


Панорамні зображення та плани поверхів:

https://www.eyespy360.com/downloads/EyeSpy360_Test_Images.zip


Як вставити тури в мої опубліковані списки нерухомості?


Вбудовування в iframe:

 <iframe width="640" height="390" src="virtualTourURL" allowfullscreen></iframe>


Де VirtualTourURL – це значення з вашого сховища даних. Відрегулюйте ширину та висоту відповідно до вашого дизайну.