Agency List


The agency list call returns a list of all agencies contained in a TransiCast web server instance. Agencies are identified by agency name and include a common name where added to the data of the respective transit agency. Each agency record includes the WGS-84 coordinates of the most northwestern and southeastern corners of the agency's service territory, and a flag that marks agencies which provide service messages and next bus and train times.

Call format


PartDescriptionOptionalExample
URLTransiCast web server instance URLhttp://transicast.appspot.com/ws/V3
Servlet descriptoragenciesagencies
Parameter:
ll=<lat>,<lon>
Geodetic reference coordinate (WGS-84)
+
ll=33.2241,-122.5198
Parameter:
regions=<region,...>
Filter result by comma-separated list of regions
+
region=NA
Parameter:
countries=<country,...>
Filter result by comma-separated list of countries by ISO 3166 county code
+
countries=CA
Parameter:
metros=<metro,...>
Comma-separated list of metros by agency common name to filter result
+
metros=Chicago
Parameter:
rights=<true>
Data originator feed notice
+
rights=true

http://transicast.appspot.com/ws/V3/agencies?ll=41.727122,-87.55947&appid=sample4

Response format


Individual agencies are returned through the <agency> tag. It contains the following attributes:

AttributeDescriptionKeyUsed inExample
regionAgency regionregion="EU"
countryAgency country, by ISO 3166 county codecountry="US"
commonAgency common name, e.g. the agency's citycommon="Chicago"
nameAgency name
+
Route list calls
Stop responses
name="CTA"
rtFlag. If true, the agency offers next bus and train times in real time and live vehicle locationsrt="true"
topWGS-84 latitude of the northwest corner of the agency's service areatop="42.083153"
leftWGS-84 longitude of the northwest corner of the agency's service arealeft="-87.9142231"
bottomWGS-84 latitude of the southeast corner of the agency's service areabottom="41.6341576"
rightWGS-84 longitude of the southeast corner of the agency's service arearight="-87.5156995"
stopcodesFlag indicating whether agency uses stop codesstopcodes="true"
feednotesData originator feed notice

<?xml version="1.0" encoding="UTF-8">
<resultSet queryTime="1319328820274" ct="2">
<agency region="NA" country="US" common="San Francisco" name="AC Transit" rt="true" top="38.01" left="-122.43" bottom="37.42" right="-121.88" stopcodes="true"/>
<agency region="NA" country="US" name="ACT" top="39.72" left="-79.06" bottom="39.47" right="-78.7"/>
</resultSet>

Notes

When the optional parameter for the geodetic reference is included in the call (ll parameter), the agencies are sorted in order by distance the agency's geographic center point to the geodetic reference.

Contact

By email  

© 2011 - 2016 TransiCast

Powered by Google App Engine