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
| Part | Description | Optional | Example |
| URL | TransiCast web server instance URL | http://transicast.appspot.com/ws/V1 | |
| Servlet descriptor | agencies | agencies | |
| Parameter: ll=<lat>,<lon> | Geodetic reference coordinate (WGS-84) |  | ll=33.2241,-122.5198 |
http://transicast.appspot.com/ws/V1/agencies?ll=41.727122,-87.55947&appid=sample4
Response format
Individual agencies are returned through the <agency> tag. It contains the following attributes:
| Attribute | Description | Key | Used in | Example | |||||||||||||||||||||||||
| id | Agency ID. This is not a key element and the id may change over time. | id="2244" | |||||||||||||||||||||||||||
| common | Agency common name, e.g. the agency's city | common="Chicago" | |||||||||||||||||||||||||||
| name | Agency name | | Route list calls Stop responses | name="CTA"
| rt | Flag. If true, the agency globally offers service messages and next bus and train times for all routes | rt="true" | top | WGS-84 latitude of the northwest corner of the agency's service area | top="42.083153" | left | WGS-84 longitude of the northwest corner of the agency's service area | left="-87.9142231" | bottom | WGS-84 latitude of the southeast corner of the agency's service area | bottom="41.6341576" | right | WGS-84 longitude of the southeast corner of the agency's service area | right="-87.5156995" | |
<?xml version="1.0" encoding="UTF-8"> <resultSet queryTime="1319328820274" ct="2"> <agency id="1033008" common="Chicago" name="CTA" rt="true" top="42.083153" left="-87.9142231" bottom="41.6341576" right="-87.5156995"/> <agency id="1027005" name="Pace" top="42.4674811" left="-88.62845" bottom="41.3805003" right="-87.3457901"/> </resultSet>
Notes
If the optional geodetic reference is included in the call (ll parameter), the sequence of agencies in the response is ordered by the distance of each agency's geographic center to the geodetic reference.
Contact
By email
| © 2011, 2012 Joachim Pfeiffer |
|