2.10 Localização

Hoje no VivaReal, o cliente tem três opções para a divulgação do endereço. 
* Divulgação do endereço completo. (Logradouro e Numero)
* Divulgação somente do nome do Logradouro. 
* Divulgação somente do bairro. 

Independente da opção feita pelo cliente, o ideal é que sempre o endereço completo seja enviado, a informação completa é fundamental para que o imóvel fique bem posicionado nas pesquisas, e também disponível nas buscas realizadas por mapa. 
Abaixo serão listadas as regras para a divulgação do endereço. Note que o único item que sofre alteração é o atributo displayAddress, que será setado como:  Neighborhood, Street ou All. 

Caso o cliente opte por divulgar as informações de endereço somente a nível de bairro, o atributo displayAddress, deverá ser setado como "Neighborhood"
Exemplo: 
<Location displayAddress="Neighborhood">
        <Country abbreviation="BR">Brasil</Country> 
        <State abbreviation="SP">Sao Paulo</State> 
        <City>São Paulo</City> 
        <Zone>Zona Sul</Zone>
        <Neighborhood>Consolação</Neighborhood> 
        <Address>Rua Bela Cintra</Address> 
       <StreetNumber>539</StreetNumber> 
        <PostalCode>01415-003</PostalCode>
        <Latitude>-23.5531131</Latitude>
        <Longitude>-46.659864</Longitude>
</Location>

Caso o cliente opte por divulgar as informações de endereço até o nome do logradouro, sem a exibição do numero, o atributo displayAddress, deverá ser setado como "Street"
Exemplo: 
<Location displayAddress="Street">
        <Country abbreviation="BR">Brasil</Country> 
        <State abbreviation="SP">Sao Paulo</State> 
        <City>São Paulo</City> 
        <Zone>Zona Sul</Zone>
        <Neighborhood>Consolação</Neighborhood> 
        <Address>Rua Bela Cintra</Address> 
       <StreetNumber>539</StreetNumber> 
        <PostalCode>01415-003</PostalCode>
        <Latitude>-23.5531131</Latitude>
        <Longitude>-46.659864</Longitude>
</Location>

Caso o cliente opte por divulgar o endereço completo dos imóveis, o atributo displayAddress, deverá ser setado como "All"
Exemplo: 
<Location displayAddress="All">
        <Country abbreviation="BR">Brasil</Country> 
        <State abbreviation="SP">Sao Paulo</State> 
        <City>São Paulo</City> 
        <Zone>Zona Sul</Zone>
        <Neighborhood>Consolação</Neighborhood> 
        <Address>Rua Bela Cintra</Address> 
       <StreetNumber>539</StreetNumber> 
        <PostalCode>01415-003</PostalCode>
        <Latitude>-23.5531131</Latitude>
        <Longitude>-46.659864</Longitude>
</Location>

Atenção: tem que existir as tags LocationCountryState, City e Neighborhood. Sem elas ocorrerão erros de importação.

Favor notar o seguinte:
  • Se você trabalha com imóveis em São Paulo e Rio de Janeiro, não esqueça de ver a seção especial sobre a tag Zone aqui nesta página.
Endereço minimo:   

<Location displayAddress="Neighborhood">
         <Country abbreviation="BR">Brasil</Country>
         <State abbreviation="SP">São Paulo</State>
         <City>São Paulo</City>
         <Neighborhood>Consolação</Neighborhood>
</Location>

Erros de codificação podem ocorrer:

  <State abbreviation="SP">Espírito Santo</State>
  <City>Vitória</City>

Para contornar esse tipo de erro, informe sem acentos, ou então, envolva o conteúdo das tags em CDATA.

  <State abbreviation="SP">Espi­rito Santo</State>
  <City>Vitoria</City>

<State abbreviation="SP"><![CDATA[Espírito Santo]]></State>
<City><![CDATA[Vitória]]></City>

Atenção: 

Se na tag <Location> não for informado o atributo displayAddress será assumido o padrão All, que é exibir o endereço completo.
Se deseje que o endereço do imóvel não seja exibido, informe displayAddress="Neighborhood", em Location.
O padrão VivaReal, referente à exibição de endereço é exibi-lo, se o cliente não explicitar que não o deseja.
Quando é exibido o endereço ele é montado pela nossa ferramenta de geolocalização baseado nas informações do imóvel no xml.

As informações no XML para essa situação é a seguinte:

<Location>
         <Country abbreviation="BR">Brasil</Country>
         <State abbreviation="SP">São Paulo</State>
         <City>São Paulo</City>
         <Neighborhood>Consolação</Neighborhood>
</Location>

Observe que não está aparecendo a tag Location, com o atributo displayAddress, que é utilizada para a divulgação ou não o endereço do imóvel.
Ocorre que, não informando-a, não significa que não será exibida e sim que a ferramenta fará um esforço para buscar um endereço para exibir pois, conforme foi mencionado, não foi explicitamente solicitado para não exibi-lo. 

Para modificar corretamente e não aparecer essa informação, monte a informação da tag Address da seguinte maneira:

<Location displayAddress="Neighborhood">
        <Country abbreviation="BR">Brasil</Country> 
        <State abbreviation="SP">Sao Paulo</State> 
        <City>São Paulo</City> 
        <Zone>Zona Sul</Zone>
        <Neighborhood>Consolação</Neighborhood> 
        <Address>Rua Bela Cintra</Address> 
       <StreetNumber>539</StreetNumber> 
        <PostalCode>01415-003</PostalCode>
        <Latitude>-23.5531131</Latitude>
        <Longitude>-46.659864</Longitude>
</Location>
Dessa forma, não aparecerá o endereço.

Importância da tag Zone, para imóveis em São Paulo e Rio de Janeiro

Existem mais de um bairro com o mesmo nome nessas cidades e, para essa situação, o que desempata é a Zona.
Para isso, solicitamos que seja inserida a tag Zone em Location.
Por exemplo o bairro, Vila Califórnia, em São Paulo, temos na Zona Sul e Zona Leste. Para discriminar esse bairro, use desta forma:

<Location displayAddress="Neighborhood">
         <Country abbreviation="BR">Brasil</Country>
         <State abbreviation="SP">São Paulo</State>
         <City>São Paulo</City>
         <Zone>Zona Sul</Zone>
         <Neighborhood>Vila Califória</Neighborhood>
</Location>
Dessa forma nosso processador irá considerar corretamente o bairro e o imóvel estará disponível para visualização.

Atenção! 
Divulga imóveis no Distrito Federal? Criamos uma seção especial, para ter mais informações Clique Aqui
Comments