DanskAdresseAPIv1
Kom i gang

Om v1

Hvad v1 er, hvad den endnu ikke kan — og hvad den skal blive.

/v1 er i beta, og den har ikke hele DAWA's datasæt.

Skal du bruge adressedata i produktion i dag, så brug [/dawa](?fane=dawa&v=v1&side=introduktion) — den er 1:1 med det officielle DAWA og fuldt dækket.

Hvad v1 er

/v1 er vores egen flade oven på de samme data som /dawa. Den er skrevet forfra med struktureret JSON, ét ensartet fejlformat, ETag-caching og berigelser, DAWA aldrig har haft.

/dawa er og bliver en tro kopi af det officielle DAWA. /v1 er dét, vi mener en moderne udgave af den samme datamodel bør se ud som.

Hvad v1 endnu IKKE dækker

MÅLT mod /dawa: /v1 dækker 27 stiområder, /dawa 35. Disse findes i dag kun/dawa:

  • DAGI-områder — regioner, kommuner, sogne, politikredse, retskredse, opstillingskredse, storkredse, valglandsdele, landsdele og afstemningsområder
  • Stednavne og steder
  • Bygninger, BBR light og OIS
  • Historik på adresser og adgangsadresser
  • Vejnavn/postnummer-relationer

Har du brug for noget af det, er /dawa svaret — ikke fordi /v1 er ringere, men fordi den endnu ikke er nået dertil.

Hvad v1 kan, som /dawa ikke kan

Omvendt har /v1 fjorten områder, det officielle DAWA aldrig har haft:

  • Jordforurening (V1/V2-kortlægning), trafikstøj og luftkvalitet
  • Tvangsauktioner fra Statstidende
  • Offentlige vurderinger og bygningsfredninger
  • Validering af en adresse skrevet i fri tekst
  • Reverse geocoding med kombineret berigelse i ét kald

Hvad v1 skal blive

Målet er, at /v1 en dag dækker alt det, /dawa gør — men med den form, vi ville have valgt, hvis vi byggede DAWA i dag: ensartede svar, forudsigelige fejl, ét kald hvor DAWA kræver tre, og berigelser der ellers skal hentes fem forskellige steder.

Indtil da er anbefalingen enkel:

Bygger du noget, der skal virke nu? Brug /dawa.

Vil du være med til at forme /v1? Brug den — og skriv til os når noget mangler.