Модуль:London DB/doc

Материал из Википедии — свободной энциклопедии
Перейти к навигации Перейти к поиску

Это страница документации Модуль:London DB.

Схема всех систем вместе (показан также Tramlink, не включённый в модуль)

Этот модуль строит списки станций по линиям для 4 транспортных систем Лондона.

Пояснения про реальность[править код]

В Лондоне нет понятия «пересадочный узел», все соединённые переходами платформы считаются одной станцией, а нумерация платформ на ней сквозная, причём фактически нумеруются не платформы, а пути. Однако разные части станции могут соответствовать разным линиям (хотя разные линии, иногда даже разных систем, могут использовать одни и те же платформы и пути). Линией, в свою очередь, фактически называется маршрут либо группа маршрутов (особенно на наземных и мелких участках; на глубоких участках более однозначно соответствие между путями и линиями, не зависящее от маршрутов).

В Лондоне в некоторых местах пересадка требует выхода за турникеты и повторного входа, но дополнительная оплата при этом не взимается, если между выходом и входом прошло менее заданного числа минут (в разных местах разное). В модуле большинство таких случаев не будут показаны одной строкой, однако, возможно, удастся обозначить такие переходы при помощи примечаний.

Таблица[править код]

Вывеска станции, на которой есть платформы всех систем (сверху вниз: DLR, Elizabeth line, Overground, Underground, National Rail)
Железнодорожный переезд через пути Overground
Поезд метро (красный) и поезд дальнего следования на одной станции

Большая таблица stations (около 600 строк) содержит полный список действующих станций четырёх систем, расположенных в основном на территории Лондона и управляемых TfL:

  • London Underground — метрополитен;
  • London Overground — сеть электричек;
  • DLR — автоматизированное лёгкое метро, в основном эстакадное;
  • Crossrail — скоростная сеть электричек, частично подземная (пока открыта одна линия — Elizabeth line).

Формально метрополитенами являются только первая и третья системы, но все они интегрированы с точки зрения входа-выхода и пересадок.

Существует пятая система, не управляемая TfL и не являющаяся городским транспортом, но интегрированная с первыми четырьмя в черте Лондона, — National Rail. Для станций, обслуживающих наряду с некоторыми из первых четырёх систем также National Rail, этот факт указывается, однако полный список станций National Rail не предусмотрен.

Функция и параметры[править код]

Главная функция list строит таблицу со списком станций.

  • Если в первый параметр передано слово London, то в список включаются все станции, присутствующие в таблице stations, и в том порядке, как они там перечислены. После названия станции приведено написание этого названия в статьях Википедии на некоторых других языках (выбраны языки, передающие звучание, для сравнения с записью на русском).
  • Если в первый параметр передано обозначение линии либо системы (в соответствии в обозначениями в таблице lines либо systems соответственно), а остальные параметры не заданы, то в список включаются только станции соответствующей линии либо системы, а список сортируется по русскому алфавиту.
  • Если в первом параметре задана линия, то поддерживаются второй и третий параметры, в которые передаются номера первой и последней станций участка линии, который надо изобразить (если третий параметр равен второму, его можно оставить пустым). Номера соответствуют значениям поля num в большой таблице. Список сортируется по порядку расположения станций на участке.
  • В предыдущем случае если поменять местами значения во втором и третьем параметрах, то порядок станций будет обращён, а если добавить непустое значение в именованном параметре hor, то список будет расположен не по вертикали, а по горизонтали.
  • Если в качестве первой станции (второй параметр) передать 0, то будут выданы все станции линии по порядку нумерации с добавлением номеров и ссылок на категории Викисклада, а также с разделительными линиями там, где номера идут не подряд (это те места, где намеренно оставлены разрывы в нумерации, чтобы обозначить переход на другую ветку).

Основной способ обращения к функции — с линией в первом параметре и с номерами станций (остальные способы существуют только для отладки). Выдача этой функции при основном способе обращения представляет собой таблицу из 4 столбцов. Первый столбец — название станции. Второй столбец — фотография той части станции, которая соответствует заданной линии. Третий столбец — тарифная зона, географическое положение станции и год её пуска. Четвёртый столбец — линии, на которые возможна пересадка. Между вторым и третьим столбцами проходит цветная полоса с кружочком у каждой станции. Можно отменить полосу до первого кружочка (выше или левее его) или после последнего (ниже или правее), передав непустое значение в именованные параметры white1 и white2.

Другие функции[править код]

Разрабатываются возможности для рисования полос, соединяющих таблицы, выдаваемые главной функцией.

Возможности развития[править код]

В модуле есть возможность добавить поддержку для других городов. Для этого надо добавить для каждого города:

  • строчки в таблицах cities, systems, lines, причём ключ в каждой из них должен остаться уникальным;
  • подстраницу по аналогии с Модуль:London DB/London.json (на месте слова London должно быть название города в том же написании, которое использовано в таблицах cities и systems).

Есть смысл добавлять города, в которых помимо собственно метрополитена имеется ещё как минимум одна рельсовая транспортная система, например со скоростными пригородными поездами, и много пересадочных станций между системами (Париж, Москва, Берлин).

Надо помнить, что у каждого города может быть своя специфика, например в Париже возможна ситуация, когда на станции есть платформы двух разных линий, но перехода с линии на линию (без выхода за турникеты) на этой станции нет.

Источники[править код]

  • Источник по топологии станций и их взаимосвязей здесь.
  • Источники по произношению английских названий (увы, они вместе не покрывают всего): 1, 2, 3.
  • Источник по бесплатным пересадкам (которые пока не отражены в модуле) здесь.
  • Источник по операторам National Rail (которые пока не отражены в модуле) здесь или здесь.
  • Источник по датам открытия станций (которые пока не отражены в модуле; только Underground) здесь.
  • Источник по доступности станций для инвалидов (которая пока не отражена в модуле) здесь.
  • Источник по глубинам станций (которые пока не отражены в модуле; только Underground) здесь.

Отладка[править код]

Черновики обращений к модулю находятся на его подстраницах.