Autocomplete på adgangsadresser

Type-ahead over adgangsadresser på DAWA’s egen sti, med tekst og UUID for hvert hit.

GEThttps://api.grundfast.dk/v1/adgangsadresser/autocomplete

Erstatter DAWA’s /adgangsadresser/autocomplete. Hittene er de samme som fra /v1/autocomplete med type=adgangsadresse, i samme { type, antal, resultater }-form og højst 20 ad gangen.

Skal du bruge BFE-nummer og koordinat i hvert hit, så brug /v1/adresse/search i stedet.

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.

Eksempel

curl -G "https://api.grundfast.dk/v1/adgangsadresser/autocomplete" \
  --data-urlencode "q=rådhuspladsen 1" \
  -H "Authorization: Bearer $GRUNDFAST_API_KEY"

Svar · eksempel, forkortet200json

{
  "type": "adgangsadresse",
  "antal": 20,
  "resultater": [
    {
      "type": "adgangsadresse",
      "tekst": "Rådhuspladsen 1, 1550 København V",
      "vaerdi": "0a3f507a-ec01-32b8-e044-0003ba298018"
    },
    {
      "type": "adgangsadresse",
      "tekst": "Rådhuspladsen 14, 1550 København V",
      "vaerdi": "0a3f507a-ec0e-32b8-e044-0003ba298018"
    }
  ]
}

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

Parametre

qstringquerypåkrævet: Søgetekst, mindst 2 tegn efter trim. Kun de første 64 tegn bruges.Eksempel: rådhuspladsen 1

Felter i svaret

resultater[].vaerdistring (UUID): Adgangsadressens UUID.
resultater[].tekststring: Adressen som visningstekst, fx "Rådhuspladsen 1, 1550 København V".

Statuskoder

Status	Betydning
200	Svaret er leveret.
400	`q` mangler eller er kortere end 2 tegn.
401	Nøglen mangler eller er ugyldig.
429	Burst-grænsen eller månedskvoten er nået. Se `Retry-After`.
503	Adresseindekset 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

Bruges ofte sammen med

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

curl -G "https://api.grundfast.dk/v1/adgangsadresser/autocomplete" \
  --data-urlencode "q=rådhuspladsen 1" \
  -H "Authorization: Bearer $GRUNDFAST_API_KEY"

Svar · eksempel, forkortet200json

{
  "type": "adgangsadresse",
  "antal": 20,
  "resultater": [
    {
      "type": "adgangsadresse",
      "tekst": "Rådhuspladsen 1, 1550 København V",
      "vaerdi": "0a3f507a-ec01-32b8-e044-0003ba298018"
    },
    {
      "type": "adgangsadresse",
      "tekst": "Rådhuspladsen 14, 1550 København V",
      "vaerdi": "0a3f507a-ec0e-32b8-e044-0003ba298018"
    }
  ]
}

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