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.

Den anbefalede vej fra adressetekst til koordinat og BFE-nummer — ét kald. Hvilket adresse-endpoint skal jeg bruge?

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ø.

Alle fejl har samme form. Byg logikken på type (fejlklassen) og vis message (dansk tekst med årsagen) til brugeren; hint kommer med, når vi kan se, hvad der skal rettes, og request_id er det, support skal bruge. Se Fejl og statuskoder for hver type, og hvad der kan prøves igen.

Fejlsvar · 404
{
  "error": "property not found",
  "type": "not_found",
  "code": "not_found",
  "message": "Ressourcen findes ikke.",
  "request_id": "6cbfa45a-a9ea-4140-9d42-ea752a70ff1f",
  "doc_url": "https://grundfast.dk/docs/fejl#not_found"
}

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.