GTFS Export
Chouette can export a dataset into the GTFS format by following the below rules.
Export options
The Chouette GTFS Export contains 2 specific options :
Prefer Referent Stop Areas : with this option, the GTFS export exports the referent stops areas when exists instead of the particular stop areas. See GTFS Stops section for details.
Ignore Monomodal Stop Places with a single Quay : with this option, the GTFS export doesn’t export a GTFS parent station with only a single quay. See GTFS Stops section for details.
Export content
File Structure
The export creates a zip containing the following csv files:
agencies.txt
stops.txt
routes.txt
trips.txt
stop_times.txt
calendars.txt
shapes.txt
transfers.txt
These files are compliant with the GTFS standard.
GTFS identifiers
Each export is associated with a codespace. This codespace is used to find code value into Chouette models to identify the GTFS resources.
By default, the GTFS export uses the codespace “external” (used by default by the Chouette imports). For Stop Areas, Lines and Companies, the registration number is used as code (to be changed).
Duplicated codes
The export prevents automatically two GTFS resources to use the same code value. In this case, the Chouette unique identifier will be used in place. For example, a GTFS Trip can be identified by chouette:VehiculeJourney:868007fe-07f8-4e02-8615-2341ba5a82c4:LOC
when the associated code can be used as unique value.
Selected Vehicle Journeys
According to the options, the export selects the Vehicle Journeys which must included into the exported data. These exported Vehicle Journeys guide Chouette to select all other kind of models which must be included in the export (time tables, journey pattern, route, stop areas, etc).
GTFS Agencies
For each Company associated to an exported Vehicle Journey (or the Line of this Vehicle Journey), Chouette create a GTFS Agency in agencies.txt
with the following information:
GTFS Agency | Details | Chouette Company |
---|---|---|
agency_id | GTFS Agency ID |
|
agency_name | Name |
|
agency_url | Default Contact URL |
|
agency_timezone | Time Zone or |
|
agency_phone | Default Contact Phone |
|
agency_email | Default Contact Email |
|
agency_lang | Default Language |
|
If the Chouette Company registration number is empty, the Company ID is used as agency_id value.
A default GTFS Agency can be exported by Chouette, if one of the exported Vehicle Journeys isn’t associated to a Company or a Line associated to a Company. This default GTFS Agency uses these values:
Default GTFS Agency attribute | GTFS Agency |
---|---|
agency_id |
|
agency_name |
|
agency_timezone |
|
A warning message is added to the Export when the default GTFS Agency is used.
GTFS Stops
For each Stop Area associated to a Route of an exported Vehicle Journey or each specific Stop Area of an exported Vehicle Journey, Chouette creates a GTFS Stop in stops.txt
. Non commercial Stop Areas (borders, etc) are ignored by the GTFS export.
Parents of exported Stop Areas are exported (except parents that has just one Stop Area child if the option “Ignore Monomodal Stop Places with a single Quay” is activated).
If the exported Stop Area as a referent Stop Place and the option “Prefer Referent Stop Areas” is activated, the Referent Stop Area will be exported at the place of the particular Stop Area.
Each GTFS Stop uses the following information:
GTFS Stop | Details | Chouette Stop Area |
---|---|---|
stop_id | GTFS Stop ID |
|
stop_name | Name |
|
stop_lat | Latitude |
|
stop_lon | Longitude |
|
stop_desc | Comment |
|
stop_url | URL |
|
location_type |
|
|
parent_station | Associated Parent Stop ID |
|
stop_timezone | Time Zone |
|
wheelchair_boarding |
|
|
platform_code |
| use |
GTFS Route
For each Line associated to an exported Vehicle Journey, Chouette creates a GTFS Route in routes.txt
with the following information: