Spring til indhold

Grundfast

Lokalplanens ord med sidetal

De afsnit i lokalplanens PDF, der handler om solceller, tag, højde, bebyggelsesprocent eller farver — ordret og med sidetal.

GET/v1/plan/ejendom/{bfe}/citater

For hver lokalplan og hvert delområde med egen PDF, der dækker ejendommen, henter vi planens PDF fra Plandata.dk, læser teksten side for side og samler de afsnit, der handler om de emner, du beder om. Afsnittene gengives ordret — kun linjeskift og orddeling er samlet — med side (siden i PDF-filen), den nærmeste paragraf over (afsnit, fx § 7.10) og et link, der åbner PDF’en på siden.

En scannet plan har intet tekstlag og kan ikke gennemsøges. Så er tekstlag "nej" og der er ingen citater — det betyder ikke, at planen intet siger. Er kun nogle sider scannet (kortbilag), er tekstlag "delvis", og sider_uden_tekst siger hvilke.

Svaret gemmes pr. PDF (SHA-256), så samme plan læses én gang for alle ejendomme i den.

Citaterne peger på, hvor i planen der skal læses — de er ikke en fortolkning. En bestemmelse kan være uddybet i redegørelsen eller på et kortbilag. Spørg kommunen ved tvivl.

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å når ejendommen ligger i flere lokalplaner.

Eksempel

curl "https://api.grundfast.dk/v1/plan/ejendom/9519007/citater?emner=solceller,tagform" \
  -H "Authorization: Bearer $GRUNDFAST_API_KEY"
