API e SDK do EyeSpy360

O que são Tours Virtuais EyeSpy360™?


Passeios totalmente imersivos em 360 graus de propriedades, barcos, hotéis e muito mais, que os próprios usuários criam e publicam usando o editor de tour virtual EyeSpy360 rápido e simples. Dê uma olhada no nosso vídeo de demonstração em https://www.eyespy360.com . Realmente é muito simples.


O que é o widget HTML EyeSpy360™?


O EyeSpy360 Widget é uma API / SDK que permite adicionar criação e publicação de tour virtual ao seu próprio editor de listagem de propriedades. É tão simples quanto adicionar uma única linha de código:


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


Para quem é isso?


Você já opera um sistema de gerenciamento de listagem de propriedades onde seus usuários criam, editam e publicam listagens de propriedades. Essas listagens incluem descrições e imagens, e você deseja oferecer aos usuários a capacidade de criar tours virtuais 360.


Como funciona?


Você provavelmente já tem um campo de formulário de URL de tour virtual para o registro de dados de listagem de propriedades e o formulário de edição. Se não, crie um primeiro. Adicione o código de incorporação de uma linha do EyeSpy360 Widget e defina o parâmetro de destino para o ID do campo de entrada HTML para o URL do tour virtual, por exemplo <input id="virtualTourURL" . O widget colocará automaticamente um botão do Virtual Tour Editor após o campo de entrada.



Quando um usuário clica no botão Tour Editor, o EyeSpy360 Tour Editor aparecerá dentro da mesma página da web como um pop-up de 95% x 95%. O usuário carrega as imagens 360, vincula-as por meio de suas entradas e saídas, visualiza o tour virtual e clica em 'Publicar'. O URL publicado é inserido automaticamente no campo de formulário de URL do tour virtual especificado pelo parâmetro do widget de destino. O Tour Editor fecha quando o usuário clica no botão Fechar no canto superior direito ou se o usuário clica fora do Tour Editor, onde o site principal ainda está visível na margem pop-up de 5%.


Em seguida, você armazenará o valor do URL do tour virtual em seu banco de dados junto com quaisquer outros campos que o usuário tenha modificado, pois o usuário salva suas alterações.


Parâmetros do widget


chave, segredo - Obrigatório. Os campos de chave e segredo são exibidos na seção 'Configurações -> Credenciais da API' em https://e3.eyespy360.com . Não tem uma conta EyeSpy360 ? Obtenha um GRATUITAMENTE

externalTourID - Obrigatório. Um identificador exclusivo fornecido por você. Comprimento máximo 36 caracteres. Você já estará armazenando suas propriedades em um armazenamento de dados sob algum identificador exclusivo. Use isso aqui.

alvo - Obrigatório. O ID do campo de entrada HTML que o editor EyeSpy360 Virtual Tour colocará no URL do tour.

agente - Opcional. Se o seu sistema de gerenciamento de propriedades for multiusuário ou mesmo multiempresarial, defina este campo para um usuário ou nome de empresa. Isso o ajudará a rastrear quais tours pertencem a quais agentes no back-end do EyeSpy360 . Exemplo: Jon Doe, Jane Doe, Doe Estates

tour - Opcional. Nome do tour virtual. Defina isso como o título da lista de propriedades, para que seus usuários não precisem inseri-lo novamente no Editor de passeios. Exemplo: Cavendish House

h - Opcional. Idioma da interface. Os valores suportados são ar,bg,de,en,es,fr,nl,pt,ru,th,zh. O padrão é 'en'


Personalização do botão do widget


Você quase certamente desejará alterar a aparência do botão 'Editor de tour' para combinar com a aparência do seu próprio site. Você pode fazer isso aplicando qualquer CSS que desejar ao elemento eyespy360_btn. Exemplo:

 #eyespy360_btn {
  cor vermelha;
  intensidade da fonte: Negrito;
  margem esquerda: 10px;
}


SDK do tour virtual do Android


Você também pode incorporar o EyeSpy360 Tour Editor diretamente em seu aplicativo Android. Dê uma olhada no SDK em https://github.com/eyespy360/Virtual-Tour-Android-SDK


SDK do tour virtual do iOS


Você também pode incorporar o EyeSpy360 Tour Editor diretamente em seu aplicativo iOS. Dê uma olhada no SDK em: https://github.com/eyespy360/Virtual-Tour-iOS-SDK


Conteúdo de teste


Imagens panorâmicas e plantas baixas:

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


Como incorporo os passeios em minhas listas de propriedades publicadas?


Incorporando em um iframe:

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


Onde VirtualTourURL é o valor do seu armazenamento de dados. Ajuste a largura e a altura para corresponder ao seu design.