Kartpunkt
EnglishSkapa testnyckel
Exempel

Planera nästa läsårs skolbussar – på kommunens egna regler.

Dagens tidtabell, kommunens riktlinjer för skolskjuts och samma elever, räknade på Trafikverkets vägnät med Kartpunkts API. För den som planerar skolskjuts i en kommun, och för utvecklarna hos leverantörerna som bygger verktygen.

1–3 färre fordon
33 % av dagens, för samma elever under samma regler.
21–26 % färre km
med elever ombord per dag, det avtalet betalar för.
−0,7 till +6,6 min
restid i snitt per elev och resa: kortare för några, längre för andra. Det står nedan.

Spannen gäller exemplets två områden, ett skolområde och hela kommunen, morgon och eftermiddag. Med er tidtabell och era regler blir siffrorna andra.

Kommunens regler, förberäknatNätversion snap_01m4twhhp1fvmv2fbzba4mk01y

Dagens tidtabell som data

Kommunens turer i dag, morgonen: vilken buss som kör, när, vilka hållplatser och skolor den når och hur många elever den har med sig. Samma tabell som i avtalet, men som data som går att räkna på.

Turer

5

Fordon

2

Elever

95

Km med elever

108,5

{
  "tur": "tur-01",
  "namn": "Morgon 07:11, Åsens skola",
  "buss": "Buss 1",
  "start": "07:11",
  "slut": "07:50",
  "elever": 24,
  "km_med_elever": 37.1,
  "besök": [
    {
      "plats": "h28",
      "typ": "hållplats",
      "tid": "07:11",
      "på": 2,
      "av": 0
    },
    {
      "plats": "h10",
      "typ": "hållplats",
      "tid": "07:13",
      "på": 1,
      "av": 0
    },
    {
      "plats": "h03",
      "typ": "hållplats",
      "tid": "07:15",
      "på": 3,
      "av": 0
    },
    "… 9 till",
    {
      "plats": "asen",
      "typ": "skola",
      "tid": "07:50",
      "på": 0,
      "av": 24
    }
  ]
}
En tur ur dagens tidtabell, morgonen, som sidan läser den. Hela tidtabellen har 10 turer.

Kommunens regler som parametrar

Riktlinjerna för skolskjuts med kommunens egna ord: hur länge en elev får åka och vänta, per årskurs, och om regeln säger bör eller ska. Varje regel blir en parameter i anropet, med sin källa.

Exempelkommun (fiktiv)
Version 2026-1, beslutad 20 maj 2026

Förskoleklass–åk 6

  • Längsta restid per resa
    ska45 min
    Restiden för elever i förskoleklass till och med årskurs 6 ska inte överstiga 45 minuter per resa.
    Källa: Riktlinjer för skolskjuts, Exempelkommun (påhittade), avsnitt 4.1
  • Längsta väntetid före skolstart
    bör15 min
    Väntetiden före skoldagens början bör inte överstiga 15 minuter.
    Källa: Riktlinjer för skolskjuts, Exempelkommun (påhittade), avsnitt 4.2
  • Längsta väntetid efter skolslut
    bör15 min
    Väntetiden efter skoldagens slut bör inte överstiga 15 minuter.
    Källa: Riktlinjer för skolskjuts, Exempelkommun (påhittade), avsnitt 4.2
  • Längsta väntetid vid byteRäknas inte än
    bör10 min
    Vid byte mellan turer bör väntetiden inte överstiga 10 minuter.
    Källa: Riktlinjer för skolskjuts, Exempelkommun (påhittade), avsnitt 4.3

