• En esta página

Inicio

API

1. Primeiros passos

• 2. Uso da API

3. Modelos de anúncios da API

4. Entrar em produção

5. Callbacks

6. Mostrar localização no mapa

8. Integração ReadOnly

9.Associar Imobiliárias

XML

1. Primeiros passos

2. Exemplos de XML por país

3. Estrutura para Anúncios

3.1 Campos obrigatórios

4. Estrutura para Lançamentos

4.1 Campos obrigatórios

5. Erros comuns XML

6. Como ler o XML do resultado?

7. Passar para produção

8. Callbacks

9. Mostrar localização no mapa

Médio

A visualização do mapa nos anúncios depende do valor atribuído ao campo muestraMapa. A seguir, detalhamos as opções disponíveis:

1. Mostrar mapa com localização aproximada:

   • Valor de mostrarMapa: APROXIMADO Exibe o mapa centralizado na área geral do imóvel, sem revelar o endereço exato Exemplo em XML:

   <localizacao>
   <endereco> Avenida Paulista, 900 </endereco>
   <idLocalidade> V1-D-525243 </idLocalidade>
   <mostrarMapa>APROXIMADO</mostrarMapa>
   </localizacao>
   

   

2. Mostrar mapa com localização exata:

   • Valor de mostrarMapa: EXATO

     Exibe o mapa centralizado no endereço exato do imóvel.

     Exemplo em XML:

     <localizacao>
     <endereco>Avenida Paulista, 900</endereco>
     <idLocalidade>V1-D-525243</idLocalidade>
     <mostrarMapa>EXATO</mostrarMapa>
     </localizacao>
     

     

3. Não mostrar mapa ou endereço:

   • Valor de mostrarMapa: NO

     O mapa e o endereço da propriedade não são mostrados no anúncio.

     Ejemplo en XML:

     <localizacao>
     <endereco> Avenida Paulista, 900 </endereco>
     <idLocalidade> V1-D-525243 </idLocalidade>
     <mostrarMapa>NO</mostrarMapa>
     </localizacao>
     

     

<aside> ⚠️

Importante: preenchimento de latitude e longitude

Para garantir que o imóvel seja visualizado corretamente no mapa, especialmente quando muestraMapa está configurado como EXACTO, é fundamental incluir as coordenadas geográficas.

</aside>

• Campo latitude: valor em formato decimal (ex.: -34.6037)
• Campo longitude: valor em formato decimal (ex.: -58.3816)

Estes campos permitem posicionar com maior precisão o imóvel no mapa.

Exemplo em XML:

<localizacao>
<endereco>Guayaquil 300</endereco>
<idLocalidade>1251</idLocalidade>
<mostrarMapa>EXATO</mostrarMapa>
<latitude>-34,6216993</latitude>
<longitude>58,4413393</longitude>
</localizacao>

Para obter as coordenadas de um endereço específico, você pode utilizar ferramentas como Google Maps, onde ao clicar com o botão direito sobre uma localização no mapa, as coordenadas correspondentes serão mostradas. (Google Help)

O que acontece se você não enviar latitude e longitude?

O sistema de integrações tentará calcular a geolocalização do anúncio através do endereço fornecido. Este processo pode falhar, já que usamos um serviço externo, o qual tem uma cota de uso e pode ser que o endereço não gere uma latitude e longitude.

Por este motivo, recomendamos que você envie esta informação para evitar que afete a qualidade do anúncio e o seu posicionamento.