API sonraí iompair don RA agus d'Éirinn
Gach stad, gach amchlár, eochair API amháin.
Bus, tram agus traein ar fud na Breataine Móire agus na hÉireann. Pleanáil turais le táillí traenach, amanna beo traenach ó National Rail, busanna beo nasctha lena dturas cruinn, poncúlacht bus tomhaiste, cur isteach ar sheirbhísí a mheaitseálann do bhealach, agus amchláir a athnuachan gach maidin. Sonraí oscailte oifigiúla ar fad, á seirbheáil mar JSON simplí.
Plean saor in aisce, gan chárta. 200 iarratas sa lá.
GET /v1/bus/vehicles.json?lat=53.4794&lon=-2.2453
{
"line": "197",
"operator": "Bee Network",
"destination": "Chorlton Street Coach Station",
"latitude": 53.476608,
"longitude": -2.241816,
"delay_seconds": -104
}Freagraí nach féidir le hamchlár a thabhairt
Tógtha ó gach bus a rianaíonn TransCAPI agus ó gach imeacht san amchlár, ní hamháin an chéad cheann eile.
Raon
Cá bhféadfainn dul i 30 nóiméad?
An limistéar is féidir a bhaint amach ar iompar poiblí ó phointe ar bith sa Bhreatain Mhór nó in Éirinn, mar GeoJSON réidh do léarscáil, nó an t-am taistil ó áit amháin go suas le 500 áit eile in iarratas amháin. Do chuardach maoine, earcaíocht, roghnú láithreáin, nó "cén t-ionad is éasca do chách?"
Treoir raoin
Poncúlacht
Cé chomh hiontaofa is atá an bus seo, i ndáiríre?
Tomhaiste, ní de réir an amchláir: in am, déanach agus an-déanach de réir bealaigh, de réir stad agus de réir uaire, ó gach bus rianaithe ag dul thar gach pointe ama, de réir shainmhíniú na dTraffic Commissioners ar a bheith in am.
Treoir poncúlachtaÓ 132,938 stad breathnaithe. Is measa ag 13:00, 58% in am. Beo ó /v1/bus/reliability.json.
Athruithe
An mbeidh mé in am don athrú?
Insíonn gach turas le hathrú cé chomh minic a d'oibrigh an t-athrú sin i ndáiríre do na busanna céanna sin le seachtainí beaga anuas. Is fiú fios a bheith agat faoi athrú 2 nóiméad a bhfuil cuma mhaith air ar pháipéar agus a oibríonn lá amháin as ceithre sula mbíonn tú i do sheasamh ag an stad.
Conas a oibrítear amach é# Sheffield station to Crookes, 08:00
GET /v1/journey.json?from_lat=53.378&from_lon=-1.462
&to_lat=53.386&to_lon=-1.513
"connection_chance_pct": 25,
"connections": [
{
"at": "West Street/Carver Street",
"from_line": "120",
"to_line": "52",
"spare_s": 120,
"chance_pct": 25,
"basis": "trip_history",
"days": 20
}
]Fógraí brúite
Ná bí ag fiafraí arís is arís. Inseoimid duit.
Cláraigh URL uair amháin agus seolann TransCAPI chuige nuair atá do bhus cúpla nóiméad uait, nó nuair a bhuaileann cur isteach do stad, do stáisiún, d'oibreoir nó do bhealach. Sínithe, seolta arís má tá do fhreastalaí thíos, agus san áireamh ar gach plean. Ní gá fiafraí gach nóiméad an bhfuil aon rud athraithe.
Doiciméid fógraí brúite# What your server receives
POST /hooks/transcapi
X-TransCAPI-Event: vehicle_approaching
X-TransCAPI-Signature: sha256=bd2b3189aef3...
{
"type": "vehicle_approaching",
"data": {
"atcocode": "370022870",
"line": "95",
"destination": "Walkley",
"minutes_away": 9.5,
"delay_seconds": 0,
"vehicle": {
"latitude": 53.381833,
"longitude": -1.464979
}
}
}Tógtha le TransCAPI
Truvel: an pleanálaí turais a insíonn duit cad a tharlóidh i ndáiríre
Is é Truvel ár bpleanálaí turais féin don Bhreatain Mhór agus d'Éirinn. Níl aon sonraí iompair dá chuid féin aige: tagann gach turas, táille, am beo agus céatadán air ón API seo, trí na críochphointí agus na heochracha céanna a fhaigheann tusa.
- An mbeidh mé in am don athrú? "Oibríonn sé 1 lá as 2", de réir mar a rith na busanna céanna sin le laethanta beaga anuas:
/v1/journey.json - An táille do gach turas, le railcards, agus athrú traenach á phraghsáil mar thicéad amháin:
/v1/rail/fares.json - Seirbhísí beo: busanna atá ag teacht, ardáin agus amanna measta na dtraenacha:
/v1/bus/stop_timetables,/v1/rail/station_timetables - Cá bhféadfainn dul i 30 nóiméad? tarraingthe ar léarscáil:
/v1/journey/reachable.json - Carbón agus iarracht siúil ar gach turas, le rogha fánaí réidhe amháin
API amháin don líonra ar fad
Trí fhotha déag oifigiúla in ocht bhformáid, meaitseáilte lena chéile agus coinnithe cothrom le dáta de réir mar a athraíonn siad, ionas nach gá duitse é a dhéanamh.
Stadanna agus áiteanna
Cuardaigh gach stad bus, tram agus traenach sa Bhreatain Mhór agus in Éirinn de réir pointe, ga nó limistéir. Insíonn gach ceann cén treo a dtéann a bhusanna, ionas gur féidir dhá stad leis an ainm céanna a aithint óna chéile.
Imeachtaí agus teachtaí
Amanna beo traenach ó Darwin National Rail, le hardáin, cealuithe agus cúiseanna moille. Amanna bus ar fud na Breataine Móire agus na hÉireann, le suíomhanna beo nuair a thuairiscíonn oibreoir iad. Cláir teachta freisin — is áit é ceann scríbe ina dtuirlingíonn daoine, ní hamháin áit nach bhfágann aon rud.
Bealaí agus céimseata
Treoracha líne, a stadanna agus amchlár an lae — chomh maith leis an mbealach a thógann gach treo i ndáiríre, mar polyline ionchódaithe. Tarraing an bóthar, ní líne idir stadanna.
Pleanáil turais
Turais ilmhódacha le teorainneacha siúil, treoracha casadh ar chasadh agus meastacháin táillí. Ó dhoras go doras, áit ar bith sa Bhreatain Mhór nó in Éirinn.
Cur isteach ar sheirbhísí
Oibreacha pleanáilte, teagmhais agus stádas líne do bhus, tram, National Rail agus líonra Londan, i bhfoirm amháin. Tabhair bealach turais agus ní bhfaighidh tú ar ais ach a mbaineann leis an mbealach sin, ní gach 21 sa tír.
Sonraí oscailte, sannta
Tá gach foinse agus ceadúnas liostaithe, leis an líne sannta a chaithfidh d'úsáideoirí a fheiceáil. Is féidir leat tógáil air go tráchtála, agus fios agat cá as a dtagann sé ar fad.
Fógraí brúite
Webhooks nuair atá bus cúpla nóiméad ó do stad nó nuair a mheaitseálann cur isteach do scagairí. JSON sínithe, seolta arís má tá do fhreastalaí thíos, ionas gur féidir le d'aip stopadh ag fiafraí.
Poncúlacht agus raon
Cé chomh minic is a bhíonn gach bus in am i ndáiríre, an seans athrú a dhéanamh, agus gach áit is féidir a bhaint amach i 30 nóiméad, tomhaiste ó na busanna féin agus ón amchlár iomlán.
Carbón agus dreapadh
Insíonn gach turas a CO2 de réir fhachtóirí an rialtais féin, in aice leis an turas céanna i gcarr leat féin, agus cé mhéad siúil suas cnoc atá i gceist, le teorainn do bhealaí réidhe.
Tógtha do na mionsonraí a bhriseann aipeanna iompair
Is é na sonraí a fháil an chuid éasca. Seo iad na codanna a thógann míonna le cur i gceart.
Cur isteach ar sheirbhísí a bhfuil aithne aige ar do bhealach
Tabhair bealach turais agus ní bhfaighidh tú ar ais ach na hoibreacha bóthair, na teagmhais agus na línte dúnta a bhaineann leis. Níl uimhreacha seirbhíse uathúil: ritheann First South Yorkshire 21 i mBarnsley agus ceann eile i Rotherham, mar sin má scagann tú de réir líne amháin tugtar rabhadh do dhaoine faoin mbaile mícheart.
/v1/disruptions.json?path=…&path_radius=300
Ciallaíonn beo beo, agus deir sé é sin
Tagann traenacha ó chóras fíor-ama National Rail féin, le hardáin, cealuithe agus an chúis go bhfuil traein déanach. Tá busanna nasctha lena dturas cruinn san amchlár, ní buille faoi thuairim ó uimhir líne. Insíonn gach imeacht an bhfuil a am beo nó de réir an amchláir, ionas nach dtaispeánann tú buille faoi thuairim mar fhíric choíche.
"source": "darwin"
Úr gach maidin
Athfhoilsíonn oibreoirí a gcuid amchlár an t-am ar fad, cuid acu gach oíche, agus gach uair athraíonn aitheantóirí na dturas. Stopann amchlár cúpla seachtain d'aois go ciúin ag meaitseáil leis na busanna ar an mbóthar. Athlódáiltear ár gceann féin ón easpórtáil náisiúnta gach lá, gan aon bhriseadh.
athnuaite gach lá, 05:30
Bóithre, ní línte díreacha
Tagann bealaí leis an mbealach a thógann gach treo i ndáiríre. Nuair nach bhfoilsíonn oibreoir aon chéimseata faigheann tú null, ní líne a nascann na stadanna choíche, a rithfeadh trí fhoirgnimh agus síos bóithre nach féidir le bus ar bith a úsáid.
"encoded_polyline": "qutdI|fkGG…"
Stadanna a insíonn cén treo
Tá an t-ainm céanna ar thrian de na stadanna agus atá ar stad eile, an cuaille trasna an bhóthair de ghnáth. Insíonn gach stad cá bhfuil a bhusanna ag dul, bunaithe ar na turais a stopann ann: rud ar féidir le paisinéir gníomhú air, rud nach féidir le "adj".
"towards": "Walkley"
Freagraí a admhaíonn an méid nach eol dóibh
Lasmuigh de chlúdach na pleanála turais faigheann tú 422 outside_coverage soiléir, ní liosta folamh a léann mar "gan bhusanna". Má tá fotha beo thíos, tagann an clár ar ais fós, de réir an amchláir, leis an gcúis. Is null iad moilleanna anaithnid, ní 0.
"live_error": null
Slán le gnó a thógáil air
Sonraí oscailte oifigiúla is ea gach foinse, ceadúnaithe d'úsáid tráchtála agus liostaithe lena cheadúnas. Faigheann tú an líne sannta chruinn a chaithfidh d'aip a thaispeáint, mar sin níl aon rud le réiteach nuair a sheolann tú.
Foinsí sonraí agus sannadhSpás le fás sula n-íocann tú
200 iarratas sa lá saor in aisce, le gach críochphointe agus gach fotha beo. Tosaíonn pleananna íoctha ag 5,000 sa lá ar £5 sa mhí, agus insíonn gach freagra duit ina cheanntásca cá seasann tú.
PraghsáilFiafraigh de stad cad atá ag teacht
Iarratas amháin, eochair API i gceanntásc, JSON ar ais. Gan chlúdach SOAP, gan fotha in aghaidh an oibreora le réiteach, gan zip GTFS le díphacáil ag a trí ar maidin.
- REST agus JSON simplí, doiciméadaithe le samplaí beo
- Eochair amháin do bhus, traein, turais agus cur isteach ar sheirbhísí
- Gach foinse agus ceadúnas liostaithe, leis an líne sannta le cóipeáil
- Teorainneacha ráta a insíonn duit sna ceanntásca cá seasann tú
$ curl -H "X-Api-Key: $KEY" \
"https://api.transcapi.com/v1/bus/stops.json\
?lat=53.3824&lon=-1.4695&radius=100&limit=1"
{
"member": [
{
"atcocode": "370022870",
"name": "Church Street/High Street",
"indicator": "HS5",
"bearing": "W",
"towards": "Walkley",
"locality": "Sheffield Centre",
"latitude": 53.382424,
"longitude": -1.46953,
"distance": 3.3
}
]
}An Bhreatain Mhór agus Éire ar fad, agus taispeánaimid ár gcuid oibre
Ní léaráid é sin. Is stad sa chlár é gach marc — 415,324 acu — breactha ón tábla céanna óna bhfreagraíonn an API. Tarraingíonn an Bhreatain Mhór agus Éire iad féin.
Nuair atá an clúdach níos tanaí, deir na doiciméid é sin seachas ligean duit é a fháil amach. Tá céimseata bealaigh ann do na hoibreoirí a fhoilsíonn í. Tagann Tuaisceart Éireann ó amchláir Translink agus an Phoblacht ó amchláir an NTA, agus tá an Ísiltír agus an Bheilg clúdaithe freisin.
Tosaigh i gcúig nóiméadTóg rud éigin leis
Eochair saor in aisce, gach críochphointe, gan chárta. Uasghrádaigh nuair a deir do thrácht é.
Faigh d'eochair API