Расписание рейсов по станции

Запрос позволяет получить список рейсов, отправляющихся от указанной станции и информацию по каждому рейсу.

Примечание.

Запрос следует отправлять по протоколу HTTPS.

  1. Синтаксис запроса
  2. Структура ответа

Синтаксис запроса

https://api.rasp.yandex.net/v3.0/schedule/ ?
  apikey=<ключ>
& station=<код станции>
& [lang=<язык>]
& [format=<формат>]
& [date=<дата>]
& [transport_types=<тип транспорта>]
& [event=<прибытие или отправление>]
& [system=<система кодирования для параметра station>]
& [show_systems=<коды в ответе>]
& [direction=<направление>]
& [result_timezone=<часовой пояс>]

Пример запроса:

https://api.rasp.yandex.net/v3.0/schedule/?apikey={ключ}&station=s9600213&transport_types=suburban&direction=на%20Москву

Входные параметры:

Параметр Описание
Обязательные параметры
apikey

Ключ доступа к API.

Параметр можно не передавать, если ключ доступа указан в заголовке Authorization, например:

Authorization: 1eb31582-941a-3ac8-a61f-041c344495ab
station

Код станции. Должен быть указан в системе кодирования.

Необязательные параметры
lang

Язык возвращаемой информации, в формате <код языка>_<код страны>. Поддерживаемые коды языка описаны стандартом ISO 639, коды стран — стандартом ISO 3166.

По умолчанию ответ возвращается для значения ru_RU.

Поддерживаемые коды языков:

  • ru — русский;

  • uk — украинский.

Поддерживаемые коды стран:

  • RU — Россия;

  • UA — Украина.

format

Формат ответа. Поддерживаемые значения:

  • json (по умолчанию);

  • xml.

date

Дата, на которую необходимо получить список рейсов. Должна быть указана в формате, соответствующем стандарту ISO 8601. Например, YYYY-MM-DD.

По умолчанию возвращается информация обо всех будущих рейсах.

transport_types

Тип транспортного средства. Возможные значения:

  • plane — самолет;

  • train — поезд;

  • suburban — электричка;

  • bus — автобус;

  • water — морской транспорт;

  • helicopter — вертолет.

По умолчанию возвращается список рейсов по всем типам транспортных средств.

direction

Код направления, по которому необходимо получить список рейсов электричек по станции (например, «arrival», «all» или «на Москву»).

Параметр direction игнорируется, если значение параметра transport_types отлично от suburban.

Доступные для станции коды направлений можно получить, запросив расписание на любую дату без параметра direction, но с параметром transport_types=suburban. Список направлений возвращается в элементе ответа directions.

event

Событие, для которого нужно отфильтровать нитки в расписании.

Поддерживаемые значения:

  • departure — включить в ответ только отправляющиеся со станции нитки (по умолчанию);

  • arrival — включить в ответ только прибывающие на станцию нитки.

system

Система кодирования, в которой указывается код станции (параметр station) в запросе. Возможные значения:

Параметр обязателен, если используется система кодирования, отличная от системы кодирования Яндекс.Расписаний.

show_systems

Система кодирования, в которой необходимо получить коды станций (в элементе ответа codes, вложенном в элемент station).

Возможные значения:

  • yandex — система кодирования Яндекс.Расписаний;

  • esr — коды железнодорожных станций СНГ и стран Балтии из базы ЕСР;

  • all — коды всех поддерживаемых систем кодирования.

По умолчанию элемент station не содержит элемента codes.

result_timezone

Часовой пояс, для которого следует указывать даты и времена в ответе. Если параметр не передан, каждая дата и время в ответе будут указаны в часовом поясе соответствующей станции.

Часовые пояса следует указывать с помощью идентификаторов базы данных tz. В английской Википедии приведен список идентификаторов из последней версии этой базы данных (в столбце «TZ» таблицы).

Структура ответа

Ответ представляет собой список рейсов с подробным описанием каждого рейса.

Количество рейсов, отображаемых на одной странице — не более 100. Информация об общем количестве полученных рейсов указана в ответе в элементе total элемента pagination.

Возможные форматы ответа: JSON, XML.

Структура ответа в различных форматах показана в примерах.

