Siden beskriver fildownload, der udstilles på Datafordeleren fra Matriklen2 (MAT2).

Få en introduktion til Fildownload på Datafordeleren, hvis du har brug for en generel og mere teknisk indføring i fildownload på Datafordeleren.

Ønsker du at opsætte et kopiregister, kan du med fordel benytte Kopiregisterguide (fildownload).

Ønsker du yderligere informationer om Matriklens tjenester kan du med fordel benytte Geodatastyrelsens dokumentation om Matriklen2 på https://gst.dk/ansvarsomraader/matrikel-og-ejendomsregistrering eller om unøjagtigheder i Matrikelkort.


Sideinformation





Generelt for MAT2 fildownload


Formater

JSON, CSV, GPKG, GML

Entiteterne Ejerlejlighed, Jordstykke, Jordstykke_sekundaerForretning, JordstykkeTemaflade, MatrikelRegion, MatrikulaerSag_sagsoperation, SamletFastEjendom_sekundaerFor og SAMLETFASTEJENDOM_X_JORDSTYKKE findes ikke i GML, da de ikke indeholder geometri

Bitemporal filtrering

Current, Temporal og Bitemporal

Total-versionerne af entiteterne Jordstykke_sekundaerForretning, MatrikulaerSag_sagsoperation, SamletFastEjendom_sekundaerFor og SAMLETFASTEJENDOM_X_JORDSTYKKE i GPKG og JSON findes kun som bitemporal

Nyeste version af fildownload2
Sikkerhedszone

0 – Indeholder ikke fortrolige eller følsomme data

TværgåendeNej
Dato- og tidsformat

Datoformat følger ISO 8601 Date and time format.

Alle datoer skrives med andre ord i formatet yyyy-mm-ddTHH:MM:SS.ssssss, hvor tidsangivelsen kan udelades.

UTC kan angives enten ved +HH:MM (2019-07-05T07:50:14.687580+01:00) eller ved at benytte Z (2019-07-05T07:50:14.687580Z)

Udstillede entiteter

Matriklen2 udstiller ikke alle deres entiteter. 

Registret udstiller følgende entiteter:

  • BygningPaaFremmedGrundFlade
  • BygningPaaFremmedGrundPunkt
  • Centroide
  • Ejerlav
  • Ejerlejlighed
  • Ejerlejlighedslod
  • Jordstykke
  • Jordstykke_sekundaerForretning
  • JordstykkeTemaflade
  • Lodflade
  • MatrikelKommune
  • MatrikelRegion
  • Matrikelskel
  • MatrikelSogn
  • MatrikulaerSag
  • MatrikulaerSag_sagsoperation
  • Nullinje
  • OptagetVej
  • SamletFastEjendom
  • SamletFastEjendom_sekundaerFor
  • SAMLETFASTEJENDOM_X_JORDSTYKKE
  • Skelpunkt
  • Temalinje

Se felter for entiteterne i registrets bilag for opdatering (.XSD)

Læs mere om registrets entiteter i objekttypekataloget




Særligt for MAT2's entiteter

Vær opmærksom på at GPKG-formatet understøttes på entiteter uden geometri for at gøre dem tilgængelige i et format, der nemt kan importeres i en database og bruges til at sammenkæde med andre entiteter og datasæt.

Eksempelvis:

For at finde geometri til jordstykke-tabellen, skal der joines med lodflade-tabellen, der har en relation til jordstykke-tabellen (via jordstykkelokalid). I den forbindelse skal man være opmærksom på at de entitetsbaserede udtræk indeholder objekter med status Foreløbig, Historisk og Ikke Gennemført. Disse statuskoder kan filtreres fra, så du nøjes med at joine objekter med status=Gældende.

Hvis du ønsker geometri for foreløbige objekter skal man tage højde for følgende:
Hvis både jordstykke og lodflade findes i status Foreløbig i samme sag (senestesaglokalid), er det disse der skal joines. Men der kan også være foreløbige jordstykker uden at der samtidigt en foreløbig lodflade - (og omvendt)- i så fald skal der joines med den gældende.

Hvis man ønsker at lave et join af de temporale udtræk, skal du udover jordstykkelokalid, også tage højde for virkningfra og virkningtil på de to tabeller.




Generelle url'er for MAT2


Se tilgængelig fildownload for MAT2:

https://api.datafordeler.dk/FileDownloads/GetAvailableFileDownloads?Register=MAT&username=xxxx&password=yyyy


Hent tilgængelige totaldownload for alle entiteter i MAT2:

https://api.datafordeler.dk/FileDownloads/GetFile?Register=MAT&username=xxxx&password=yyyy

BEMÆRK

Forkortelsen for Matriklen2 i fildownload er "MAT", da den tidligere version af Matriklen er udfaset.






Totaldownload bitemporal

Beskrivelse

Et totaldownload af et eller alle entiteter fra registret med fuld bitemporalitet. Læs mere om MAT2's bitemporalitet.

Generelt

Navn i Dataoversigten

