Filformat til jobs

4 min læsning

Her står præcis, hvordan filen til et job skal se ud. Reglerne er de samme, uanset om du uploader i dashboardet eller sender filen til POST /v1/jobs. Under Nyt job i dashboardet kan du også klikke Se filformat og hente en eksempelfil for hver type.

Jobbet læser hele filen, før det starter. Er bare én række ugyldig, oprettes jobbet ikke, og du får linjenummeret at vide — se input_ugyldigt.

Fælles regler

Regel	Sådan
Formater	CSV, TSV (tabulator), NDJSON (én JSON-værdi pr. linje) og — kun via API'et — JSON
Overskrift	Første linje i en CSV/TSV-fil skal være kolonnernes navne. Store og små bogstaver er ligegyldige
Skilletegn	Komma eller semikolon findes automatisk ud fra overskriften. Tabulator: gem filen som `.tsv`
Tegnsæt	UTF-8, med eller uden BOM. Gem fra Excel som «CSV UTF-8», så æ, ø og å kommer rigtigt med
Decimaltegn	Punktum eller komma (`55.6761` eller `55,6761`). Bruger du komma, så brug semikolon som skilletegn
Citationstegn	Felter med skilletegnet i skal stå i `"…"` (som Excel gør det)
Andre kolonner	Ignoreres og kommer ikke med i resultatet — match rækkerne via `idx`
Tomme linjer	Springes over

Husk overskriften. Uden en overskrift bliver første datarække enten læst som overskrift (og mangler i resultatet), eller filen afvises, fordi en påkrævet kolonne mangler.

Rækkenumre: idx i resultatet er rækkens plads blandt datarækkerne, startende fra 0 (0 = første række under overskriften). Fejlbeskeder ved oprettelsen bruger linjenumre i filen, hvor overskriften er linje 1.

`reverse`

Reverse geocoding: koordinater → de nærmeste adresser.

Kolonne	Også	Påkrævet	Værdi
`lat`	`latitude`, `y`	ja	Breddegrad (WGS84), 54–58
`lon`	`lng`, `longitude`, `x`	ja	Længdegrad (WGS84), 7–16
`radius`	–	nej	Søgeradius i meter, hele tal 1–5000. Standard 100
`limit`	–	nej	Højst så mange adresser pr. punkt, 1–50. Standard 5

CSV

lat,lon,radius
55.6761,12.5683,50
56.1503,10.2039,
55.3959,10.3883,
57.0488,9.9217,250

Samme som NDJSON:

JSON

{"lat":55.6761,"lon":12.5683,"radius":50}
{"lat":56.1503,"lon":10.2039}

`datavask`

Datavask: adresser som tekst → den rigtige adresse, også med stavefejl. Vælg varianten enhedsadresser (adresser, med etage og dør) eller adgangsadresser (adgangsadresser, kun husnummer).

Kolonne	Også	Påkrævet	Værdi
`betegnelse`	`adresse`, `address`, `adressebetegnelse`	ja	Adressen som tekst, 3–2000 tegn, med vejnavn, husnummer og postnummer

Stavefejl i vejnavn og by er fine — datavasken retter dem. Men uden et firecifret postnummer kan rækken ikke tolkes (se ikke_tolket).

Én kolonne: Har filen kun én kolonne (ingen komma, semikolon eller tabulator i overskriften), er hver linje under overskriften én adresse — kommaer i adressen behøver ingen citationstegn. Kolonnen må hedde hvad som helst.

CSV

adresse
Vesterbrogade 12, 3. th, 1620 København V
Nørrebrogade 20, 2. tv, 2200 København N
Vestergde 2, 8000 Århus C
Rådhuspladsen 1, 1550 København V

Flere kolonner: Kolonnen adresse (eller et af navnene ovenfor) bruges, resten ignoreres:

CSV

kundenr;adresse
1001;Rådhuspladsen 1, 1550 København V
1002;Banegårdspladsen 1, 8000 Aarhus C

NDJSON: én adresse pr. linje som JSON-tekst — eller som objekt med betegnelse:

JSON

"Rådhuspladsen 1, 1550 København V"
{"betegnelse":"Boulevarden 13, 9000 Aalborg"}

`bbr`

BBR-opslag ud fra BBR-objektets id (id_lokalid, et UUID). Vælg varianten bygninger eller enheder — id'erne skal passe til varianten.

Kolonne	Også	Påkrævet	Værdi
`id`	`id_lokalid`, `bygning_id`, `enhed_id`, `uuid`	ja	BBR-id (UUID)

Har filen kun én kolonne, bruges den, uanset hvad den hedder.

CSV

sagsnr,bygning_id
S-2041,57a791c4-25b0-4e57-8143-aa5b08efec51
S-2042,6c16b07d-acb1-414e-9d24-443340fe382e

NDJSON:

JSON

"e71e2419-fca7-4b73-b178-9cafaa1995fd"
{"id":"ffed9944-62a8-4385-8495-9f1467ef9d7c"}

`dagi`

DAGI-opslag: koordinater eller postnumre → kommune, region, sogn, politikreds, retskreds, opstillingskreds m.m.

Kolonne	Også	Påkrævet	Værdi
`lat`	`latitude`, `y`	`lat` + `lon` eller `postnr`	Breddegrad (WGS84), 54–58
`lon`	`lng`, `longitude`, `x`	`lat` + `lon` eller `postnr`	Længdegrad (WGS84), 7–16
`postnr`	`postnummer`	`lat` + `lon` eller `postnr`	Firecifret postnummer

Hver række skal have lat og lon eller postnr — begge slags rækker kan stå i samme fil. Dansk Excel med semikolon og decimalkomma virker:

CSV

lat;lon
55,6761;12,5683
56,1503;10,2039

CSV

postnr
8000
2100
800

I CSV lægges et manglende foranstillet nul til (800 læses som 0800, som Excel ofte viser det). I NDJSON og JSON skal postnr være tekst med fire cifre:

JSON

{"lat":55.6761,"lon":12.5683}
{"postnr":"0800"}

JSON (kun via API'et)

Via API'et kan du også sende elementerne direkte i en JSON-body — samme elementer som NDJSON-linjerne ovenfor:

JSON

{
  "type": "datavask",
  "variant": "adresser",
  "navn": "kunder-oktober",
  "input": [
    "Vesterbrogade 12, 3. th, 1620 København V",
    "Nørrebrogade 20, 2. tv, 2200 København N"
  ]
}

Se Jobs via API for alle måder at sende filen på.

Eksport fra Find ejendomme

En eksport har ingen fil — den bruger filtrene fra din søgning i Find ejendomme. Klik Eksportér CSV eller JSONL på fanen Eksportér. Kolonnerne er de samme som i ejendomssøgningen.

Var dette nyttigt?