Guia de publicação de imóveis

Transcrição

1 Guia de publicação de imóveis Como disponibilizar seus imóveis facilmente no Tá Tri Imóveis Porto Alegre, 01 de junho de

2 Índice Introdução...3 Sobre...3 Imobiliárias Parceiras...3 Objetivos... 3 Pré-requisitos...3 Contato...3 Especificação da página XML...4 Vantagens de disponibilizar imóveis através do XML:... 4 Frequência da coleta dos dados...4 Disponibilização do XML...4 Definição do XML... 5 Formato do XML... 5 Exemplo do XML... 9 Tá Tri Guia de publicação de imóveis Pág 2 de 9

3 Introdução Sobre O Tá Tri Imóveis é um site de busca direcionado às pessoas que procuram imóvel para comprar ou alugar e não querem perder tempo. O Tá Tri coleta diariamente ofertas de imóveis em sites de imobiliárias e os disponibiliza em um único local, facilitando para os internautas a busca pelo imóvel ideal. Quando o usuário encontra no Tá Tri um imóvel de seu interesse, ele é direcionado ao site da imobiliária onde obtém mais detalhes. Imobiliárias Parceiras Para a imobiliária ter seus imóveis publicados no Tá Tri é necessário que disponibilize uma página em seu site com os dados dos imóveis em formato XML conforme especificado neste guia. Ao disponibilizar seus imóveis neste formato, a imobiliária demonstra estar de acordo com as políticas do serviço oferecido pelo Tá Tri Imóveis. A publicação dos imóveis no Tá Tri neste formato é gratuita. Objetivos Este guia tem como objetivo explicar como o anunciante deve disponibilizar dados de seus imóveis em formato XML para que sejam publicados no site Tá Tri Imóveis. Pré-requisitos São requisitos para publicação de imóveis no Tá Tri: Atuar como corretor ou imobiliária; Ter ofertas de imóveis em Porto Alegre-RS ou demais regiões de atuação do Tá Tri; Possuir site próprio com URLs específicas para cada imóvel; Estar de acordo com os serviços oferecidos pelo Tá Tri Imóveis. Este documento será melhor compreendido pelo departamento de TI, pelo webmaster ou pelo responsável pelo site da imobiliária. Contato Para obter maiores informações ou esclarecer quaisquer dúvidas relacionadas a este guia, entre em contato pelo imoveis@tatri.com.br. Tá Tri Guia de publicação de imóveis Pág 3 de 9

4 Especificação da página XML Vantagens de disponibilizar imóveis através do XML: Maior disponibilidade das ofertas Há duas formas de disponibilizar ofertas no Tá Tri Imóveis: através da indexação do site ou através do processamento da página XML. O processamento de página XML permite que os imóveis da imobiliária continuem aparecendo no Tá Tri, mesmo que esta altere o leiaute do site ou mude a forma de navegação entre as páginas do mesmo. O que não é possível pelo método de indexação. Rapidez e garantia na divulgação dos imóveis A única forma de garantir que seus imóveis sejam publicados no Tá Tri é disponibilizando-os no formato XML descrito por este guia. Uma vez comunicada a disponibilização do XML, o Tá Tri se compromete a processá-lo e adicionar as ofertas de imóveis no seu buscador, desde que o XML esteja acessível e de acordo com o especificado neste documento. Precisão das informações A disponibilização dos dados de imóveis através da página XML diminui drasticamente a chance de interpretação errada das informações por parte do sistema automatizado do Tá Tri. Além disso, alterações nos dados são detectadas mais rapidamente, pois o processamento do XML ocorre com maior frequência do que a indexação. Frequência da coleta dos dados O Tá Tri Imóveis procura coletar os dados de suas fontes diariamente. Isso garante que as ofertas de imóveis no Tá Tri estejam atualizadas em relação ao publicado no site das imobiliárias. Disponibilização do XML A empresa será responsável por disponibilizar a página XML que será acessada pelo Tá Tri Imóveis através de protocolos HTTP ou opcionalmente FTP. Recomendamos que esta página seja gerada dinamicamente da mesma forma que são geradas as páginas HTML normais do site a partir do banco de dados de imóveis da imobiliária. Desta forma, garante-se que as ofertas contidas nele estão atualizadas e em sincronia com as ofertas do site da imobiliária. A imobiliária deverá informar ao Tá Tri Imóveis o endereço (URL) para acesso ao XML, bem como credenciais necessárias para acessá-lo, tais quais usuário e senha, caso necessário. Tá Tri Guia de publicação de imóveis Pág 4 de 9

