---
title: GTFS Data Import Pipeline
description: Understand in detail how Podaris handles GTFS data
---

[Skip to content](https://support.podaris.com/gtfs-data-import-pipeline#main-content)

English

Show submenu for translations

![podaris\_logo\_png.png\]](https://support.podaris.com/hs-fs/hubfs/podaris_logo_png.png?height=50&name=podaris_logo_png.png)

Open main navigation

Close main navigation

- English
  
  Show submenu for translations
- [Go to podaris.com](https://podaris.com/)

[Go to podaris.com](https://podaris.com/)

 Podaris Support Centre

- There are no suggestions because the search field is empty.

1. [Help Center](https://support.podaris.com/?hsLang=en)
2. [Scheduled Services](https://support.podaris.com/scheduled-services?hsLang=en)
3. [GTFS Import](https://support.podaris.com/scheduled-services?hsLang=en#gtfs-import)

# GTFS Data Import Pipeline

## Understand in detail how Podaris handles GTFS data

The GTFS Data Pipeline in Podaris is a sophisticated system that transforms raw GTFS data into Podaris-specific data structures optimized for transit planning and analysis. This process involves several key steps and transformations, which may vary depending on which of the [Advanced Import options](https://support.podaris.com/network-import-options?hsLang=en) are selected. This pipeline is designed to balance fidelity to the original GTFS data with the need for efficient representation and analysis in Podaris. The various import options allow users to fine-tune this balance according to their specific project needs:

### 1. Data Ingestion

- The pipeline reads the GTFS zip file, extracting and parsing relevant .txt files (`agency.txt`, `stops.txt`, `calendar.txt`, `trips.txt`, `routes.txt`, etc.).
- It applies user-defined filters for [agencies](https://support.podaris.com/filtering-network-imports-by-agency?hsLang=en), [geographic areas](https://support.podaris.com/filtering-network-imports-by-geography?hsLang=en), and [date ranges](https://support.podaris.com/filtering-network-imports-by-date?hsLang=en).

### 2. Data Transformation

#### Agency and Stop Processing

- Agencies and stops are converted into Podaris-specific structures.

#### Route and Pattern Generation

- GTFS routes are converted into Podaris Services.
- For each transport mode, an [infrastructure layer](https://support.podaris.com/understanding-layers?hsLang=en) is created to host the stops which are served by that mode.
- Depending on the "**Use shapes.txt**" option: 
    - If **Yes**: Route geometries are derived from the `shapes.txt` file. These will be hard-coded and sometimes can be challenging to edit, but preserve the fidelity of the source data.
    - If **No**: Route geometries are either auto-generated using street networks or created as straight lines between stops, either of which are easily editable.
- Service Patterns are created based on unique stop sequences and shape data. 
    - Note that GTFS can reuse the same `shapes` across multiple different services, with not all of them calling at the same sequence of stations. In Podaris, this means that separate patterns will be created for each variant.
    - If the "**Use shape\_id for pattern name**" is  **Yes**, then the shape\_id will be applied to the patterns, which may be useful for analytical purposes.

#### Trip Processing

- The handling of trips depends on the "**Use trips.txt**" and "**Create individual trips**" options: 
    - If "**Use trips.txt"** is **Yes**: 
          - Detailed trip information is preserved.
          - If "**Create individual trips**" is **Yes**: Each GTFS trip becomes a separate Podaris trip.
          - If "**Create individual trips**" is **No**: Trips with identical patterns and schedules are aggregated.
    - If "**Use trips.txt**" is **No**: 
          - Trips are aggregated into frequency-based services where appropriate.
          - This results in a simplified trip structure that maintains overall service levels but may not exactly match the input data.

### Calendar Processing

- If the "**Identical Calendars**" option is set to "**Merge/De-duplicate**", the pipeline combines identical service patterns to reduce redundancy.

### 3. Data Optimization

- Based on the selected preset (**Strategic Planning**, **Network Analysis**, or **Detailed Editing**), the pipeline applies various optimizations: 
    - Simplifying route patterns for easier editing (**Strategic Planning**)
    - Dropping detailed route geometry for faster analysis (**Network Analysis**)
    - Preserving full data fidelity (**Detailed Editing**)

### 4. Additional Processing

- The pipeline handles frequency-based services, calculating headways and service spans.
- Depending on the "**Pattern Timings**" option, it includes varying levels of stop timing information.

### 5. Output Generation

 The pipeline generates a Podaris data structure containing:

- Services (with associated Patterns and trips)
- Calendars
- Agencies
- Vehicles
- Stations

 

- [Welcome](https://support.podaris.com/welcome?hsLang=en#main-content)

    - [Introduction](https://support.podaris.com/welcome?hsLang=en#introduction)
    - [Getting Started](https://support.podaris.com/welcome?hsLang=en#getting-started)
    - [Key Concepts](https://support.podaris.com/welcome?hsLang=en#key-concepts)
    - [Obtaining Further Help](https://support.podaris.com/welcome?hsLang=en#obtaining-further-help)
- [Projects](https://support.podaris.com/projects?hsLang=en#main-content)

    - [Projects Overview](https://support.podaris.com/projects?hsLang=en#projects-overview)
    - [Adding & Importing Sources](https://support.podaris.com/projects?hsLang=en#adding-importing-sources)
    - [Privacy Settings](https://support.podaris.com/projects?hsLang=en#privacy-settings)
    - [Collaborator Permissions](https://support.podaris.com/projects?hsLang=en#collaborator-permissions)
    - [Configuring Notifications](https://support.podaris.com/projects?hsLang=en#configuring-notifications)
    - [Project Menu](https://support.podaris.com/projects?hsLang=en#project-menu)
    - [Project Settings](https://support.podaris.com/projects?hsLang=en#project-settings)
    - [Projects FAQ](https://support.podaris.com/projects?hsLang=en#projects-faq)
    - [User Settings](https://support.podaris.com/projects?hsLang=en#user-settings)
- [Planning & Engineering](https://support.podaris.com/planning-engineering?hsLang=en#main-content)

    - [Plan Overview](https://support.podaris.com/planning-engineering?hsLang=en#plan-overview)
    - [Tools](https://support.podaris.com/planning-engineering?hsLang=en#tools)
    - [Controls](https://support.podaris.com/planning-engineering?hsLang=en#controls)
    - [Panels](https://support.podaris.com/planning-engineering?hsLang=en#panels)
    - [Modes](https://support.podaris.com/planning-engineering?hsLang=en#modes)
    - [Custom Tilesets](https://support.podaris.com/planning-engineering?hsLang=en#custom-tilesets)
    - [Datasets](https://support.podaris.com/planning-engineering?hsLang=en#datasets)
    - [Isochrones](https://support.podaris.com/planning-engineering?hsLang=en#isochrones)
    - [Optimising](https://support.podaris.com/planning-engineering?hsLang=en#optimising)
    - [Planning FAQ](https://support.podaris.com/planning-engineering?hsLang=en#planning-faq)
    - [Tutorials](https://support.podaris.com/planning-engineering?hsLang=en#tutorials)
    - [Terminology](https://support.podaris.com/planning-engineering?hsLang=en#terminology)
    - [Networks](https://support.podaris.com/planning-engineering?hsLang=en#networks)
    - [Streets](https://support.podaris.com/planning-engineering?hsLang=en#streets)
- [Scheduled Services](https://support.podaris.com/scheduled-services?hsLang=en#main-content)

    - [Terminology](https://support.podaris.com/scheduled-services?hsLang=en#terminology)
    - [Creating a Route (Tutorial)](https://support.podaris.com/scheduled-services?hsLang=en#creating-a-route-tutorial)
    - [GTFS Import](https://support.podaris.com/scheduled-services?hsLang=en#gtfs-import)
    - [Route Settings](https://support.podaris.com/scheduled-services?hsLang=en#route-settings)
    - [Analysis](https://support.podaris.com/scheduled-services?hsLang=en#analysis)
    - [Tutorials](https://support.podaris.com/scheduled-services?hsLang=en#tutorials)
    - [GTFS Export](https://support.podaris.com/scheduled-services?hsLang=en#gtfs-export)
- [Demand Responsive Transport Services](https://support.podaris.com/demand-responsive-transport-services?hsLang=en)
- [Stakeholder Engagement](https://support.podaris.com/stakeholder-engagement?hsLang=en#main-content)

    - [Engage](https://support.podaris.com/stakeholder-engagement?hsLang=en#engage)
    - [Creating Screenshots](https://support.podaris.com/stakeholder-engagement?hsLang=en#creating-screenshots)
- [Demand Modelling](https://support.podaris.com/demand-modelling?hsLang=en#main-content)

    - [Tutorials](https://support.podaris.com/demand-modelling?hsLang=en#tutorials)
    - [Glossary](https://support.podaris.com/demand-modelling?hsLang=en#glossary)
- [Accounts & Billing](https://support.podaris.com/accounts-billing?hsLang=en#main-content)

    - [Accounts FAQ](https://support.podaris.com/accounts-billing?hsLang=en#accounts-faq)
    - [Organisations](https://support.podaris.com/accounts-billing?hsLang=en#organisations)
- [Plugins and Integrations](https://support.podaris.com/plugins-and-integrations?hsLang=en)
- [Podaris:Insight](https://support.podaris.com/podarisinsight?hsLang=en#main-content)

    - [General](https://support.podaris.com/podarisinsight?hsLang=en#general)
    - [Analysis Types](https://support.podaris.com/podarisinsight?hsLang=en#analysis-types)
    - [FAQ](https://support.podaris.com/podarisinsight?hsLang=en#faq)
    - [Tutorials](https://support.podaris.com/podarisinsight?hsLang=en#tutorials)

[![Chill listening crop-3](https://support.podaris.com/hs-fs/hubfs/podaris_logo-1.png?width=142&height=55&name=podaris_logo-1.png "Chill listening crop-3")](https://support.podaris.com?hsLang=en)

<https://www.facebook.com/podaris> <https://twitter.com/podaris>

Copyright © 2026, Podaris Limited