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/V3 | |
Servlet descriptor | agencies | agencies | |
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=<api_key>
Response format
Individual agencies are returned through the <agency> tag. It contains the following attributes:
Attribute | Description | Key | Used in | Example | |||||||||||||||||||||||||||||||||||
region | Agency region | region="EU" | |||||||||||||||||||||||||||||||||||||
country | Agency country, by ISO 3166 county code | country="US" | |||||||||||||||||||||||||||||||||||||
common | Agency common name, e.g. the agency's city | common="Chicago" | |||||||||||||||||||||||||||||||||||||
timezone | Agency schedule timezone | timezone="America/Chicago" | |||||||||||||||||||||||||||||||||||||
name | Agency name | Route list calls Stop responses | name="CTA"rt | Flag. If true, the agency offers next bus and train times in real time and live vehicle locations | 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" | stopcodes | Flag indicating whether agency uses stop codes | stopcodes="true" | feednotes | Data originator feed notice | |
<?xml version="1.0" encoding="UTF-8"> <resultSet queryTime="1319328820274" ct="2"> <agency region="NA" country="US" common="San Francisco" timezone="America/Los_Angeles" name="AC Transit" rt="true" top="38.01" left="-122.43" bottom="37.42" right="-121.88" stopcodes="true"/> <agency region="NA" country="US" timezone="America/Los_Angeles" 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 - 2023 TransiCast |