Spring til indhold

Grundfast

Autocomplete på adgangsadresser

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

GET/v1/adgangsadresser/autocomplete

Samme sti og parametre som DAWA’s /adgangsadresser/autocomplete, men Grundfasts svarform. 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.

Svaret har ingen koordinat og intet BFE-nummer — kun tekst og id. Skal du bruge koordinat og BFE i samme kald, så brug /v1/adresse/search; skal svaret have DAWA’s form med x/y, så brug /dawa/adresser/autocomplete. 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.

Eksempel

curl -G "https://api.grundfast.dk/v1/adgangsadresser/autocomplete" \
  --data-urlencode "q=rådhuspladsen 1" \
  -H "Authorization: Bearer $GRUNDFAST_API_KEY"
Svar · eksempel, forkortet200
{
  "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

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.
503Adresseindekset er ikke slået til eller 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

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/adgangsadresser/autocomplete?q=r%C3%A5dhuspladsen+1

Bruges ofte sammen med

Læs mere om Adresser: lister, autocomplete og reverse, og hvad data kan bruges til, på produktsiden.