# Autocomplete på vejnavne

`GET /v1/vejnavne/autocomplete` · DAWA-kompatibel

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

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`](https://grundfast.dk/docs/api/autocomplete), men her får du vejnavnene som strenge.

**Godkendelse:** `Authorization: Bearer gf_live_…` (eller `gf_test_…`)

**Afregning:** Ét kald pr. forespørgsel — også pr. tastetryk, hvis du kalder ved hvert tryk.

## Parametre

| Navn | Placering | Type | Påkrævet | Beskrivelse |
| --- | --- | --- | --- | --- |
| `q` | query | string | ja | Starten af eller en del af vejnavnet. Kun de første 64 tegn bruges. |
| `kommunekode` | query | string | nej | Afgrænser til én kommune, fx `0101` (1–4 cifre; `101` læses som `0101`). |

## Eksempel

```bash
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 (200)

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

## Vigtige felter

| Felt | Type | Betydning |
| --- | --- | --- |
| `antal` | integer | Antal hits, højst 20. |
| `vejnavne` | string[] | Højst 20 vejnavne, præfiks-match først. |
| `total` | integer | Antal vejnavne i hele listen (eller i kommunen) — ikke antallet af hits. |

## Fejl

| Status | Betydning |
| --- | --- |
| 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`. |