Tag og solceller pr. BFE
Hver tagflade målt i højdemodellen, med skygge måned for måned, paneler der kan ligge der, produktion og tre anlæg med økonomi.
https://api.grundfast.dk/v1/dhm/tag/{bfe}/solBygger på samme tagfit som /v1/dhm/bygninger: RANSAC-planer i overflademodellen (0,4 m) inden for GeoDanmark-omridset. Hver celle gives til den flade, der forklarer den, så hver flade får sit sande areal (planareal ÷ cos hældning), sin retning, tagfod, top og spær. Celler, ingen flade forklarer — skorsten, kviste, træ over taget — står i uden_flade_m2 og får ingen paneler.
Skyggen er målt, ikke antaget: fra op til fem punkter på fladen marcheres der stråler gennem overflademodellen ud til 100 m i 72 retninger, og horisonten blokerer den direkte sol time for time i et typisk år fra PVGIS. Ydelsen pr. kWp kommer fra PVGIS (EU JRC) for fladens hældning og retning og ganges med månedens skyggefaktor.
Panelerne pakkes i fladens eget plan med fast panel (1,762 × 1,134 m, 440 Wp) og 0,30 m fri kant. Tre anlæg: maks (alle paneler på flader over 650 kWh/kWp), foreslaaet (bedste flade først, til produktionen dækker forbruget) og lille (halvdelen). Økonomien bruger Energinets day-ahead-priser for prisområdet, vægtet med hvornår solen skinner på adressen.
En tagform, højdemodellen ikke kan navngive, får beregnet: false og en aarsag — vi gætter aldrig et tag ud fra årstal eller materiale. Alle antagelser står i forudsaetninger, og de økonomiske kan overskrives på forespørgslen.
/v1/plan/ejendom/:bfe/citater.Godkendelse · API-nøgle
Send din nøgle som Authorization: Bearer gf_live_… — eller gf_test_… for gratis sandbox-kald. Se Godkendelse og nøgler.
Afregning
Ét kald — også selvom svaret samler DHM, GeoDanmark, BBR, PVGIS og Energi Data Service.
Eksempel
curl "https://api.grundfast.dk/v1/dhm/tag/6033800/sol?forbrug_kwh=5500" \
-H "Authorization: Bearer $GRUNDFAST_API_KEY"{
"bfe_nummer": 6033800,
"prisomraade": "DK2",
"antal": 2,
"bygninger": [
{
"bbr_uuid": "20092849-2ea1-42a5-8511-a88bc98a78f5",
"bbr": {
"anvendelse": "Bygning til kontor",
"opfoerelsesaar": 1845,
"tagdaekning": "Fibercement herunder asbest",
"bebygget_areal_m2": 381
},
"tagform": "saddeltag",
"konfidens": 0.61,
"haeldning_grader": 28.1,
"terraen_m": 2.75,
"beregnet": true,
"aarsag": null,
"tag_aarsag": null,
"fodaftryk_m2": 376.8,
"uden_flade_m2": 29.4,
"tagmaal": {
"tagfod_m": 0.8,
"rygning_m": 20.9,
"spaer_m": 21.1,
"tagflade_m2": 395.3,
"tagflade_inkl_udhaeng_m2": 416.5
},
"flader": [
{
"nr": 1,
"haeldning_grader": 31.5,
"aspekt_grader": 112,
"retning": "Ø",
"areal_m2": 206.7,
"areal_vandret_m2": 176.2,
"tagfod_m": 0.4,
"top_m": 20.7,
"spaer_m": 21.1,
"skygge": {
"aar_pct": 8.6,
"maaned_pct": [
39.6,
17.9,
10.1,
6.9,
5.3,
5,
5,
6.5,
6.9,
16.3,
31.6,
53.2
],
"horisont_grader": [
42.8,
34.3,
16.4,
16.8,
16.8,
15.3,
9.9,
14.6,
15.9,
14.3,
15.3,
15.2,
15.8,
15.3,
14.3,
12.2,
12.4,
14,
15.5,
16.1,
16.4,
16.9,
15.9,
15.1,
17.3,
21.5,
23.4,
25.3,
26.8,
28.8,
28.8,
27.1,
27.8,
24.9,
31.1,
44.1
]
},
"kwh_pr_kwp": 775,
"kwh_pr_kwp_uden_skygge": 848,
"maaned_kwh_pr_kwp": [
8.4,
24,
60.5,
99.2,
120.4,
124.1,
117.9,
98.2,
71.3,
35.5,
11.2,
4.2
],
"paneler": {
"antal": 67,
"retning": "staaende",
"kwp": 29.5,
"kwh_aar": 22847,
"placering": [
[
[
12.5902582,
55.6792607,
8.35
],
[
12.5902507,
55.6792514,
8.35
],
[
12.5902289,
55.6792571,
9.27
],
[
12.5902365,
55.6792663,
9.27
]
]
]
}
},
{
"nr": 2,
"haeldning_grader": 24.7,
"aspekt_grader": 292,
"retning": "V",
"areal_m2": 188.6,
"areal_vandret_m2": 171.4,
"tagfod_m": 0.4,
"top_m": 20.9,
"spaer_m": 13.3,
"skygge": {
"aar_pct": 11.5,
"maaned_pct": [
23.8,
23.2,
15.8,
10.4,
9.1,
9.9,
8.6,
10.5,
13.3,
18.4,
27.9,
20
],
"horisont_grader": [
20.6,
17.8,
18.8,
18.3,
12.9,
18.2,
24.9,
27.9,
30.2,
34.9,
35,
34.8,
35.9,
34.9,
34.1,
31.2,
28.2,
25.3,
16.9,
17.6,
17.9,
17.8,
17.6,
16.9,
15.3,
13.9,
13.3,
17,
14.5,
12.4,
11.7,
11.7,
29.4,
31.5,
28,
25.7
]
},
"kwh_pr_kwp": 633,
"kwh_pr_kwp_uden_skygge": 715,
"maaned_kwh_pr_kwp": [
5.4,
13.9,
42.8,
79.7,
106.8,
110.5,
106.3,
82.4,
51.5,
23.6,
6.7,
3.3
],
"paneler": {
"antal": 57,
"retning": "liggende",
"kwp": 25.1,
"kwh_aar": 15877,
"placering": [
[
[
12.5902459,
55.6792063,
8.33
],
[
12.5902579,
55.6792206,
8.33
],
[
12.5902727,
55.6792168,
8.8
],
[
12.5902607,
55.6792024,
8.8
]
]
]
}
}
],
"anlaeg": {
"lille": {
"paneler": 7,
"kwp": 3.1,
"kwh_aar": 2387,
"maaned_kwh": [
26,
74,
186,
306,
371,
382,
363,
303,
220,
109,
34,
13
],
"fordeling": [
{
"flade": 1,
"paneler": 7
}
],
"oekonomi": {
"pris_kr": 38200,
"egetforbrug_andel": 0.48,
"egetforbrug_kwh": 1147,
"salg_kwh": 1240,
"vaerdi_aar1_kr": 2199,
"tilbagebetaling_aar": 18.1
}
},
"foreslaaet": {
"paneler": 14,
"kwp": 6.2,
"kwh_aar": 4774,
"maaned_kwh": [
52,
148,
373,
611,
741,
765,
726,
605,
439,
219,
69,
26
],
"fordeling": [
{
"flade": 1,
"paneler": 14
}
],
"oekonomi": {
"pris_kr": 64400,
"egetforbrug_andel": 0.34,
"egetforbrug_kwh": 1622,
"salg_kwh": 3152,
"vaerdi_aar1_kr": 3795,
"tilbagebetaling_aar": 17.7
}
},
"maks": {
"paneler": 67,
"kwp": 29.5,
"kwh_aar": 22847,
"maaned_kwh": [
248,
709,
1784,
2924,
3548,
3659,
3475,
2896,
2103,
1048,
330,
123
],
"fordeling": [
{
"flade": 1,
"paneler": 67
}
],
"oekonomi": {
"pris_kr": 262600,
"egetforbrug_andel": 0.16,
"egetforbrug_kwh": 3549,
"salg_kwh": 19298,
"vaerdi_aar1_kr": 14380,
"tilbagebetaling_aar": 19.1
}
}
},
"anlaeg_aarsag": null
},
{
"bbr_uuid": "7a43c85a-7837-4c32-bce3-e9ad146371bc",
"bbr": {
"anvendelse": "Bygning til kontor",
"opfoerelsesaar": 1845,
"tagdaekning": "Tegl",
"bebygget_areal_m2": 223
},
"tagform": "saddeltag",
"konfidens": 0.5,
"haeldning_grader": 45.3,
"terraen_m": 2.27,
"beregnet": true,
"aarsag": null,
"tag_aarsag": null,
"fodaftryk_m2": 230.4,
"uden_flade_m2": 49.8,
"tagmaal": {
"tagfod_m": 34.4,
"rygning_m": 0.5,
"spaer_m": 11.9,
"tagflade_m2": 256.7,
"tagflade_inkl_udhaeng_m2": 280.9
},
"flader": [
{
"nr": 1,
"haeldning_grader": 45.1,
"aspekt_grader": 202,
"retning": "S",
"areal_m2": 137.6,
"areal_vandret_m2": 97.1,
"tagfod_m": 17.3,
"top_m": 0.4,
"spaer_m": 10.7,
"skygge": {
"aar_pct": 8.4,
"maaned_pct": [
6.5,
7.2,
11.1,
9.7,
7.8,
7.4,
7.6,
8.2,
9.8,
9.1,
6.3,
4
],
"horisont_grader": [
43.6,
47,
47,
47,
46.9,
51.9,
46.4,
37.1,
36.3,
31.4,
24.2,
24.2,
6.1,
5.6,
5.1,
4.2,
2.8,
1.6,
2.7,
3,
3.2,
2.4,
2.5,
3.1,
15.7,
20.2,
24.3,
25.3,
25.1,
27.8,
30.9,
32.9,
31.9,
37.3,
40.8,
43.6
]
},
"kwh_pr_kwp": 890,
"kwh_pr_kwp_uden_skygge": 971,
"maaned_kwh_pr_kwp": [
23.8,
40.3,
78.1,
109.2,
122.7,
119.1,
115.3,
102.8,
82.2,
53.8,
25.8,
16.5
],
"paneler": {
"antal": 37,
"retning": "liggende",
"kwp": 16.3,
"kwh_aar": 14482,
"placering": [
[
[
12.5904483,
55.6794559,
14.22
],
[
12.5904228,
55.6794626,
14.22
],
[
12.5904282,
55.679469,
15.02
],
[
12.5904537,
55.6794624,
15.02
]
]
]
}
},
{
"nr": 2,
"haeldning_grader": 45.5,
"aspekt_grader": 21,
"retning": "N",
"areal_m2": 119.1,
"areal_vandret_m2": 83.5,
"tagfod_m": 17.1,
"top_m": 0.5,
"spaer_m": 11.9,
"skygge": {
"aar_pct": 2.6,
"maaned_pct": [
1.7,
1.7,
2.2,
1.2,
2.6,
3.9,
3.6,
1.5,
1.7,
2.7,
1.7,
1.7
],
"horisont_grader": [
1.3,
0,
1.8,
1.7,
1.6,
0.6,
1.5,
2.1,
0,
0,
0,
17.7,
12.2,
17,
22.6,
27.1,
35.5,
39.4,
39.4,
42.5,
42.5,
36.1,
36.1,
36.1,
34.6,
32.1,
26,
24.7,
31.9,
28.6,
18.1,
6.3,
0,
0,
0,
1
]
},
"kwh_pr_kwp": 408,
"kwh_pr_kwp_uden_skygge": 419,
"maaned_kwh_pr_kwp": [
4.4,
9.6,
22.9,
44.3,
67.8,
80,
73.7,
52.6,
29.5,
14.4,
5.7,
2.9
],
"paneler": {
"antal": 27,
"retning": "liggende",
"kwp": 11.9,
"kwh_aar": 4845,
"placering": [
[
[
12.5904857,
55.6795495,
14.21
],
[
12.5905112,
55.679543,
14.21
],
[
12.5905062,
55.6795365,
15.02
],
[
12.5904805,
55.679543,
15.02
]
]
]
}
}
],
"anlaeg": {
"lille": {
"paneler": 6,
"kwp": 2.6,
"kwh_aar": 2348,
"maaned_kwh": [
63,
106,
206,
288,
324,
314,
304,
271,
217,
142,
68,
44
],
"fordeling": [
{
"flade": 1,
"paneler": 6
}
],
"oekonomi": {
"pris_kr": 34400,
"egetforbrug_andel": 0.48,
"egetforbrug_kwh": 1138,
"salg_kwh": 1211,
"vaerdi_aar1_kr": 2172,
"tilbagebetaling_aar": 16.5
}
},
"foreslaaet": {
"paneler": 12,
"kwp": 5.3,
"kwh_aar": 4697,
"maaned_kwh": [
126,
213,
412,
577,
648,
629,
609,
543,
434,
284,
136,
87
],
"fordeling": [
{
"flade": 1,
"paneler": 12
}
],
"oekonomi": {
"pris_kr": 56900,
"egetforbrug_andel": 0.34,
"egetforbrug_kwh": 1609,
"salg_kwh": 3088,
"vaerdi_aar1_kr": 3746,
"tilbagebetaling_aar": 15.8
}
},
"maks": {
"paneler": 37,
"kwp": 16.3,
"kwh_aar": 14482,
"maaned_kwh": [
388,
655,
1271,
1779,
1998,
1939,
1877,
1673,
1339,
876,
419,
269
],
"fordeling": [
{
"flade": 1,
"paneler": 37
}
],
"oekonomi": {
"pris_kr": 150400,
"egetforbrug_andel": 0.2,
"egetforbrug_kwh": 2825,
"salg_kwh": 11657,
"vaerdi_aar1_kr": 9632,
"tilbagebetaling_aar": 16.2
}
}
},
"anlaeg_aarsag": null
}
],
"elpris": {
"prisomraade": "DK2",
"fra": "2025-10-05",
"til": "2026-10-05",
"gennemsnit_kr_kwh": 0.78,
"solvaegtet_kr_kwh": 0.51,
"kilde": "Energi Data Service (Energinet), DayAheadPrices — CC BY 4.0"
},
"forudsaetninger": {
"panel": {
"laengde_m": 1.762,
"bredde_m": 1.134,
"effekt_wp": 440,
"kantafstand_m": 0.3,
"mellemrum_m": 0.02
},
"forbrug_kwh": 4500,
"egetforbrug_andel": 0.35,
"egetforbrug_regel": "andel = egetforbrug_andel × kvadratroden af (forbrug_kwh / produktion), højst 0,8",
"pris_fast_kr": 12000,
"pris_kr_pr_kwp": 8500,
"tillaeg_kr_kwh": 0.6,
"moms_andel": 0.25,
"salgsgebyr_kr_kwh": 0.02,
"degradering_pr_aar": 0.005,
"horisont_aar": 30,
"min_kwh_pr_kwp": 650,
"systemtab_pct": 14,
"udhaeng_m": 0.3,
"horisont_afstand_m": 100,
"observator_over_flade_m": 0.3,
"albedo": 0.2,
"noter": [
"Panel: 1,762 × 1,134 m, 440 Wp, 0,3 m fri kant til tagets kanter, skorstene og kviste.",
"Hældning, retning og flader er målt i Danmarks Højdemodel (0,4 m celler) inden for GeoDanmarks omrids — ikke på taget. En flade, højdemodellen ikke kan navngive, får ingen tal.",
"Skygge fra bygninger, træer og terræn op til 100 m væk er målt i overflademodellen, som er fløjet én gang; løvfald om vinteren er ikke med, så vinterskyggen fra løvtræer er sat for højt.",
"Produktion: PVGIS' gennemsnit for årene i databasen, 14 % systemtab, paneler i tagets plan.",
"Pris: 12.000 kr. + 8.500 kr. pr. kWp inkl. moms — et overslag, ikke et tilbud.",
"Eget forbrug: 4.500 kWh om året; ved et anlæg der producerer det samme, bruges 35 % af strømmen i huset.",
"Købt strøm koster spotpris + 0,6 kr./kWh (nettarif, afgifter og handelstillæg) + 25 % moms; solgt strøm giver spotpris − 0,02 kr./kWh.",
"Tilbagebetaling: faste priser, 0,5 % lavere ydelse pr. år, ingen rente, ingen vedligehold.",
"Tagmål: omridset er GeoDanmarks, set fra luften; om det følger tagkanten eller facaden varierer. Tilføjet 0,3 m udhæng ved tagfod og gavle — mål taget, før der bestilles materialer."
]
},
"metode": {
"tagflader": "RANSAC-planer fra /v1/dhm/bygninger; hver 0,4 m-celle i omridset tildeles den definerende flade, der forklarer den inden for 0,35 m",
"skygge": "Horisont målt ved ray-marching i overflademodellen (0,8 m) ud til 100 m fra op til fem punkter på fladen; direkte stråling blokeres time for time i et typisk år, diffus reduceres med den skjulte del af himlen foran fladen",
"instraaling": "PVGIS PVcalc (månedligt gennemsnit, 1 kWp, uden PVGIS-horisont) ganget med månedens skyggefaktor fra PVGIS TMY",
"paneler": "Fladens målte celler i fladens eget plan, formindsket med kantafstanden; rækker fra tagfoden og op, stående og liggende afprøvet",
"elpris": "Day-ahead-priser for prisområdet over de seneste 365 dage, vægtet time for time med adressens typiske solindstråling"
},
"ufuldstaendig": false,
"kilder": [
{
"navn": "Danmarks Højdemodel (Klimadatastyrelsen) via Dataforsyningen",
"brug": "Tagflader, hældning, retning og horisont",
"vilkaar": "Frie data"
},
{
"navn": "GeoDanmark",
"brug": "Bygningernes omrids",
"vilkaar": "CC BY 4.0 — @geodanmark"
},
{
"navn": "PVGIS (EU Joint Research Centre)",
"brug": "Indstråling og ydelse pr. kWp",
"vilkaar": "PVGIS © European Union, 2001-2026 (EU Joint Research Centre) — genbrug tilladt med kildeangivelse"
},
{
"navn": "Energi Data Service (Energinet)",
"brug": "Day-ahead-elpriser",
"vilkaar": "CC BY 4.0"
},
{
"navn": "BBR",
"brug": "Anvendelse, opførelsesår og tagdækning",
"vilkaar": "Frie data"
}
],
"attribution": "@geodanmark",
"meta": {
"kilde": "Dataforsyningen DHM + GeoDanmark + PVGIS + Energi Data Service via Grundfast",
"grundfast_version": "0.1.0"
}
}Forkortet: lange lister og geometrier er skåret ned — de viste værdier er uændrede.
Parametre
bfeintegerstipåkrævet- BFE-nummeret på ejendommen.Eksempel:
6033800 bygningstringqueryvalgfri- Kun denne bygning (BBR-UUID). Uden: alle bygninger, de fire største tage beregnet.
forbrug_kwhintegerqueryvalgfri- Husstandens årsforbrug, som det foreslåede anlæg dimensioneres efter. Standard 4500.Eksempel:
5500 egetforbrug_andelnumberqueryvalgfri- Andel af produktionen, der bruges i huset, når anlægget producerer præcis forbruget. Standard 0,35.
pris_kr_pr_kwpintegerqueryvalgfri- Installeret pris pr. kWp inkl. moms. Standard 8.500 kr.
pris_fast_krintegerqueryvalgfri- Fast del af prisen (inverter, stillads, tilslutning) inkl. moms. Standard 12.000 kr.
tillaeg_kr_kwhnumberqueryvalgfri- Hvad en købt kWh koster oven i spotprisen, ekskl. moms (nettarif, afgifter, handelstillæg). Standard 0,60 kr.
Felter i svaret
bygninger[].flader[]object[]- Én pr. målt tagflade:
haeldning_grader,aspekt_grader/retning,areal_m2(sandt) ogareal_vandret_m2,tagfod_m,top_m,spaer_m,skygge,kwh_pr_kwp(med skygge) ogkwh_pr_kwp_uden_skygge(PVGIS’ eget tal),maaned_kwh_pr_kwpogpaneler. bygninger[].flader[].skyggeobjectaar_pctogmaaned_pct: andel af indstrålingen, den målte horisont tager.horisont_grader: 36 vinkler (10° ad gangen fra nord med uret) til den højeste forhindring set fra fladens midte.bygninger[].flader[].paneler.placeringnumber[][][]- Hvert panels fire hjørner som
[lon, lat, h];her meter over bygningensterraen_m— klar til at tegne i et kort eller en 3D-model. bygninger[].tagmaalobject | null- Til tækkemanden:
tagfod_m(samlet),rygning_m(nullpå fladt og ensidigt tag),spaer_m,tagflade_m2ogtagflade_inkl_udhaeng_m2med det antagne udhæng ved tagfod og gavle. bygninger[].anlaegobject | nulllille,foreslaaetogmaks:paneler,kwp,kwh_aar,maaned_kwh,fordelingpr. flade ogoekonomi(pris, egetforbrug, værdi år 1,tilbagebetaling_aar).nullmedanlaeg_aarsag, når ingen flade egner sig.bygninger[].aarsagstring | null- Hvorfor en bygning ikke er beregnet:
tag_ikke_maalt(setag_aarsag),for_lille,uden_for_budget(spørg medbygning=),horisont_utilgaengeligellerinstraaling_utilgaengelig. elprisobject | null- Prisområde, periode, gennemsnitlig og solvægtet day-ahead-pris i kr./kWh.
null, når priserne ikke kunne hentes — så eroekonomiogsånull, mens produktionen står. forudsaetningerobject- Hver antagelse tallene hviler på — panel, kantafstand, forbrug, priser, egetforbrugsreglen, degradering, udhæng, horisontafstand — og
noteri klar tekst til at vise ved siden af tallene. kilderobject[]- Kilderne med vilkår. PVGIS må genbruges med kildeangivelse; GeoDanmark kræver
@geodanmark, hvor omridsene vises.
Statuskoder
| Status | Betydning |
|---|---|
| 200 | Svaret er leveret. |
| 400 | BFE-nummeret er ikke et positivt heltal, eller en antagelse ligger uden for sit interval. |
| 401 | Nøglen mangler eller er ugyldig. |
| 404 | BFE-nummeret findes ikke, eller bygning er ikke en bygning på ejendommen. |
| 429 | Burst-grænsen eller månedskvoten er nået. Se Retry-After. |
| 502 | Højdemodellen kunne ikke nås for nogen af bygningerne. En delvis fejl er en 200 med beregnet: false og en aarsag på de berørte bygninger. |
| 503 | DHM-, GeoDanmark- eller PVGIS-kilden er ikke konfigureret i dette miljø. |
Alle fejl har samme form. Byg logikken på type (fejlklassen) og vis message (dansk tekst med årsagen) til brugeren; hint kommer med, når vi kan se, hvad der skal rettes, og request_id er det, support skal bruge. Se Fejl og statuskoder for hver type, og hvad der kan prøves igen.
{
"error": "property not found",
"type": "not_found",
"code": "not_found",
"message": "Ressourcen findes ikke.",
"request_id": "6cbfa45a-a9ea-4140-9d42-ea752a70ff1f",
"doc_url": "https://grundfast.dk/docs/fejl#not_found"
}Prøv det
Live-kald fra siden
Bruges ofte sammen med
- GETTag og sol som PDF
/v1/dhm /tag /:bfe /sol /rapport.pdf - GETHent bygningshøjder
/v1/dhm /bygninger /:bfe - GETLokalplanens ord med sidetal
/v1/plan /ejendom /:bfe /citater
Læs mere om DHM, og hvad data kan bruges til, på produktsiden.