MAT2_TotalDownload_Bitemporal

Genereringstid

Natten til søndag, mellem klokken 3 og 6

Arkiveringstid

7 dage

Type

Totaldownload

Adgangsniveau

Kendt bruger – der skal oprettes en webbruger og tjenestebruger med brugernavn og adgangskode.

Udstillede entiteter

Ikke alle, som nævnt i Generelt om MAT2 fildownload

Eksempler på url'er

Hent senest totaldownload med bitemporalitet for entiteten Ejerlejlighed i JSON-format:

https://api.datafordeler.dk/FileDownloads/GetFile?Register=MAT&LatestTotalForEntity=Ejerlejlighed&type=bitemporal&format=JSON&username=xxxx&password=yyyy

Hent et specifikt totaldownload med bitemporalitet for entiteten Matrikelskel i GPKG-format: (Vær opmærksom på at erstatte "zzzz" med et gældende udtræksnummer)

https://api.datafordeler.dk/FileDownloads/GetFile?Filename=MAT_V1_Matrikelskel_TotalDownload_gpkg_Bitemporal_zzzz.zip&username=xxxx&password=yyyy






Totaldownload temporal

Beskrivelse

Et totaldownload af et eller alle entiteter fra registret kun med virkningsdimensionen. Læs mere om MAT2's bitemporalitet.

Generelt

Navn i Dataoversigten

MAT2_TotalDownload_temporal

Genereringstid

Natten til søndag, mellem klokken 3 og 6

Arkiveringstid

7 dage

Type

Totaldownload

Adgangsniveau

Kendt bruger – der skal oprettes en webbruger og tjenestebruger med brugernavn og adgangskode.

Udstillede entiteter

Ikke alle, som nævnt i Generelt om MAT2 fildownload

Eksempler på url'er

Hent seneste totaldownload med temporal for entiteten SamletFastEjendom i GPKG-format:

https://api.datafordeler.dk/FileDownloads/GetFile?Register=MAT&LatestTotalForEntity=SamletFastEjendom&type=temporal&format=gpkg&username=xxxx&password=yyyy

Hent et specifikt totaldownload med temporal for entiteten Lodflade i GML-format: (Vær opmærksom på at erstatte "zzzz" med et gældende udtræksnummer)

https://api.datafordeler.dk/FileDownloads/GetFile?Filename=MAT_V1_Lodflade_TotalDownload_gml_temporal_zzzz.zip&username=xxxx&password=yyyy






Totaldownload aktuel

Beskrivelse

Et totaldownload af et eller alle entiteter fra registret kun med aktuelle data. Læs mere om MAT2's bitemporalitet.

Generelt

Navn i Dataoversigten

MAT2_TotalDownload_current

Genereringstid

Natten til søndag, mellem klokken 3 og 6

Arkiveringstid

7 dage

Type

Totaldownload

Adgangsniveau

Kendt bruger – der skal oprettes en webbruger og tjenestebruger med brugernavn og adgangskode.

Udstillede entiteter

Ikke alle, som nævnt i Generelt om MAT2 fildownload

Eksempler på url'er

Hent seneste aktuelle totaldownload for entiteten BygningPaaFremmedGrundPunkt  i JSON-format:

https://api.datafordeler.dk/FileDownloads/GetFile?Register=MAT&LatestTotalForEntity=BygningPaaFremmedGrundPunkt&type=current&format=JSON&username=xxxx&password=yyyy

Hent et specifikt aktuelt totaldownload for entiteten MatrikelKommune i GML-format: (Vær opmærksom på at erstatte "zzzz" med et gældende udtræksnummer)

https://api.datafordeler.dk/FileDownloads/GetFile?Filename=MAT_V1_MatrikelKommune_TotalDownload_gml_current_zzzz.zip&username=xxxx&password=yyyy






Deltadownload

Beskrivelse

Et deltadownload af et eller alle entiteter fra registret med bitemporalitet. Læs mere om MAT2's bitemporalitet.

Deltadownload kan kun hentes ved bruge af parameteren Filename i metoden GetFile.

Hvis du vedligeholder en kopi af registret ved hjælp af deltadownload, anbefales det at udgangspunktet er et totaldownload bitemporal. 

Generelt

Navn i Dataoversigten

MAT2_DeltaDownload_Bitemporal

Genereringstid

Dagligt mellem klokken 3 og 6

Arkiveringstid

14 dage

Type

Deltadownload

Adgangsniveau

Kendt bruger – der skal oprettes en webbruger og tjenestebruger med brugernavn og adgangskode.

Udstillede entiteter

Ikke alle, som nævnt i Generelt om MAT2 fildownload

Eksempel på url

Hent et specifikt deltadownload for entiteten Ejerlav i GPKG-format: (Vær opmærksom på at erstatte "zzzz" med et gældende udtræksnummer)

https://api.datafordeler.dk/FileDownloads/GetFile?Filename=MAT_V1_Ejerlav_DeltaDownload_gpkg_Bitemporal_zzzz.zip&username=xxxx&password=yyyy