EyeSpy360 API и SDK

Что такое виртуальные туры 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> 


Это кому?


Вы уже используете систему управления списками недвижимости, в которой ваши пользователи создают, редактируют и публикуют списки недвижимости. Эти списки включают описания и изображения, и вы хотите дать своим пользователям возможность создавать виртуальные 360-градусные туры.


Как это работает?


Вероятно, у вас уже есть поле формы URL-адреса виртуального тура для записи данных о вашем объекте недвижимости и формы редактирования. Если нет, сначала создайте его. Добавьте код для встраивания виджета EyeSpy360 в одну строку и установите целевой параметр на идентификатор поля ввода HTML для URL-адреса виртуального тура, например <input id="virtualTourURL" . Виджет автоматически разместит кнопку «Редактор виртуального тура» после поля ввода.



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


Затем вы сохраните значение URL-адреса виртуального тура в своей базе данных вместе с любыми другими полями, измененными пользователем, поскольку пользователь сохраняет свои изменения.


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


ключ, секрет - Обязательный. Поля ключа и секрета отображаются в разделе «Настройки -> Учетные данные API» на странице https://e3.eyespy360.com . У вас нет учетной записи EyeSpy360 ? Получите один БЕСПЛАТНО

externalTourID - Обязательный. Уникальный идентификатор, предоставленный вами. Максимальная длина 36 символов. Вы уже будете хранить свои свойства в хранилище данных под каким-то уникальным идентификатором. Используйте это здесь.

цель - обязательно. Идентификатор поля ввода HTML, в которое редактор виртуального тура EyeSpy360 поместит URL-адрес тура.

агент - необязательно. Если ваша система управления недвижимостью является многопользовательской или даже многопользовательской, задайте в этом поле имя пользователя или название компании. Это поможет вам отслеживать, какие туры принадлежат какому агенту в бэкэнде EyeSpy360 . Пример: Джон Доу, Джейн Доу, Доу Эстейтс.

тур - по желанию. Название виртуального тура. Установите его в качестве названия вашего объекта недвижимости, чтобы вашим пользователям не нужно было вводить его снова в редакторе тура. Пример: Кавендиш Хаус

гл - необязательно. Язык интерфейса. Поддерживаемые значения: ar,bg,de,en,es,fr,nl,pt,ru,th,zh. По умолчанию "en"


Настройка кнопки виджета


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

 #eyespy360_btn {
  красный цвет;
  вес шрифта: полужирный;
  поле слева: 10px;
}


SDK виртуального тура Android


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


SDK виртуального тура для iOS


Вы также можете встроить редактор тура EyeSpy360 прямо в свое приложение для 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 — это значение из вашего хранилища данных. Отрегулируйте ширину и высоту в соответствии с вашим дизайном.