Meridiano

Problema

Existem conjuntos de dados públicos com mais de cinquenta mil localidades do mundo, mas em bruto são uma tabela plana. Saber que país tem mais cidades registadas, quais são as capitais de cada região ou onde fica um ponto no mapa exige tratar os dados antes de os poder ler.

Abordagem

O Meridiano carrega o conjunto de dados no arranque e valida-o antes de servir: coordenadas dentro dos limites, identificadores únicos, população registada distinguida de população desconhecida. Fica em memória com os índices que a API precisa — por código ISO3, por tipo de capital e um índice de pesquisa em que nome, país e região são reduzidos à forma sem acentos, para que São Paulo responda com ou sem til.

A API é só de leitura, serve páginas ordenáveis, agrega os países uma vez no arranque e responde também por área geográfica, que é como as fichas de cidade e de país desenham o seu mapa. O frontend é Next.js com React e TypeScript: tabelas paginadas para cidades, países e capitais, rankings com barras proporcionais à população e um mapa Leaflet que agrupa os pontos próximos. No mapa mundial o desenho é por amostra, a partir de um mínimo de população, porque cinquenta mil marcadores soltos não se desenham.

Resultado

Concluído. O atlas cobre 50 248 localidades, 241 países e 250 capitais nacionais, com pesquisa tolerante a acentos, tabelas ordenáveis, rankings e mapa. A API tem testes automáticos e a interface distingue sempre população conhecida de dados em falta. Os dados são o conjunto público de cidades da SimpleMaps, sob CC BY 4.0, e o mapa usa mosaicos de OpenStreetMap; as atribuições e a data da versão estão visíveis na aplicação.