• Logga in och få automatisk översyn på resor du köpt som inloggad på sj.se
• Val att bevaka resor hämtade via beställningsnummer eller telefonnummer
• Val att få push-notiser förändringar i dina bevakade resor vid inställt tåg, ändrad avgångstid och byte av spår
• Som medlem i SJ Prio ser du ditt medlemsnummer, nivå och poäng att använda.

SJ API

SJ har också utökat sitt API med nya metoder för att möjliggöra de nya funktionerna i appen.

• Endpoint: https://sjmg.sj.se/api2/
• Key: E252FEDA2EAA72F0CEBF5E9E432C66BB

API-metoder

Metodanropen dokumenterade nedan är de som jag hittills haft möjlighet att se över. Håll utkik efter fler uppdateringar genom att följa mig på Twitter.

• Register device
• Station timetable
• Train timetable
• Login user
• Customer tickets

Register device

GET deviceRegistration/{token}/{iphone|android}

Exempelfråga:

$ curl https://sjmg.sj.se/api2/deviceRegistration/1/iphone \
    -H "Appkey: E252FEDA2EAA72F0CEBF5E9E432C66BB" \
    -H "Devicetype: iphone" \
    -H "Version: 3"

Get stations

GET stations.json

Exempelfråga:

$ curl "https://sjmg.sj.se/api2/stations.json" \
    -H "Appkey: E252FEDA2EAA72F0CEBF5E9E432C66BB" \
    -H "Devicetype: iphone" \
    -H "Version: 3"

Exempelsvar:

{
    "stations":
    [
        {
            "id": 1,
            "stationName": "Stockholm C",
            "city": "Stockholm C",
            "stationType": "sj"
        },
        …
        {
            "id": 924,
            "stationName": "Stenstorp",
            "city": "Stenstorp",
            "stationType": "sj"
        }
    ]
}

Station timetable

GET stationTimeTable/{id}.json

Exempelfråga:

$ curl https://sjmg.sj.se/api2/stationTimeTable/1.json \
    -H "Appkey: E252FEDA2EAA72F0CEBF5E9E432C66BB" \
    -H "Devicetype: iphone" \
    -H "Version: 3"

Exempelsvar:

{
    "id": 1,
    "stationName": "Stockholm C",
    "city" :"Stockholm C",
    "stationType": "SJ",
    "arrivals":
    [
        {
            "trainNumber": "93",
            "date": "2012-03-23",
            "time":
            {
                "scheduledTime": "2012-03-24T12:05",
                "newTime": "2012-03-24T12:30"
            },
            "track":
            {
                "scheduledTrack": "12",
                "newTrack": ""
            },
            "fromStationName": "Riksgränsen",
            "toStationName": "Stockholm C",
            "stationNames":
            [
                "Riksgränsen",
                "Katterjåkk",
                "Björkliden",
                "Abisko turiststation",
                "Abisko Östra",
                "Kiruna C",
                "Gällivare",
                "Murjek",
                "Boden C",
                "Älvsbyn",
                "Jörn",
                "Bastuträsk",
                "Umeå C",
                "Örnsköldsvik C",
                "Mellansel",
                "Långsele",
                "Bräcke",
                "Ånge",
                "Sundsvall C",
                "Söderhamn",
                "Gävle C",
                "Uppsala C",
                "Arlanda C",
                "Stockholm C"
            ],
            "isPassed": true,
            "cancelled": false
        },
        …
        {
            "trainNumber": "91",
            "date": "2012-03-24",
            "time":
            {
                "scheduledTime": "2012-03-25T06:42",
                "newTime": ""
            },
            "track":
            {
                "scheduledTrack": "12",
                "newTrack": ""
            },
            "fromStationName": "Luleå C",
            "toStationName": "Göteborg C",
            "stationNames":
            [
                "Luleå C",
                "Sunderby sjukhus",
                "Boden C",
                "Älvsbyn",
                "Jörn",
                "Bastuträsk",
                "Vindeln",
                "Umeå C",
                "Örnsköldsvik C",
                "Mellansel",
                "Långsele",
                "Ånge",
                "Ljusdal",
                "Bollnäs",
                "Gävle C",
                "Uppsala C",
                "Arlanda C",
                "Stockholm C",
                "Hallsberg",
                "Skövde C",
                "Herrljunga",
                "Göteborg C"
            ],
            "isPassed": false,
            "cancelled":false
        }
    ],
    "departures":
    [
        {
            "trainNumber": "633",
            "date": "2012-03-24",
            "time":
            {
                "scheduledTime": "2012-03-24T12:21",
                "newTime": "2012-03-24T12:22"
            },
            "track":
            {
                "scheduledTrack": "10",
                "newTrack": ""
            },
            "fromStationName": "Stockholm C",
            "toStationName": "Karlstad C",
            "stationNames":
            [
                "Stockholm C",
                "Södertälje Syd",
                "Katrineholm C",
                "Hallsberg",
                "Degerfors",
                "Kristinehamn",
                "Karlstad C"
            ],
            "isPassed": true,
            "cancelled": false
        },
        …
        {
            "trainNumber": "808",
            "date": "2012-03-25",
            "time":
            {
                "scheduledTime": "2012-03-25T07:11",
                "newTime": ""
            },
            "track":
            {
                "scheduledTrack": "3",
                "newTrack": ""
            },
            "fromStationName": "Stockholm C",
            "toStationName": "Uppsala C",
            "stationNames":
            [
                "Stockholm C",
                "Märsta",
                "Knivsta",
                "Uppsala C"
            ],
            "isPassed": false,
            "cancelled": false
        }
    ]
}

Train timetable

GET trainTimeTable/{train}/{Y-m-d}

Exempelfråga:

$ curl https://sjmg.sj.se/api2/trainTimeTable/8456/2012-03-24 \
    -H "Appkey: E252FEDA2EAA72F0CEBF5E9E432C66BB" \
    -H "Devicetype: iphone" \
    -H "Version: 3"

Exempelsvar:

