Lastbil och buss

# Färdvägar för lastbil och buss, efter NVDB:s gränser

Ni skickar start, mål och fordonets mått, och API:et svarar med en färdväg för lastbil eller buss efter NVDB:s gränser för höjd, vikt, längd och förbud.

## Operationerna

-   **Färdväg**[`POST /v1/route`](https://api.kartpunkt.se/docs#tag/routing/POST/v1/route)
    
    Färdvägen med profilen hgv och fordonets mått, i delsträckor med vägreferens och vägfakta.
    
-   **Vägavstånd**[`POST /v1/distances`](https://api.kartpunkt.se/docs#tag/routing/POST/v1/distances)
    
    Vägavstånd för samma fordon från många startpunkter till några mål.
    
-   **Profil**[`GET /v1/profiles`](https://api.kartpunkt.se/docs#tag/registries/GET/v1/profiles)
    
    Profilerna och vad var och en tar hänsyn till, så att ni inte behöver skriva in dem i koden.
    

## Ett anrop och dess svar

En lastbil på 26 ton, 4 meter hög och 12 meter lång, med väghållare och hastighetsgräns summerade längs färdvägen.

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

{
  "origin": {"lat": 59.2965, "lon": 18.0445},
  "destination": {"lat": 59.2705, "lon": 17.9195},
  "profile": "hgv",
  "vehicle": {"kind": "lorry", "weight_t": 26, "height_m": 4, "length_m": 12},
  "facts": ["road_owner", "speed_limit"],
  "geometry": "none"
}
```

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

```
{
  "status": "ok",
  "distance_m": 9840.4,
  "duration_s": 507,
  "facts": {
    "road_owner": {"state": 8823.2, "private": 272.9, "municipal": 744.4},
    "speed_limit": {"30": 46.4, "40": 275, "50": 695.8, "60": 483.4, "70": 3431.2, "80": 4908.6}
  },
  "avoid_m": null,
  "snap_m": 19.44,
  "street_matched": null,
  "destination_snap_m": 10.79,
  "destination_street_matched": null,
  "blocked_by": null,
  "via": null,
  "segments": [
    {
      "length_m": 157.2,
      "ref": "13636:3867@0.613570-1.000000",
      "facts": {"road_owner": "state", "speed_limit": "70"}
    },
    {
      "length_m": 0,
      "ref": "13636:3873@0.000000-0.000002",
      "facts": {"road_owner": "state", "speed_limit": "70"}
    }
    // … 108 delsträckor till
  ],
  "avoid": null,
  "alternatives": null,
  "provenance": {
    "synthetic": false,
    "network": {
      "id": "snap_01m51kym0qe499571qqyfr5q6g",
      "dataset": "nvdb",
      "source_date": "2026-10-13",
      "built_at": "2026-10-16T05:46:25.175Z",
      "graph": "snap_01m52ek3n7e4995j4m1xrkapwh",
      "profile": "hgv",
      "experimental": false
    },
    "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"
      }
    ]
  }
}
```

## Fordonet i anropet

Profilen `hgv` tar fordonets mått i `vehicle`: vikt, höjd och längd. Med `"kind": "bus"` räknas färdvägen för en buss, efter de förbud NVDB anger för buss. Färdvägen håller sig borta från vägar och svängar som NVDB stänger för fordonet i den riktning det kör, och från gränser för höjd, vikt och längd som är lägre än fordonets. Tiden räknas vid fritt flöde, med högst 80 km/h.

## En känd begränsning

Ett lastbilsförbud som NVDB anger i en riktning behandlas som förbud i båda riktningarna. Färdvägen kan då bli längre än den behöver vara.

## Vad svaret innehåller

Varje delsträcka har en vägreferens, `ref`, till NVDB:s länk, som pekar på samma väg i varje leverans där länken finns kvar, och de vägfakta ni bad om. `provenance` anger nätversionen, profilen och NVDB:s leverans och källhänvisning: svaret är dokumenterat och daterat med nätversion.

## Prova och kom igång

-   [Välj Fordon och en höjd eller vikt på kartan och se fordonets färdväg bredvid bilens, utan nyckel](https://kartpunkt.se/#prova-fardvag)
-   [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/routing/POST/v1/route), 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).

> Färdvägar och avstånd för lastbil och buss efter NVDB:s gränser för höjd, vikt, längd och förbud, med fordonets mått i anropet.
>
> https://kartpunkt.se/lastbil