MAT2: Matriklen2
Matriklen2 v1 og v2 videreføres med alle offentlige legacy-metoder, selector-varianter og tidsopslag i det oprindelige REST-format.
Drop-in kontrakt
§01Behold Datafordelerens path, metode, query-parametre og Format. v1 og v2 holdes adskilt, og svarene bevarer legacy FeatureCollection, feltnavne, datatyper, null-værdier og XML-struktur.
Coverage
83 live-cases gennem GraphQL og historisk WFS
Datafordeler paths
§02| Service | Version | Type | Base path | Metoder |
|---|---|---|---|---|
| Matrikel | 1.0.0 | REST | /Matriklen2/Matrikel/1.0.0/rest | SamletFastEjendom, BygningPaaFremmedGrund, Ejerlejlighed, BestemtFastEjendom, MatrikelKommune |
| Matrikel | 2.0.0 | REST | /Matriklen2/Matrikel/2.0.0/rest | SamletFastEjendom, BygningPaaFremmedGrund, Ejerlejlighed, BestemtFastEjendom, MatrikelKommune, MatrikulaerSag |
Metoder og parametre
§03| Metode | Selectorer | Valgfrie parametre |
|---|---|---|
SamletFastEjendom | SFEBFEnr · Ejerlavkode + Matrikelnr · Point · JordstykkeId · SagsId | Registreringstid · Virkningstid · Status |
BygningPaaFremmedGrund | SFEBFEnr · BPFGBFEnr · Ejerlavkode + Matrikelnr · Point · SagsId | Registreringstid · Virkningstid · Status |
Ejerlejlighed | SFEBFEnr · BPFGBFEnr · ELBFEnr · Ejerlavkode + Matrikelnr (+ Ejerlejlighednr) · SagsId | Registreringstid · Virkningstid · Status |
BestemtFastEjendom | BFEnr (kan gentages) · SagsId · Ejendomstype | Registreringstid · Virkningstid · Status |
MatrikelKommune | Kommunekode · Kommunenavn | Registreringstid · Virkningstid · Status · RegistreringstidFra/Til · VirkningstidFra/Til |
MatrikulaerSagKun i v2.0.0. | SagsId · Journalnr · Sagskategori + Kommunenavn · Sagsoperation + RekvirentRef | Registreringstid · Virkningstid · Status · RegistreringstidFra/Til · VirkningstidFra/Til |
Eksempel
§04GETJSON og XML
/Matriklen2/Matrikel/2.0.0/rest/MatrikulaerSag?Format=XML&SagsId=9022778
Authentication
Send API key i x-api-key, som Bearer token, i apiKey-query eller som password i den eksisterende legacy credential-struktur.
Attribution
Matriklen, Datafordeleren og Klimadatastyrelsen krediteres.
x-restdanmark-attribution
Kendte begrænsninger
§05- Point skal sendes som gyldig WKT: POINT(x y). Mellemrummet URL-encodes som %20; Datafordeleren accepterer ikke den dokumenterede kortform (x y).
- Periodeparametrene Fra/Til er kun en del af legacy-kontrakten for MatrikelKommune og MatrikulaerSag. De genskabes fra Datafordelerens moderne historiske MAT WFS-lag og er live-verificeret mod legacy REST i både JSON og XML.
- Rækkefølgen i den indlejrede ejerlejlighed-relation er ikke defineret af Datafordeleren; indhold, antal og øvrig struktur er kompatibel.
Tilbage til overblik