Files
VacatureRadar/docs/operations/GEOCODING_DATA_IMPORT.md
2026-07-22 05:12:07 +02:00

45 lines
1.5 KiB
Markdown

# 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
```bash
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.