Svar · eksempel, forkortet200
{
  "bfe_nummer": 9519007,
  "emner": [
    "solceller",
    "tagmateriale",
    "tagform",
    "reflekterende"
  ],
  "antal": 1,
  "planer": [
    {
      "plan_id": 10474743,
      "plannr": "2020-10",
      "navn": "Turist- og begivenhedsdestination, Egeskov Slot",
      "status": "vedtaget",
      "dokument_url": "https://dokument.plandata.dk/20_10474743_1617784575173.pdf",
      "status_laesning": "ok",
      "sha256": "9891694278d45c9a1d14004eb41b4ac841d64204a765b9fb3e84ff72afc98424",
      "sider": 38,
      "tekstlag": "delvis",
      "sider_uden_tekst": [
        1,
        6,
        29,
        32,
        33,
        34,
        35,
        38
      ],
      "citater": [
        {
          "emne": "solceller",
          "side": 24,
          "afsnit": "§ 7.10",
          "tekst": "§ 7.10 Solfangere/solceller på bygningens tage må kun opsættes efter følgende retningslinjer: • de må ikke være reflekterende. • de skal lægges på tagfladen og være parallelle med tagfladen. • de skal placeres, så de udgør ét samlet rektangel. • de skal placeres, så elementer som ovenlysvinduer, udluftningshætter mv. ikke bryder solpanel/solcelle fladen. • de skal placeres på tagflader der ikke vender mod slottet/voldgraven.",
          "traeffere": [
            "Solfangere",
            "solceller",
            "solpanel",
            "solcelle"
          ],
          "link": "https://dokument.plandata.dk/20_10474743_1617784575173.pdf#page=24"
        },
        {
          "emne": "tagmateriale",
          "side": 23,
          "afsnit": "§ 7.5",
          "tekst": "§ 7.5 Tagbeklædningen må ikke udføres i reflekterende materialer med et glanstal på over 5. Drivhuse/orangerier/ udstillingsbygninger med glastag er undtaget bestemmelsen om glanstal.",
          "traeffere": [
            "Tagbeklædningen"
          ],
          "link": "https://dokument.plandata.dk/20_10474743_1617784575173.pdf#page=23"
        },
        {
          "emne": "tagform",
          "side": 22,
          "afsnit": "Ad. § 6.5",
          "tekst": "… Der gives mulighed for op til 16 m i højden i byggefelt 3A, fordi der her kan etableres lagerfaciliteter, udstillingshaller mv. som er store bygningskroppe, som med sadeltag bliver høje. Det er sammen med de øvrige store bygningskroppe, så disse ikke spredes unødigt. Tagene i byggefelterne 4A og 5A må ikke gives en højde der overstiger tagryggen på de omkransende bygninger. Tagenes tagfod skal være under tagfod på de omkransende bygninger. jf. § 6.4. Bestemmelsen skal sikre at byggeri i disse byggefelter underordner sig de øvrige bygninger i miljøet og fremstår med lethed og transparens i forh …",
          "traeffere": [
            "sadeltag"
          ],
          "link": "https://dokument.plandata.dk/20_10474743_1617784575173.pdf#page=22"
        },
        {
          "emne": "reflekterende",
          "side": 23,
          "afsnit": "§ 7.5",
          "tekst": "§ 7.5 Tagbeklædningen må ikke udføres i reflekterende materialer med et glanstal på over 5. Drivhuse/orangerier/ udstillingsbygninger med glastag er undtaget bestemmelsen om glanstal.",
          "traeffere": [
            "reflekterende",
            "glanstal"
          ],
          "link": "https://dokument.plandata.dk/20_10474743_1617784575173.pdf#page=23"
        }
      ]
    }
  ],
  "struktureret": {
    "solceller": [],
    "tagmateriale": [],
    "tagform": [],
    "reflekterende": []
  },
  "forbehold": "Citaterne er fundet automatisk ved ordsøgning i planens tekst og gengivet ordret. De er en læsevejledning, ikke en juridisk gennemgang: en bestemmelse kan være uddybet andre steder i planen eller på kortbilag. Læs planen i sammenhæng, og spørg kommunen ved tvivl.",
  "meta": {
    "kilde": "Plandata.dk (planernes PDF) 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: 9519007
emnerstringqueryvalgfri
Kommasepareret: solceller, tagmateriale, tagform, reflekterende, hoejde, bebyggelsesprocent, farver. Udeladt: alle.Eksempel: solceller,tagform

Felter i svaret

planer[].citater[]object[]
emne, side, afsnit, tekst (ordret; lange afsnit klippes omkring træffet med …), traeffere (de ord, der matchede) og link (dokument_url#page=N). Højst 12 pr. emne pr. plan.
planer[].tekstlag'ja' | 'delvis' | 'nej' | null
Hvor meget af PDF’en der kunne gennemsøges. nej = scannet uden tekst: læs PDF’en selv. null, når PDF’en ikke kunne læses (se status_laesning).
planer[].status_laesningstring
ok, utilgaengelig (Plandata svarede ikke), for_stor (over 40 MB) eller ulaeselig (ikke en læsbar PDF).
planer[].sha256string | null
Fingeraftryk af den PDF, der blev læst — det svaret er gemt under.
struktureretobject
Pr. emne de felter på /v1/plan/ejendom/:bfe, der også svarer på det — bebyggelse.max_hoejde_m for højde, bebyggelse.bebyggelsesprocent for bebyggelsesprocent. Citaterne er planens tekst ved siden af tallene. For tagform, materialer, farver og solceller har registret intet felt ([]), så teksten er eneste kilde.
forbeholdstring
Altid med: citaterne er fundet ved ordsøgning og er en læsevejledning, ikke en juridisk gennemgang. Vis det sammen med citaterne.

Statuskoder

StatusBetydning
200Svaret er leveret.
400BFE-nummeret er ikke et positivt heltal, eller et emne er ukendt.
401Nøglen mangler eller er ugyldig.
404BFE-nummeret findes ikke i Matriklen, eller ejendommen har ingen jordstykkegeometri.
429Burst-grænsen eller månedskvoten er nået. Se Retry-After.
502Plandata kunne ikke nås, svarede ubrugeligt, eller et af lagene var tomt. Rapporteres aldrig som landzone eller "ingen lokalplan".
503Plandata-kilden er ikke konfigureret i dette miljø.

Fejl har altid formen { "error": "…" }. Se Fejl og statuskoder for, hvad der kan prøves igen.

Prøv det

Live-kald fra siden

Kræver din nøgle

Nøglen bliver i denne fane og sendes kun til grundfast.dk. Kaldet tæller som et almindeligt kald — brug en gf_test_-nøgle for at prøve gratis. Opret en gratis nøgle

GET /v1/plan/ejendom/9519007/citater?emner=solceller%2Ctagform

Bruges ofte sammen med

Læs mere om Plandata, og hvad data kan bruges til, på produktsiden.