Autocomplete på adgangsadresser
Type-ahead over adgangsadresser på DAWA’s egen sti, med tekst og UUID for hvert hit.
https://api.grundfast.dk/v1/adgangsadresser/autocompleteSamme 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.
/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"{
"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ø. |
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
- GETAutocomplete på tværs
/v1/autocomplete - GETAutocomplete på etage og dør
/v1/adresser /autocomplete - GETSøg efter en adresse
/v1/adresse /search
Læs mere om Adresser: lister, autocomplete og reverse, og hvad data kan bruges til, på produktsiden.