Kartpunkt
EnglishSkapa testnyckel

NVDB API

NVDB som API: vägfakta och vägreferenser

Ni frågar vad Trafikverkets vägdatabas NVDB anger om en väg, som hastighetsgräns, väghållare, bärighetsklass och höjdhinder, och får svaret med vägreferens och nätversion.

Operationerna

  • VägPOST /v1/roads/nearby

    Vägarna kring en punkt, närmast först, med de vägfakta ni ber om.

  • VägreferensGET /v1/roads/{ref}

    En väg utifrån en vägreferens ni sparat ur ett tidigare svar.

  • VägfaktaGET /v1/facts

    De 34 vägfakta ur NVDB som en väg, en färdväg eller ett spår kan redovisa, med slag och enhet.

  • VektorrutorGET /v1/tilesets

    NVDB:s vägar som vektorrutor (PMTiles) att visa i er egen karta.

Ett anrop och dess svar

Vägen vid en punkt, inom 40 meter, med elva vägfakta.

POST https://api.kartpunkt.se/v1/roads/nearby
Authorization: Bearer $KARTPUNKT_API_KEY
Content-Type: application/json

{
  "point": {"lat": 59.70658, "lon": 17.7998},
  "radius_m": 40,
  "limit": 1,
  "facts": [
    "speed_limit",
    "road_owner",
    "surface",
    "bearing_class",
    "road_class",
    "traffic_safety_class",
    "built_up",
    "fast_road",
    "traffic_volume",
    "max_weight",
    "max_height"
  ]
}

Svaret från api.kartpunkt.se, inspelat 2026-10-24. Rader som börjar med // … är utelämnade.

{
  "roads": [
    {
      "ref": "1000:89985@0.873831-0.877665",
      "distance_m": 0.52,
      "name": null,
      "number": "1043",
      "length_m": 10.2,
      "facts": {
        "speed_limit": "70",
        "road_owner": "state",
        "surface": "gravel",
        "bearing_class": "BK1",
        "road_class": "5",
        "traffic_safety_class": "unknown",
        "built_up": false,
        "fast_road": true,
        "traffic_volume": 185,
        "max_weight": null,
        "max_height": 3.7
      }
      // … geometry, vägens linje som GeoJSON
    }
  ],
  "provenance": {
    "synthetic": false,
    "network": {
      "id": "snap_01m5jtxeacfk49vqky0fy1myje",
      "dataset": "nvdb",
      "source_date": "2026-10-13",
      "built_at": "2026-10-22T22:15:11.949Z",
      "graph": "snap_01m5k1bmzgfk49vt8z6wche2jr"
    },
    "sources": [
      {
        "id": "nvdb",
        "name": "Trafikverket, NVDB",
        "licence": "CC0-1.0",
        "attribution": "Vägdata från NVDB, Trafikverket, CC0 1.0",
        "url": "https://creativecommons.org/publicdomain/zero/1.0/",
        "updated": "2026-10-13"
      }
    ]
  }
}

Vägreferensen

Varje sträcka i ett svar har en vägreferens, ref: NVDB:s länk och en del av den, som 1000:89985@0.873831-0.877665. Referensen pekar på samma väg i varje leverans där länken finns kvar. Spara den med ert eget ärende, och läs vägen igen med GET /v1/roads/{ref}. Färdvägar och spårmatchningar har samma referens på varje delsträcka.

Nätversion och källa

Vägnätet byggs ur NVDB, som Trafikverket ger ut under CC0. Vi läser in nya NVDB-leveranser, och provenance.network i varje svar anger nätversionen och vilken leverans den byggdes ur (source_date). Svaret är dokumenterat och daterat med nätversion, och har NVDB:s källhänvisning.

Prova och kom igång