Route Details


The route details call returns the stops and their sequence within a route. Each stop record includes the stop's id, stop code, stop name, coordinates, the stop's predecessors within the route, and data that indicates if the stop is a terminus (last) stop on the route.
The parameter <routename> can be used to filter the result by the route longname. This is effective for agency's that maintain multiple, identical route id's differentiated by route longname.

Call format


PartDescriptionOptionalExample
URLTransiCast web server instance URLhttp://transicast.appspot.com/ws/V2
Servlet descriptortermini termini
Parameter: agency=<agency ID>Agency ID, as provided by the agencies callagency=CTA
Parameter:
route=<route id>
Route ID, as provided by the route list callroute=28
Parameter:
routename=<longname>
Route longname, as provided by the route list call
+
routename=CAMDEN - WASHINGTON
Parameter:
all=<mode>
This parameter controls how the resulting list of stops is filtered. There are three settings:
  • all=false: Return terminus stops of the route only
  • all=true: Return all stops of the route, except terminus stops
  • all=full: Return all stops of the route (default)
+
all=full

http://transicast.appspot.com/ws/V2/termini?agency=CTA&route=28&appid=sample3

Response format


Individual routes are returned through the <route> tag. It contains the following attributes:

AttributeDescriptionKeyVerUsed inExample
locidStop ID, as provided by stops callallStops, as key valuelocid="7131"
loccodeTraveler facing stop code. Stop codes are often printed on stop signage or included in handout schedules to make it easier for travelers to request a stop schedule or real-time arrival information for a particular stop./V2loccode="137227"
routeRoute ID, as provided by the route list call. In full call mode, the presence of this attribute indicates terminus stopsallRoute list, as key valueroute="28"
colorRGB route color, in hexadecimal values. In full call mode, the presence of this attribute indicates terminus stopsallcolor="E12D27"
typeRoute type in accordance with the GTFS definitionalltype="3"
preComma separated list of predecessor stops within the route, by stop ID/V1Stops, as key valuepre="1515"
descStop descriptionalldesc="Lake Park & 47th Street Terminal"
latStop latitudealllat="41.78601833"
lngStop longitudealllng="-87.5864924"

Starting with /V2, each predecessor stop provided through the pre attribute above now has a separate tag, <pre>. It contains the <locid> tag for the stop's processor stops:

AttributeDescriptionKeyVerUsed inExample
locidStop ID of the predecessor stop/V2Stops, as key valuelocid="1515"

<?xml version="1.0" encoding="UTF-8"?>
<resultSet queryTime="1319383523699" ct="58">
<stop locid="70061" loccode="" route="Red Line" color="E12D27" type="1" desc="Alewife Station" lat="42.395428" lng="-71.142483">
	<pre locid="70064"/>
</stop>
<stop locid="70063" loccode="" desc="Davis Station" lat="42.39674" lng="-71.121815">
	<pre locid="70061"/>
</stop>
<stop locid="70065" loccode="" desc="Porter Square Station" lat="42.3884" lng="-71.119149">
	<pre locid="70063"/>
</stop>
<stop locid="70067" loccode="" desc="Harvard Square Station" lat="42.373362" lng="-71.118956">
	<pre locid="70065"/>
</stop>
<stop locid="70069" loccode="" desc="Central Square Station" lat="42.365486" lng="-71.103802">
	<pre locid="70067"/>
</stop>

 . . .

<stop locid="70276" loccode="" desc="Mattapan Station" lat="42.267762" lng="-71.092241">
	<pre locid="70276"/>
</stop>
</resultSet>

Contact

By email  

© 2011 - 2016 TransiCast

Powered by Google App Engine