5 Definição do XML Formato do XML O XML usado para a inclusão das ofertas no Tá Tri Imóveis possui a seguinte estrutura: Obs: mais abaixo há um exemplo com o XML preenchido com valores. <?xml version="1.0" encoding="utf-8"?> <tatri> <imovel> <anunciante></anunciante> <contrato></contrato> <tipo></tipo> <dormitorios></dormitorios> <valor></valor> <cidade><![cdata[]]></cidade> <estado><![cdata[]]></estado> <bairro><![cdata[]]></bairro> <logradouro><![cdata[]]></logradouro> <numero></numero> <complemento><![cdata[]]></complemento> <endereco><![cdata[]]></endereco> <cep></cep> <latitude></latitude> <longitude></longitude> <imediacoes><![cdata[]]></imediacoes> <descricao><![cdata[]]></descricao> <codigo></codigo> <condominio></condominio> <iptu></iptu> <garagem></garagem> <area_total></area_total> <area_privativa></area_privativa> <cobertura></cobertura> <elevador></elevador> <mobiliado></mobiliado> <lancamento></lancamento> <fotos> <foto> <titulo></titulo> </foto> <foto> <titulo><![cdata[]]></titulo> </foto> </fotos> </imovel> </tatri> Tá Tri Guia de publicação de imóveis Pág 5 de 9

6 A seguir a definição e descrição de todos os elementos do XML. Também vale ressaltar que os campos do tipo texto devem estar contidos em tags <![CDATA[]]> ou então estarem codificados de acordo para que não utilizem caracteres especiais de marcação do XML. <tatri></tatri> Descrição: elemento raiz do XML. Formado por um ou mais elementos imovel <imovel></imovel> Descrição: representa um imóvel da imobiliária. Elemento composto, formado pelos demais elementos listados abaixo. <anunciante></anunciante> Descrição: Nome da imobiliária ou anunciante Valor: O valor deve estar contido em uma tag <![CDATA[]]> <contrato></contrato> Descrição: Tipo de contrato Valor: Ex: Aluguel, Venda. <tipo></tipo> Descrição: Tipo do imóvel Valor: Ex: Apartamento, casa, conjunto, terreno. O valor deve estar contido em uma tag <![CDATA[]]> <dormitorios></dormitorios> Descrição: Número de dormitórios. Valor: 0 (zero) no caso de apartamento JK. mas altamente recomendável para casas e apartamentos Descrição: URL apontando para o anúncio imóvel no site da imobiliária. A URL deve ser única para cada imóvel. <valor></valor> Descrição: Custo do aluguel ou custo de venda do imóvel * <cidade></cidade> Descrição: Cidade a qual o imóvel pertence. <estado></estado> Descrição: Sigla do estado ou distrito ao qual o imóvel pertence. Valor: Ex: RS, SC, PR, SP, etc. <bairro></bairro> Descrição: Bairro ao qual o imóvel pertence. Tá Tri Guia de publicação de imóveis Pág 6 de 9

