Pakketpunten Nederland
Een systeem voor het verzamelen, analyseren en visualiseren van pakketpunten in Nederland, bestaande uit een Python backend voor dataverzameling en een Next.js webapplicatie voor interactieve kaartvisualisatie.
Data wordt wekelijks automatisch bijgewerkt via GitHub Actions voor alle 342 Nederlandse gemeenten.
Disclaimer — Dit project wordt geleverd "as is" zonder garantie. Data is verzameld van publieke bronnen en kan onnauwkeurigheden bevatten. Verifieer locatiegegevens. Dit project is niet gelieerd aan de databronbedrijven.
Huidige Dekking
| Vervoerder | Methode | Locaties | Landelijk ophalen |
|---|---|---|---|
| PostNL | Publieke Widget API | ~4.560 | Per gemeente (bbox) |
| DHL | Publieke REST API | ~4.380 | Grid-based cache |
| DPD | Publieke REST API | ~2.100 | Cache (enkele API call) |
| VintedGo | Web scraping | ~2.090 | Per gemeente (bounds) |
| Amazon | Browser automation | ~1.220 | Per gemeente |
| GLS | Browser automation | ~950 | Landelijk cache |
| De Buren | Web scraping | ~165 | Per gemeente |
| Totaal | ~15.460 |
Data wordt bijgehouden sinds november 2025 met wekelijkse snapshots.
Webapplicatie
De Next.js webapp biedt een interactieve kaartvisualisatie op pakketpunten.nl.
Features
- Interactieve kaart met OpenStreetMap en Leaflet voor alle 342 gemeenten + nationaal overzicht
- Adaptieve rendering — canvas rendering en vereenvoudigde markers voor grote datasets (15.000+ punten)
- Filters — per vervoerder, bufferzone (300m/400m), bezettingsgraad, punttype
- Statistieken — per gemeente en vervoerder, met historische trends
- Adres zoeken — zoek naar een adres en vind nabijgelegen pakketpunten
- Dichtstbijzijnde punten — vind pakketpunten binnen 500m van een locatie
- Gemeentegrenzen — provinciale grenzen weergave in nationaal overzicht
- Data export — download data als GeoJSON of CSV via de API
- Data matrix — vergelijk dekking over alle gemeenten en vervoerders
- Automatische spiderfy — overlappende markers worden gespreid op hoog zoomniveau
- Eerlijke zichtbaarheid — vervoerder render-volgorde roteert elk uur
Installatie
cd webapp
npm install
npm run dev
Open http://localhost:3000 in je browser.
Python Backend
Installatie
git clone https://github.com/robbertj85/pakketpunten.git
cd pakketpunten
python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt
Gebruik
# Enkele gemeente verwerken
python main.py --gemeente Amsterdam --filename test --format geojson
# Complete DHL data ophalen (grid-based, ~3.800+ locaties) - eenmalig
python scripts/dhl_grid_fetch.py
# Complete DPD data ophalen - eenmalig
python scripts/dpd_fetch_all.py
# Complete GLS data ophalen - eenmalig
python scripts/gls_fetch_all.py
# Alle gemeenten batch verwerken (gebruikt caches automatisch)
python scripts/batch_generate.py
# Nationaal overzicht genereren
python scripts/create_national_overview.py
# Provinciale grenzen genereren (voor Nederland view)
python scripts/create_provincial_boundaries.py
Projectstructuur
pakketpunten/
├── main.py # Hoofdscript: data ophalen en analyse
├── api_client.py # API-aanroepen (DHL, DPD, PostNL, GLS, VintedGo, De Buren, Amazon)
├── geo_analysis.py # Geografische analyses (buffers, unions)
├── utils.py # Hulpfuncties (CRS, geocoding, sessies)
├── visualize.py # Kaartweergave met Folium (legacy)
├── requirements.txt # Python dependencies
├── data/ # Gecachte data en logs
│ ├── dhl_all_locations.json
│ ├── dpd_all_locations.json
│ └── gls_all_locations.json
├── scripts/ # Automatisering en data processing
│ ├── batch_generate.py # Batch verwerking alle gemeenten
│ ├── dhl_grid_fetch.py # Landelijke DHL data (grid-based)
│ ├── dpd_fetch_all.py # Landelijke DPD data
│ ├── gls_fetch_all.py # Landelijke GLS data
│ ├── create_national_overview.py
│ ├── create_provincial_boundaries.py
│ ├── update_totals_history.py
│ ├── fetch_cbs_municipality_data.py
│ ├── municipality_statistics_analysis.py
│ └── generate_pdf_report.py
├── .github/workflows/ # GitHub Actions
│ ├── update-data.yml # Wekelijkse data-update (alle vervoerders)
│ └── fetch-gls-data.yml # Wekelijkse GLS data-update
├── docs/ # Documentatie
└── webapp/ # Next.js webapplicatie
├── app/ # Next.js App Router (pagina's + API routes)
│ ├── page.tsx # Hoofdpagina met kaart
│ ├── data-export/ # Data export pagina + matrix view
│ └── api/ # REST API (download, geocode, v1)
├── components/ # React componenten
│ ├── Map.tsx # Leaflet kaart met adaptieve rendering
│ ├── FilterPanel.tsx # Vervoerder filters en opties
│ ├── StatsPanel.tsx # Statistieken dashboard
│ ├── MunicipalitySelector.tsx
│ ├── AddressSearchInput.tsx
│ ├── NearestPointsFinder.tsx
│ ├── AboutModal.tsx
│ └── ... # History modals, trends, clusters
├── utils/ # Hulpfuncties
│ ├── boundaryLoader.ts
│ └── distanceUtils.ts
├── types/ # TypeScript type definities
└── public/
├── data/ # GeoJSON per gemeente + nationaal overzicht
├── logos/ # Vervoerder logo's (SVG/PNG)
└── municipalities.json
Automatisering
Data wordt wekelijks automatisch bijgewerkt via GitHub Actions:
update-data.yml— Elke zondag: haalt data op voor alle 342 gemeenten, genereert nationaal overzicht, werkt historische snapshots bijfetch-gls-data.yml— Elke zondag: vernieuwt de GLS landelijke cache
Handmatig triggeren kan via gh workflow run update-data.yml.
Technische Details
Coordinatensystemen
- WGS84 (EPSG:4326) — API I/O, GeoJSON, webkaarten (graden)
- RD New (EPSG:28992) — Metrische berekeningen, buffers (meters)
Altijd transformeren naar RD New voor afstandsberekeningen, daarna terug naar WGS84 voor output.
Stack
| Component | Technologie |
|---|---|
| Backend | Python 3.10+, GeoPandas, Shapely, Requests |
| Frontend | Next.js 16, TypeScript, React, Leaflet, Tailwind CSS |
| CI/CD | GitHub Actions |
| Hosting | Vercel (webapp), GitHub (data) |
Licentie
Dit project is vrijgegeven onder de MIT-licentie. De licentie geldt voor de broncode, niet voor de data.
Data Attributie
Bij gebruik van de gegenereerde data moet de volgende attributie worden opgenomen:
Data bronnen:
- DHL Parcel Netherlands (https://www.dhl.nl)
- PostNL (https://www.postnl.nl)
- DPD (https://www.dpd.nl)
- GLS Netherlands (https://gls-group.com/NL)
- Amazon (via https://www.amazon.nl/ulp)
- VintedGo / Mondial Relay (https://vintedgo.com)
- De Buren (https://deburen.nl)
- Gemeente grenzen (c) OpenStreetMap contributors