Criar links com resultados de busca

⚠ Atenção: esta ajuda requer certo conhecimento avançado; use-a para seu próprio benefício e por sua conta e risco.

índice desta ajuda

Criar links avançados para entregar resultados de busca

Esta ajuda vai ensinar você a criar urls avançadas para depois compor links que possam ser aplicados onde você quiser, direcionando para resultados de busca específicos do seu site

Uma URL é um endereço de internet. Neste caso vamos ensinar você a usar endereços de internet do seu site, criados especialmente para que, quando inseridos no navegador de internet ou usados como links, entreguem resultados de propriedades segundo uma lógica determinada por você.

Introdução

Ao realizar uma busca tradicional no seu site, pressionando o botão buscar do seu buscador e sem selecionar nenhum tipo de filtro, o resultado serão todas as propriedades do seu site.

Esses resultados, visíveis no navegador em forma de fotos e texto, em listagem, têm um endereço de internet (url) específico, que contém parâmetros que podem ser editados de forma avançada para obter resultados diferentes

Modo de uso simples

A forma mais simples de obter urls personalizadas é fazendo buscas personalizadas. Selecione diferentes opções nos filtros do buscador e depois pressione o botão Buscar. Veja o exemplo desta imagem

Ao pressionar o botão buscar você obterá uma url; copie-a e use-a como link para mostrar resultados do seu site no seu próprio site ou em sites de terceiros.

Modo de uso avançado

Como mencionamos, copiar a url de um determinado resultado de busca permite compor um link para mostrar esses mesmos resultados de propriedades através de um botão ou um link no seu site ou em sites de terceiros.

Importante: Para todas as URLs que você compuser para exibir listagens de propriedades, deve fornecer o parâmetro &view=list&page=0 no final da URL; caso contrário, causará problemas na visualização em lista de propriedades

http://flex.mapaprop.com/buscar/?operation=&type=&bedrooms=&zone1=&currency=&priceFrom=&priceTo=&view=list&page=0

Neste caso, a url é composta por uma grande quantidade de parâmetros (certamente desconhecidos e incompreensíveis para você), que definem quais resultados devem ser exibidos. Vamos fazer uma breve análise.

URL principal: Existe uma url principal, que é o endereço do seu site precedido por http:// e seguido por uma barra "/"

http://www.sudominio.com/

Função buscar (/buscar/?): Depois existe uma determinação da função buscar, definida por "/buscar/?"

http://www.sudominio.com/buscar/?

Parâmetros de busca: Por fim existem funções pré-codificadas (parâmetros), que permitem definir os resultados a exibir

http://www.sudominio.com/buscar/?operation=&type=&bedrooms=&zone1=&currency=&priceFrom=&priceTo=&view=list&page=0

Neste caso, já podemos ver que existe uma URL base e depois uma grande quantidade de parâmetros que ainda desconhecemos (marcados em negrito)

http://www.sudominio.com/buscar/**?operation=&type=&bedrooms=&zone1=&currency=&priceFrom=&priceTo=&view=list&page=0**

Na próxima seção, começaremos a analisar esses parâmetros para entendê-los e finalmente manipulá-los como quisermos, para obter os resultados desejados.

Parâmetros de busca

