Adresse-autocomplete-API til danske adresser

API til adressesøgning

Grundfast er et API til adressesøgning på danske adresser: send q til GET /v1/autocomplete og få rangerede adresseforslag retur på få millisekunder. Søgningen kører fuzzy + præfiks-match (pg_trgm) oven på et lokalt indeks af DAR — så stavefejl, forkortelser og halve gadenavne stadig rammer rigtigt, i stedet for kun eksakt-match. Skal du bruge mere end en label, laver GET /v1/adresse/search et fuldt opslag med betegnelse, bfe_nummer, postnr og koordinat.

Adresseforslag mens brugeren skriver

Det type-as-du-skriver adressefelt er den mest integrerede DAWA-funktion. Hvert adresseforslag bærer en tekst til visning i dropdownen og en stabil vaerdi (adgangsadresse-UUID, vejnavn eller postnr) at binde valget til. Filtrér på type, hvis du kun vil have adgangsadresser, vejnavne eller postnumre — ét endpoint driver hele adressefeltet. Fladen er bygget som drop-in for DAWAs autocomplete, så et eksisterende adressefelt kan flyttes over uden at skrive frontend’en om.

Prøv adresse-autocomplete live

Skriv en dansk adresse og se rangerede forslag lande på få millisekunder — kørt mod den nøglefrie demo /v1/demo/adresse-search oven på det rigtige DAR-indeks, med ægte svartid.

Hvad autocomplete-API’et giver dig

Kald autocomplete i din stack

Samme kald i cURL, den typede TS-SDK og ren Python — ét GET /v1/autocomplete?q= med en gf_live_-nøgle (samme auth og metering som de øvrige registre), og svaret nedenfor:

curl -H "Authorization: Bearer gf_live_…" \
  "https://api.grundfast.dk/v1/autocomplete?q=rådhusplads"

# Adresse-autocomplete, Bearer gf_live_…:
GET /v1/autocomplete?q=rådhusplads
→ 200 { type: "adgangsadresse", antal: 3,
        resultater: [
          { type: "adgangsadresse", tekst: "Rådhuspladsen 1, 1550 København V",
            vaerdi: "0a3f50a1-2d3e-32b8-e044-0003ba298018" },
          { type: "adgangsadresse", tekst: "Rådhuspladsen 2, 1550 København V",
            vaerdi: "0a3f50a1-2d3e-32b8-e044-0003ba298020" } ] }

Parametre

Felter i svaret

Grundfast vs. DAWA vs. rå Datafordeler

Adresse-autocomplete som drop-in for DAWA — men på et lag der overlever Datafordeler-migreringen, oven på et lokalt DAR-indeks du selv slipper for at bygge.

Adresseforslag mens brugeren skriver — sådan integrerer du det

Et adressefelt med forslag mens brugeren skriver er tre trin: debounce hvert tastetryk (ét kald, ikke ét pr. bogstav), map resultater[].tekst til dropdownen, og bind valget til resultater[].vaerdi (den stabile nøgle) — ikke til visningsstrengen. Slå til sidst hele posten op med /v1/adresse/search, så du får betegnelse, bfe_nummer, postnr og koordinat:

// Adresseforslag mens brugeren skriver — debounced typeahead i React
import { useRef, useState } from 'react';

const HEADERS = { Authorization: 'Bearer gf_live_…' };

function AdresseFelt() {
  const [forslag, setForslag] = useState([]); // [{ type, tekst, vaerdi }]
  const timer = useRef();

  function onChange(e) {
    const q = e.target.value;
    clearTimeout(timer.current);
    if (q.length < 2) return setForslag([]);
    // Vent 200 ms efter sidste tastetryk — ét kald, ikke ét pr. bogstav
    timer.current = setTimeout(async () => {
      const res = await fetch(
        '/v1/autocomplete?q=' + encodeURIComponent(q),
        { headers: HEADERS },
      );
      const { resultater } = await res.json();
      setForslag(resultater); // hver har tekst (label) + vaerdi (nøgle)
    }, 200);
  }

  async function vaelg(hit) {
    // Bind til hit.vaerdi (stabil adgangsadresse-UUID), ikke til visningsstrengen.
    // Slå hele posten op — betegnelse, postnr, bfe_nummer, koordinat i ét svar:
    const res = await fetch(
      '/v1/adresse/search?q=' + encodeURIComponent(hit.tekst),
      { headers: HEADERS },
    );
    const { results } = await res.json();
    return results[0]; // { betegnelse, adgangsadresse_id, bfe_nummer, postnr, koordinat, … }
  }

  return (
    <div>
      <input onChange={onChange} placeholder="Skriv en adresse…" />
      <ul>
        {forslag.map((hit) => (
          <li key={hit.vaerdi} onClick={() => vaelg(hit)}>
            {hit.tekst}
          </li>
        ))}
      </ul>
    </div>
  );
}

Se også Adresse-API (DAR) — opslag på UUID, postnummer-API, datavask og DAWA-alternativ.

Ofte stillede spørgsmål