7 <logradouro></logradouro> Descrição: O nome da rua onde o imóvel se encontra. <numero></numero> Descrição: Número da casa ou prédio. <complemento></complemento> Descrição: Outras informações do endereço não contempladas pelo logradouro, por exemplo o número do apartamento. <endereco></endereco> Descrição: O endereço do imóvel. Pode ser utilizado como alternativa caso não seja possível informar logradouro, número e complemento separadamente. <cep></cep> Descrição: O CEP do imóvel. <latitude></latitude> Descrição: Graus de latitude, expresso em decimal* Valor: de a <longitude></longitude> Descrição: Graus de longitude, expresso em decimal* Valor: de a <imediacoes></imediacoes> Descrição: Indicador de imediações do imóvel. Geralmente é utilizado quando não se deseja informar o endereço exato do imóvel. <descricao></descricao> Descrição: Descrição textual do imóvel. Pode ser utilizado para comunicar qualquer informação que não se encaixe em outro campo. Recomenda-se em torno de 50 palavras ou 400 caracteres. <codigo></codigo> Descrição: um identificador único do imóvel dentro do sistema da imobiliária. <condominio></condominio> Descrição: Custo mensal estimado do condomínio.* <iptu></iptu> Descrição: Valor mensal estimado do IPTU.* Tá Tri Guia de publicação de imóveis Pág 7 de 9

8 <garagem></garagem> Descrição: significa o número de garagens disponíveis. Valor: 0 (zero) para nenhuma garagem, 1 (um) para um espaço de garagem, 2 (dois) para dois espaços de garagem e assim por diante. <area_total></area_total> Descrição: Área total do imóvel, em metros quadrados.* <area_privativa></area_privativa> Descrição: Área privativa do imóvel, em metros quadrados.* <cobertura></cobertura> Descrição: Indica se o imóvel é uma cobertura ou não. Valor: "S" caso o imóvel seja uma cobertura; "N" caso não seja. <elevador></elevador> Descrição: Indica se o imóvel tem elevador ou não. Valor: "S" no caso de edifício com elevador; "N" em qualquer outro caso. <mobiliado></mobiliado> Descrição: indica se o imóvel é mobiliado ou não. Valor: "S" caso trate-se de um imóvel mobiliado; "N" caso contrário. <lancamento></lancamento> Descrição: indica se o imóvel é um lançamento na imobiliária ou não. Valor: "S" caso trate-se de um imóvel lançamento; "N" caso contrário. <fotos></fotos> Descrição: representa o conjunto de fotos do imóvel. Elemento composto que contém um ou mais elementos foto <foto></foto> Descrição: representa uma foto do imóvel. Contém os subelementos url e titulo Descrição: representa o endereço da URL onde a foto está localizada. Normalmente é um endereço no site da imobiliária. <titulo></titulo> Descrição: Título descrevendo a foto. Valor: seu valor deve estar contido numa tag <![CDATA[]]> * Nota: Preços e outros números não devem conter o separador de milhar. O separador decimal deve ser um ponto (ex ). Tá Tri Guia de publicação de imóveis Pág 8 de 9

9 Exemplo do XML Este é um exemplo de XML preenchido corretamente com as informações de um imóvel. <?xml version="1.0" encoding="utf-8"?> <tatri> <imovel> <anunciante><![cdata[tá Tri]]></anunciante> <contrato>aluguel</contrato> <tipo>apartamento</tipo> <dormitorios>3</dormitorios> <url> <valor>450.00</valor> <cidade><![cdata[porto Alegre]]></cidade> <estado>rs</cidade> <bairro><![cdata[santana]]></bairro> <cep> </cep> <latitude> </latitude> <longitude> </longitude> <descricao> <![CDATA[>Um apartamento de frente para a rua com uma bela vista, lareira e três banheiros. Perfeito para toda a fámilia]]> </descricao> <logradouro><![cdata[rua Ipiranga]]></logradouro> <numero>1345</numero> <complemento><![cdata[ap. 13]]></complemento> <endereco><![cdata[rua Ipiranga, 1345 Ap. 13]]></endereco> <imediacoes><![cdata[próx. ao Shopping]]></imediacoes> <codigo>12345</codigo> <condominio>90.00</condominio> <iptu>19.90</iptu> <garagem>3</garagem> <area_total>165</area_total> <area_privativa>130</area_privativa> <cobertura>s</cobertura> <elevador>s</elevador> <mobiliado>n</mobiliado> <lancamento>n</lancamento> <fotos> <foto> <url> <titulo><![cdata[fachada]]></titulo> </foto> </fotos> </imovel> </tatri> Tá Tri Guia de publicação de imóveis Pág 9 de 9