Soil Information Endpoints
Get detailed soil information including type, pH, organic matter, and gardening recommendations.
GET /api/soil-info/postcode/{postcode}
Get soil information by Dutch postcode (e.g., 1012AB). Returns soil type, properties, and gardening advice.
GET /api/soil-info/coordinates/{lat}/{lon}
Get soil information by GPS coordinates. Searches within expanding radius to find nearest soil data.
GET /api/soil-info/address?q={address}
Get soil information by full address. Uses Google Geocoding to convert address to coordinates.
Cadastral (Kadaster) Information Endpoints
Get parcel boundaries, areas, and cadastral information from the official Dutch Kadaster.
GET /api/kadaster/parcel-by-address?postcode={postcode}&huisnummer={number}&toevoeging={addition}
Get parcel information by address. Returns full geometry with boundary coordinates, total area, and estimated garden area.
• postcode: Dutch postcode (required)
• huisnummer: House number (required)
• toevoeging: House number addition like 'A' or 'bis' (optional)
GET /api/kadaster/parcel/{perceelId}
Get parcel information by cadastral ID (e.g., ASD04-F-7955). Returns geometry and area calculations.
GET /api/kadaster/search?q={query}&lat={lat}&lon={lon}&radius={radius}
General search for cadastral information. Can search by text query or coordinates with radius.
GET /api/kadaster/geometry/{perceelId}
Get only the geometry data for a specific parcel. Useful for debugging or when you only need boundaries.
⚠️ Note: Parcel geometry may be found using location-based search when exact cadastral ID match is not available in the WFS service.
Insect Prediction Endpoints
Get insect predictions based on habitat analysis, seasonal activity, and observation data.
GET /api/insects/postcode/{postcode}?month={1-12}&includeDetails={true|false}&debug={true|false}&nocache={true|false}
Get insect predictions for a Dutch postcode. Returns scored insects based on habitat suitability, seasonal activity, and observations.
• month: Query month (1-12), defaults to current month
• includeDetails: Include detailed confidence factors and plant preferences
• debug: Include diagnostic information for troubleshooting
• nocache: Skip cache and force fresh calculation
GET /api/insects/coordinates/{lat}/{lon}
Get insect predictions by GPS coordinates. Same parameters as postcode endpoint.
GET /api/insects/:id?postcode={postcode}
Get details for a specific insect. Optional postcode for location-specific confidence calculation.
GET /api/insects/seasonal/{postcode}
Get seasonal overview showing insect activity for all 12 months.
GPKG Data Migration
Upload BRO Bodemkaart GPKG files to populate the soil database.
Checking connection...