{
    "trainNumber": "8456",
    "date": "2012-03-24",
    "trainType": "",
    "fromStationName": "Upplands Väsby",
    "toStationName": "Uppsala C",
    "trainPosition":
    {
        "latitude": 59.52166666666667,
        "longitude": 17.899444444444445,
        "timestamp": ""
    },
    "stops":
    [
        {
            "station":
            {
                "id": 782,
                "stationName": "Upplands Väsby",
                "city": "Upplands Väsby",
                "stationType": "SJ"
            },
            "arrivalTime":
            {
                "scheduledTime": "",
                "newTime": ""
            },
            "departureTime":
            {
                "scheduledTime": "2012-03-24T19:20",
                "newTime": ""
            },
            "track":
            {
                "scheduledTrack": "32a",
                "newTrack":""
            },
            "isCancelled": false,
            "isPassed": false
        },
        …
        {
            "station":
            {
                "id": 5,
                "stationName": "Uppsala C",
                "city": "Uppsala C",
                "stationType": "SJ"
            },
            "arrivalTime":
            {
                "scheduledTime": "2012-03-24T19:47",
                "newTime": ""
            },
            "departureTime":
            {
                "scheduledTime": "",
                "newTime": ""
            },
            "track":
            {
                "scheduledTrack": "3",
                "newTrack": ""
            },
            "isCancelled": false,
            "isPassed": false
        }
    ],
    "nextStop": 0,
    "isSubscribeable": true
}

Login user

GET login?username={username}&password={password}&deviceID={id}&deviceType={iphone|android}

Exempelfråga:

$ curl "https://sjmg.sj.se/api2/login?username={username}&password={password}&deviceID=1&deviceType={iphone|android}" \
    -H "Appkey: E252FEDA2EAA72F0CEBF5E9E432C66BB" \
    -H "Devicetype: iphone" \
    -H "Version: 3"

Exempelsvar:

{
    "customerID": "censurerad",
    "firstName": "ERIK",
    "lastName": "PETTERSSON",
    "hash": "censurerad",
    "sjPrioCards":
    [
        {
            "cardNo": "censurerad",
            "priority": "Svart",
            "points": 6998
        }
    ]
}

Customer tickets

GET customerTickets/{customerID}/{deviceID}/{iphone|android}?hash={hash}

Exempelfråga:

$ curl https://sjmg.sj.se/api2/customerTickets/{customerID}/{deviceID}/iphone?hash={hash} \
-H "Appkey: E252FEDA2EAA72F0CEBF5E9E432C66BB" \
-H "Devicetype: iphone" \
-H "Version: 3"

Exempelsvar:

[
    {
        "ticketID": "censurerad0001",
        "orderID": "censurerad",
        "travellerID": "censurerad",
        "itineraries":
        [
            {
                "trainNumber": "85",
                "trainType": "74",
                "departureStation": "Gävle C",
                "departureTime": "2012-03-25T21:00",
                "arrivalStation": "Stockholm C",
                "arrivalTime": "2012-03-25T22:35",
                "isSubscribeable": true,
                "subscriptionID": "censurerad",
                "stops":
                [
                    {
                        "station":
                        {
                            "id": 210,
                            "stationName": "Gävle C",
                            "city": "Gävle C",
                            "stationType": "SJ"
                        },
                        "arrivalTime":
                        {
                            "scheduledTime": "2012-03-25T20:50",
                            "newTime": ""
                        },
                        "departureTime":
                        {
                            "scheduledTime": "2012-03-25T21:00",
                            "newTime": ""
                        },
                        "track":
                        {
                            "scheduledTrack": "1",
                            "newTrack": ""
                        },
                        "isCancelled": false,
                        "isPassed": false
                    },
                    –
                    {
                        "station":
                        {
                            "id": 1,
                            "stationName": "Stockholm C",
                            "city": "Stockholm C",
                            "stationType": "SJ"
                        },
                        "arrivalTime":
                        {
                            "scheduledTime": "2012-03-25T22:33",
                            "newTime": ""
                        },
                        "departureTime":
                        {
                            "scheduledTime": "",
                            "newTime": ""
                        },
                        "track":
                        {
                            "scheduledTrack": "4",
                            "newTrack": ""
                        },
                        "isCancelled": false,
                        "isPassed": false
                    }
                ],
                "nextStop":0,
                "trainPosition":
                {
                    "latitude":63.351274,
                    "longitude":14.38646,
                    "timestamp": "2012-03-25T16:47"
                }
            }
        ]
    }
]

SJ skickar användarens position till tredje part

Något som jag reagerade på är att SJ utan användarens medgivande skickar vidare dess position till tredje part. För kännedom gäller det tjänsten Xtify. Om vi ser till Apples riktlinjer för iOS applikationer måste användaren ge sitt medgivande vid förmedling, användning och nyttjande av positionsinformation. I annat fall hävdar Apple att applikationen inte kommer bli godkänd och synas i App Store. Men den här gången blev det fel.

Fler som skrivit om uppdateringen av Min resa

• SJ uppgraderar kostnadsfri mobilapp

Jag var på plats med Fredrik, Johan, Hardy och Adam i form av #TeamFoo. Vi utvecklade och lanserade ett API för crowdsourcing av (mikro)störningar i kollektivtrafik, Avvikelse.

Vinnare på TravelHack 2011

Själva tävlingsmomentet var uppdelat i fem olika delar.

Best Prototype Award

Den enligt juryn bästa prototypen var GREEN bITs Commutify som uppmuntrar till klimatsmart resande. Genom att på ett roligt sätt utmana sig själv, vänner eller kändisar i vardagsresande och samtidigt belönas resenären med tillgång till rabatterade erbjudanden, ökad hälsa och bättre en miljö.

Best Team Award

Juryns val av team vid bedömning av gruppdynamik, produktivitet och den bästa laginsatsen var Team VISIT för utveckling av tjänsten Buy Nearby.

The Business Region Göteborg Entrepreneur Award

Det lag juryn bedömde att bäst visa en tydlig affärsidé var också TeamVISIT med sin prototyp Buy Nearby. En tjänst för dig som letar nytt boende och vill ha kort restid men ändå åka kollektivt och hållbart.

Developer Recognition Award

Den prototyp eller tjänst som bäst agerar som tröskelsänkare och möjliggör distribuerad utveckling avgjordes av de deltagande lagen i form av omröstning. Flest röster mottog vårt API, Avvikelse. Stort tack från oss i #TeamFoo och vi hoppas ni också får nytta av detta i vidare utveckling.

CommuteGreener Award

Tjänsten som bäst enligt juryn mötte kriterierna för att vara affärs- och ingenjörsmässig samt bemötte en efterfrågan blev slutligen Code Monkeys Find me a ride.

