Pakketpunten Web App
Interactive web application for visualizing parcel point locations across Dutch municipalities.
Features
- 📍 Interactive Map: View parcel points on an OpenStreetMap-based interactive map
- 🏘️ Municipality Selection: Search and select from 5+ Dutch municipalities
- 🎨 Provider Filtering: Filter by DHL, PostNL, VintedGo, and De Buren
- 📊 Occupancy Filter: Filter by occupancy rate (bezettingsgraad)
- 🎯 Coverage Zones: Toggle 300m and 500m buffer zones
- 📈 Real-time Statistics: See totals, averages, and provider breakdowns
Tech Stack
- Framework: Next.js 16 with App Router
- Language: TypeScript
- Styling: Tailwind CSS
- Maps: React-Leaflet + OpenStreetMap
- Data: Static GeoJSON files (pre-generated via GitHub Actions)
Getting Started
Prerequisites
- Node.js 18+ and npm
Installation
# Install dependencies
npm install
# Run development server
npm run dev
# Build for production
npm run build
# Start production server
npm start
The app will be available at http://localhost:3000
Data Updates
Data is automatically updated daily at 02:00 UTC via GitHub Actions. The workflow:
- Runs Python scripts to fetch fresh data from all provider APIs
- Generates GeoJSON files for each municipality
- Commits updated files to the repository
- Vercel automatically redeploys with fresh data
Project Structure
webapp/
├── app/
│ ├── page.tsx # Main application page
│ ├── layout.tsx # Root layout
│ └── globals.css # Global styles + Leaflet CSS
├── components/
│ ├── Map.tsx # Interactive map component
│ ├── MunicipalitySelector.tsx # Municipality dropdown
│ ├── FilterPanel.tsx # Filter controls
│ └── StatsPanel.tsx # Statistics display
├── types/
│ └── pakketpunten.ts # TypeScript type definitions
└── public/
├── data/ # GeoJSON files per municipality
│ ├── amsterdam.geojson
│ ├── rotterdam.geojson
│ └── ...
└── municipalities.json # List of available municipalities
Deployment
Vercel (Recommended)
- Push to GitHub
- Import project in Vercel
- Vercel will auto-detect Next.js and deploy
- Data updates via GitHub Actions will trigger automatic redeployments
Environment Variables
No environment variables are required. All data is static and committed to the repository.
Development Notes
- Map component uses
dynamicimport withssr: falseto avoid Leaflet SSR issues - Data is loaded on-demand per municipality to optimize performance
- Filters are applied client-side for instant feedback
- Leaflet CSS must be imported in
globals.css
Future Enhancements
- Add search by address/postcode
- Add route planning to nearest parcel point
- Add heatmap visualization
- Export filtered data as CSV/JSON
- Add municipality comparison view
- Expand to all 345 Dutch municipalities
License
MIT License - See parent project for details