Autocomplete på vejnavne

Vejnavne, der matcher en tekst — dem, der starter med teksten, først.

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

Erstatter 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"

Svar · eksempel200json

{
  "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; 101 læses som 0101).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`.

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/vejnavne/autocomplete" \
  --data-urlencode "q=rådhus" \
  --data-urlencode "kommunekode=0101" \
  -H "Authorization: Bearer $GRUNDFAST_API_KEY"

Svar · eksempel200json

{
  "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"
  }
}