Vad TravelHack 2011 lämnat efter sig

Åter igen, ett stort tack till arrangörer, inblandade samt deltagare för en lång och inspirerande helg. Jag hoppas att de skapelser som under TravelHack 2011 såg dagens ljus blir något som resenärer snart kan nyttja för ett hållbart vardagsresande.

• Presentationer från TravelHack
• Video från TravelHack, tack Jocke!

Andra som skrivit om TravelHack 2011

• Rapport från TravelHack av Daniel Rudmark, Mashup.se
• West Coast Travel Hack 2011 av Elias Arnestrand, Trafiklab
• Direkt från Travelhack av Eva Wieselgren, GP
• West Coast Travel Hack 2011 avgjort av Erik-Wilhelm Graef Behm, Businss Region Göteborg
• TravelHack 2011 – mobila tjänster för hållbara resmönster, Göteborgs stad
• Travelhack och test med bambuser, Joakim Jardenberg
• West Coast TravelHack 2011, Svensk kollektivtrafik
• Travelhack i Big Brother-version, Kreativ stuga
• West Coast TravelHack, Göteborgs universitet

Detta innebär att vi i Sverige nu enkelt kan planera resor med kollektivtrafik som tar oss från exempelvis Göteborg till Malmö, via Google Maps eller applikationer som Maps på iPhone eller iPad.

Google Transit började 2005 som ett sidoprojekt och var till 2007 en del av Labs. Idag omfattar tjänsten kollektivtrafik för flera hundra städer runt om i världen.

“Är lite besviken att jag inte blev kallad till presentationen, uppmanar Google & Samtrafiken till bättring på den punkten.”

Inga tidtabeller i realtid

I samarbete med Samtrafiken har Google via GTFS tillgängliggjort Transit i Sverige. Dock är detta endast stolptidtabeller, dvs. att förändringar och förseningar (ännu) inte omfattas. Jag ser gärna att de även implementerar GTFS-realtime för att snabbt och korrekt nå ut med kollektivtrafikinformation till resenärer.

Möjligtvis mer öppen data

Den data som Samtrafiken tillhandahåller Google är ännu inte publik, vad jag kan se, i GTFS:s officiella lista.

Andra som skrivit om Google kollektivtrafik för Sverige

• Google lanserar Transit för Maps i Sverige, Swedroid
• Googles nya gratistjänst – tidtabeller av Fredrik Sjöshult, Expressen
• Google Transit nu i Sverige – kollektivtrafik i Google Maps, Google Sweden Press Blog
• Google och Samtrafiken visar kollektivtrafiken i Google Maps av Google, Mynewsdesk

SJ exponerade personlig data

Om du tittar lite närmare i svarsdatan från SJ:s API nedan, närmare bestämt i värdefältet för deviceID. Detta innehåller den privata, unika identifieraren för den enhet du använder när en ny bevakning skapas. SJ exponerar alltså denna data, om alla som valt att bevaka tåg via deras app.

Detta är väldigt kritiskt data, som varken Google eller Apple tillåter att utvecklare tillgängliggör. Med informationen, som Theodor nämner i sitt inlägg, är det exempelvis möjligt att skapa, ändra och ta bort andra användares bevakningar.

Jag uppmanar alla användare att ta bort alla sina bevakningar som skapats via appen, tills dess att SJ har säkrat sitt API.

SJ har bemött kritiken via Twitter

“Nu har vi svar. Det finns ingen personlig info i appen, inte ens UD ID. Det vi kallar device ID är endast kopplat till appen. Trots det ska vi göra om den så den blir krypterad så fort som möjligt.” — @SJ_AB

Intressant svar. Inget är fel, men det ska ändå åtgärdas? Detta är fel. Appen skickar UDID i klartext till SJ:s API. Theodor har tydliggjort detta med enkla skärmdumpar i sitt inlägg. Därefter var det dags att bekänna.

“Vi var övertygade om att vi hade rätt. Nu undersöker vi vad detta beror på och ska åtgärda snarast.” — @SJ_AB

Jättebra agerande av marknadsavdelningen tycker jag. Nu hoppas vi bara att SJ först kommunicerar problemet med sina användare och sedan stänger in användardatan snarast.

Uppdatering: SJ har nu säkrat den mest kritiska bristen i sitt API. Men fortfarande skickas iOS-enheters UDID i klartext till och från appen.

• Endpoint: http://sjmg.sj.se/api/
• Format: JSON

Metoder (deprecated)

Första versionen av SJ API fungerar inte längre som dokumenterat nedan. Se dokumentation av SJ API 2.

• Get stations
• Get station
• Get station timetable
• Get train
• Get train timetable
• Get subscriptions
• New subscription

Get stations

GET /stations.json
Returnerar alla stationer. Exempel för /stations.json:

{
    "stations":
    [
        {
            "id": 1,
            "stationName": "Stockholm C",
            "city": "Stockholm C",
            "stationType": "sj"
        },
        …
        {
            "id": 924,
            "stationName": "Stenstorp",
            "city": "Stenstorp",
            "stationType": "sj"
        }
    ]
}

Get station

GET /station/#{id}.json
Returnerar given station. Exempel för /station/1.json:

{
    "id": 1,
    "stationName": "Stockholm C",
    "city": "Stockholm C",
    "stationType": "SJ"
}

Get station timetable

GET /stationTimeTable/#{id}.json
Returnerar tidtabell för given station. Exempel för /stationTimeTable/1.json:

