Spring til indhold

Grundfast

Vask en adresse

Match en uformateret adressestreng mod DAR og få op til 10 rangerede kandidater og en sikkerhedskategori A, B eller C.

GET/v1/datavask/adgangsadresser

Erstatter DAWA’s /datavask/adgangsadresser. Strengen sammenlignes med alle adgangsadresser efter lighed, så stavefejl, manglende postnumre og forkortelser stadig kan give et match. Svaret er { kategori, antal, resultater }, og hver kandidat har sin lighed (0–1).

A er et sikkert match: næsten eksakt, eller klart bedre end nummer to. B er et sandsynligt match, der bør bekræftes. C er usikkert. Læs antal før kategori: C med antal: 0 betyder, at intet matchede, mens C med kandidater betyder, at de skal gennemgås.

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.

Eksempel

curl -G "https://api.grundfast.dk/v1/datavask/adgangsadresser" \
  --data-urlencode "betegnelse=rådhuspladsen 1, københavn" \
  -H "Authorization: Bearer $GRUNDFAST_API_KEY"
Svar · eksempel, forkortet200
{
  "kategori": "B",
  "antal": 10,
  "resultater": [
    {
      "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 },
      "lighed": 0.813
    },
    {
      "betegnelse": "Rådhuspladsen 11, 1550 København V",
      "adgangsadresse_id": "0a3f507a-ec07-32b8-e044-0003ba298018",
      "bfe_nummer": 100058380,
      "vejnavn": "Rådhuspladsen",
      "husnr": "11",
      "postnr": "1550",
      "postnrnavn": "København V",
      "kommunekode": "0101",
      "koordinat": { "lon": 12.5686571, "lat": 55.6763797 },
      "lighed": 0.735
    }
  ],
  "meta": {
    "kilde": "Datafordeler DAR via Grundfast",
    "grundfast_version": "0.1.0"
  }
}

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

Parametre

betegnelsestringquerypåkrævet
Adressen, der skal vaskes, mindst 2 tegn efter trim. Tekst ud over 128 tegn ignoreres.Eksempel: rådhuspladsen 1, københavn

Felter i svaret

kategori'A' | 'B' | 'C'
Sikkerheden for det bedste match. Læs den sammen med antal.
antalinteger
Antal kandidater, højst 10. 0 betyder intet match.
resultater[].lighednumber
Trigram-lighed mellem input og kandidat, 0–1 med tre decimaler. Listen er sorteret faldende.
resultater[].adgangsadresse_idstring (UUID)
DAR-husnummerets UUID for kandidaten. Kandidaten har også bfe_nummer og koordinat.

Statuskoder

StatusBetydning
200Svaret er leveret.
400betegnelse 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.
503Adresseindekset er ikke slået til eller 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

Kræver din nøgle

Nøglen bliver i denne fane og sendes kun til grundfast.dk. Kaldet tæller som et almindeligt kald — brug en gf_test_-nøgle for at prøve gratis. Opret en gratis nøgle

GET /v1/datavask/adgangsadresser?betegnelse=r%C3%A5dhuspladsen+1%2C+k%C3%B8benhavn

Bruges ofte sammen med

Læs mere om DAWA-kompatibel, og hvad data kan bruges til, på produktsiden.