Este artigo mostra como obter os bairros de uma cidade no Overpass Turbo (OpenStreetMap), gerar um arquivo GeoJSON com essas regiões e importá-lo no Cadastro de Regiões da MaisEntregas pelo ambiente administrativo.

Antes de começar

  • Você precisa de acesso ao ambiente administrativo com permissão para cadastrar regiões.
  • O procedimento depende de dados públicos do OpenStreetMap. A qualidade dos bairros depende do que está cadastrado lá para a cidade escolhida.

Passo 1 – Acessar o Overpass Turbo

  1. Acesse https://overpass-turbo.eu/
  2. No painel de consulta, à esquerda da tela, apague todo o conteúdo existente antes de colar a nova consulta.

Passo 2 – Inserir o código de consulta

Cole o código abaixo no editor do Overpass Turbo:

[out:json][timeout:25];

{{geocodeArea:Florianópolis, Santa Catarina}}->.searchArea;

// gather results
(
  nwr["boundary"="administrative"]["admin_level"="10"](area.searchArea);
);

// print results
out geom;

Essa consulta busca as regiões administrativas (bairros) cadastradas no OpenStreetMap para a cidade informada.

Importante: às vezes o Overpass Turbo exibe um erro como request_read_and_idx::timeout, que indica que o tempo limite da consulta foi excedido. Na maioria das vezes, isso acontece por alta demanda nos servidores do OpenStreetMap e não indica problema no código. Aguarde alguns minutos e execute a pesquisa novamente até o processamento concluir com sucesso.

Passo 3 – Informar a cidade desejada

Localize a linha:

{{geocodeArea:Florianópolis, Santa Catarina}}->.searchArea;

Substitua Florianópolis, Santa Catarina pela cidade e pelo estado desejados. Exemplo:

{{geocodeArea:Recife, Pernambuco}}->.searchArea;

Passo 4 – Executar a consulta

  1. Clique no botão Run, na parte superior da página.
  2. Aguarde o processamento e confira se os polígonos dos bairros aparecem no mapa.

O tempo de carregamento varia conforme o tamanho da cidade e a quantidade de regiões cadastradas no OpenStreetMap.

Passo 5 – Ajustar o nível administrativo (se necessário)

Se a consulta rodar, mas nenhum bairro aparecer, troque o nível administrativo. Algumas cidades usam níveis diferentes no OpenStreetMap.

  1. Localize a linha ["admin_level"="10"] e altere para ["admin_level"="9"]. Clique em Run.
  2. Se ainda não houver resultados, altere para ["admin_level"="8"] e clique em Run novamente.

Passo 6 – Exportar o arquivo GeoJSON

Depois de conferir os bairros no mapa:

  1. Clique em Export.
  2. Selecione GeoJSON.
  3. Clique em Download/Copy as GeoJSON.
  4. Salve o arquivo no seu computador. O nome padrão é export.geojson.

O arquivo conterá todas as regiões retornadas pela consulta.

Passo 7 – Importar o arquivo na MaisEntregas

  1. No ambiente administrativo, acesse o Cadastro de Regiões.
  2. Selecione a cidade correspondente.
  3. Informe o nome da região, quando aplicável.
  4. Escolha o tipo de região desejado.
  5. Clique em Carregar arquivo GeoJSON.
  6. Selecione o arquivo export.geojson.
  7. Aguarde o processamento.
  8. Confira os bairros e os polígonos exibidos no mapa.
  9. Clique em Confirmar.

Após o processamento, a plataforma identifica automaticamente as regiões contidas no arquivo.

Resultado esperado

Ao final do procedimento você terá:

  • todos os bairros da cidade importados com um único arquivo GeoJSON;
  • os limites geográficos visíveis no mapa;
  • a possibilidade de conferir as regiões antes de concluir o cadastro;
  • menos cadastros manuais de regiões.