{
    "id": 1,
    "stationName": "Stockholm C",
    "city": "Stockholm C",
    "stationType": "SJ",
    "arrivals":
        [
        {
            "trainNumber": "11",
            "time":
            {
                "scheduledTime": "2011-09-29T08:16",
                "newTime": "2011-09-29T08:18"
            },
            "track":
            {
                "scheduledTrack": "7",
                "newTrack": ""
            },
            "fromStationName": "Falun C",
            "toStationName": "Stockholm C",
            "stationNames":
            [
                "Falun C",
                "Borlänge C",
                "Säter",
                "Hedemora",
                "Avesta Krylbo",
                "Sala",
                "Uppsala C",
                "Arlanda C",
                "Stockholm C"
            ],
            "cancelled": false
        },
        …
        {
            "trainNumber": "861",
            "time":
            {
                "scheduledTime": "2011-09-29T19:49",
                "newTime":""
            },
            "track":
            {
                "scheduledTrack": "3",
                "newTrack": ""
            },
            "fromStationName": "Uppsala C",
            "toStationName": "Stockholm C",
            "stationNames":
            [
                "Uppsala C",
                "Knivsta",
                "Märsta",
                "Stockholm C"
            ],
            "cancelled": false
        },
        …
        {
            "trainNumber": "10759",
            "time":
            {
                "scheduledTime": "2011-09-29T20:00",
                "newTime": ""
            },
            "track":
            {
                "scheduledTrack": "7",
                "newTrack": ""
            },
            "fromStationName": "Örebro C",
            "toStationName": "Stockholm C",
            "stationNames":
            [
                "Örebro C",
                "Arboga",
                "Köping",
                "Västerås C",
                "Enköping",
                "Bålsta",
                "Sundbyberg",
                "Stockholm C"
            ],
            "cancelled": false
        }
    ],
    "departures":
    [
        {
            "trainNumber": "425",
            "time":
            {
                "scheduledTime": "2011-09-29T08:10",
                "newTime": ""
            },
            "track":
            {
                "scheduledTrack": "10",
                "newTrack": ""
            },
            "fromStationName": "Stockholm C",
            "toStationName": "Göteborg C",
            "stationNames":
            [
                "Stockholm C",
                "Södertälje Syd",
                "Katrineholm C",
                "Skövde C",
                "Alingsås",
                "Göteborg C"
            ],
            "cancelled":false
        },
        …
        {
            "trainNumber": "860",
            "time":
            {
                "scheduledTime": "2011-09-29T20:11",
                "newTime": ""
            },
            "track":
            {
                "scheduledTrack": "3",
                "newTrack": ""
            },
            "fromStationName": "Stockholm C",
            "toStationName": "Uppsala C",
            "stationNames":
            [
                "Stockholm C",
                "Märsta",
                "Knivsta",
                "Uppsala C"
            ],
            "cancelled":false
        }
    ]
}

Get train

GET /train/#{nr}.json
Returnerar position för givet tågnummer. Exempel för /train/220.json:

{
    "trainNumber": "220",
    "trainType": "",
    "fromStationName": "Linköping C",
    "toStationName": "Stockholm C",
    "trainPosition":
    {
        "latitude": 59.154098,
        "longitude": 17.762635,
        "timestamp": "2011-10-03T08:09"
    }
}

Get train timetable

GET /trainTimeTable/#{nr}.json
Returnerar stationer och position för givet tågnummer. Exempel för /trainTimeTable/538.json:

{
    "trainNumber": "538",
    "trainType": "",
    "fromStationName": "Malmö C",
    "toStationName": "Stockholm C",
    "trainPosition":
    {
        "latitude": 58.417037,
        "longitude": 15.624342,
        "timestamp": "2011-09-28T17:52"
    },
    "stops":
    [
        {
            "station":
            {
                "id": 3,
                "stationName": "Malmö C",
                "city": "Malmö C",
                "stationType": "SJ"
            },
            "arrivalTime":
            {
                "scheduledTime": "2011-09-28T13:09",
                "newTime":""
            },
            "departureTime":
            {
                "scheduledTime": "2011-09-28T13:17",
                "newTime": "2011-09-28T13:37"
            },
            "track":
            {
                "scheduledTrack": "6",
                "newTrack": ""
            },
            "isCancelled" :true,
            "isPassed":true
        },
        …
        {
            "station":
            {
                "id": 1,
                "stationName": "Stockholm C",
                "city": "Stockholm C",
                "stationType": "SJ"
            },
            "arrivalTime":
            {
                "scheduledTime": "2011-09-28T17:39",
                "newTime": "2011-09-28T19:30"
            },
            "departureTime":
            {
                "scheduledTime": "",
                "newTime": ""
            },
            "track":
            {
                "scheduledTrack": "10",
                "newTrack": ""
            },
            "isCancelled": false,
            "isPassed": false
        }
    ],
    "nextStop":7
}

Get subscriptions

GET /subscriptions.json
Returnerade tidigare alla bevakningar. Exempel för /subscriptions.json:

{
    "subscriptionsDTO":
    [
        {
            "id": "censurerad",
            "deviceID": "censurerad",
            "deviceType": "Android",
            "fromStationName": "Stockholm C",
            "toStationName": "Malmö C",
            "fromStationID": 1,
            "toStationID": 3,
            "enabled": true,
            "fromTime": "19:25",
            "toTime": "22:28",
            "weekdays":
            [
                "Tuesday",
                "Friday"
            ]
        },
        …
        {
            "id": "censurerad",
            "deviceID": "censurerad",
            "deviceType": "Android",
            "fromStationName": "Västerås C",
            "toStationName": "Katrineholm C",
            "fromStationID": 99,
            "toStationID": 166,
            "enabled": true,
            "fromTime": "06:55",
            "toTime": "08:00",
            "weekdays":
            [
                "Thursday",
                "Monday",
                "Tuesday",
                "Wednesday"
            ]
        }
    ]
}

New subscription

POST /subscriptions.json
Skapar ny bevakning. Exempelfrågan:

{
    "enabled":true,
    "deviceType": "iphone",
    "weekdays":
    [
        "Thursday"
    ],
    "deviceID": "censurerad",
    "toStationName": "Uppsala C",
    "fromStationName": "Stockholm C",
    "fromStationID": 1,
    "toStationID": 5,
    "fromTime": "10:41",
    "toTime": "11:41"
}

ger svaret:

{
    "id": "censurerad",
    "deviceID": "censurerad",
    "deviceType": "iphone",
    "fromStationName": "Stockholm C",
    "toStationName": "Uppsala C",
    "fromStationID": 1,
    "toStationID": 5,
    "enabled": true,
    "fromTime": "10:41",
    "toTime": "11:41",
    "weekdays":
    [
        "Thursday"
    ]
}

Andra som skrivit om SJ:s API

• API Måndag – Trafikverket, SJ, Bredbandskollen och E-delegationen av Andreas Krohn, Mashup.se
• SJ läckte info om användare av Sujay Dutt, DN
• SJs app läcker användardata av Ludvig Mjöbring, Computer Sweden
• SJ släppte app – som läckte telefonens identitet av Lisa Röstlund, Aftonbladet
• SJs app läcker resenärsinformation av Theodor Storm
• SJ läcker info om användare av Roman Pixell, Mobil Business
• SJ:s nya appar läcker information om användare, Travel News
• Fel om Upptåget i SJ-app ”Mina resor”, Upplands Lokaltrafik
• SJ-app läckte info om användare, The Scandinavian Travel Trade Journal
• Ny app från SJ ska underlätta resandet, Androidbloggen