{
  "date": "2017-10-28",
  "pagination":
  {
    "total": 210,
    "limit": 100,
    "offset": 0
  },
  "station":
  { /* hide:station */
    "code": "s9600213",
    "title": "Шереметьево",
    "station_type": "аэропорт",
    "popular_title": "",
    "short_title": "",
    "transport_type": "train",
    "type": "station"
  },
  "schedule":
  [
    {
      "except_days": "6, 7, 8, 9, 13, 14 февраля",
      "arrival": "2017-02-27T00:04:00+03:00",
      "thread":
      { /* hide:thread */
        "uid":"7303A_9600213_g13_af",
        "title":"аэропорт Шереметьево - Москва (Белорусский вокзал)",
        "number":"7303",
        "short_title":"а/п Шереметьево - Москва (Белорусский вокзал)",
        "carrier":
        { /* hide:carrier */
          "code": 153,
          "codes": {
            "icao": null,
            "sirena": null,
            "iata": null
          },
          "title": "Центральная пригородная пассажирская компания"
        },
        "transport_type":"suburban",
        "vehicle":null,
        "transport_subtype":
        { /* hide:transport_subtype */
          "color": "#FF7F44",
          "code": "suburban",
          "title": "Пригородный поезд"
        },
        "express_type":"aeroexpress"   
      },
      "is_fuzzy":false,
      "days":"ежедневно",
      "stops":"без остановок",
      "departure": "2017-02-27T00:05:00+03:00",
      "terminal": null,
      "platform": ""
    },
    ...
  ],
  "interval_schedule":
  [
    {
      "except_days": null,
      "thread":
      {
        "uid": "502-*28mxt*29_0_f9744758t9744460_r2531_1",
        "title": "Москва (м. Медведково) — Пироговский (Посёлок Пироговский)",
        "interval":
        {
          "density": "маршрутное такси раз в 15-30 минут",
          "end_time": "2017-07-10T21:30:00",
          "begin_time": "2017-07-10T06:00:00"
        },
        "number": "502 (м/т)",
        "short_title": "Москва (м. Медведково) — Пироговский (Посёлок Пироговский)",
        "carrier": null,
        "transport_type": "bus",
        "vehicle": null,
        "transport_subtype":
        {
          "color": "#ff0000",
          "code": "bus",
          "title": "Автобус"
        },
        "express_type": null
      },
      "is_fuzzy": false,
      "days": "ежедневно",
      "stops": "",
      "terminal": null,
      "platform": ""
    },
    ...
  ],
  "schedule_direction":
  {
    "code": "на Москву",
    "title": "на Москву"
  },
  "directions":
  [
    {
      "code": "arrival",
      "title": "прибытие"
    },
    {
      "code": "на Москву",
      "title": "на Москву"
    },
    {
      "code": "all",
      "title": "все направления"
    }
  ]
}
Элемент JSON Тип Описание
date Строка

Дата, на которую получен список рейсов.

Принимает значение null, если в запросе не указан параметр date.
pagination Объект

Информация о постраничном выводе найденных рейсов.

station Объект

Информация об указанной в запросе станции.

schedule Массив

Список рейсов.

schedule_direction Объект

Код и название запрошенного направления рейсов.

Элемент включается в ответ, если в запросе указан параметр direction.

directions Объект

Коды и названия возможных направлений движения электричек по станции.

Элемент включается в ответ, если в запросе указан параметр transport_types со значением suburban.

Элементы объекта pagination
total Число

Общее количество рейсов, удовлетворяющих условиям поиска.

limit Число

Ограничение на количество рейсов, которые Яндекс.Расписания возвращают в ответ на запрос (заданное в параметре limit).

Значение по умолчанию — 100.

offset Число

Смещение относительно первого результата поиска, заданное в параметре offset.

Значение по умолчанию — 0.

Элементы объекта station
code Строка

Код станции в системе кодирования Яндекс.Расписаний.

station_type Строка

Тип станции.

Возможные значения:

  • station — станция;
  • platform — платформа;

  • stop — остановочный пункт;

  • checkpoint — блок-пост;

  • post — пост;

  • crossing — разъезд;

  • overtaking_point — обгонный пункт;

  • train_station — вокзал;

  • airport — аэропорт;

  • bus_station — автовокзал;

  • bus_stop — автобусная остановка;

  • unknown — станция без типа;

  • port — порт;

  • port_point — портпункт;

  • wharf — пристань;

  • river_port — речной вокзал;

  • marine_station — морской вокзал.

station_type_name Строка

Название типа станции, зависит от языка ответа. Возможные значения на русском — в списке значений ключа station_type.

title Строка

Название станции.

popular_title Строка

Общепринятое название станции.

short_title Строка

Короткое название станции.

codes Объект

Список кодов станции в системах кодирования, заданных параметром show_systems.

transport_type Строка

Тип транспорта, обслуживаемый станцией.

Возможные значения:

  • plane — самолет;

  • train — поезд;

  • suburban — электричка;

  • bus — автобус;

  • water — водный транспорт;

  • helicopter — вертолет.

type Строка Вид станции. Для запроса расписания по станции возможно только одно значение — station.
Элементы объекта schedule
except_days Строка Дни, в которые нитка не курсирует (даже если они входят в множество, описанное элементом days).
arrival Строка

Время прибытия, в формате ISO 8601 (YYYY-MM-DDThh:mm:ss±hh:mm).

Если параметр result_timezone не был передан, указывается в часовом поясе станции.

thread Объект

Информация о нитке.

is_fuzzy Булевый

Признак неточности времени отправления и времени прибытия. Возможные значения:

  • true — время прибытия и время отправления указаны неточно;

  • false — время прибытия и время отправления указан точно.

days Строка

