SIRI - Stop monitoring

Stop monitoring -rajapinta tuottaa pysäkkikohtaisen reaaliaikaisen näkymän pysäkille seuraavaksi saapuviin vuoroihin. Ajossa oleville ajoneuvoille (monitored=true) taustajärjestelmä laskee ennusteen pysäkille saapumisen täsmällisestä ajankohdasta.

Ennakoidut aikataulut perustuvat pelkästään linjan sen hetkiseen GPS-sijaintiin linjan ajoreitillä. Laskettuun saapumisaikaan vaikuttaa :

Mahdolliset yllättävät ruuhkatilanteet tai liikenne-esteet.
Tietojen päivittyminen ajoneuvon sijainnista ja mahdolliset GPRS-siirtoviiveet ja -katkot
Reitillä olevien liikennevalojen tila.
Pysäkeiltä nousevien matkustajien määrä / ruuhka-aika.

Ennakoitu laskennallinen aikataulu saattaa myös nopeasti viivästyä (ts. karata tulevaisuuteen) hyvinkin paljon mikäli matkalle osuu liikenne-este ja palata myös nopeasti takaisin normaaliin kun ajoneuvo on ohittanut liikenne-esteen. Nämä tilanteet tulisi huomioida rajapintadataa käytettäessä, esim. hyödyntämällä vertailutietoina myös saapuvan ajoneuvon sijaintikoordinaatteja ja niistä johdettua etäisyyttä pysäkin sijaintiin.

Pysäkkiluettelo

http://data.foli.fi/siri/sm/pretty

{
    "4": {
        "stop_name": "Turun linna"
    },
    "578": {
        "stop_name": "Patterinhaka"
    },
    /* ... */
    "5400": {
        "stop_name": "Liedon ja Tarvasjoen raja VT10"
    }
}

Pysäkkikohtainen ennuste

Attribuutit

Sanomakohtaiset attribuutit

sys Stop monitoring-viesteille tunniste "SM". (Vrt. Vehicle-monitoring -viesteille "VM"
status "OK", mikäli tietosisältö on ajantasainen ja käyttökelpoinen. Voi olla myös "NO_SIRI_DATA", mikäli Siri-taustajärjestelmä ei tuota järjellistä tietoa.
servertime aikaleima (unix-timestamp) ajankohdalle, jona vastaus on generoitu. Taustajärjestelmän kuormituksen vähentämimseksi edustapalvelin cacheaa pysäkkikohtaisesti liikennöinnin vilkkaudesta riippuen vastauksia.
result pysäkille saapuvat vuorot saapumisjärjestyksessä.

Ajoneuvokohtaiset attribuutit

recordedattime aikaleima (unix-timestamp) viimeisimmälle tilapäivitykselle
monitored true, mikäli linjasta saatavilla reaaliaikadataa
latitude, longitude pysäkkiä lähestyvän ajoneuvon koordinaatit, mikäli tiedossa (WGS-84)
originaimeddeparturetime ajettavan linjan suunniteltu lähtöajankohta linjan alkupisteestä
originaimedarrivaltime ajettavan linjan suunnitelty saapumisajankohta pääteasemalle.
destinationdisplay linjan tunnus (bus frontplate)
aimedarrivaltime aikataulun mukainen saapumisajankohta pysäkille
expectedarrivaltime laskennallinen toteutuva saapumisajankohta pysäkille
aimeddeparturetime aikataulun mukainen lähtöajankohta pysäkiltä
expecteddeparturetime laskennallinen toteutuva lähtöaika pysäkiltä

URL-muunnokset

Data-url ilman lisämääreitä palauttaa kompaktin koneluettavan JSON-vastauksen. Lähtökohtaisesti sovelluksissa tulisi käyttää tätä.
/pretty -lisämääreellä vastaus palautetaan muotoiltuna. Tietosisältö on sama kuin kompaktissa muodossa.
/format -lisämääreellä tietosisällön aikaleimat muunnetaan kellonajaksi.
/xml -lisämääreellä palautetaan alkuperäinen SIRI:n XML-vastaus.

Esimerkkisanoma

http://data.foli.fi/siri/sm/4/pretty

{
    "sys": "SM",
    "status": "OK",
    "servertime": 1432453114,
    "result": [
        {
            "recordedattime": 1432453110,
            "lineref": "15",
            "monitored": true,
            "latitude": 60.454883,
            "longitude": 22.2696,
            "originaimeddeparturetime": 1432451700,
            "destinationaimedarrivaltime": 1432455180,
            "destinationdisplay": "Kakskerta Brinkhallin kautta",
            "aimedarrivaltime": 1432453320,
            "expectedarrivaltime": 1432453229,
            "aimeddeparturetime": 1432453500,
            "expecteddeparturetime": 1432453409,
            "delay": -91
        },
        {
            "recordedattime": 1432453110,
            "lineref": "61",
            "monitored": true,
            "latitude": 60.457017,
            "longitude": 22.268633,
            "originaimeddeparturetime": 1432452000,
            "destinationaimedarrivaltime": 1432454160,
            "destinationdisplay": "Ilpoinen",
            "aimedarrivaltime": 1432453260,
            "expectedarrivaltime": 1432453308,
            "aimeddeparturetime": 1432453500,
            "expecteddeparturetime": 1432453500
        },
        {
            "recordedattime": 1432453110,
            "lineref": "56",
            "monitored": true,
            "latitude": 60.473783,
            "longitude": 22.3123,
            "originaimeddeparturetime": 1432452900,
            "destinationaimedarrivaltime": 1432455180,
            "destinationdisplay": "Haarla",
            "aimedarrivaltime": 1432454040,
            "expectedarrivaltime": 1432454040,
            "aimeddeparturetime": 1432454400,
            "expecteddeparturetime": 1432454400
        },
        {
            "recordedattime": 1432453110,
            "lineref": "55",
            "monitored": false,
            "originaimeddeparturetime": 1432454700,
            "destinationaimedarrivaltime": 1432457220,
            "destinationdisplay": "Haarla",
            "aimedarrivaltime": 1432455840,
            "expectedarrivaltime": 1432455840,
            "aimeddeparturetime": 1432456200,
            "expecteddeparturetime": 1432456200
        },
        /* ...... */
        {
            "recordedattime": 1432453110,
            "lineref": "55",
            "monitored": false,
            "originaimeddeparturetime": 1432461900,
            "destinationaimedarrivaltime": 1432464540,
            "destinationdisplay": "Haarla",
            "aimedarrivaltime": 1432463100,
            "expectedarrivaltime": 1432463100,
            "aimeddeparturetime": 1432463400,
            "expecteddeparturetime": 1432463400
        }
    ]
}