• Endpoint: http://trafikinfo.trafikverket.se/litcore/orion/orionproxy.ashx
• Format: JSON
• Metod: POST
• Språkstöd (locale): SE_sv, US_en

Genom att skriva en egen klient som efterliknar anropen som görs på Trafikverkets webbplats har jag funnit att följande data exponeras.

Stationer

Alla tågstationer (och trafikplatser?).

Exempelfrågan:

<ORIONML version='1.0'>
    <REQUEST plugin='KartDB'>
        <PLUGINML table='Stations'></PLUGINML>
    </REQUEST>
</ORIONML>

ger svaret:

{
    "Stations":
    {
        "Station":
        [
            {
                "CountyNo": "23",
                "EPSG": "3006",
                "EW": "472351",
                "Id": "002ce1da-199e-437c-b9ed-b5a2180869cf",
                "IkonNiva": "trafikplats_hpl",
                "Namn": "Krokom",
                "NS": "7022027",
                "Prognostisering": "true",
                "Signatur": "Krm",
                "Timestamp": "2011-06-14T10:35:49+02:00"
            },
            …
            {
                "CountyNo": "19",
                "EPSG": "3006",
                "EW": "587627",
                "Id": "ffd446fc-94b8-4537-8a9c-9c4aa807c087",
                "IkonNiva": "trafikplats_dp",
                "Namn": "Västerås C",
                "NS": "6608750",
                "Prognostisering": "true",
                "Signatur": "Vå",
                "Timestamp": "2011-06-14T10:35:49+02:00"
            }
        ]
    }
}

Meddelanden

Alla meddelanden som berör tågtrafiken vid olika stationer.

Exempelfrågan:

<ORIONML version="1.0">
    <REQUEST plugin="KartDB" locale="SE_sv">
        <PLUGINML table="Messages" />
    </REQUEST>
</ORIONML>

ger svaret:

{
    "Messages":
    {
        "Message":
        [
            {
                "CountyNo": "23",
                "EPSG": "3006",
                "EW": "418246.5",
                "Header": "banarbete",
                "IconId": "1005",
                "Id": "740326",
                "Message": "5\/10-6\/10 är tåg 10087 tidigarelagd pga av banarbete. Storlien 19.00, Enafors 19.10, Ånn 19.19, Duved 19.37, Åre 19.46, Undersåker 20.00, Järpen 20.11, Krokom 20.45, Östersund 21.00, Bräcke, 21.45 samt Ånge 22.05. En buss kommer att avgå i den gamla tidtabellen och ansluta med tåg 91 i Ånge. För mer information www.sj.se eller 0771-75 75 75.",
                "NS": "7014354",
                "PaverkadePlatser": "Ånn,Du,Åre,Ens,Jpn,Krm,Un,Ös,Gö,Bä,Bf,Stv,Pl,Åg",
                "StartTidpunkt": "2011-10-05T12:39:00+02:00",
                "UppdateradTidpunkt": "2011-09-20T12:42:39+02:00"
            },
            …
            {
                "CountyNo": "2",
                "EPSG": "3006",
                "EW": "670572",
                "Header": "banarbete",
                "IconId": "1005",
                "Id": "687756",
                "Message": "SL Pendeltåg Västerhaninge-Bålsta samt fjärrtåg Stockholm C-Västerås:\u000d\u000a\u000d\u000aEtt banarbete mellan Karlberg och Sundbyberg medför att endast ett av två spår kan trafikeras en kortare sträcka. Då tågen går enligt tidtabell ska inga förseningar uppstå på grund av detta men vid avvikelser så drabbas tåg i båda riktningar.",
                "NS": "6582927.5",
                "PaverkadePlatser": "Sub",
                "StartTidpunkt": "2011-07-18T07:00:00+02:00",
                "UppdateradTidpunkt": "2011-07-15T11:44:19+02:00"
            }
        ] 
    }
}

Tidtabeller

Aktuella tidtabeller vid alla stationer. Det är den här datan som enligt mig är den mest intressanta. Genom att filtrera och sortera går det enkelt att få ut precis den informationen man som resenär söker.

Exempelfrågan:

<ORIONML version="1.0">
    <REQUEST plugin="WOW" locale="SE_sv">
        <PLUGINML table="LpvTrafiklagen" />
    </REQUEST>
</ORIONML>

ger svaret:

