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:
GTFS Route | Details | Chouette Line |
---|---|---|
route_id | GTFS Route ID |
|
agency_id | Associated GTFS Agency ID | Company or |
route_short_name | Number |
|
route_long_name | Published Name |
|
route_desc | Comments |
|
route_type | Transport mode | See values below |
route_url | URL |
|
route_color | Line color |
|
route_text_color | Text color |
|
The GTFS route type value is selected according to the Chouette Line transport mode according to this mapping:
NeTEx Transport Mode | GTFS Route Type |
---|---|
Metro | 1 / Metro |
Funicular | 7 / Funicular |
Tram | 0 / Tram |
Rail | 2 / Rail |
Coach | 200 / Coach |
Bus | 3 / Bus |
Water | 4 / Ferry |
Telecabin | 6 / Gondola |
Air | 1100 / Air Service |
Hire Car | 1506 / Private Hire Service Vehicle |
Taxi | 1100 / Taxi Service |
GTFS Calendar and GTFS Calendar Date (Service)
For each Timetable including in the exported period associated to exported Vehicle Journeys :
for the first TimeTable Period and included/excluded Dates, Chouette creates a GTFS Calendar and GTFS Calendar Dates with the same GTFS Service ID.
if there is more than one Timetable Period, Chouette creates additional GTFS Calendars for each Timetable Period with a new GTFS Service ID.
Each GTFS Calendar are created with the following information:
GTFS Calendar | Details | Chouette TimeTable Period |
---|---|---|
service_id | GTFS Service ID |
|
monday | if monday is selected |
|
tuesday | if tuesday is selected | |
wednesday | if wednesday is selected | |
thursday | if thursday is selected | |
friday | if friday is selected | |
saturday | if saturday is selected | |
sunday | if sunday is selected | |
start_date | Period start date |
|
end_date | Period end date |
|
Each GTFS Calendar Date are written in calendar_dates.txt
:
GTFS Calendar Date | Details | Chouette TimeTable Date |
---|---|---|
service_id | GTFS Service ID |
|
date | Date |
|
exception_type | date is included : 1 date is excluded : 2 |
|
When several GTFS Calendars / Services are required, the GTFS export will need to create several GTFS Trips. See GTFS Trips section.
GTFS Trips
For each exported Vehicle Journey and each GTFS Service require to export the associated TimeTables, Chouette creates a dedicated GTFS Trip in trips.txt
with the following information:
GTFS Trip | Details | Chouette Vehicle Journey |
---|---|---|
trip_id | GTFS Trip ID | code or |
route_id | Associated GTFS Route ID |
|
service_id | Associated GTFS Service ID |
|
trip_short_name | Published Name |
|
direction_id |
| Route |
shape_id | Associated GTFS Shape id |
|
A single Chouette Vehicle Journey can be exported into several GTFS Trip because of GTFS format limitations on service/calendar description.
Example
A Timetable A on week days with two periods and an excluded date (on the first period)
A Timetable B with only included dates
A Vehicle Journey 1 which uses the two timetables A & B
A Vehicle Journey 2 which uses only the Timetable B
These models should be exported as:
A Calendar (service_id A1) for the first period of Timetable A and an associated Calendar Date for the excluded date
A Calendar (service_id A2) for the second period of Timetable A
A Calendar Date for each included dates of Timetable B (with the same service_id B)
A Trip for Vehicle Journey 1 associated to the service_id A1
A Trip for Vehicle Journey 1 associated to the service_id A2
A Trip for Vehicle Journey 1 associated to the service_id B
A Trip for Vehicle Journey 2 associated to the service_id B
GTFS Stop Times
For each Vehicle Journey At Stop associated to exported Vehicle Journey, Chouette creates a dedicated GTFS Stop Time in stop_times.txt
with the following information:
GTFS Stop Time | Details | Chouette Vehicle Journey At Stop |
---|---|---|
trip_id | Associated GTFS Trip ID |
|
arrival_time | Arrival Time |
|
departure_time | Departure Time |
|
stop_id | GTFS Stop ID | the Route Stop Area by default |
stop_sequence | Position |
|
pickup_type | Indicates pickup method. Valid options are: 0 or empty - Regularly scheduled pickup. 1 - No pickup available. 2 - Must phone agency to arrange pickup. 3 - Must coordinate with driver to arrange pickup. |
|
When the user exports Vehicle Journeys associated to a Line with the flag "On demand transportation", all associated GTFS Stop Times use the pickup type 2.
GTFS Transfers
For each Connection Link with both departure and arrival associated to the exported Stop Areas, Chouette creates a dedicated GTFS Transfer with the following information:
GTFS Transfer | Details | Chouette Connection Link |
---|---|---|
from_stop_id | Associated GTFS Stop ID |
|
to_stop_id | Associated GTFS Stop ID |
|
transfer_type |
|
|
min_transfer_time | Minimum Transfer Time |
|
GTFS Shapes
For each Shape associated to a Journey Pattern and linked to exported Vehicle Journeys, Chouette creates a dedicated GTFS Shape. For each geometry point of the Shape it creates an element in shapes.txt
with the following information :
GTFS Shape | Details | Chouette Shape |
---|---|---|
shape_id | GTFS Shape ID |
|
shape_pt_lat | Shape point latitude |
|
shape_pt_lon | Shape point longitude |
|
shape_pt_sequence | Shape point position |
|