/
GTFS Export

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:

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).

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

GTFS Agency

Details

Chouette Company

agency_id

GTFS Agency ID

registration_number or by default objectid

agency_name

Name

name

agency_url

Default Contact URL

default_contact_url

agency_timezone

Time Zone or “Etc/GMT"

time_zone or by default “Etc/GMT"

agency_phone

Default Contact Phone

default_contact_phone

agency_email

Default Contact Email

default_contact_email

agency_lang

Default Language

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

Default GTFS Agency attribute

GTFS Agency

agency_id

“chouette_default”

agency_name

“Default Agency”

agency_timezone

“Etc/GMT”

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

GTFS Stop

Details

Chouette Stop Area

stop_id

GTFS Stop ID

registration_number or by default objectid

stop_name

Name

name

stop_lat

Latitude

latitude

stop_lon

Longitude

longitude

stop_desc

Comment

comment

stop_url

URL

url

location_type

0 for Quay,

1 for other Stop Area type

0 when area_type is Quay or 1

parent_station

Associated Parent Stop ID

registration_number or by default objectid of the StopArea selected as parent

stop_timezone

Time Zone

time_zone if there is no parents

wheelchair_boarding

0 when not present or false

1 when true

mobility_restricted_suitability

platform_code

 

use public_code

GTFS Route

For each Line associated to an exported Vehicle Journey, Chouette creates a GTFS Route in routes.txtwith the following information:

GTFS Route

Details

Chouette Line

GTFS Route

Details

Chouette Line

route_id

GTFS Route ID

registration_number or by default objectid

agency_id

Associated GTFS Agency ID

Company registration_number or by default objectid

or chouette_default if no associated Company

route_short_name

Number

number

route_long_name

Published Name

published_nameor by default name (set if the value is different from route_short_name or blank otherwise)

route_desc

Comments

comment

route_type

Transport mode

See values below

route_url

URL

url

route_color

Line color

color

route_text_color

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 and submode

GTFS route_type

GTFS transport mode

Netex transport mode and submode

GTFS route_type

GTFS transport mode

Transport mode : tram

Transport submode : none

0 - Tram, Streetcar, Light rail. Any light rail or street level system within a metropolitan area.

canonical

Transport mode : metro

Transport submode : none

1 - Subway, Metro. Any underground rail system within a metropolitan area.

Transport mode : rail

Transport submode : none

2 - Rail. Used for intercity or long-distance travel.

Transport mode : bus

Transport submode : none

3 - Bus. Used for short- and long-distance bus routes.

Transport mode : water

Transport submode : none

4 - Ferry. Used for short- and long-distance boat service.

Transport mode : funicular

Transport submode : streetCableCar

5 - Cable tram. Used for street-level rail cars where the cable runs beneath the vehicle (e.g., cable car in San Francisco).

Transport mode : telecabin

Transport submode : none

6 - Aerial lift, suspended cable car (e.g., gondola lift, aerial tramway). Cable transport where cabins, cars, gondolas or open chairs are suspended by means of one or more cables.

Transport mode : funicular

Transport submode : none

7 - Funicular. Any rail system designed for steep inclines.

Transport mode : trolleyBus

Transport submode : none

11 - Trolleybus. Electric buses that draw power from overhead wires using poles.

Transport mode : rail

Transport submode : monorail

12 - Monorail. Railway in which the track consists of a single rail or a beam.

Transport mode : rail

Transport submode : none

100 - Railway Service

extended
(See Extended GTFS Route Types  |  Static Transit  |  Google for Developers )

Transport mode : rail

Transport submode : interregionalRail

103 - Inter Regional Rail Service

Transport mode : coach

Transport submode : none

200 - Coach Service

Transport mode : coach

Transport submode : regionalCoach

204 - Regional Coach Service

Transport mode : coach

Transport submode : specialCoach

205 - Special Coach Service

Transport mode : coach

Transport submode : commuterCoach

208 - Commuter Coach Service

Transport mode : bus

Transport submode : none

700 - Bus Service

Transport mode : bus

Transport submode : schoolAndPublicServiceBus

713 - School and Public Service Bus

Transport mode : air

Transport submode : none

1100 - Air Service

Transport mode : hireCar

Transport submode : none

1506 - Private Hire Service Vehicle

Transport mode : taxi

Transport submode : none

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

GTFS Calendar

Details

Chouette TimeTable Period

service_id

GTFS Service ID

objectid

monday

if monday is selected

days_of_week

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

period_start

end_date

Period end date

period_end

Each GTFS Calendar Date are written in calendar_dates.txt :

GTFS Calendar Date

Details

Chouette TimeTable Date

GTFS Calendar Date

Details

Chouette TimeTable Date

service_id

GTFS Service ID

objectid

date

Date

date

exception_type

date is included : 1

date is excluded : 2

in_out

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

GTFS Trip

Details

Chouette Vehicle Journey

trip_id

GTFS Trip ID

code or objectid. The GTFS Service id is added for additional GTFS Trips.

route_id

Associated GTFS Route ID

registration_number or by default objectid

service_id

Associated GTFS Service ID

 

trip_short_name

Published Name

published_journey_name

direction_id

0 for outbound Route or 1

Route wayback

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: