Spring til indhold

Grundfast

Hent vejnavne

Alle forskellige danske vejnavne, side for side og valgfrit afgrænset til én kommune.

GET/v1/vejnavne

Erstatter DAWA’s /vejnavne med samme side/per_side. Hvert vejnavn er en streng, ikke et objekt, og et navn optræder kun én gang, selvom det findes i mange kommuner. Brug kommunekode for kun at få vejnavnene i én kommune.

Navnene er sorteret alfabetisk efter dansk sortering. Svaret er { antal, total, vejnavne, meta }, hvor total er antallet af vejnavne i hele listen.

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. side.

Eksempel

curl "https://api.grundfast.dk/v1/vejnavne?per_side=100&kommunekode=0101" \
  -H "Authorization: Bearer $GRUNDFAST_API_KEY"
Svar · eksempel, forkortet200
{
  "antal": 100,
  "total": 2683,
  "vejnavne": ["A-Vej", "A.C. Meyers Vænge", "A.F. Beyers Vej"],
  "meta": {
    "kilde": "Datafordeler DAR (vejnavne) via Grundfast",
    "grundfast_version": "0.1.0"
  }
}

Forkortet: lange lister og geometrier er skåret ned — de viste værdier er uændrede.

Parametre

per_sideintegerqueryvalgfri
Antal vejnavne pr. side, højst 200.Standard:100Eksempel: 100
sideintegerqueryvalgfri
Sidenummer, startende ved 1.Standard:1
kommunekodestringqueryvalgfri
Afgrænser til én kommune, fx 0101 (1–4 cifre; 101 læses som 0101).Eksempel: 0101

Felter i svaret

antalinteger
Antal vejnavne på denne side. Mindre end per_side på sidste side.
vejnavnestring[]
Vejnavnene på siden.
totalinteger
Antal vejnavne i hele listen (eller i kommunen). Sidst side er nået, når side × per_side ≥ total.

Statuskoder

StatusBetydning
200Svaret er leveret.
400kommunekode er ikke 1–4 cifre.
401Nøglen mangler eller er ugyldig.
429Burst-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.

Fejlsvar · 404
{
  "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øgle

Nøglen bliver i denne fane og sendes kun til grundfast.dk. Kaldet tæller som et almindeligt kald — brug en gf_test_-nøgle for at prøve gratis. Opret en gratis nøgle

GET /v1/vejnavne?per_side=100&kommunekode=0101

Bruges ofte sammen med

Læs mere om Adresser: lister, autocomplete og reverse, og hvad data kan bruges til, på produktsiden.