{
    "LpvTrafiklagen":
    {
        "Trafiklage":
        [
            {
                "AnnonseradAnkomstTid": "07:27",
                "AnnonseradAvgangTid": "07:27",
                "AnnonseradTidpunktAnkomst": "2011-09-28T07:27:00+02:00",
                "AnnonseradTidpunktAvgang": "2011-09-28T07:27:00+02:00",
                "ArAnkomstTag": "true",
                "ArAvgangTag": "true",
                "InstalldAnkomst": "false",
                "InstalldAvgang": "false",
                "SenasteTidrapportAktivitet": "Ankomst",
                "StatiskInformationTagVisning": "För den här stationen är det inte säkert att information om beräknade förseningar eller inställda tåg visas",
                "StatiskInformationTrafikplatsVisning": "För den här stationen är det inte säkert att information om beräknade förseningar eller inställda tåg visas",
                "TagGrupp": "c8b11e29-86e5-419b-a7d9-00250f9df6cc",
                "TagGruppOrdning": "9",
                "TeknisktTagId": "2710",
                "TrafikInfoAgareMobilUrl": "http:\/\/www.sl.se",
                "TrafikInfoAgareNamn": "Stockholmståg\/SL",
                "TrafikInfoAgareUrl": "http:\/\/www.sl.se",
                "TrafikplatsNamn": "Solna",
                "TrafikplatsPrognos": "false",
                "TrafikplatsSignatur": "So",
                "Utgangsdatum": "2011-09-28T00:00:00+02:00",
                "VisaAnkomst": "true",
                "VisaAvgang": "true"
            },
            …
            {
                "AnmarkningarAnkomst": "SJ Regional",
                "AnmarkningarAvgang": "SJ Regional",
                "AnnonseradAnkomstTid": "07:09",
                "AnnonseradAvgangTid": "07:16",
                "AnnonseradTidpunktAnkomst": "2011-09-28T07:09:00+02:00",
                "AnnonseradTidpunktAvgang": "2011-09-28T07:16:00+02:00",
                "AnnonseratTagId": "218",
                "ArAnkomstTag": "true",
                "ArAvgangTag": "true",
                "Fran": "Linköping,Norrköping,Nyköping",
                "InstalldAnkomst": "false",
                "InstalldAvgang": "false",
                "SenasteTidrapportAktivitet": "Ankomst",
                "SparangivelseAnkomst": "18b",
                "SparangivelseAvgang": "18b",
                "StatiskInformationTrafikplatsVisning": "SL-tåg och Arlanda Express omfattas ej. 

Spåruppgifterna är preliminära och kan snabbt ändras. När du kommer till stationen måste du alltid kontrollera igen vilket spår tåget avgår från, eller ankommer till.",
                "TagGrupp": "c048bf5b-6c99-4a01-ac46-931c2b822023",
                "TagGruppOrdning": "7",
                "TeknisktTagId": "218",
                "Till": "Uppsala,Gävle",
                "TrafikInfoAgareMobilUrl": "http:\/\/www.sj.se\/sj\/jsp\/polopoly.jsp?d=288",
                "TrafikInfoAgareNamn": "SJ",
                "TrafikInfoAgareUrl": "http:\/\/www.sj.se\/sj\/jsp\/polopoly.jsp?d=288",
                "TrafikplatsNamn": "Stockholm C",
                "TrafikplatsPrognos": "true",
                "TrafikplatsSignatur": "Cst",
                "Utgangsdatum": "2011-09-28T00:00:00+02:00",
                "VisaAnkomst": "true",
                "VisaAvgang": "true"
            }
        ]
    }
}

Avvikelser

Information om planerade och pågående vägarbeten samt avvikelser i färjetrafiken.

Exempelfrågan:

<ORIONML version="1.0">
    <REQUEST plugin="TrissData2">
        <PLUGINML table="Deviations" />
    </REQUEST>
</ORIONML>

ger svaret:

{
    "Deviations":
    {
        "Deviation":
        [
            {
                "Active": "true",
                "CountryCode": "se",
                "CountyNo": "2",
                "CreationTime": "2000-03-01T15:44:21+01:00",
                "EW": "721792.22",
                "Geometry": "POINT(721792,22 6619018,33)",
                "Header": "Blidö",
                "IconId": "140",
                "Id": "SE_SRA_TRISSID_1_1030564",
                "ListElements": "Väg 1025",
                "MainNews": "false",
                "MapObject": "false",
                "Message": "Färja.\u000d\u000aVäg 1025 vid Blidöleden, i båda riktningar.",
                "MessageCode": "färja",
                "MessageCodeValue": "ferry",
                "MessageType": "Färjor",
                "MessageTypeValue": "TransitInformation",
                "NS": "6619018.33",
                "Provider": "Trafikverket",
                "RoadCategory": "S",
                "RoadNumberNumeric": "1025",
                "SituationsId": "GUIDf7e0b46d-7376-4c45-8440-b7d7e51a39f5",
                "StartTime": "2011-05-18T18:26:28+02:00",
                "Teaser": "Väg 1025 vid Blidöleden, i båda riktningar.",
                "ValidUntilFurtherNotice": "true",
                "Version": "24",
                "VersionTime": "2011-05-18T18:26:13+02:00",
                "Zone": "Nord"
            },
            …
            {
                "Active": "true",
                "CountryCode": "se",
                "CountyNo": "12",
                "CreationTime": "2011-09-19T11:01:12+02:00",
                "EndTime": "2011-10-21T16:00:00+02:00",
                "EW": "445076.72",
                "Geometry": "POINT(445076,72 6208429,78)",
                "Header": "Härlöv Trafikplats, Kristianstad",
                "IconId": "120",
                "Id": "SE_SRA_TRISSID_2_8079856",
                "ListElements": "E 22",
                "LPV_Message": "På E22 mellan Trafikplats Vilan (38) och Trafikplats Härlöv (37), i riktning mot Hörby görs fräsning och beläggning av ytterfilen vid Trafikplats Härlöv, fram till påfartsramp mot Hässleholm.\u000d\u000aHastighetsbegränsat till 50 km\/h under pågående arbete, övrig tid 70 km\/h.\u000d\u000aRekommenderad hastighet 30 km\/h.",
                "MainNews": "true",
                "MapObject": "true",
                "Message": "Beläggningsarbete.\u000d\u000aE 22 mellan Trafikplats Vilan (38) och Trafikplats Härlöv (37), i riktning mot Hörby.\u000d\u000aPå E22 mellan Trafikplats Vilan (38) och Trafikplats Härlöv (37), i riktning mot Hörby görs fräsning och beläggning av ytterfilen vid Trafikplats Härlöv, fram till påfartsramp mot Hässleholm.\u000d\u000aHastighetsbegränsat till 50 km\/h under pågående arbete, övrig tid 70 km\/h.\u000d\u000aRekommenderad hastighet 30 km\/h.",
                "MessageCode": "beläggningsarbete",
                "MessageCodeValue": "resurfacingWork",
                "MessageType": "Vägarbete",
                "MessageTypeValue": "MaintenanceWorks",
                "NS": "6208429.78",
                "ParentId": "SE_SRA_TRISSID_1_8079856",
                "Provider": "Trafikverket",
                "RoadCategory": "E",
                "RoadNumberNumeric": "22",
                "Severity": "4",
                "SeverityText": "Stor påverkan",
                "SituationsId": "GUID70657dac-a857-4bc2-b1ca-5b5a8ea6be9a",
                "StartTime": "2011-09-26T12:45:00+02:00",
                "Teaser": "E 22 mellan Trafikplats Vilan (38) och Trafikplats Härlöv (37), i riktning mot Hörby.",
                "ValidUntilFurtherNotice": "false",
                "Version": "2",
                "VersionTime": "2011-09-26T12:48:31+02:00",
                "Zone": "NO"
            }
        ]
    }
}

Filtrering & sortering

