Siden beskriver fildownload, der udstilles på Datafordeleren fra Danmarks Adresseregister (DAR).
Få en introduktion til Fildownload på Datafordeleren, hvis du har brug for en generel og mere teknisk indføring i fildownloads på Datafordeleren.
Ønsker du at opsætte et kopiregister kan du med fordel benytte Kopiregisterguide (fildownload).
Du kan finde eksempler på, hvad der sker med DAR data i fildownload, når der sker ændringer i adresser på siden Grunddata – eksempler på anvendelse af bitemporalitet.
Under kodelister på Danmarksadresser.dk, kan du finde de værdier forretningsproces, forretningsområde og forretningshændelse kan tage.
Sideinformation
Generelt for DAR fildownload
| Formater | JSON |
|---|---|
| Nyeste version af fildownload | 1 |
| Sikkerhedszone | 0 – Indeholder ikke fortrolige eller følsomme data |
| Tværgående | Nej |
| 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 | DAR udstiller alle deres entiteter i alle fildownloadstyper. Registret har følgende entiteter:
Se felter for entiteterne i registrets bilag for opdatering (.XSD) |
Adresse | Download entiteten, hvis du har behov for en kopi af alle adresse-objekter. Entiteten indeholder bl.a adressebetegnelse, dørbetegnelse, etagebetegnelse og relation til husnummerobjektet. |
|---|---|
Adressepunkt | Download entiteten, hvis du har behov for en kopi af placeringen af adgangspunkter og vejpunkter for alle husnumre-objekter. Hvis du downloader Adressepunkt bør du også downloade Husnummer for at kunne koble adgangspunkter med attributterne i dette objekt. Adressepunkt indeholder ud over den fysiske placering også adressepunkternes tekniske standard, der indeholder oplysningerne om, hvordan adressepunkterne er placeret og dermed information om kvaliteten af adressepunkterne. Læs mere på https://danmarksadresser.dk/adressedata/kodelister/teknisk-standard |
Husnummer | Download entiteten, hvis du har behov for en kopi af alle husnumre-objekter. Entiteten indeholder bl.a adgangsadressebetegnelse, husnummertekst, husnummerretning, relation til BBR-bygninger og -tekniske anlæg, relation til Navngivenvej og Vejmidte, relation til kommuneinddeling, sogneinddeling, supplerende bynavn og afstemningsområde. |
NavngivenVej | Download entiteten, hvis du har behov for en kopi af alle vejnavne og vejnavnenes fysiske udstrækning. Entiteten indeholder bl.a vejnavnet, koordinaterne for vejnavnelinje eller vejnavneområde samt vejtilslutningspunkt |
NavngivenVejKommunedel | NavngivenvejKommunedel er relationen mellem Navngivenvej og Kommune. En NavngivenVej kan være beliggende i en eller flere kommuner. Download entiteten, hvis du har behov for en kopi af i, hvilke kommuner alle Navngivenvej findes i eller, hvis du har brug for at koble Navngivenvej med Vejmidter fra GeoDanmarkVektor vha Kommunekode-vejkode. |
NavngivenVejPostnummer | NavngivenvejPostnummer er relationen mellem Navngivenvej og Postnummer. En NavngivenVej kan være beliggende i et eller flere postnumre. Download entiteten, hvis du har behov for en kopi af i, hvilke postnumre alle Navngivenvej findes i. |
NavngivenVejSupplerendeBynavn | NavngivenVejSupplerendeBynavn er relationen mellem Navngivenvej og SupplerendeBynavn. En NavngivenVej kan være beliggende i nul, et eller flere supplerende bynavne. Download entiteten hvis du har behov for en kopi af i, hvilke supplerende bynavne alle Navngivenvej findes i. |
Postnummer | Download entiteten, hvis du har behov for en kopi af i, hvilke postnumre alle Navngivenveje findes i. Postnumrenes geografiske afgrænsning registreres i DAGI |
SupplerendeBynavn | Download entiteten, hvis du har behov for at vide i, hvilke postnumre en Navngivenvej findes i. De supplerende bynavnes geografiske afgrænsning registreres i DAGI |
Generelle url'er for DAR
Se tilgængelig fildownloads for DAR:
https://api.datafordeler.dk/FileDownloads/GetAvailableFileDownloads?Register=DAR&username=xxxx&password=yyyy |
Hent tilgængelige totaldownload for alle entiteter i DAR:
https://api.datafordeler.dk/FileDownloads/GetFile?Register=DAR&username=xxxx&password=yyyy |
Totaldownload bitemporal
Beskrivelse
Et totaldownload af et eller alle entiteter fra registret med fuld bitemporalitet. Læs mere om DAR's bitemporalitet.
Generelt
| Tjenestenavn | DAR_TotalDownload_Bitemporal |
|---|---|
| Genereringstid | Natten til lørdag, 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 | Alle |
Eksempler på url'er
Hent senest totaldownload med bitemporalitet for entiteten Adresse:
| https://api.datafordeler.dk/FileDownloads/GetFile?Register=DAR&LatestTotalForEntity=Adresse&type=bitemporal&format=JSON&username=xxxx&password=yyyy |
Hent et specifikt totaldownload med bitemporalitet for entiteten Husnummer:
| https://api.datafordeler.dk/FileDownloads/GetFile?Filename=DAR_V1_Husnummer_TotalDownload_json_Bitemporal_zz.zip&username=xxxx&password=yyyy |
Totaldownload temporal
Beskrivelse
Et totaldownload af et eller alle entiteter fra registret kun med virkningsdimensionen. Læs mere om DAR's bitemporalitet.
Generelt
| Tjenestenavn | DAR_TotalDownload_temporal |
|---|---|
| Genereringstid | Natten til lørdag, 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 | Alle |
Eksempler på url'er
Hent senest totaldownload med temporal for entiteten Adressepunkt:
| https://api.datafordeler.dk/FileDownloads/GetFile?Register=DAR&LatestTotalForEntity=Adressepunkt&type=temporal&format=JSON&username=xxxx&password=yyyy |
Hent et specifikt totaldownload med temporal for entiteten Husnummer:
| https://api.datafordeler.dk/FileDownloads/GetFile?Filename=DAR_V1_Husnummer_TotalDownload_json_temporal_zz.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 DAR's bitemporalitet.
Generelt
| Tjenestenavn | DAR_TotalDownload_current |
|---|---|
| Genereringstid | Natten til lørdag, 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 | Alle |
Eksempler på url'er
Hent senest aktuelle totaldownload for entiteten NavngivenVejPostnummer:
| https://api.datafordeler.dk/FileDownloads/GetFile?Register=DAR&LatestTotalForEntity=NavngivenVejPostnummer&type=current&format=JSON&username=xxxx&password=yyyy |
Hent et specifikt aktuelt totaldownload for entiteten Husnummer:
| https://api.datafordeler.dk/FileDownloads/GetFile?Filename=DAR_V1_Husnummer_TotalDownload_json_current_zz.zip&username=xxxx&password=yyyy |
Deltadownload
Beskrivelse
Et deltadownload af et eller alle entiteter fra registret med bitemporalitet. Læs mere om DAR's bitemporalitet.
Deltadownload kan kun hentes ved bruge af parameteren Filename i metoden GetFile.
Bemærkninger
Hvis en kopi af DAR vedligeholdes vha. DeltaDownload, skal udgangspunktet være TotalDownload temporal eller TotalDownload bitemporal, da DAR data kan indeholde objekter med fremtidig virkning, som ikke vil være inkluderet, hvis man starter med TotalDownload current.
Generelt
| Tjenestenavn | DAR_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 | Alle |
Eksempel på url
Hent et specifikt deltadownload for entiteten Adressepunkt:
| https://api.datafordeler.dk/FileDownloads/GetFile?Filename=DAR_V1_Adressepunkt_DeltaDownload_json_Bitemporal_zz.zip&username=xxxx&password=yyyy |