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äg**[`POST /v1/roads/nearby`](https://api.kartpunkt.se/docs#tag/roads/POST/v1/roads/nearby)
    
    Vägarna kring en punkt, närmast först, med de vägfakta ni ber om.
    
-   **Vägreferens**[`GET /v1/roads/{ref}`](https://api.kartpunkt.se/docs#tag/roads/GET/v1/roads/{ref})
    
    En väg utifrån en vägreferens ni sparat ur ett tidigare svar.
    
-   **Vägfakta**[`GET /v1/facts`](https://api.kartpunkt.se/docs#tag/registries/GET/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.
    
-   **Vektorrutor**[`GET /v1/tilesets`](https://api.kartpunkt.se/docs#tag/registries/GET/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

-   [Klicka på en väg på kartan och se dess vägfakta och vägreferens, utan nyckel](https://kartpunkt.se/#prova-vagfakta)
-   [Skapa en gratis testnyckel](https://kartpunkt.se/konto). Den räknar på NVDB:s riktiga vägnät, med testadresser i samma format som livedata.
-   Fälten och felkoderna står i [API-referensen](https://api.kartpunkt.se/docs#tag/roads/POST/v1/roads/nearby), och integrationen för en kodagent på [sidan för utvecklare](https://kartpunkt.se/utvecklare). Vad planerna kostar står under [Priser](https://kartpunkt.se/priser).

> Vad Trafikverkets NVDB anger om en väg, som hastighetsgräns, väghållare och bärighetsklass, i ett anrop med vägreferens och nätversion i svaret.
>
> https://kartpunkt.se/nvdb-api