Como a Busca Funciona no eDirectory: Um Guia Completo

Introdução

A funcionalidade de busca é um dos componentes mais essenciais de qualquer plataforma de diretórios. No eDirectory, o sistema de busca é impulsionado pelo Elasticsearch, permitindo que os usuários encontrem anúncios, eventos, ofertas, classificados, artigos e posts de blog com alta precisão e rapidez. Entender como o algoritmo de busca funciona — e como os resultados variam dependendo do tipo de busca — ajuda administradores a otimizar o conteúdo e oferecer a melhor experiência possível aos usuários.

Este artigo explica os dois tipos de busca disponíveis, como os campos e pesos influenciam os resultados e como funcionam as opções de ordenação após a conclusão de uma busca.

Como a Busca Funciona para os Usuários

Quando um visitante usa a barra de busca do eDirectory — seja no campo de palavra-chave ou no campo de localização — a plataforma utiliza o Elasticsearch para determinar os resultados mais relevantes. Existem dois tipos diferentes de experiência de busca, e cada uma produz resultados distintos.

1. Busca Direta (Usuário digita o termo e pressiona Enter)

Essa busca vale tanto para o campo de palavra-chave quanto para o campo de localização.

Quando o usuário digita um termo e clica em Buscar (sem selecionar uma sugestão da lista suspensa), o eDirectory faz uma varredura em vários campos do banco de dados. As correspondências podem vir de:

• Título
• Descrição
• Palavras-chave
• URL amigável
• Informações de localização (endereço, CEP, cidade, estado, região)

Se o termo digitado aparecer em qualquer um desses campos, o item se torna um candidato para aparecer nos resultados.

Isso significa que os resultados podem ser bastante variados. Por exemplo, ao buscar por “farmácia”, podem aparecer:

• Anúncios chamados "Farmácia"
• Anúncios que tenham na descrição a palavra "Farmácia"
• Artigos ou posts de blog contendo "Farmácia" no conteúdo ou na URL
• Anúncios que tenham no campo de palavras-chave a palavra "Farmácia"

Na busca direta, todos os campos pesquisáveis são considerados para determinar a relevância.

2. Busca com Sugestões da lista suspensa (Usuário seleciona uma sugestão)

Ao digitar na barra de busca, o usuário pode ver sugestões automáticas. Essas sugestões geralmente incluem:

• Categorias existentes
• Localidades cadastradas no site

Quando o usuário seleciona uma dessas sugestões, o comportamento da busca muda completamente:

• O sistema busca somente conteúdos associados à categoria ou localização selecionada
• Não considera título, descrição, palavras-chave ou URL amigável
• Os resultados ficam limitados apenas aos itens vinculados à categoria ou localização escolhida

Por isso, selecionar uma sugestão pode gerar resultados bem diferentes de simplesmente pressionar Enter.

Exemplo:

• Digitar “Farmácia” e pressionar Enter pode mostrar vários anúncios que mencionam “Farmácia”, independentemente da categoria.
• Mas escolher a categoria “Farmácia” da lista suspensa mostrará apenas anúncios atribuídos a essa categoria.

Opções de Ordenação Após a Busca

Depois de realizar uma busca — por qualquer método — o usuário pode ordenar os resultados pelos filtros disponíveis:

• Relevância
• Distância
• Alfabética
• Popular

Abaixo está a explicação detalhada de cada uma.

1. Relevância

Relevância é o método de ordenação mais complexo e é o padrão na busca direta.

Quando um usuário digita uma palavra-chave, o eDirectory avalia vários campos nos módulos de conteúdo, cada um com um peso específico que contribui para a pontuação final.

Pesos para Anúncios, Eventos, Classificados e Ofertas

Pesos para Artigos

Pesos para Posts de Blog

Por que a URL Amigável tem peso tão alto?

A URL Amigável recebe o peso mais alto porque, quando um usuário tenta acessar um anúncio que está inativo, o eDirectory o redireciona para a página de resultados da busca. Priorizar a URL Amigável garante que o anúncio correspondente apareça com destaque — muitas vezes como o único resultado relevante — oferecendo uma experiência mais fluida.

Busca Baseada em Localização

Quando um usuário busca no campo “onde”, o sistema avalia:

• Endereço
• CEP
• Nome da cidade, estado ou região

Todos inicialmente com peso igual.

Lógica da Busca por Proximidade (Nearby)

Se o administrador ativar a funcionalidade “Resultados próximos”:

• O sistema calcula a distância usando latitude e longitude
• Inclui anúncios dentro do raio configurado
• Campos de localização ganham maior peso
• Os itens são ordenados pela proximidade

Exemplo:

Buscar “São Paulo” pode mostrar primeiro anúncios na cidade e depois cidades vizinhas.

Como os Itens São Ordenados na Busca por Relevância

O eDirectory usa um processo em duas etapas:

1. Pontuação (Fator Principal)

Gerada pelo Elasticsearch com base em:

• Pesos dos campos
• Grau de correspondência do conteúdo com o termo digitado
• Quanto maior a pontuação, mais alto o item aparece.

2. Nível do Item (Desempate)

Se dois itens tiverem a mesma pontuação:

• O item com nível mais alto (ex.: Diamond → Gold → Silver) aparece primeiro

Exemplo: Um anúncio Ouro chamado “Restaurante Tokyo” pode aparecer antes de um anúncio Diamante chamado “Tokyo Restaurante Japonês” se o termo buscado for “Restaurante Tokyo”.

Ordenação ao Navegar ou Usar Sugestões

Quando o usuário está navegando por:

• Categoria

• Localização

• Sugestões da lista suspensa

As regras mudam:

Anúncios, Eventos, Classificados e Ofertas

1. Nível do item
2. Pontuação de relevância

Artigos

• Ordenados do mais recente para o mais antigo

Posts de Blog

• Ordenados do mais recente para o mais antigo

Ofertas

• Ordenadas pela data de término (as que acabam primeiro aparecem no topo)

Eventos

1. Nível do item
2. Data de término (eventos que acabam antes aparecem primeiro)

2. Ordenação por Distância

Ao escolher esse filtro, o sistema:

• Determina a localização do usuário (via permissão do navegador ou IP)
• Calcula a distância até cada anúncio
• Exibe os resultados do mais próximo ao mais distante
• Mostra a informação de distância diretamente nos resultados

3. Ordenação Alfabética

• Ordena os resultados de A → Z com base no título do anúncio ou item.

4. Ordenação por Popularidade

• Itens populares são exibidos de acordo com o número de cliques recebidos.
• Quanto mais visualizações, mais acima ficam nos resultados.

Conclusão

Entender como a busca funciona no eDirectory é fundamental para administradores que desejam maximizar a visibilidade dos anúncios e oferecer a experiência mais intuitiva possível aos usuários.

Seja por busca direta ou por seleção de sugestões, o sistema aplica uma lógica inteligente para retornar resultados relevantes.

Ao combinar campos com pesos diferentes, pontuação do Elasticsearch, hierarquia de níveis dos itens, diversas opções de ordenação, o eDirectory garante que os usuários encontrem rapidamente o que procuram — enquanto os administradores têm ferramentas para otimizar seus conteúdos.