VacatureRadar/docs/operations/GEOCODING_DATA_IMPORT.md

Geodata import voor Belgische locaties

Deze module gebruikt lokaal beheerde postcode/gemeentedata om locatiecoördinaten te kunnen afleiden. De actuele lokale keuze is GeoNames Postal Codes BE, versie 2026-04-03 onder CC BY 4.0. Bron, checksums, reviewdatum en steekproef staan in config-data/geodata/README.local.md.

CLI

python manage.py import_geodata <pad-naar-geodata.csv> \
  --source-name local \
  --dataset-version 2026-01-01 \
  --license-name "Naam van licentie"
  --license-url "https://..."
  --replace

• Gebruik --validate-only om validatie uit te voeren zonder databasewijzigingen.
• Gebruik --replace wanneer een bron volledig opnieuw opgebouwd moet worden.

Verplichte CSV-kolommen

• postal_code (exact 4 cijfers)
• municipality
• region
• latitude
• longitude

Validatie

• Niet-numerieke coördinaten worden geweigerd.
• Latitude en longitude moeten binnen geldige range vallen.
• Dubbels op postal_code + municipality in de invoer worden afgekeurd.
• Bestaande lookupregels van dezelfde source_name/dataset-version blokkeren import zonder --replace.

Fallback

Zonder geïmporteerde geodata blijft afstandsafleiding op "onbekend".

Nauwkeurigheid en privacy

Een postcodepunt is een geschat centrum en geen routeafstand of exact adres. VacatureRadar bewaart voor het thuisprofiel alleen de ingevoerde postcode en het bijbehorende lookup-punt. De dataset bevat geen namen, adressen, contactgegevens of andere persoonsgegevens.