Då Trafikverket har exponerat ett SQL-gränssnitt är det, som jag nämnder ovan, möjligt att ställa mer komplexa frågor för att filtrera och sortera informationen. Detta är också det stora problemet. I mina exempelfrågor har jag inte valt att göra någon filtrering, vilket resulterar i stora(!) mängder svarsdata. Tillgängliga attribut för PLUGINML:

• filter
• orderby
• selectcolumns
• limit

Om du snabbt vill komma igång med Trafikverkets exponerade API finns:

• API-wrapper för PHP av mig
• Exempelkod för PHP av mig
• Exempelkod för .NET av Rickard Pettersson

Andra som bloggat om Trafikverkets API

• API Måndag – Trafikverket, SJ, Bredbandskollen och E-delegationen av Andreas Krohn, Mashup.se

http://ombord.sj.se/?mac=78:CA:39:BB:15:02&longitude=17.998610&latitude=59.259320…

Genom att göra en mängd frågor fick jag snabbt ihop koordinaterna för tågets färd ut från Stockholm C.

• …?longitude=17.998610&latitude=59.259320…
• …?longitude=17.951672&latitude=59.221930…
• …?longitude=17.928563&latitude=59.203430…
• …?longitude=17.894603&latitude=59.184005…
• …?longitude=17.856482&latitude=59.165897…

Som tidigare nämnt förmedlas inte denna information vidare till varken Trafikverket eller andra intressenter. Däremot presenteras det en enklare karta med tågets position på ombord.sj.se. Efter att ha kikat lite efter resurser som ligger till grund för kartan hittade jag ett API med enklare ombordinformation.

• Endpoint: http://www.ombord.info/api/
• Format: XML eller JSONP

Metoder

Get connectivity

GET /{format}/connectivity/[?callback={function}]
Exempelsvar för /xml/connectivity/:

<?xml version="1.0" encoding="UTF-8"?>
<connectivity>
    <online type="integer">1</online>
    <links type="array">
        <link>
            <index type="integer">2</index>
            <device_type type="string">ethernet</device_type>
            <device_subtype type="string">unavailable</device_subtype>
            <device_state type="string">down</device_state>
            <link_state type="string">disconnected</link_state>
            <rssi type="integer">-1</rssi>
            <technology type="string">unavailable</technology>
            <operator_id type="integer">-1</operator_id>
        </link>
        <link>
            <index type="integer">101</index>
            <device_type type="string">modem</device_type>
            <device_subtype type="string">sierra-8700</device_subtype>
            <device_state type="string">up</device_state>
            <link_state type="string">available</link_state>
            <rssi type="integer">-85</rssi>
            <technology type="string">hspa</technology>
            <operator_id type="integer">24005</operator_id>
            <umts_info>
                <net_status type="integer">1</net_status>
                <lac type="string">0018</lac>
                <cellid type="string">00183689</cellid>
            </umts_info>
        </link>
        <link>
            <index type="integer">103</index>
            <device_type type="string">modem</device_type>
            <device_subtype type="string">sierra-8700</device_subtype>
            <device_state type="string">up</device_state>
            <link_state type="string">available</link_state>
            <rssi type="integer">-78</rssi>
            <technology type="string">dc-hspa+</technology>
            <operator_id type="integer">24004</operator_id>
            <umts_info>
                <net_status type="integer">1</net_status>
                <lac type="string">0502</lac>
                <cellid type="string">04047224</cellid>
            </umts_info>
        </link>
   </links>
</connectivity>

Get position

GET /{format}/position/[?callback={function}]
Exempelsvar för /xml/position/:

<?xml version="1.0" encoding="UTF-8"?>
<position>
    <time type="double">1316243696</time>
    <latitude type="double">59.0026</latitude>
    <longitude type="double">16.269718</longitude>
    <altitude type="double">63.1</altitude>
    <speed type="double">44.556</speed>
    <cmg type="double">257.3</cmg>
    <satellites type="integer">11</satellites>
</position>

Get system

GET /{format}/system/[?callback={function}]
Exempelsvar för /xml/system/:

<?xml version="1.0" encoding="UTF-8"?>
<system>
    <system_id type="integer">1086</system_id>
</system>

Get users

GET /xml/users/[?callback={function}]
Exempelsvar för /xml/users/:

<?xml version="1.0" encoding="UTF-8"?>
<users> 
    <total type="integer">80</total> 
    <online type="integer">34</online> 
</users>

Get user

GET /{format}/user/[?callback={function}]
Exempelsvar för /xml/user/:

<?xml version="1.0" encoding="UTF-8"?>
<user>
    <ip type="string">10.101.1.69</ip>
    <mac type="string">78:CA:39:BB:15:02</mac>
    <online type="integer">12160</online>
    <userclass type="integer">2</userclass>
</user>

General Transit Feed Specification (GTFS)

Datastandarden som är till grund för Google Transit, utvecklad av Google och Portland TriMet, ursprungligen känd som Google Transit Feed Specification. GTFS tar hänsyn till en mängd trafikslag där bland färja, balkbana och tunnelbana.

Se hela specifikationen på Google Code och läs historien bakom standarden hos Streetsblog San Francisco.

• Format: CSV
• Licens: Creative Commons Attribution 3.0

GTFS-realtime

Den 22 augusti presenterade Google en ny standard, en förlängning av GTFS som möjliggör aktörer att kommunicera realtidsinformation om fordon och rutter. Utformat för enkel implementation och för att snabbt kunna förmedla information till resenärer som reser kollektivt.

Mer om GTFS-realtime

DATEX2

Christoffer tipsade mig om DATEX2 som skapats med stöd av EasyWay-projektet och medgrundats av självaste EU-kommissionen. Standarden omfattar främst trafikslag på väg och förmedling av trafiksituationer för analys.

Mer information på datex2.eu

• Format: XML
• Status: Under utveckling

TransXChange

Den nationella standarden i England för utbyte av busstidtabeller och relaterad information. TransXChange utgörs av två modeller, en för registrering och en för utbyte av data mellan system. Används för trafik- och reseplanering samt realtidsspårning av fordon.

Mer om TransXChange

• Version: 2.4
• Format: XML

Service Interface for Real Time Information

SIRI är en standrad som ursprungligen togs fram med deltagare från Frankrike, Tyskland, Skandinavien(?) och England för att enklare kunna utbyta information om kollektivtrafik i realtid. Standarden bygger på publicera/prenumerera-modellen för web services (HTTP). Hogia har implementerat standarden hos operatörer i Sverige.

