Road distances for school-transport platforms

curl -X POST https://api.kartpunkt.se/v1/distances \
  -H "Authorization: Bearer $KARTPUNKT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"destinations":[{"point":{"lat":59.859904,"lon":17.644332,"street":"Järngatan"}}],"origins":[{"id":"home-1","point":{"lat":59.858268,"lon":17.642901,"street":"Bredstigen"}},{"id":"home-2","point":{"lat":59.862563,"lon":17.645463,"street":"Örnvägen"}}],"profile":"walk","facts":["fast_road","unlit_outside_built_up","crossings_without_refuge"]}'

{
  "avoid": null,
  "destinations": [
    {
      "id": null,
      "snap_m": 0.01,
      "street_matched": true
    }
  ],
  "results": [
    {
      "id": "home-1",
      "destination_id": null,
      "destination_index": 0,
      "status": "ok",
      "distance_m": 199.1,
      "duration_s": 143,
      "facts": {
        "fast_road": 0,
        "unlit_outside_built_up": 0,
        "crossings_without_refuge": 0
      },
      "avoid_m": null,
      "snap_m": 0.04,
      "street_matched": true,
      "destination_snap_m": 0.01,
      "destination_street_matched": true,
      "blocked_by": null,
      "alternatives": null
    },
    {
      "id": "home-2",
      "destination_id": null,
      "destination_index": 0,
      "status": "ok",
      "distance_m": 713.7,
      "duration_s": 514,
      "facts": {
        "fast_road": 0,
        "unlit_outside_built_up": 0,
        "crossings_without_refuge": 0
      },
      "avoid_m": null,
      "snap_m": 21.76,
      "street_matched": true,
      "destination_snap_m": 0.01,
      "destination_street_matched": true,
      "blocked_by": null,
      "alternatives": null
    }
  ],
  "provenance": {
    "synthetic": true,
    "network": {
      "id": "snap_01m45nmn6mfey8z9wvaf31nb9n",
      "dataset": "nvdb",
      "source_date": "2026-10-05",
      "built_at": "2026-10-05T09:17:11.764Z",
      "graph": "snap_01m45nmnryfey8z9x29xcd08tq",
      "profile": "walk",
      "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-05"
      }
    ]
  }
}

Each origin is answered in the order sent, with a status of its own, so one bad address never costs the others their answers. Each result is one home to one destination, with its destination_id. walk is the shortest way on foot, car_shortest the shortest legal road distance by car, and car_fastest the quickest way by car; each gives distance_m along the roads and duration_s, free-flow seconds (5 km/h on foot, the posted limits by car, no traffic).

Send the facts you need as facts, and each result's facts states NVDB's facts about its route: fast_road, the metres along roads of 70 km/h or more; unlit_outside_built_up, the metres outside built-up areas that are not on a lit path; crossings_without_refuge, crossings of roads of 60 km/h or more without a refuge; and traffic_volume, the traffic (ÅDT). It is not a verdict on whether the route is safe.

Store each distance with its profile, its status and the answer's provenance.network: the network snapshot's id and its NVDB date. That documents and dates the distance with the road network it was computed on.

Send the same homes to POST /v1/nearest with kind: "bus_stop" to get each one's nearest bus stops on foot, and send avoid to /v1/distances to keep off stretches you name. POST /v1/route answers the route itself for one pair of points, as segments to draw on a map, each with its road reference and the facts you ask for.

Never send people with skyddade personuppgifter (protected identities). Kartpunkt never logs or stores what you send: about a call it keeps only the key, the operation, the status, the response time and counts.

Road distances and routes count in calculations under Routes & distances: one per route or trace, one per origin per destination of a distance call, one per reach area, one per point of a nearest call and one per stop or shipment of an optimization or a plan check; a matrix counts half its cells, at most ten per point of the longer list. Utvecklare has 2,000 calculations a month on test keys, Bas includes 5,000 and Pro 50,000; the add-on gives 50,000 more on Bas or Pro. 200 origins, each to three depots, are 600 calculations as distances with road facts and 300 as a matrix. All prices are in Swedish kronor, excl. VAT.

Create a test key on your account page (the account pages are in Swedish), read how to start, or see all plans.