Åk 7–9

  • Längsta restid per resa
    bör55 min
    Restiden för elever i årskurs 7–9 bör inte överstiga 55 minuter per resa.
    Källa: Riktlinjer för skolskjuts, Exempelkommun (påhittade), avsnitt 4.1
  • Längsta väntetid före skolstart
    bör30 min
    Väntetiden före skoldagens början bör inte överstiga 30 minuter.
    Källa: Riktlinjer för skolskjuts, Exempelkommun (påhittade), avsnitt 4.2
  • Längsta väntetid efter skolslut
    bör30 min
    Väntetiden efter skoldagens slut bör inte överstiga 30 minuter.
    Källa: Riktlinjer för skolskjuts, Exempelkommun (påhittade), avsnitt 4.2
  • Längsta väntetid vid byteRäknas inte än
    bör15 min
    Vid byte mellan turer bör väntetiden inte överstiga 15 minuter.
    Källa: Riktlinjer för skolskjuts, Exempelkommun (påhittade), avsnitt 4.3
  • Sammanlagd väntetid per veckaRäknas inte än
    bör120 min/vecka
    Den sammanlagda väntetiden bör inte överstiga två timmar per vecka.
    Källa: Riktlinjer för skolskjuts, Exempelkommun (påhittade), avsnitt 4.2
Prova andra värden
Förinställda värden, räknade på riktigt. * är kommunens.

Årskurs F–6

Längsta restid, åk F–6 (min)
Längsta väntetid, åk F–6 (min)

Årskurs 7–9

Längsta restid, åk 7–9 (min)
Längsta väntetid, åk 7–9 (min)
Högst ombord per buss

Sidan skickar bara vilket scenario, vilken del av dagen och vilka av värdena ovan du valt. Nya kombinationer är begränsade till några i timmen.

Kontroll av dagens plan

Dagens tidtabell skickad som den är till /v1/optimize/check, morgonen: håller den reglerna? Varje avvikelse har en kod, hur bindande regeln är och vilka elever den gäller.

Dagens plan håller reglerna morgonen: 95 elever på 5 turer.

I dag, morgonen
Planen håller reglerna och tar med alla elever.

Inga avvikelser

Nästa läsår

Samma elever, samma skoltider och samma regler, skickade till /v1/optimize: vilken buss som hämtar vem, i vilken ordning och när, med så få fordon som möjligt. Den nya planen kontrolleras sedan mot reglerna på samma sätt som dagens.

Fordon i dag

3 fordon

2 på morgonen, 3 på eftermiddagen. Eftermiddagen binder.

Fordon med ny plan

2 fordon

2 på morgonen, 2 på eftermiddagen. Morgonen och eftermiddagen binder: dagen behöver så många fordon som den mest krävande delen.

Vad det betyder för eleverna

Färre bussar betyder oftast längre resor för några. Diagrammet visar hur många elever som åker hur länge, i dag och med den nya planen, med kommunens gränser utritade.

Restid i snitt, morgonen

+6,6 min

14,5 min i dag, 21,1 min med ny plan.

Längsta restid i dag

38,3 min

Längsta restid, ny plan

42,2 min

Elever per restid i minuter. Idag: längst 38,3 min, i snitt 14,5 min. Ny plan: längst 42,2 min, i snitt 21,1 min. Längsta restid: Förskoleklass–åk 6 ska 45 min; Åk 7–9 bör 55 min.
Det går inte utan att någon elev får det sämre
Det går inte: om ingen elev får längre restid eller väntetid än i dag blir 20 elever utan plats eller över en gräns.

Hur fulla bussarna får bli

Antalet fordon beror på hur många elever en buss får ha med sig samtidigt. Bussarna har 55 platser; med ett lägre tak behövs fler turer och ibland fler fordon. Samma elever i varje rad.

2 fordon

i den nya planen med högst 55 elever ombord. Taket är bussens 55 platser. Välj ett annat tak under Prova andra värden.

Tabellen är räknad med kommunens egna regler.

Två utfall

Det finns två sätt att räkna vad planen är värd, och de ska inte läggas ihop. Kronor i dagens avtal är vad kommunen betalar per km och hållplats med det avtal som gäller. Fordon inför nästa upphandling är hur många bussar nästa avtal behöver.

Kronor i dagens avtal
Per läsår, med avtalets pris per km och hållplats
1 253 120 kr933 432 kr
−319 688 kr per läsår
Km med elever per dag
219,7 → 161,6
Hållplatser per dag
74 → 60
Fordon inför nästa upphandling
Flest fordon samtidigt under dagen
3 fordon2 fordon
−1 fordon−650 000 kr per år

Kronorna räknar med ett antaget pris per fordon och år: 650 000 kr.

Idag binder eftermiddagen; ny plan binder morgonen och eftermiddagen.

