Spring til indhold

Grundfast

DAWA-alternativ

Et DAWA-alternativ, der også giver dig ejendommen

DAWA gav dig adressen. Grundfast giver dig de samme adresser fra DAR — og ejendommen bag dem: hvert hit har BFE-nummeret og et WGS84-punkt med, så BBR, Matriklen, vurdering og byggelinjer er ét kald væk med samme nøgle.

DAWA lukket 1. okt.

Opret gratis kontoSe dokumentationen

Adressen — og det, der står på den

Et rigtigt søgehit. Det, DAWA også havde, står til venstre; de to nøgler, DAWA ikke gav dig på adressen, står til højre — med de registre, hver af dem åbner.

Ét hit fra /v1/adresse/search

Rådhuspladsen 1, 1550 København V

adgangsadresse_id — samme UUID som i DAWA

0a3f507a-ec01-32b8-e044-0003ba298018

bfe_nummer

6033528

Ejendommen bag adressen — åbner:

koordinat — WGS84

55.6756275, 12.5695777

Punktet på grunden — åbner:

Før og efter i koden

Vil du have mere end en ny base-URL, er det her skiftet til vores eget API: et adresseopslag mod DAWA og mod /v1, skrevet op mod begge rigtige svar. Id’et er det samme, felterne er flade, og BFE-nummeret følger med.

adressefelt.ts5 linjer ændret
// Første forslag til et adressefeltFjernet: const r = await fetch(`${DAWA}/adgangsadresser/autocomplete?q=${q}`);Fjernet: const [hit] = await r.json();Fjernet: const { id, x, y } = hit.adgangsadresse;Fjernet: const tekst = hit.tekst;Tilføjet: const r = await fetch(`${GRUNDFAST}/adresse/search?q=${q}`, { headers });Tilføjet: const { results: [hit] } = await r.json();Tilføjet: const { adgangsadresse_id: id, koordinat: { lon: x, lat: y } } = hit;Tilføjet: const tekst = hit.betegnelse;Tilføjet: const bfe = hit.bfe_nummer; // → BBR, Matriklen, vurdering

Er du i gang med at rette en integration, der er holdt op med at virke, så start med fejlene, rettelsen og endpoint-tabellen — 17 af DAWA’s flader har samme sti og svar under /dawa.

Felt for felt: DAWA → Grundfast

Et hit fra DAWA’s /adgangsadresser/autocomplete mod et hit fra /v1/adresse/search. De fleste felter hedder det samme; de sidste tre rækker er dem, der kræver en ændring.

  • tekstbetegnelseHele adresselinjen.
  • adgangsadresse.idadgangsadresse_idSamme DAR-UUID. Gemte id’er virker videre.
  • adgangsadresse.vejnavnvejnavnUændret.
  • adgangsadresse.husnrhusnrUændret, inkl. bogstav.
  • adgangsadresse.postnrpostnrUændret, som streng.
  • adgangsadresse.postnrnavnpostnrnavnUændret.
  • adgangsadresse.kommunekodekommunekodeUændret, fire cifre som streng.
  • adgangsadresse.x / .ykoordinat.lon / .latNavngivet objekt. Altid WGS84 i svaret.
  • —bfe_nummerNyt. I DAWA krævede det et ekstra opslag på jordstykket.
  • vejkode, supplerendebynavn, status, href—Følger ikke med i søgehittet. Slå adressen op på UUID for mere.

Fem forskelle, du skal kende

Det her er de steder, hvor Grundfast bevidst opfører sig anderledes end DAWA.

  1. Nøgle påkrævet

    DAWA var nøglefri. Grundfast kræver en nøgle på alle kald — som Authorization: Bearer-header eller ?token= — både under /dawa og /v1; uden nøgle svarer et kald 401. Nøglen hører hjemme på serveren, ikke i browseren.

  2. To veje ind: /dawa og /v1

    Under /dawa svarer Grundfast med DAWA’s egne stier og svarformer, så eksisterende kode virker med en ny base-URL. Under /v1 ligger vores eget API, hvor svaret er et objekt — søgning giver { results }, reverse { punkt, antal, adresser } og datavask { kategori, antal, resultater } — med BFE-nummeret i hvert hit.

  3. Koordinater i /v1

    I /v1 er koordinaten et navngivet objekt, koordinat.lon og koordinat.lat, i WGS84. Under /dawa er det DAWA’s x/y, og srid=25832 virker som før.

  4. Kun aktuelle data

    Svarene er current-only, så historiske rækker skal ikke filtreres fra. Skal du se en adresse, som den var på en dato, findes ?asOf= på Scale-planen og op.

  5. Forbrug måles

    DAWA var gratis og ubegrænset. Gratisplanen her er 5.000 kald om måneden. Burst-grænsen står i X-RateLimit-*, månedsforbruget i X-Quota-*; begge svarer 429 med Retry-After, så én retry med backoff dækker dem.

Ofte stillede spørgsmål

Det afhænger af, hvad du brugte DAWA til. Den officielle afløser for data er Danmarks Adresseregister (DAR) på Datafordeleren — selve registret. Til adressefelter har Klimadatastyrelsen lavet Adressevælger og Adressevask, men uden reverse geocoding og ikke 1:1 med DAWA. Har du kode skrevet mod DAWA, eller skal adressen føre videre til ejendommen, er et lag oven på DAR som Grundfast den korteste vej.

DAWA var adresser. Grundfast har de samme adresser fra DAR og kobler hver af dem til BFE-nummeret og et WGS84-punkt — så BBR, Matriklen, vurdering, byggelinjer og resten af de 14 registre er ét kald væk, med samme nøgle.

Det meste af den: 17 af DAWA’s flader findes under https://api.grundfast.dk/dawa med samme sti, parametre og svarform, så du skifter base-URL og tilføjer en nøgle. Vil du have BFE-nummeret i hvert hit, er /v1 vejen — felt-tabellen ovenfor viser, hvad der ændrer sig dér.

Hvert søgehit har bfe_nummer med. Kald /v1/bbr/ejendom/{bfe} for bygninger og enheder, /v1/matrikel/ejendom/{bfe} for jordstykker og /v1/vurdering/{bfe} for den offentlige vurdering — med samme nøgle.

Fra registrene på Datafordeleren — for adresser DAR, samme kilde som DAWA byggede på. Grundfast sælger laget oven på de åbne data: indekset, oversættelsen, samlingen og driften.

Adressen og ejendommen, med én nøgle

Opret en gratis konto, lav en API-nøgle, og slå den første adresse op — med BFE-nummeret og resten af ejendommen ét kald væk.
Opret gratis kontoSe dokumentationen

Gratis op til 5.000 kald/md · intet kreditkort · data fra Klimadatastyrelsen/Datafordeler, CC BY 4.0

Se også

Begreber og guides