mhatipog/dados-abertos-belgas

Dados abertos belgas

Os dados públicos belgas estão divididos entre editores federais, regionais, comunitários e locais, três idiomas e limites que mudam frequentemente. A maioria das respostas erradas vem do uso do editor errado, do ano de limite errado ou da leitura incorreta de um arquivo. Esta skill fornece o método de trabalho e o contexto que evitam esses erros. Ela utiliza o conector Belgium Data Desk incluído neste plugin.

Método de trabalho

1. Encontre a fonte. Chame search_datasets com as próprias palavras do usuário; holandês, francês e inglês funcionam. Se o resultado tiver um bloco guidance, os primeiros resultados são a fonte de referência oficial para aquela necessidade: informe quem publica e repasse a ressalva quando for relevante para a pergunta do usuário.
2. Verifique antes de recomendar. Chame get_dataset para o registro que pretende usar. Informe o editor, a família de licença (open, non-commercial, custom, unknown), o ciclo de atualização e a verificação do link. unknown significa que o usuário deve verificar os termos do editor antes de reutilizar; não o chame de aberto.
3. Olhe o arquivo. Quando preview_available for verdadeiro, chame preview_dataset para ver os nomes reais das colunas, tipos, delimitador e linhas de amostra antes de descrever o que os dados contêm ou como uni-los. A pré-visualização cobre apenas os primeiros 64 KiB: nunca apresente rows_read ou valores de amostra como totais para o arquivo inteiro.
4. Responda com evidências. Forneça o título do conjunto de dados, o editor e a página de destino. Cite valores apenas de uma pré-visualização ou da página do editor, rotule-os como amostras e informe qual ano ou data de referência eles descrevem. Se nenhum registro se encaixar, diga isso e sugira o editor com maior probabilidade de possuir os dados.

O conector descreve metadados de catálogo, verificações de links e amostras de arquivos. Ele não certifica que os números em um conjunto de dados estão corretos e não pode calcular totais sobre arquivos inteiros.

Quem publica o quê

• Estatísticas federais: Statbel (população, domicílios, preços e índice de preços ao consumidor, acidentes rodoviários, censo, empresas por setor). O Banco Nacional da Bélgica publica contas anuais de empresas e estatísticas econômicas.
• Estatísticas regionais: Statistiek Vlaanderen (Flandres), IWEPS (Valônia) e IBSA/BISA (Bruxelas) publicam indicadores regionais, frequentemente mais detalhados que as tabelas federais.
• Empresas: o Balcão Central para Empresas (KBO em holandês, BCE em francês), mantido pelo Serviço Público Federal de Economia, é o registro de todos os números de empresa. Um número de IVA belga é BE seguido pelo número de empresa de 10 dígitos.
• Emprego: RVA/ONEM conta beneficiários de seguro-desemprego; os candidatos a emprego registados são contados pelos serviços regionais (VDAB, Le Forem, Actiris e ADG para a Comunidade Germanófona); a taxa de desemprego da OIT provém do Inquérito ao Trabalho de Statbel. Esses três números diferem e não devem ser misturados.
• Meio ambiente, mobilidade, ordenamento do território, agricultura: principalmente regionais. Flandres, Valônia e Bruxelas publicam seus próprios dados, com formatos e datas diferentes.
• Educação, creches, cultura: assuntos comunitários. Os órgãos da Comunidade Flamenga cobrem Flandres e instituições de língua neerlandesa em Bruxelas; a Fédération Wallonie-Bruxelles cobre as de língua francesa.
• Ferrovias: Infrabel (infraestrutura, pontualidade) e SNCB/NMBS (serviços de passageiros). Os horários de transporte público são publicados como GTFS por operador (SNCB, De Lijn, TEC, STIB-MIVB).

Quando a pergunta for sobre toda a Bélgica e os dados forem regionais, informe que o usuário precisa de três fontes e que elas podem não ser comparáveis.

Lugares e códigos

• A Bélgica tem 3 regiões, 10 províncias e, desde as fusões de 1 de janeiro de 2025, 565 municípios (581 antes). Dados publicados antes de 2025 usam os municípios antigos.
• Una dados municipais pelo código REFNIS (NIS/INS) de 5 dígitos, nunca pelos nomes: os nomes diferem por idioma (Antwerpen / Anvers, Liège / Luik, Bergen / Mons) e mudam com fusões. A tabela de códigos REFNIS de Statbel mapeia os códigos; verifique qual ano de limite cada arquivo utiliza.
• O primeiro dígito de um código REFNIS indica a província; os municípios de Bruxelas-Capital são 21001 a 21019.
• Os setores estatísticos são as unidades submunicipais de Statbel; seus códigos começam com o código REFNIS do município.

Lendo arquivos belgas

• Muitos arquivos CSV usam ponto e vírgula como delimitador e vírgula decimal (1.234,5 significa mil duzentos e trinta e quatro e meio). preview_dataset informa delimiter e decimal_separator: "comma" quando detecta isso.
• Arquivos mais antigos frequentemente estão em Windows-1252 em vez de UTF-8; a pré-visualização informa a codificação que usou.
• Os cabeçalhos das colunas costumam estar apenas em holandês ou francês; traduza-os para o usuário e mantenha o nome original ao lado da tradução.
• Um link rotulado como CSV às vezes retorna uma planilha ou uma página web. A pré-visualização informa quando um editor respondeu com uma página web em vez de um arquivo.

Licenças

Informe o rótulo da licença e a família de get_dataset. Licenças abertas (por exemplo, CC BY ou CC0) permitem reutilização comercial com a atribuição indicada. non-commercial e no-derivatives restringem a reutilização. custom e unknown significam que o usuário deve ler os termos do editor. Não adivinhe uma licença com base na reputação do editor.