Fordon om bussen får ta högst så många elever
  • högst 25: 2 fordon
  • högst 35: 2 fordon
  • högst 45: 2 fordon
  • högst 55: 2 fordon

Avtalets pris i exemplet: 28 kr per km med elever och 12 kr per hållplats, 178 skoldagar per läsår. Fordonens kronor räknar med ett antaget pris på 650 000 kr per fordon och år, inte ett anbud.

Från plan till upphandling

Planen som behov, i den form en upphandling anger det: antal fordon, turer och km per dag, med tidtabellen. Kopiera den som text och tabell till ert underlag.

Upphandlingsunderlag
Behovet som en upphandling anger det, med tidtabellen

Behov av 2 bussar, med 2 morgonturer om sammanlagt 65 kilometer per dag, med 4 eftermiddagsturer om sammanlagt 97 km per dag.

Fiktiv kommun på verkliga vägar (NVDB, 6 oktober 2026). Orter, skolor, hållplatser, elever och tidtabell är påhittade.

Nätversion
snap_01m4twhhp1fvmv2fbzba4mk01y
NVDB-datum
2026-10-06
Regler
Exempelkommun (fiktiv), version 2026-1 (2026-05-20)
Dag
2026-11-02

Vägdata från NVDB, Trafikverket, CC0 1.0

Så gör man

Allt ovan är vanliga anrop till Kartpunkts API med en nyckel, från en server. API:et vet inget om elever eller årskurser: varje hållplats elever till en skola i en årskurs blir en sändning med så många platser, restiden blir max_ride_s och väntetiden ett tidsfönster vid skolan. Sidan anropar API:et från sin egen server; webbläsaren skickar bara vilket scenario och vilka förinställda värden du valt.

  • POST /v1/optimize/checkcheckPlan

    Dagens tidtabell mot reglerna, och den nya planen en gång till: avvikelser med kod, och elever som inte får plats eller inte hinner fram.

  • POST /v1/optimizeoptimizeRoutes

    Den nya planen: vilken buss som hämtar vem och när, med så få fordon som möjligt först (vehicles_then_duration).

  • POST /v1/jobssubmitJob

    En plan som är större än ett direktanrop tar, som jobb, med samma indata under operation.

  • GET /v1/jobs/{id}getJob

    Jobbets status och förlopp, och planen i result när det är klart.

  • GET /v1/networkslistNetworks

    Vilken nätversion som gäller nu; varje svar säger vilken det räknades på, och samma id ger samma svar medan den nätversionen används.

Nyckeln och anropen från er kod står på /utvecklare, varje operation med scheman i API-dokumentationen och gränserna i llms.txt.

Vad siffrorna inte säger

Exemplet räknar på det här, och inte på mer.

Antaganden
Varje siffra på sidan vilar på dem
  • Kommunen, skolorna, hållplatserna, eleverna och tidtabellen är påhittade. Vägarna, avstånden och körtiderna är NVDB:s, för en buss på 13 m och 18 ton.
  • Avtalet betalar 28 kr per km med elever ombord och 12 kr per hållplats, 178 skoldagar per läsår. Km utan elever (från depån, mellan turer) räknas inte, som i många avtal.
  • Fordonens kronor räknar med ett antaget pris på 650 000 kr per fordon och år. Det är ett antagande, inte ett anbud.
  • Samma elever varje dag, samma skoltider. Elever som byter buss, åker kollektivt eller med taxi planeras inte här; de räknas och sägs.
  • Sammanlagd väntetid per vecka och res- och väntetid tillsammans går att skriva som regler men räknas inte än.
  • Planen är bättre än dagens på det som visas, inte bevisat bäst. Trafik, väder och förare finns inte i den.
  • Att ingen elev får det sämre än i dag går inte att kombinera med färre fordon i exemplet; sidan säger hur många elever det gäller i stället för att dölja det.

Med er tidtabell och era regler

Planerar ni skolskjuts eller bygger ni verktygen för den? Samma anrop fungerar med era hållplatser, skolor och riktlinjer. Börja med en testnyckel, eller hör av er så går vi igenom ert underlag.

Skapa testnyckelKontakta oss