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åndsmatris**[`POST /v1/matrix`](https://api.kartpunkt.se/docs#tag/routing/POST/v1/matrix)
    
    Meter och sekunder från varje startpunkt till varje mål, med en status per cell.
    
-   **Vägavstånd**[`POST /v1/distances`](https://api.kartpunkt.se/docs#tag/routing/POST/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äg**[`POST /v1/route`](https://api.kartpunkt.se/docs#tag/routing/POST/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](https://kartpunkt.se/exempel/matprotokoll).

## 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

-   [Klicka start och mål på kartan och se färdvägen och dess vägavstånd, 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/matrix), 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).

> Meter och sekunder längs Trafikverkets vägnät, från en startpunkt eller många, som avstånd med vägfakta eller som avståndsmatris, daterade med nätversion.
>
> https://kartpunkt.se/vagavstand