GTFS View

GTFS View

The Admin Panel product contains the GTFS view, which allows you to manage the intake of GTFS into Swiftly's system and more quickly diagnose issues with GTFS files that may cause problems in Swiftly's software. You must have permission within the Swiftly dashboard to make any changes to your agency’s GTFS files, intake methods, or settings. To get permission, reach out to [e-mail] or your Customer Success Manager.

 

GTFS Settings

The “Edit GTFS Settings” is where you can update GTFS information in Swiftly.

“Method” is where you choose whether you would like to update the GTFS automatically via a fetch location, or manually via a file upload.

Automatic GTFS Setting: If you are uploading your data automatically, you will need to add a URL next to “GTFS URL.”. The URL must be stable, and can not change from one file upload to the next. 

This “automatic” GTFS setting means that any new file that is posted to this URL will be automatically detected by Swiftly, and uploaded into the Swiftly platform. 

The “Advanced Features” allow you to select the frequency with which our system checks for GTFS file changes, and add or edit HTTP Headers to our requests for your GTFS file. The most common reason to include HTTP Headers is to include an API key that is needed to download the GTFS file.

Most agencies will not need to use the advanced features. If you are uncertain about a setting in this section, please contact [e-mail] or your Customer Success Manager.

The Advanced settings allow you to select the frequency with which Swiftly checks for GTFS file changes from the URL, and add or edit HTTP Headers to our requests for your GTFS file. The most common reason to include HTTP Headers is to include an API key that is needed to download the GTFS file.

Most agencies will not need to use the Advanced settings. If you are uncertain about a setting in this section, please contact [e-mail] or your Customer Success Manager.

Manual GTFS Setting: When using a manual upload, you will need to upload a zipped GTFS file directly from your computer. There is a box to enter a description to give context as to why you are uploading a file manually or what changes are contained in that file - a description is required for all manual file uploads.

It is important to note that when you switch to manual upload, Swiftly will no longer pick up automatic GTFS updates from the entered URL until it is changed back. Once automatic updates are turned back on, our system will update the GTFS if the files are different from those uploaded manually. If they are the same, our system will not upload a new GTFS. 

To learn more about Swiftly’s GTFS Intake process, you can read about it here. 

 

 

GTFS Intake History

The GTFS Intake History section This where you can see a history of all of the GTFS files uploaded to Swiftly. This section provides a space to investigate problems that may crop up from new GTFS file uploads.

• File Status: Shows "Active" for the currently-active GTFS file, and "Future" if a GTFS file has been processed and is waiting to become active.
• File Received: Shows the date and time that Swiftly received the GTFS file.
• Method: Shows the method that Swiftly received the GTFS file.
• Description: Shows the added description (if the file was added automatically, an automatic description is generated that lists the files changed from the previous version).
• Processing Status: Shows whether a download was successful or not. If the status is “Processing Failed,” an error message will appear in the expanded view for that row.

Click on the arrow to the left of file status to see more details about the GTFS file upload to Swiftly.

• File: Download
  • Download a zipped file of this GTFS version.
• Description: Shows the added description (if the file was added automatically, an automatic description is generated that lists the exact GTFS files that were changed from the previous version).
• Service Dates: Shows the active dates for that GTFS file.
• Email address: Information will populate showing who uploaded a file manually when a file is manually uploaded