Autocomplete på tværs
Samlet type-ahead over adgangsadresser, vejnavne eller postnumre, med en ensartet liste af tekst og værdi.
https://api.grundfast.dk/v1/autocompleteSamme sti og parametre som DAWA’s /autocomplete, men Grundfasts svarform. type vælger, hvad der søges i; hvert hit er { type, tekst, vaerdi }, hvor vaerdi er nøglen: adgangsadressens UUID, vejnavnet eller postnummeret. Svaret er pakket ind i { type, antal, resultater } i stedet for et bart array, og der returneres højst 20 hits.
type=adresse går trinvis fra vej over husnummer til enhed, som DAWA’s autocomplete gjorde: så længe teksten passer på flere adgangsadresser, er hittene type: "adgangsadresse"; når den peger på én, kommer dens enheder med etage og dør som type: "adresse". Svarets egen type følger trinnet, så en klient, der kun kender adgangsadresser, ser intet nyt, før den når en enhed. Har brugeren valgt en adgangsadresse, så send dens UUID som adgangsadresseid, og du får dens enheder direkte. Et enhedshit har vaerdi = enhedens UUID plus adgangsadresse_id, etage og doer.
Svarformen er ikke den samme som DAWA’s (forslagstekst, caretpos, data findes ikke), så en klient, der læser tekst og vaerdi, virker — en widget, der er bygget til DAWA’s svar, skal bruge /dawa/autocomplete i stedet, fx via @grundfast/dawa-autocomplete. Et adgangsadresse-hit bliver til et BFE via /v1/jordstykker/reverse, eller brug /v1/adresse/search, som har bfe_nummer med i hvert hit.
/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, hvis du kalder ved hvert tryk.
Eksempel
curl -G "https://api.grundfast.dk/v1/autocomplete" \
--data-urlencode "q=rådhuspladsen 1, 1550" \
-H "Authorization: Bearer $GRUNDFAST_API_KEY"{
"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 2, 1550 København V",
"vaerdi": "39ece5fb-ee06-0ee2-e044-0003ba298018"
},
{
"type": "adgangsadresse",
"tekst": "Rådhuspladsen 3, 1550 København V",
"vaerdi": "0a3f507a-ec03-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, 1550 typestringqueryvalgfri- Hvad der søges i.
adresseer det trinvise forløb vej → husnummer → enhed (etage og dør).Standard:adgangsadresseVærdier:adgangsadresseadressevejnavnpostnummer adgangsadresseidstring (UUID)queryvalgfri- Kun ved
type=adresse: en valgt adgangsadresse. Svaret er så dens enheder, indsnævret afq, når teksten indsnævrer dem. kommunekodestringqueryvalgfri- Afgrænser vejnavne til én kommune, fx
0101(1–4 cifre;101læses som0101). Bruges kun vedtype=vejnavn, men valideres altid.
Felter i svaret
resultater[].tekststring- Teksten, du viser i listen — for et postnummer fx "8000 Aarhus C".
resultater[].vaerdistring- Nøglen for det valgte hit: enhedens UUID, adgangsadressens UUID, vejnavnet eller det firecifrede postnummer.
resultater[].typestring- Hvad hittet er:
adresse(enhed),adgangsadresse,vejnavnellerpostnummer. Vedtype=adresseskifter det undervejs. resultater[].etagestring | null- Kun på enhedshit: etagen, fx
"st","2"eller"kl". Sammen meddoerogadgangsadresse_id. antalinteger- Antal hits, højst 20.
Statuskoder
| Status | Betydning |
|---|---|
| 200 | Svaret er leveret. |
| 400 | q mangler eller er kortere end 2 tegn, type er ukendt, kommunekode er ikke 1–4 cifre, eller adgangsadresseid er ikke et UUID. |
| 401 | Nøglen mangler eller er ugyldig. |
| 429 | Burst-grænsen eller månedskvoten er nået. Se Retry-After. |
| 503 | Kun ved adgangsadresser og adresser: adresseindekset er ikke slået til eller endnu ikke indlæst. Mangler kun enhedsindekset, svarer type=adresse med adgangsadresser i stedet for at fejle. |
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.
{
"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øgleBruges ofte sammen med
- GETSøg efter en adresse
/v1/adresse /search - GETAutocomplete på vejnavne
/v1/vejnavne /autocomplete - GETAutocomplete på postnumre
/v1/postnumre /autocomplete - GETFind jordstykket på et punkt
/v1/jordstykker /reverse
Læs mere om Adresser: lister, autocomplete og reverse, og hvad data kan bruges til, på produktsiden.