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 på /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.
