Spring til indhold

Grundfast

Søg efter en adresse

Autocomplete over alle danske adgangsadresser: fritekst ind, rangerede adresser ud med UUID, BFE-nummer og WGS84-punkt.

GET/v1/adresse/search

Søgningen kører mod et lokalt indeks over DAR (Danmarks Adresseregister), fordi Datafordelers eget DAR-endpoint kun kan slå op på id. Præfiks-match rangeres først, derefter stavefejlstolerante match efter lighed, så både rådhuspladsen 1 og radhuspladsen finder Rådhuspladsen 1. Æ, ø og å matcher også skrevet som ae, oe og aa.

Hvert hit er en adgangsadresse (husnummer) uden etage og dør — enhederne med etage og dør finder du via /v1/adresser/autocomplete. bfe_nummer er BFE-nummeret på det jordstykke, adgangspunktet ligger på, så du kan gå direkte videre til BBR eller Matriklen uden et ekstra opslag.

Godkendelse · API-nøgle

Send din nøgle som Authorization: Bearer gf_live_… — eller gf_test_… for gratis sandbox-kald. Se Godkendelse og nøgler.

Afregning

Ét kald pr. forespørgsel — også pr. tastetryk, hvis du kalder ved hvert tryk.

Eksempel

curl -G "https://api.grundfast.dk/v1/adresse/search" \
  --data-urlencode "q=rådhuspladsen 1, 1550" \
  --data-urlencode "per_side=8" \
  -H "Authorization: Bearer $GRUNDFAST_API_KEY"
Svar · fra demo-endpointet, forkortet200
{
  "results": [
    {
      "betegnelse": "Rådhuspladsen 1, 1550 København V",
      "adgangsadresse_id": "0a3f507a-ec01-32b8-e044-0003ba298018",
      "bfe_nummer": 6033528,
      "vejnavn": "Rådhuspladsen",
      "husnr": "1",
      "postnr": "1550",
      "postnrnavn": "København V",
      "kommunekode": "0101",
      "koordinat": { "lon": 12.5695777, "lat": 55.6756275 }
    },
    {
      "betegnelse": "Rådhuspladsen 2, 1550 København V",
      "adgangsadresse_id": "39ece5fb-ee06-0ee2-e044-0003ba298018",
      "bfe_nummer": 6033587,
      "vejnavn": "Rådhuspladsen",
      "husnr": "2",
      "postnr": "1550",
      "postnrnavn": "København V",
      "kommunekode": "0101",
      "koordinat": { "lon": 12.5677412, "lat": 55.676827 }
    }
  ]
}

Forkortet: lange lister og geometrier er skåret ned — de viste værdier er uændrede.

Parametre

qstringquerypåkrævet
Fritekst, mindst 2 tegn efter trim. Tekst ud over 128 tegn ignoreres.Eksempel: rådhuspladsen 1, 1550
per_sideintegerqueryvalgfri
Antal hits. Værdier over 20 sænkes til 20; en tom, ikke-numerisk eller ikke-positiv værdi giver standarden.Standard:8Eksempel: 8

Felter i svaret

results[].adgangsadresse_idstring (UUID)
DAR-husnummerets UUID — en stabil nøgle, du kan gemme og slå op med /v1/adresse/:uuid.
results[].betegnelsestring
Hele adresselinjen, fx "Rådhuspladsen 1, 1550 København V".
results[].bfe_nummerinteger | null
BFE på det jordstykke, der dækker adgangspunktet. null kun når intet jordstykke dækker punktet.
results[].kommunekodestring | null
Firecifret kommunekode som streng, fx "0101".
results[].koordinat{ lon, lat } | null
Adgangspunktet i WGS84.

Statuskoder

StatusBetydning
200Svaret er leveret.
400q mangler eller er kortere end 2 tegn.
401Nøglen mangler eller er ugyldig.
429Burst-grænsen eller månedskvoten er nået. Se Retry-After.
503Adressesøgningen er ikke slået til, eller indekset er endnu ikke indlæst i dette miljø.

Fejl har altid formen { "error": "…" }. Se Fejl og statuskoder for, hvad der kan prøves igen.

Prøv det

Live-kald fra siden

Demoen søger i det rigtige indeks, men returnerer højst 6 hits. Med en q under 2 tegn — eller hvis søgningen ikke er tilgængelig — svarer den med et gemt, rigtigt svar på søgningen “Solbakkevej 70, 8600” i samme form.

GET /v1/demo/adresse-search?q=r%C3%A5dhuspladsen+1%2C+1550

Bruges ofte sammen med

Læs mere om Adresser (DAR), og hvad data kan bruges til, på produktsiden.