Sedan oktober 2010 baseras allt utbyte av realtidsinformation för kollektivtrafik i Norge på SIRI-standarden.

Mer om SIRI

• Version: 1.3
• Format: XML

Real Time Interest Group XML

Utvecklad i England för att tillåta distribuerade beräkningar av information om kollektivtrafik i realtid. Formad som en förlängning av TransModel. Numera en del av SIRI.

Mer om RTIG-XML

Dokumenterad men inte öppen

När en eller flera standarder har valts och implementerats behöver de tillgängliggöras. Av erfarenhet är det just när det tar stopp. Information flödar mellan aktörer, men den enskilda resenären får sällan ta del av den. Antingen för sent, eller inte alls.

Jag har följt Trafiklab som stängd beta under en tid, men nu är den äntligen live. Vi behöver just den här typen av initiativ för att öka kvaliteten på kollektivt resande i Sverige.

Fler som bloggat om Trafiklab

• Trafiklab – portalen för svenska rese-APIer – Mashup.se
• Trafik API på Drupal från SL och Samtrafiken – MKSE

Att tolka inkonsekvent information

Som du kanske redan har noterat, hämtar jag aktuell trafikinformation direkt från, bland annat, Trafikverkets webbplats. Därefter granskas, korrigeras och ordnas informationen till det du kan ta del av, exempelvis i form av tidtabeller för Stockholm C. Denna process är något jag under året kontinuerligt förfinat och optimerat för att ny trafikinformation snabbt ska kunna mottas via webb, SMS eller Tågtider API.

Den information som presenteras på tavlor eller via högtalare på stationer runt om i Sverige görs manuellt från trafikledningscentraler. Nedan är några av de, enligt mig, mest udda anmärkningarna i sin helhet som Trafikverket valt att publicerat under året.

• älgkrock
• Extrabuss
• bus ers
• Omledning
• Personal
• Tågab
• inväntar
• SJ Regio
• Förstärk buss
• Felvänt
• vä
• Arriva
• Snö/Is
• Nästa anslutn
• EJ
• Tåg-
• Omlett
• Bistron
• vagnar i
• ingen
• P
• Främre Tågsät
• Neds. hast.
• Krot tåg
• Djur i spåret
• Hinder
• Tomtåg
• Obeh i spåret
• Broöppning
• Spårhalka
• Passkontr
• Sjukdom
• Shellmacken
• Stängd
• o-ordning
• kor

Genom att se till dessa förstår du kanske delar av den huvudvärk jag ständigt drabbas av. Visst är det fint att redaktörerna på trafikledningen vill informera om alla händelser i tågtrafiken samt orsaken till dessa? Jag tycker dock att många av fraserna ovan snarare bidrar till förvirring, istället för att vägleda resenärer med relevant information. Vidare vill jag tydliggöra hur inkonsekvent data som verkligen publiceras. Fraserna nedan tolkar jag som samma anmärkning, att given avgång eller ankomst är inställd och ersatt med buss(ar).

• Buss ers.
• Buss ers,
• Buss ersätter
• Buss
• buss
• bus ers
• Ersatt av Buss
• Ersättn.buss
• Tågbuss
• Buss beställd
• Ersättn.buss

För att snabbare och mer effektivt nå ut med information till resenärer föreslår jag att trafikledningen standardiserar de mest frekventa anmärkningsfraserna. Om inte annat för att undvika publicering av pinsamma felstavningar.

Tågtider i mobilen

Redan i september, i.o.m. lanseringen av Tågtider 2 var tjänsten anpassad för webbläsare i både smarta och enklare mobiler. Möjligheten att bevaka tåg via SMS har mottagits med öppna armar av resenärer runt om i landet. SJ gjorde i januari ett (halvhjärtat) försök med en liknande funtion.

När jag sedan byggde Tågtider API på Codemocracy tog det bara någon timme för ett par fantastiska utvecklare att bygga enklare appar för både iOS och Android. Just nu finns Tågtider i applikationer för följande mobila plattformar.

• Android
• Windows Phone 7
• iOS (beta)

Tågtider i framtiden

Om du följt bloggen har du ganska bra koll på vad som komma skall. Tågtider för iOS (iPhone & iPod touch) är just nu i beta och vi trimmar in såväl push-servern som detaljer i appen. Därefter är det dags för Tågtider 3, först i form av ett helt nytt API följt av webb- och uppdaterade mobilapplikationer.

Så länge Trafikverket och/eller operatörer inte tar sitt ansvar och förmedlar relevant information till sina resenärer, kommer jag fortsätta underhålla och utveckla Tågtider.

Tågtider 3 i molnet

Det som gör att Tågtider svarar med aktuell information när du använder skickar ett SMS eller använder någon applikation.

• Apache2 – Webbserver
• PHP5 – Scriptspråk
• cURL – Klient för att skicka och motta data
• Redis (med phpredis) – Primär  datalagring i minnet med redundans till disk
• MySQL – Sekundär datalagring på disk.

Tågtiderbot spindlar trafikinformation

Det är i roboten som mycket av logiken (magin) är definierad för att tolka inkonsekvent data från Trafikverket om stationer, operatörer, förbindelser, tåg, trafikplatser, spår etc. Då Trafikverket inte följer enkla standarder för HTTP-protokollet är det omöjligt att veta när informationen uppdateras. Det gör att jag i blindo kontinuerligt söker efter förändringar i järnvägstrafiken. Tågtiderbot består av följande tre delar.

1. Scheduler – Schemalägger och prioriterar nerladdningar
2. Downloader – Flertrådad nerladdning av innehåll
3. Parser – Läser, tolkar och relaterar informationen.

Tågtider API 2 med realtidsströmmar

Första versionen av Tågtider API mottogs med öppna armar av en mängd utvecklare som skapat applikationer för bland annat Android, Windows Phone 7 och iPhone. Alla hurrarop och förfrågningar ger mig energi att utveckla tjänsten till något mycket bättre med tekniken nämnd ovan. Nästa version av Tågtider API omfattar bland annat:

• Helt öppna metodanrop för aktuella tidtabeller
• Klientautentisering för applikationer via oAuth2
• Realtidsuppdateringar via PubSubHubbub, SMS (via Cellsynt), C2DM och APNS
• Tillgång till historisk data.