API и SDK на EyeSpy360

Какво представляват виртуалните обиколки EyeSpy360™?


Напълно завладяващи 360-градусови прегледи на имоти, лодки, хотели и други, които потребителите създават и публикуват сами с помощта на бързия и лесен редактор на виртуални обиколки EyeSpy360 . Разгледайте нашето демонстрационно видео на https://www.eyespy360.com . Наистина е много просто.


Какво представлява EyeSpy360™ HTML Widget?


EyeSpy360 Widget е 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 адрес на виртуална обиколка за вашия запис на данни за списък с имоти и формуляр за редактиране. Ако не, първо създайте такъв. Добавете един ред код за вграждане на Widget EyeSpy360 и задайте целевия параметър на ID на полето за въвеждане на HTML за URL адрес на виртуална обиколка, напр. <input id="virtualTourURL" . Приспособлението автоматично ще постави бутон за редактор на виртуална обиколка след полето за въвеждане.



Когато потребител щракне върху бутона Tour Editor, EyeSpy360 Tour Editor ще се появи в същата уеб страница като изскачащ прозорец с размери 95% x 95%. Потребителят качва 360-градусовите изображения, свързва ги чрез техните входове и изходи, визуализира виртуалната обиколка и кликва върху „Публикуване“. Публикуваният URL адрес се въвежда автоматично в полето на формуляра за URL адрес на виртуална обиколка, посочено от целевия параметър на приспособлението. Редакторът на обиколка се затваря, когато потребителят щракне върху бутона Затваряне в горния десен ъгъл или ако потребителят щракне извън редактора на обиколка, където основният уебсайт все още се вижда в 5% изскачащо поле.


След това ще съхраните URL стойността на виртуалната обиколка във вашата база данни заедно с всички други полета, които потребителят е променил, тъй като потребителят запазва своите промени.


Параметри на джаджата


ключ, секретен - Задължителен. Ключовите и секретните полета се показват в секцията „Настройки -> Идентификационни данни за API“ на https://e3.eyespy360.com . Нямате акаунт в EyeSpy360 ? Вземете един БЕЗПЛАТНО

externalTourID - Задължително. Уникален идентификатор, предоставен от вас. Максимална дължина 36 знака. Вие вече ще съхранявате своите свойства в хранилище на данни под някакъв уникален идентификатор. Използвайте това тук.

цел - Задължително. Идентификационният номер на полето за въвеждане на HTML, в което редакторът на EyeSpy360 Virtual Tour ще постави 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 {
  цвят: червен;
  тегло на шрифта: удебелен;
  margin-left: 10px;
}


SDK за виртуална обиколка на Android


Можете също така да вградите EyeSpy360 Tour Editor директно във вашето приложение за Android. Разгледайте SDK на https://github.com/eyespy360/Virtual-Tour-Android-SDK


SDK за виртуална обиколка на iOS


Можете също така да вградите 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 е стойността от вашето хранилище за данни. Регулирайте ширината и височината , за да отговарят на вашия дизайн.