Autocomplete på vejnavne
Vejnavne, der matcher en tekst — dem, der starter med teksten, først.
https://api.grundfast.dk/v1/vejnavne/autocompleteErstatter DAWA’s /vejnavne/autocomplete. Vejnavne, der starter med q, kommer først, derefter vejnavne, der indeholder teksten. Matchet tåler oe/aa i stedet for ø/å, så norrebro og noerrebro begge finder Nørrebrogade. Der returneres højst 20 hits.
Rangeringen er den samme som type=vejnavn på /v1/autocomplete, men her får du vejnavnene som strenge.
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/vejnavne/autocomplete" \
--data-urlencode "q=rådhus" \
--data-urlencode "kommunekode=0101" \
-H "Authorization: Bearer $GRUNDFAST_API_KEY"{
"antal": 3,
"total": 2683,
"vejnavne": ["Rådhuspladsen", "Rådhusstræde", "Bag Rådhuset"],
"meta": {
"kilde": "Datafordeler DAR (vejnavne) via Grundfast",
"grundfast_version": "0.1.0"
}
}Parametre
qstringquerypåkrævet- Starten af eller en del af vejnavnet. Kun de første 64 tegn bruges.Eksempel:
rådhus kommunekodestringqueryvalgfri- Afgrænser til én kommune, fx
0101(1–4 cifre;101læses som0101).Eksempel:0101
Felter i svaret
antalinteger- Antal hits, højst 20.
vejnavnestring[]- Højst 20 vejnavne, præfiks-match først.
totalinteger- Antal vejnavne i hele listen (eller i kommunen) — ikke antallet af hits.
Statuskoder
| Status | Betydning |
|---|---|
| 200 | Svaret er leveret. |
| 400 | q mangler eller er tom, eller kommunekode er ikke 1–4 cifre. |
| 401 | Nøglen mangler eller er ugyldig. |
| 429 | Burst-grænsen eller månedskvoten er nået. Se Retry-After. |
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
- GETHent vejnavne
/v1/vejnavne - GETAutocomplete på tværs
/v1/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.