Como mencionamos anteriormente, existe uma URL base (domínio de internet precedido por http:// e seguido por /buscar/?)

http://www.sudominio.com/buscar/?

e depois uma grande quantidade de parâmetros que ainda desconhecemos.

operation=&type=&bedrooms=&zone1=&currency=&priceFrom=&priceTo=&view=list&page=0

Análise dos parâmetros

Vamos fazer uma breve análise desses parâmetros para conhecê-los e depois poder alterá-los.

Para começar, podemos ver que existe um caractere que se repete constantemente, que é "&". Este caractere é um divisor ou concatenador (somador) de parâmetros: permite definir o início de um novo parâmetro.

operation=**&type=&bedrooms=&zone1=&currency=&priceFrom=&priceTo=&view=list&**page=0

Para entender melhor, se eu tenho uma url como a seguinte...

http://www.sudominio.com/buscar/?operation=&type=&view=list&page=0

Ela define, depois de /buscar/?

um tipo de operação: operation=
um tipo de propriedade: type=
um tipo de visualização para os resultados: view=list
um número de página de resultados: page=0

Todos esses parâmetros estão concatenados com um "&" que permite inserir parâmetros de forma consecutiva e assim construir a URL de busca.

Lembre-se de que, para que qualquer parâmetro funcione, você deve sempre colocar /buscar/? antes deles

Agora que estamos entendendo como se compõe uma URL de busca, vejamos como alterar os parâmetros para obter URLs que mostrem listagens de propriedades com resultados diferentes

http://www.sudominio.com/buscar/?operation=&type=&bedrooms=&zone1=&currency=&priceFrom=&priceTo=&view=list&page=0

Neste caso, vamos analisar os parâmetros que compõem a URL, depois do domínio (precedido por http://)

/buscar/?operation=&type=&bedrooms=&zone1=&currency=&priceFrom=&priceTo=&view=list&page=0

Ela define

um tipo de operação: operation=
um tipo de propriedade: type=
uma quantidade de quartos: bedrooms=
uma zona 1: zone1=
um tipo de moeda: currency=
um preço a partir de: priceFrom=
um preço até: priceTo=
um tipo de visualização para os resultados: view=list
um número de página de resultados: page=0

Todos esses parâmetros estão concatenados com um "&" que permite inserir parâmetros de forma consecutiva e assim construir a URL de busca.

Agora vamos tentar alterar esta url para obter um resultado diferente. Por exemplo, se eu quiser definir outra quantidade de quartos, vou alterar a url, especificamente no parâmetro bedrooms, colocando um novo valor, por exemplo "1"

exemplo 1: "bedrooms=1"

http://flex.mapaprop.com/buscar/?operation=1&type=&**bedrooms=1**&zone1=&currency=&priceFrom=&priceTo=&view=list&page=0

Se você colar esta URL na barra de endereços do seu navegador, o resultado será uma listagem contendo todas as propriedades que tenham sido definidas com 1 quarto

Agora, se eu quiser definir uma operação específica (venda, aluguel ou aluguel temporário), vou alterar o parâmetro operation adicionando um novo valor, por exemplo 1 (venda)

exemplo 2: "operation=1"

http://flex.mapaprop.com/buscar/?**operation=1**&type=&**bedrooms=1**&zone1=&currency=&priceFrom=&priceTo=&view=list&page=0

Se você colar esta URL na barra de endereços do seu navegador de internet, será exibida uma página com resultados apenas de propriedades com operação do tipo 1 (venda, operation=1), mas também com quartos 1 (bedroom=1).

Alguns exemplos de uso

O parâmetro mínimo para entregar um resultado em listagem é o seguinte (definido como url).

http://flex.mapaprop.com/buscar/?**view=list&page=0**

Onde view-list define uma listagem e page=0 define um número de página de resultados. Ambos os parâmetros estão localizados depois da url /buscar/? e divididos pelo caractere &

Resultados no Mapa

O parâmetro mínimo para entregar um resultado em mapa é o seguinte (definido como url)

http://flex.mapaprop.com/buscar/?**view=map**

Neste caso, view-map define um resultado exibido em um mapa. Neste caso, mostrará todas as propriedades do site.

Resultados para uma determinada zona

Os parâmetros para entregar resultados por zonas têm a ver com a codificação de zona com base em zone1=&zone2=&zone3. Esta URL entregará propriedades de todas as zonas

http://flex.mapaprop.com/buscar/?zone1=&zone2=&zone3&view=list&page=0

Lembre-se de sempre incluir no final da URL o parâmetro &view=list&page=0!NOTE Para obter códigos de zona, recomendamos sempre usar o método simples de composição de url, mencionado mais acima neste tutorial. Use o buscador selecionando suas zonas e pressione buscar, depois copie o código.

http://flex.mapaprop.com/buscar/?zone1=16&zone2=&zone3=&view=list&page=0