This is a small repository with a OSM file with the Polish Railway Network.

The dataset is complete and contains both stations and railway lines. Partial replacement bus data is also available.

The primary usage is for PolishTrainsGTFS.

The map itself, <plrailmap.osm> is available under the CC0 1.0 license.

Everything else in this repository (in particular the plrailmap Python module) is available under the MIT license.

These tags are always required:

• railway=station
• name: name of the station in the local language
• ref: PKP PLK code of the station (not necessarily an integer!)

Optional tags:

• ref:ibnr: available for most stations, but not all of them.
• ref:2: Station Kępno has 2 PKP PLK codes; the secondary code is available under this key.
• ref:ztmw: 4-digit station code used by ZTM Warszawa.
• name:pl: Must be used if the station name is not in Polish.
• wheelchair=yes/wheelchair/no: Determines whether the station is wheelchair accessible.

If the station name is not in Polish, name:pl should also be present.

Unless a station has public_transport=stop_position, it must be attached to a railway=rail way.

These tags are always required:

• public_transport=platform
• name - number of the platform (e.g. 1)
• ref:station - ID (ref) of the whole station

Optional tags:

• ref:ztmw: ;-separated list of 6-digit ZTM stop codes that should map to this platform.
• wheelchair=yes/wheelchair/no: Determines whether the platform is wheelchair accessible.

Not all stations have platforms (in fact, most of them don't).

To aid with finding the correct platform, the direction key might be present. If present it must contain a list (;-separated) of the following values:

• T: Platform used for trains terminating and starting at this station
• N/NE/E/SE/S/SW/W/NW: Platform used for trains in a specified heading.
• *: Platform used for trains in all geographical directions.

The following rules apply:

1. If one platform has a * direction hint, no heading hints may be present.
2. If using heading hints - at least 2 platforms with different heading hints must be present.
3. A single hint can only be present in at most one platform.
4. T hint has precedence over other hints, however if it's present - a * hint, or 2 heading hints are required.
5. There might be platforms without any direction hints, if they're used irregularly.
6. If there's no clear usage pattern for platforms (or if the pattern is not representable by the hint system), none of the platforms can have direction hints.

A pseudo-algorithm for matching a train to a platform based on the hints would be:

BEARING_CODE_TO_DEGREES = {
    "N":   0, "NE":  45, "E":  90, "SE": 135,
    "S": 180, "SW": 225, "W": 270, "NW": 315,
}

if station.has_platform_with_hint("T") and (train.terminates_at(station) or train.starts_at(station)):
    return station.platform_with_hint("T")

if station.has_platform_with_hint("*"):
    return station.platform_with_hint("*")

# Bearing calculation
if train.terminates_at(station):
    # Special case when there's no next station
    train_heading = calculate_heading(previous_station, station)
else:
    train_heading = calculate_heading(station, next_station)

closest_hint = min(
    station.all_available_heading_hints(),
    key=lambda hint: abs(train_heading - BEARING_CODE_TO_DEGREES[hint]),
)
return station.platform_with_hint(closest_hint)

By default, railway=station nodes must be part of a railway=rail way.

However, there are a couple of edge-case stations, where such 1-to-1 mapping is not possible (see Opole Główne or Kraków Bieżanów). In these cases extra public_transport=stop_position nodes may be present on the railway=rail ways, and the railway=station node will be left unattached.

In those cases the following tags are required:

• public_transport=stop_position,
• ref:station - ID (ref) of the whole station.
• platforms - list (;-separated) of names of platforms for which this stop position applies.

The following tags may be optionally provided:

• towards - list (;-separated) of IDs of stations which immediately follow or precede this station for this stop_position to apply; or fallback. When a station uses stop positions, there must be at least exactly one fallback stop position. Offers and alternative matching method if reliable platform data is not available for trains.

To mark positions of bus replacements' stops, highway=bus_stops may be used. Such stops must have an ref:station node, with the ID of the parent station. If there are more than one replacement bus stops attached to a single station, direction hints (see (platform direction hints)[#direction-hints]) must be provided.