Technology & data
Which data does Schaduwplan use? 3DBAG, BAG, AHN4 and PDOK

Schaduwplan runs on four open government sources: BAG, PDOK, 3DBAG and AHN. BAG and PDOK supply addresses and building outlines, 3DBAG the building models and AHN the laser heights, in three versions: AHN4, AHN5 and AHN6. For buildings 3DBAG still lacks, Schaduwplan calculates the roof itself on the newest AHN6 scan, with roofer. Vertical accuracy of AHN: 5 cm.
Which data does Schaduwplan use?
Schaduwplan builds the 3D model of an address from four public Dutch government sources. The Key Register of Addresses and Buildings (BAG) and the PDOK Locatieserver fix addresses and building outlines. 3DBAG turns them into building models. AHN (Actueel Hoogtebestand Nederland) measures heights with lasers, in three versions: AHN4, AHN5 and AHN6. All sources are open and free to use without an API key.
The sources form a stack, from bottom to top. At the bottom is the BAG with the outline of every building, together with PDOK, which finds an address on it. Above it is 3DBAG, which turns that outline into a building with a roof shape. At the top is AHN: the laser scans that 3DBAG derives its roofs from and that Schaduwplan uses to check heights. All layers use the same coordinate system (Rijksdriehoekstelsel, EPSG:28992), so the projection works without conversion discrepancies. That is exactly the kind of data stack that HoeveelZon, DGMR and Peutz also base their sunlight studies on.
3DBAG: building models from TU Delft and 3DGI
3DBAG (at 3dbag.nl) is an open dataset of automatically reconstructed 3D models for all roughly 10 million buildings in the Netherlands. The models are available at two levels of detail. LoD1 is a simple flat extrusion: the BAG footprint pulled up to the average roof height from AHN. LoD2.2 is far richer — it contains real roof shapes (gable roof, hip roof, flat roof, lean-to roof), gutter lines and ridge heights. Schaduwplan uses LoD2.2 because the roof shape makes a material difference at a low sun angle (February, October).
The dataset is built by a joint team from TU Delft (the 3D Geoinformation group) and 3DGI. Source material: BAG footprints combined with AHN height points through a reconstruction algorithm. Updates are released quarterly. The current beta version (v2025.09.03) covers the whole of the Netherlands. The attribution “3DBAG by tudelft3d + 3DGI” is required in reports — Schaduwplan places this in the methodology appendix by default.
For the report you submit to the municipality, the LoD2.2 accuracy is relevant. In Voorburg (5 April 2023, ECLI:NL:RVS:2023:1329) the Council of State ruled that a height discrepancy of 3 cm on a ridge height of 8.24 m is “negligible” — a signal that the AHN-derived 3DBAG heights sit well below any legally relevant threshold.
BAG: Dutch address and building register (Kadaster)
The BAG (Key Register of Addresses and Buildings) is the authentic source for all Dutch addresses, buildings, dwelling units and parcels. Managed by the Kadaster under the Addresses and Buildings Register Act. Every building has a unique ID (BAG building code) and an exact footprint in Rijksdriehoek coordinates. It also holds metadata: year of construction, use function (dwelling, shop, office), floor area, status (under construction, in use, demolished).
For a sunlight study, the footprint is decisive. The precise position of a building on the parcel determines where shadows are cast. An error of half a metre to the left or right shifts the shadow curve by a few tens of centimetres per hour. With BAG that margin is absent: the Kadaster maintains parcel boundaries to millimetre precision, and 3DBAG takes the footprint directly from it.
A second important detail: BAG distinguishes dwelling units within a single building. An apartment block is one building but contains several dwelling units. For a measurement point in a specific living room, the dwelling-unit ID is more relevant than the building ID. Schaduwplan uses PDOK to resolve an address to both the building and the dwelling unit, so that measurement points are placed on the correct floor.
AHN4, AHN5 and AHN6: height data from laser surveys
The Actueel Hoogtebestand Nederland (AHN) is a nationwide raster of height points, captured with aircraft-based laser surveys (LiDAR). Managed by Rijkswaterstaat and the water authorities. Resolution: 50 cm horizontal, vertical accuracy 5 cm. Each new version is a new round of measurements. Schaduwplan reads two types of data from it: ground level (for correct terrain rendering in the 3D model) and object height (for existing buildings). Three versions now lie side by side, and which one lies under your address depends on where you live.
| Version | Captured | Where | How Schaduwplan uses it |
|---|---|---|---|
| AHN4 | 2020 to 2022 | All of the Netherlands | The basis. Served by PDOK. It covers everywhere, so also the terrain far around your building and every address where a newer version is still missing. |
| AHN5 | Since 2023, region by region | Many regions, not everywhere yet | Where it exists, it is the newer measurement above AHN4. Served by Ellipsis Drive, AHN's distribution partner. |
| AHN6 | Since October 2025, region by region | A growing part of the Netherlands | The newest measurement. Also from Ellipsis Drive. Here Schaduwplan calculates roofs itself for buildings that 3DBAG still lacks (see below). |
According to the AHN programme (ahn.nl, dataroom), the versions do not follow each other neatly: AHN5 and AHN6 are partly captured side by side. Schaduwplan knows for each map sheet which version is the newest and picks it. If that lookup list is unavailable, it falls back to AHN4, because that one covers everywhere. The outer ring of the terrain, where distant hills count as shadow casters, always comes from AHN4: for a far hill a scan from a few years later makes no difference.
The ground level matters more than it seems. A terraced house on sloping terrain gets different shadows than the same house on a flat polder plain. In Limburg or the Utrechtse Heuvelrug, the height difference between two adjacent parcels can run to several metres. Sunlight studies that reckon only with BAG footprints and flatten the ground level miss this effect. Schaduwplan includes the AHN ground level in the scene, from the newest version Schaduwplan knows for the map sheet (AHN4 or AHN5).
When does Schaduwplan read the laser itself, and when does it rely on 3DBAG? 3DBAG stays the first choice: its roofs come from the same AHN surveys. If a building was altered afterwards, or a clearly newer scan lies over the building than the one 3DBAG used, Schaduwplan measures the height again in the newest scan it knows for that map sheet (AHN4 or AHN5; AHN6 for a building built after the last AHN5 scan). A building that was built even later than the newest scan is not in it; it stays an estimate, and the building card says so.
Buildings 3DBAG still lacks: roofer on AHN6
For a building that 3DBAG has not modelled yet, Schaduwplan runs the same program as 3DBAG, roofer, on the newest AHN6 laser scan itself. The roof then comes from the newest measurement and not from an estimate. Roofer is open source and made by the 3DBAG team (github.com/3DBAG/roofer). It concerns recently built buildings, such as new-build homes, that are not in 3DBAG or whose 3DBAG roof is older than the building.
This happens in advance, not at every visit. Roofer calculates per map sheet of 1 by 1 kilometre and stores the result. Every visitor and every paid report then reads the same file. Each calculated roof goes through checks against the laser points. If it fails some checks but still lies closer to the measured points than a flat block would, it shows on the building card as "less certain". A roof that fails the checks is not used by Schaduwplan.
What this is not yet: full coverage. Not every map sheet has been calculated yet; the calculation began with the map sheets that hold the most new buildings. A building on a map sheet that is not yet done, or outside the area AHN6 has already flown, keeps its estimate for now. If the roof is there, the building card says under "How was this determined?" that it was calculated with roofer and, where known, from which month the laser scan dates.
PDOK Locatieserver: from address to geo-ID
The PDOK Locatieserver is an open geocoding service managed by the Ministry of the Interior (BZK). Type in a free-form address (“Prinses Beatrixlaan 12, Rijswijk” or “1234AB 12”), and the service returns: exact coordinates in Rijksdriehoek, the BAG building ID, the BAG dwelling-unit ID, and all metadata from BAG. Even with typos or incomplete addresses (“Beatrixlaan Rijswijk”) it produces a correct match.
For Schaduwplan this is the starting point. When you type an address into the search bar, PDOK retrieves the exact building ID, which is forwarded to the 3DBAG API for the 3D volume, and the AHN raster for the surrounding ground level within a 150-metre radius. The whole process takes less than a second. None of these requests require an API key, which means the data supply chain has no dependencies that could fall away or undergo price changes.
The same data as a €500 report — the difference lies elsewhere
An important point to make explicit: the data quality of self-service tools and independent firms is identical. All four price segments in the market (self-service €49, small firm from €400, large engineering firm €500 to €5,000) use 3DBAG, BAG and AHN as their basis. The difference between the segments lies in interpretation, sign-off and report form — not in the underlying measurement.
| Element | Self-service tool | Small firm | Large engineering firm |
|---|---|---|---|
| 3DBAG building models | Yes | Yes | Yes |
| BAG address validation | Yes | Yes | Yes |
| AHN ground level | Yes | Yes | Yes |
| Rijksdriehoek projection | Yes | Yes | Yes |
| TNO test-date assessment | Yes, automated | Yes, manual | Yes, manual |
| Human sign-off | No | Yes (consultant) | Yes (sworn expert) |
| Expert witness at a hearing | No | Depends on the firm | Yes |
The table shows the crux: the data is identical, the interpretation differs. For the objection phase of an environmental permit — where an official assesses the file on its merits without a hearing — the sign-off rarely plays a role. The file is primarily assessed on methodology, source citation and conclusions, not on who signs it.
How judges test these sources
Three rulings by the Council of State together build the legal framework within which this data stack is accepted. In Ootmarsum (3 July 2013, ECLI:NL:RVS:2013:191) the Council annulled a zoning plan precisely because no sunlight study using this type of data had been carried out. In Almelo (18 January 2023, ECLI:NL:RVS:2023:172) the Council confirmed that TNO standards based on this data are not unusual. In Voorburg (5 April 2023, ECLI:NL:RVS:2023:1329) the Council accepted a height discrepancy of 3 cm as negligible.
Together these three rulings form an implicit seal of approval. A report that combines 3DBAG, BAG and AHN, with TNO-standard testing and coordinates on the Dutch national grid, sits methodologically in the safe zone. What the court does still test is whether the study is complete: are all relevant buildings included? Is the test-date choice correct? Is the measurement point placed at 75 cm height? For these specifically testable elements, Schaduwplan is automated.
When this data is not enough
Honest about the limits: for roughly 95% of sunlight questions, 3DBAG, BAG and AHN suffice. The remaining 5% are situations where additional data is needed that does not come from 3DBAG, BAG or AHN.
- Building plans that deviate from the BAG registration. A roof addition under construction is not yet in 3DBAG. You have to draw the planned construction manually, based on the building drawings you receive (as an interested party) through the municipality.
- “Maximum planning possibilities” as the reference. Some municipalities require you to compare not with the existing buildings but with the maximum permitted development under the zoning plan. That comparison you make in Schaduwplan. As soon as your address is known we query the public Ruimtelijke Plannen API — so the omgevingsplan, not 3DBAG. Where the municipality publishes a building plot with its dimensions, the permitted volume appears under Layers and you confirm or correct every value before anything is computed with it. Where it does not, that layer stays away: the plan is then a scan whose building plot exists only on the plan map, and you take the dimensions over yourself. That is a statement about the data, not about what may be built there — an omgevingsplan applies either way. What data does not solve still stands: Schaduwplan does not derive the envelope from the planning rules itself, that legal interpretation stays with you and your architect, and permit-free building, in-plan deviation powers and custom rules are not included in the envelope.
- Complex building physics. For projects with mirrored façades, double skins or atmospheric light reflection, a full daylight study is needed that goes beyond sun hours. Large engineering firms (DGMR, Peutz, Nieman) cover this.
- Historic inner cities with specific aesthetic-quality rules. Municipalities such as Amsterdam-Centrum, Utrecht-Binnenstad and Den Haag-Binnenhof may require additional aesthetic-quality advice that does not fit within a sunlight study. There, local expertise adds value.
In those cases Schaduwplan is usually the fastest starting point: first generate an indicative report based on the standard data, and take it to the firm for the more specialised follow-up steps. The firm then saves the initial 3D modelling time, which materially lowers the final turnaround and the final cost.
Sources (15)
We back every article with public sources. Click to see all the original documents, rulings and datasets.
Sources (15)
We back every article with public sources. Click to see all the original documents, rulings and datasets.
Data sources
- 3DBAG — automatically reconstructed 3D models— TU Delft 3D Geoinformation and 3DGI
- BAG — Key Register of Addresses and Buildings— Kadaster
- AHN4 — Actueel Hoogtebestand Nederland (2020–2022)— Rijkswaterstaat and the water authorities
- AHN5 and AHN6 — distribution and coverage per version— AHN dataroom
- Where are we flying now — progress of the AHN survey— AHN
- roofer — reconstructing roofs from laser points (open source)— 3DBAG team, TU Delft
- PDOK Locatieserver — geocoding and address suggestions— Publieke Dienstverlening Op de Kaart
- BGT — Key Register of Large-scale Topography— Kadaster
- Rijksdriehoekstelsel — national coordinate system— Kadaster
Case law that accepts these sources
- Council of State 3 July 2013 — Ootmarsum: zoning plan annulled for lack of a sunlight study— ECLI:NL:RVS:2013:191
- Council of State 18 January 2023 — Almelo: TNO standards not unusual— ECLI:NL:RVS:2023:172
- Council of State 5 April 2023 — Voorburg: height discrepancy of 3 cm negligible— ECLI:NL:RVS:2023:1329
Standards and documentation
- TNO sunlight standard — original report 2005-BBE-R0036— TNO Delft
- Sunlight study guideline, Krimpen aan den IJssel— Municipality of Krimpen aan den IJssel
- Addresses and Buildings Register Act— wetten.overheid.nl
Frequently asked questions
- Are these data sources legally recognised in court?
- Yes. The Council of State (Almelo, 2023, ECLI:NL:RVS:2023:172) accepted TNO standards based on the same data as "not unusual". In Voorburg (2023, ECLI:NL:RVS:2023:1329) the Council accepted that a height discrepancy of 3 cm at 8 metres is negligible — an implicit confirmation of the accuracy of AHN4 and 3DBAG. In Ootmarsum (2013) the Council even annulled a zoning plan for the absence of a study using these sources.
- How up to date is the data?
- 3DBAG is updated quarterly on the basis of new BAG registrations and AHN surveys. BAG is synchronised in real time with the Kadaster — a newly completed building typically appears within four working days. AHN4 dates from surveys in 2020–2022; AHN5 (since 2023) and AHN6 (since October 2025) are added region by region, and Schaduwplan reads the newest one it knows for your map sheet: AHN4 or AHN5 today, and AHN6 for roofer and for new builds. Vertical accuracy is 5 cm. The sources are more current than at most independent building consultancies, which often work with monthly snapshots.
- What if a recent extension or roof addition is not yet in 3DBAG?
- It happens. Structures without a BAG registration do not automatically appear in 3DBAG. In Schaduwplan you can add a missing volume yourself with the drawing tool, exactly as you draw a planned construction. The Council of State (Voorburg, 2023, ECLI:NL:RVS:2023:1329) ordered an additional study when a recently built roof addition was missing — which shows that it is legally sound to add missing buildings manually.
- What if my building is new and 3DBAG does not have it yet?
- Then Schaduwplan calculates the roof itself with roofer, the 3DBAG program, on the AHN6 laser scan. This only works where AHN6 has already flown and where the calculation for that map sheet is done. Not every map sheet has been calculated yet; the calculation began with the map sheets that hold the most new buildings. A building that was built after the scan is not seen by the laser: it stays an estimate and the building card says so. You can always draw a missing volume yourself.
- Do you pay for this data?
- No. All four sources (3DBAG, BAG, AHN and PDOK) are open data. No API key, no subscription, no volume limits. 3DBAG is available under CC-BY with the attribution "3DBAG by tudelft3d + 3DGI". BAG is an authentic key register under the Addresses and Buildings Register Act. AHN4 is served by PDOK; AHN5 and AHN6 by Ellipsis Drive, the distribution partner of AHN. That is why Schaduwplan can offer reports at € 49 each.
- Can I use this data myself without Schaduwplan?
- In theory, yes. 3DBAG provides CityJSON and 3D Tiles files that you can import into QGIS, Blender or Rhino. BAG is available through the PDOK WFS feed. AHN (4, 5 and 6) can be downloaded as GeoTIFF. Combining them, projecting them onto the Dutch national grid, and running a correct sun-hour calculation, however, typically takes a non-specialist 40 to 80 hours of work. Schaduwplan automates this.
- What is NOT in this data?
- Three categories of element are not included by default. Trees and fences are not in 3DBAG: legally they count as temporary landscape elements and therefore stay outside the formal TNO test (in a neighbour-law dispute their shadow can indeed be weighed — for that you draw them in yourself and Schaduwplan calculates the shadow separately). Interiors and window positions are not modelled in detail — 3DBAG works with roof shapes and volume mass, not with individual windows. Structures without an environmental permit (unauthorised buildings) are usually not registered. For missing elements you use the drawing tool.
The same data as a € 500 report, for € 49
Schaduwplan pulls 3DBAG, BAG and AHN straight from public sources. No API key, no paid data packages. Enter your address and, within one minute, see the 3D model that judges rely on.
Read more

Technology & data
How the sun moves across your garden, by season
In the Netherlands the sun moves from east through south to west and stands due south around midday. Only its height changes: on 21 June it reaches 61 degrees in Amsterdam, on 21 December 14 degrees. This article gives the sun position per reference day and shows how much of that sun your garden actually keeps.

Standards & municipalities
Sunlight and Dutch neighbour law: which rules apply
Three separate frameworks govern sunlight at a home. Sunlight access (the TNO standard) is a guideline, not a law. Daylight (Articles 4.146 and 4.147 of the Building Works Environment Decree) is the only one written into national law. Neighbour law (Article 5:37 of the Civil Code) governs unlawful nuisance. Window size counts for daylight, not for sunlight access.

How Schaduwplan works
Verifying a sunlight report: how to check it is genuine
Every Schaduwplan PDF carries a unique SHA-256 hash that we publish at the moment of issue on schaduwplan.nl/verify. A judge, lawyer or neighbour can confirm in under thirty seconds that the file has not been altered since issue, without having to trust us. As far as we know, no other sunlight-study provider in the Netherlands does this.