Дни курсирования нитки.

stops Строка (не более 1000 символов)

Станции следования рейса, на которых совершается остановка. Описывается в свободной форме. Например, значение везде значит, что остановка совершается на всех станциях следования.

Пустая строка значит, что нитка нигде не останавливается между начальной и конечной станциями.

departure Строка

Время отправления, в формате ISO 8601 (YYYY-MM-DDThh:mm:ss±hh:mm).

Если параметр result_timezone не был передан, указывается в часовом поясе станции.

terminal Строка

Терминал аэропорта (например, «D»).

Принимает значение null, если информации о терминале нет.

platform Строка

Платформа или путь, с которого отправляется рейс (например, «3 путь»).

Пустая строка значит, что информации о платформе или пути нет.

Элементы объекта codes
yandex Строка

Код станции в системе кодирования Яндекс.Расписаний.

esr Строка

Код станции в системе кодирования ЕСР.

Элементы объекта schedule_direction
code Строка

Код направления.

Может принимать значения:
  • arrival — код направления с названием «прибытие», для рейсов электричек, прибывающих на станцию.

  • на Москву (на Шалю и т. д.) — код направления с названием, для электричек курсирующих по такому направлению.

  • all — код направления с названием «все направления», для рейсов, отправляющихся по всем возможным направлениям.

title Строка

Название направления.

Возможные значения: «прибытие», «все направления», «на Москву», «на Шалю» и т. д.

Элементы объекта thread
uid Строка (не более 100 символов)

Идентификатор нитки, принятый в Яндекс.Расписаниях.

title Строка

Название нитки. Составляется из полных названий первой и последней станций следования.

number Строка

Номер рейса.

short_title Строка

Короткое название нитки. Составляется из коротких названий первой и последней станций следования.

carrier Объект

Информация о перевозчике.

transport_type Строка

Тип транспортного средства. Возможные значения:

  • plane — самолет;

  • train — поезд;

  • suburban — электричка;

  • bus — автобус;

  • water — морской транспорт;

  • helicopter — вертолет.

По умолчанию возвращается список рейсов по всем типам транспортных средств.

vehicle Строка

Название транспортного средства.

transport_subtype Строка

Информация о подтипе транспортного средства.

express_type Строка

Признак экспресса или аэроэкспресса. Значение по умолчанию — null.

Если тип транспорта — электричка (ключ transport_type возвращен со значением suburban), принимает одно из значений:

  • express — экспресс-рейс;

  • aeroexpress — рейс, курсирующий между городом и аэропортом.

Элементы объекта codes
icao Строка

Код перевозчика в системе кодирования ICAO.

sirena Строка

Код перевозчика в системе кодирования Sirena.

iata Строка

Код перевозчика в системе кодирования IATA.

Элементы объекта transport_subtype
color Строка

Основной цвет транспортного средства в шестнадцатеричном формате.

code Строка

Код подтипа транспорта для типа, указанного в элементе transport_type. Подтип может совпадать с типом (например, для обычной электрички указывается тип suburban и подтип suburban).

Другие возможные значения:

  • helicopter — вертолет (для типа plane);

  • rex — экспресс РЭКС (для типа suburban);

  • sputnik«Спутник» (для типа suburban);

  • skiarrow«Лыжная стрела» (для типа suburban);

  • shezh«Снежинка» (для типа suburban);

  • skirus«Лыжня России» (для типа suburban);

  • city — городская электричка (для типа suburban);

  • kalina«Калина красная» (для типа suburban);

  • vostok«Восток» (для типа suburban);

  • prostoryaltaya«Просторы Алтая» (для типа suburban);

  • 14vag — состав из 14 вагонов (для типа suburban);

  • last«Ласточка» (для типа suburban);

  • exprdal — экспресс с билетами на конкретные места (для типа suburban);

  • volzhex«Волжский экспресс» (для типа suburban);

  • stdplus — электрички типа «стандарт плюс» (для типа suburban);

  • express — экспресс (для типа suburban);

  • skor — ускоренный поезд (для типа suburban);

  • fiztekh — Физтех.Электричка (для типа suburban);

  • vag6 — состав из 6 вагонов (для типа suburban);

  • river— речной транспорт (для типа water);

  • sea — морской транспорт (для типа water).

title Строка

Описание подтипа транспорта на естественном языке.

Элементы объекта carrier
code Число

Код перевозчика в системе кодирования Яндекс.Расписаний.

codes Объект

Список кодов перевозчика в других системах кодирования, поддерживаемых Яндекс.Расписаниями.

title Строка

Название перевозчика.

Элементы объекта directions
code Строка

Код направления. Может указываться в свободной форме, или одним из следующих идентификаторов:

  • all — все направления для указанной станции;

  • arrival — только прибывающие направления;

  • departure — только отправляющиеся направления.

title Строка

Название направления (расшифровка кода) в свободной форме. Если значение элемента code не является одним из идентификаторов, то название и код направления обычно совпадают (например, «на Москву»).