Guidance Needed: Determining Primary Stop ID for Wharf in GTFS for Trip Planning

App development
1

Hi team,

I’m building a public transport app (KRAIL) using the static GTFS data provided on the Transport for NSW Open Data portal. I’ve encountered an issue related to ferry wharves and their corresponding stop IDs in the dataset.

For example, in the case of Barangaroo, the GTFS stops.txt file contains the following entries:

"2000441","2000441","Barangaroo Wharf 1",...
"2000442","2000442","Barangaroo Wharf 2",...

Similarly, Manly Wharf and Circular Quay Wharf also have multiple entries:

  • Manly, Wharf 1 (20951)
  • Manly, Wharf 2 (209525)
  • Manly, Wharf 3 (209593)

Each of these wharf numbers is represented by its own stop_id, but there is no parent_station field grouping them together. While I have grouped these stops manually on the UI side to show a single label like “Manly Wharf” (similar to the Opal app), I’m unsure which stop_id to use when making trip planning API calls, as the trip planning endpoints only accept a single stop_id.

In other words:

  • When a user selects “Manly Wharf” in my app, I don’t know which of the three stop IDs (20951, 209525, 209593) I should pass to your trip planning API.
  • The same applies to destinations like “Barangaroo Wharf”, which has 2000441 and 2000442.

Could you please advise:

Thanks so much for your time and for making this valuable dataset publicly available.

Kind regards,
Karan Sharma