Installation using pip:
pip install transitland
Alternatively, download from PyPi or clone this repository, and install using setup.py:
python ./setup.py install
The dependencies mzgeohash and mzgtfs will be automatically installed using the above methods.
First, make sure you have a copy of the current Transitland Feed Registry. This can be accomplished through a git clone:
git clone https://github.com/transitland/transitland-feed-registry.git
Then, create a registry reader with transitland.registry.FeedRegistry, passing the path to the registry as the argument.
>>> import transitland.registry
>>> registry = transitland.registry.FeedRegistry('.')
You can now list the known feeds:
>>> registry.feeds()
['f-9q5-lacmta', 'f-9q8-samtrans', 'f-9q8y-sanfranciscomunicipaltransportationagency', 'f-9q9-actransit', 'f-9q9-caltrain', 'f-9q9-vta', 'f-9vk-mtaharriscounty', 'f-c20-trimet', 'f-c23-kingcounty', 'f-c28-translink', 'f-dhw-miamidade', 'f-dnh-marta', 'f-dp3-cta', 'f-dpz8-ttc', 'f-dq-mtamaryland', 'f-dqc-wmata', 'f-dr5r-nyctsubway', 'f-dr5r-panynjpath', 'f-drt-mbta']
A specific feed can be read with FeedRegistry.feed(). The resulting Feed can be used to inspect the feed attributes, download the current version of the feed, etc.
>>> feed = registry.feed('f-9q9-caltrain')
>>> feed.url()
'http://www.caltrain.com/Assets/GTFS/caltrain/GTFS-Caltrain-Devs.zip'
>>> feed.download('caltrain-current-gtfs.zip')
The current versions of GTFS feeds can be downloaded to the current directory using transitland.fetch:
$ python -m transitland.fetch f-9q9-caltrain
Downloading: http://www.caltrain.com/Assets/GTFS/caltrain/GTFS-Caltrain-Devs.zip -> f-9q9-caltrain.zip
The "--all" option can also be used to download all feeds in the registry. Only updated feeds will be downloaded:
$ python -m transitland.fetch --all
Downloading: http://developer.metro.net/gtfs/google_transit.zip -> f-9q5-lacmta.zip
Downloading: http://www.samtrans.com/Assets/GTFS/samtrans/SamTrans-GTFS.zip -> f-9q8-samtrans.zip
Downloading: http://archives.sfmta.com/transitdata/google_transit.zip -> f-9q8y-sanfranciscomunicipaltransportationagency.zip
...
A Feed can be created from a GTFS url with transitland.bootstrap. Specify the URL with "--url" and the feed name with "--feedname":
$ python -m transitland.bootstrap --url http://www.bart.gov/dev/schedules/google_transit.zip --feedname bayarearapidtransit
Downloading: http://www.bart.gov/dev/schedules/google_transit.zip
Loading feed: /var/folders/zl/ps1504fx0b9_n2bx4ndmyyy40000gn/T/tmpUuzl2D.zip
Feed: f-9q9-bayarearapidtransit
Stops: 45
Routes: 6
Operators: 1
Operator: Bay Area Rapid Transit
Routes: 6
Stops: 45
Writing to f-9q9-bayarearapidtransit.json
A basic feed description will be written to the feeds directory that can then be annotated with details about licenses, additional identifiers, etc.
{
"feedFormat": "gtfs",
"onestopId": "f-9q9-bayarearapidtransit",
"operatorsInFeed": [
{
"gtfsAgencyId": "BART",
"identifiers": [],
"onestopId": "o-9q9-bayarearapidtransit"
}
],
"tags": {},
"url": "http://www.bart.gov/dev/schedules/google_transit.zip"
}See data.md
Please open a Github issue with as much of the following information as yo're able to specify, or contact us for assistance.
Transitland is sponsored by Mapzen. Contact us with your questions, comments, or suggests: hello@mapzen.com.