Trafikmätningar

Data från signalljus

Data levereras löpande (varje kvart) från de flesta av Linköpings trafiksignaler till databasen. Den utrustning som räknar trafiken består av detektorer till trafiksignalen för att känna av om ett fordon närmar sig korsningen. Detektorer finns i normalfallet i alla vägar in i en korsning. Den data som levereras som öppna data kommer från en detektor i varje väg in i en korsning. Det ger möjlighet till att avgöra hur mycket trafik som ankommer en korsning från varje väg men också en totalsumma på korsningens hanterade trafikmängd.

Varje trafiksignalsanläggning har ett id-nummer och varje detektor har i sin tur ett nummer. Kombinationen id-nummer och detektor är unika.

Två metoder finns tillgängliga för att hämta ut trafikdata. Samtliga svar kapslas in i ett svarsobjekt där värdet för propertyn status är ok om allting gått bra. Är status error finns oftast ett meddelande i message som talar om vilket fel som eventuellt uppstått.

Trafikmätningar - demosida för hur API:et kan användas och data visualiseras

Kräver parameter CustomKey med API-nyckel
Tjänsten anropas med HTTP GET.

Anrop +TrafikdataDetektorInfo

Kan användas för att söka upp och lista tillgängliga detektorer, få ut geografisk placering, i vilken riktning mätningen sker, beskrivning etc.                           

Man får i detectorListGeoJSON ett GeoJSON-objekt som beskriver samtliga matchande detektorer.

Inparametrar

Returnerad data

Exempel 

För att hämta ut enskild detektor anges ControllerID ihop med DetectorID.
http://opendata.linkoping.se/WS_OpenData/Open.svc/TrafikdataDetektorInfo?CustomKey=DIN_API_NYCKEL&ControllerID=2&DetectorID=4

För att söka upp detektorer som matchar på viss beskrivning/namn skickas Fritext med.
http://opendata.linkoping.se/WS_OpenData/Open.svc/TrafikdataDetektorInfo?CustomKey=DIN_API_NYCKEL&Fritext=Drottninggatan

För att få ut samtliga detektorer anropas metoden endast med API-nyckeln.
http://opendata.linkoping.se/WS_OpenData/Open.svc/TrafikdataDetektorInfo?CustomKey=DIN_API_NYCKEL

Anrop +TrafikdataDetektorData

Anrop för att hämta ut trafikdata från detektor. Returnerar antal fordon som passerat, mät-tid etc.

Inparametrar

Returnerad data

Exempel 

/WS_OpenData/Open.svc/TrafikdataDetektorData?CustomKey=DIN_API_NYCKEL&ControllerID=2&DetectorID=4

Measuretime är tiden i början på det intervall som antal räknas, d.v.s. om measuretime är 2017-05-11 12:15:00 så får man antalet för tiden mellan 12:15 och 12:30, vid intervall på 15.

Datum anges i formatet yyyy-mm-dd hh:mm. Exempelvis 2017-04-19 19:15

Tomma datum gör att anropet returnerar senaste värdet för efterfrågad detektor/detektorer.

http://opendata.linkoping.se/WS_OpenData/Open.svc/TrafikdataDetektorData?CustomKey=DIN_API_NYCKEL&ControllerID=2&DetectorID=4&DateFrom=2017-05-01&DateTo=2017-05-02

Resultatet begränsas till 1000 poster så förfrågan bör begränsas så mycket som möjligt mha datum (Är resultatet klippt framgår det i returens message).

-----------------------------------------------------------------------------------------------------------------

Vad som inte levereras:

• Svängandelar
• Hastighet
• Mätvärden för gång (finns inte)
• Mätvärden för cykel (finns i viss omfattning, men är svåra att kvalitetssäkra).

Möjliga felkällor (fler kan finnas)

• Vägarbete eller dylikt kan ge bortfall p.g.a. arbete med signaler eller i dess närhet
• Detektorfel
• Serverproblem
• Driftarbete
• Felräkning, ibland räknas betydligt färre fordon av, för närvarande, oklar anledning

Formatet som efterlevs finns definierat här https://tools.ietf.org/html/rfc7946 
För att testa GeoJSON finns det ett antal websidor, exempelvis http://www.geojsonlint.com och http://www.geojson.io

-----------------------------------------------------------------------------------------------------------------

Data från utplacerade slingor

Trafikkontoret placerar ut slingor runt om på Linköping kommuns vägar vid enstaka tillfällen för att genomföra trafikmätning. Här har vi även data för cykeltrafik. Observera att data för träfikmätningar från slingor inte rapporteras in dynamiskt utan mätningar genomförs ungefär var trejde år i snitt. Däremot innehåller den mer omfattande data som tex hastighet och vad är för typ av fordon.

Ingen API-nyckel krävs för detta anrop.

Anrop fordon

 Returnerad data

Exempelanrop för WFS-fil:

http://ows.linkoping.se/isms/vagar?service=wfs&request=getfeature&typename=trafikmatning_bil&version=1.1.0&

Anrop cykel

Returnerad data

Exempelanrop för WFS-fil:

http://ows.linkoping.se/isms/vagar?service=wfs&request=getfeature&typename=trafikmatning_cykel&version=1.1.0&