Como funciona a busca por localização (cidade ou divisão administrativa)?

Introdução

O script utiliza a base de dados do Geonames (geonames.org) — uma das mais estruturadas — para obter informações sobre cidades e divisões administrativas.

No entanto, essa base não é completa para todos os países.

Você pode atualizar essa base manualmente acessando:
Painel de Administração → Configurações → Internacional → Países → ... "Divisões Administrativas 1" ou "Cidades"
Ali você pode adicionar, editar ou excluir dados conforme necessário.

Como funciona a busca por local com a base padrão?

Quando uma Divisão Administrativa é pesquisada

• Quando o usuário pesquisa ou clica em uma divisão administrativa (ex: Estado, Região, Província, Departamento ou Distrito), o script:

1. Exibe anúncios de todas as cidades dentro dessa divisão, ignorando a função de distância.

2. Se a divisão não existir na base de dados, o sistema exibirá anúncios da cidade mais populosa do país (dentro de um raio X, se o recurso de distância estiver ativado).

3. Se a divisão não tiver cidades associadas, nenhum resultado será encontrado.

4. Se nenhum tipo de divisão administrativa for selecionado para o país, a cidade mais populosa será usada automaticamente.

Importante:
Em alguns países, os dados do mapa SVG correspondem às Divisões Administrativas 1 e em outros à Divisão 2.
Por isso, é necessário selecionar pelo menos um tipo de divisão administrativa (1 ou 2) nas configurações do país no painel.

Sobre os dados geográficos

• O script utiliza dois recursos diferentes:

  • Simplemaps para os mapas SVG (simplemaps.com)

  • Geonames para os dados de localização

Como resolver problemas de precisão entre a base de dados e os mapas SVG?

1. Vá para:
   Administração → Configurações → Internacional → Países → [Editar país]

2. Edite ou adicione as cidades e divisões administrativas para que correspondam aos nomes do mapa SVG.

3. Se necessário, edite os arquivos SVG localizados em:
   /public/images/maps/
   (Você pode atualizar nomes de divisões que estão desatualizados no mapa)

4. Se quiser usar apenas seus próprios dados, você pode:

   • Excluir todas as divisões e cidades do país

   • Inserir os dados manualmente pelo painel

5. Se os mapas SVG do Simplemaps não forem precisos o suficiente, você pode desativá-los em:
   Administração → Configurações → Página Inicial → Localizações e Mapa do País

Quando uma Cidade é pesquisada

Você pode configurar o comportamento do script quando o usuário pesquisa uma cidade inexistente em:
Administração → Configurações → Geral → Listagem e Pesquisa → Resultados falsos de localização

As opções disponíveis:

• Página de erro (404): Mostra uma página de erro se a cidade não for encontrada.

• Mostrar resultados da cidade mais popular: Exibe anúncios da cidade mais populosa do país.

• Não aplicar filtro de localização: Ignora o filtro de cidade e mostra todos os resultados.

Nos Formulários de Criação/Edição de Anúncios

Em alguns países, cidades com o mesmo nome podem existir em divisões diferentes.
Por isso, o ideal é permitir que o usuário selecione primeiro a divisão administrativa antes da cidade.

Para habilitar esse recurso:

1. Vá em:
   Painel de Administração → Configurações → Internacional → Países → [Editar país]

2. Selecione o Tipo de Divisão Administrativa (1 ou 2)

3. Marque a opção: "Ativar Campo de Divisão Administrativa"

Pronto! Agora você pode acessar a página de criação de anúncios com localização estruturada.