Kartpunkt
EnglishSkapa testnyckel

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ägPOST /v1/route

    Färdvägen med profilen hgv och fordonets mått, i delsträckor med vägreferens och vägfakta.

  • VägavståndPOST /v1/distances

    Vägavstånd för samma fordon från många startpunkter till några mål.

  • ProfilGET /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