Kartpunkt
EnglishSkapa testnyckel

Vägavstånd

Vägavstånd och avståndsmatris via API

Ni skickar startpunkter och mål, och API:et svarar med vägavstånd i meter och restid i sekunder längs Trafikverkets vägnät NVDB, för gång, bil, lastbil eller buss.

Operationerna

  • AvståndsmatrisPOST /v1/matrix

    Meter och sekunder från varje startpunkt till varje mål, med en status per cell.

  • VägavståndPOST /v1/distances

    Från många startpunkter till några mål, med de vägfakta ni ber om summerade längs varje väg och, om ni vill, dess linje.

  • FärdvägPOST /v1/route

    En färdväg mellan två punkter, i delsträckor med vägreferens och vägfakta.

Ett anrop och dess svar

Fem punkter mot samma fem punkter med bil, den snabbaste vägen: en avståndsmatris på 5 × 5.

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

{
  "origins": [
    {"lat": 57.77071, "lon": 11.99134},
    {"lat": 57.79255, "lon": 11.96891},
    {"lat": 57.73889, "lon": 11.97117},
    {"lat": 57.79789, "lon": 12.04819},
    {"lat": 57.75602, "lon": 11.92846}
  ],
  "destinations": [
    {"lat": 57.77071, "lon": 11.99134},
    {"lat": 57.79255, "lon": 11.96891},
    {"lat": 57.73889, "lon": 11.97117},
    {"lat": 57.79789, "lon": 12.04819},
    {"lat": 57.75602, "lon": 11.92846}
  ],
  "profile": "car_fastest"
}

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

{
  "distances_m": [
    [0, 4011.9, 5023.7, 7766.2, 6878],
    [3967.5, 0, 9078.7, 7259.9, 8812],
    [5121.8, 9317.3, 0, 12751.6, 6334.5],
    [7713.2, 7543.9, 12108, 0, 14719.2],
    [7128.5, 9032.3, 6431.2, 15067.3, 0]
  ],
  "durations_s": [
    [0, 274, 348, 494, 481],
    [270, 0, 519, 442, 581],
    [355, 570, 0, 714, 455],
    [454, 426, 653, 0, 794],
    [498, 596, 462, 816, 0]
  ],
  "statuses": [
    ["ok", "ok", "ok", "ok", "ok"],
    ["ok", "ok", "ok", "ok", "ok"],
    ["ok", "ok", "ok", "ok", "ok"],
    ["ok", "ok", "ok", "ok", "ok"],
    ["ok", "ok", "ok", "ok", "ok"]
  ],
  "provenance": {
    "synthetic": false,
    "network": {
      "id": "snap_01m4twhhp1fvmv2fbzba4mk01y",
      "dataset": "nvdb",
      "source_date": "2026-10-06",
      "built_at": "2026-10-13T15:01:52.961Z",
      "graph": "snap_01m4v498g5fvmv2jph75zf2g5w",
      "profile": "car_fastest",
      "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-06"
      }
    ]
  }
}

Vad svaret innehåller

Raderna är startpunkterna och kolumnerna målen, i den ordning ni skickade dem. En punkt som inte når vägnätet får sin status i statuses i stället för ett tal, så en dålig punkt fäller inte anropet. Restiden räknas vid fritt flöde, efter NVDB:s hastighetsgränser, utan trafik och tid på dygnet.

provenance anger nätversionen, profilen och NVDB:s leverans: varje vägavstånd är dokumenterat och daterat med nätversion. Hur ett vägavstånd ser ut som utskrivbart dokument visar mätprotokollet.

Matris, avstånd eller färdväg

Avståndsmatrisen ger bara tal, för en tabell mellan många platser. /v1/distances ger varje väg med sina vägfakta och linje, och /v1/route en färdväg med en vägreferens per delsträcka. Ett avstånd är en beräkning per startpunkt och mål, och en avståndsmatris räknas som hälften av sina celler, högst tio per punkt i den längsta listan.

Prova och kom igång