Список станций следования

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

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

Идентификатор нитки можно получить в ответах на запросы: Расписание рейсов между станциями, Расписание рейсов по станции.

Примечание

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

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

https://api.rasp.yandex.net/v3.0/thread/ ?
  apikey=<ключ>
& uid=<идентификатор нитки>
& [from=<код станции отправления>]
& [to=<код станции прибытия>]
& [format=<формат>]
& [lang=<язык>]
& [date=<дата>]
& [show_systems=<коды в ответе>]

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

https://api.rasp.yandex.net/v3.0/thread/?apikey={ключ}&format=json&uid=038AA_tis&lang=ru_RU&show_systems=all

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

Обязательные параметры

Параметр

Описание

apikey

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

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

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

uid

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

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

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

Параметр	Описание
`from`	Код станции отправления. Должен быть указан в системе кодирования. При использовании системы кодирования Яндекс Расписаний в данном параметре также можно указать код населенного пункта. Код населенного пункта или код станции можно получить из адресной строки, пользуясь Яндекс Расписаниями. Например, из адресной строки: «http://rasp.yandex.ru/station/9600213» — код станции «s9600213» (к числовому значению кода добавляется латинская буква «s»); «http://rasp.yandex.ru/city/146» — код населенного пункта «c146» (к числовому значению кода добавляется латинская буква «c»).
`to`	Код станции прибытия. Должен быть указан в системе кодирования. При использовании системы кодирования Яндекс Расписаний в данном параметре также можно указать код населенного пункта. Код населенного пункта или код станции можно получить из адресной строки, пользуясь Яндекс Расписаниями. Например, из адресной строки: «https://rasp.yandex.ru/station/9600213» — код станции «s9600213» («s» от сокращенного «station»). «https://rasp.yandex.ru/city/146» — код населенного пункта «c146» («c» от сокращенного «city»).
`format`	Формат ответа. Поддерживаемые значения: `json` (по умолчанию); `xml`.
`lang`	Язык возвращаемой информации, в формате <код языка>_<код страны>. Поддерживаемые коды языка описаны стандартом ISO 639, коды стран — стандартом ISO 3166. По умолчанию ответ возвращается для значения `ru_RU`. Поддерживаемые коды языков: `ru` — русский; `uk` — украинский. Поддерживаемые коды стран: `RU` — Россия; `UA` — Украина.
`date`	Дата, на которую необходимо получить список станций следования. Должна быть указана в формате, соответствующем стандарту ISO 8601. Например, YYYY-MM-DD. По умолчанию возвращается список станций следования на первую дату хождения нитки.
`show_systems`	Cистеме кодирования, в которой необходимо получить коды станций (в элементе ответа `codes`, вложенном в элемент `station`). Возможные значения: `yandex` — система кодирования Яндекс Расписаний; `esr` — коды железнодорожных станций СНГ и стран Балтии из базы ЕСР; `all` — коды всех поддерживаемых систем кодирования. По умолчанию элемент `station` не содержит элемента `codes`.

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

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

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

Пример ответа в формате JSON

Пример ответа в формате XML

{
  "except_days": "",
  "arrival_date": null,
  "from": null,
  "uid":"038AA_tis",
  "title": "Москва - Санкт-Петербург",
  "interval":
  {
    "density": "автобус раз в 10-15 минут",
    "end_time": "2017-06-10T22:30:00",
    "begin_time": "2017-06-10T06:00:00"
  },
  "departure_date": null,
  "start_time": "00:44",
  "number": "038А",
  "short_title": "Москва - Санкт-Петербург",
  "days": "ежедневно, кроме вс",
  "to": null,
  "carrier":
  { /* hide:carrier */
    "code": 112,
    "offices": [],
    "codes":
    {
      "icao": null,
      "sirena": null,
      "iata": null
    },
    "title": "РЖД/ФПК",
  },
  "transport_type": "train",
  "stops":
  [
    { 
      "arrival": null,
      "departure": "2017-02-20T00:44:00+03:00",
      "terminal": null,
      "platform": "",
      "station":
      { /* hide:station */
        "codes":
        { 
          "express": "2006004",
          "yandex": "s2006004",
          "esr": "060073 "
        },
        "title": "Москва (Ленинградский вокзал)",
        "popular_title": "Ленинградский вокзал",
        "short_title": "М-Ленинградск",
        "code": "s2006004",
        "type": "station" 
      },
      "stop_time": null,
      "duration": 0.0
    },
    {
      "arrival": "2017-02-20T02:34:00",
        ...
    }
  ]
  "vehicle": null,
  "start_date": "2017-03-22",
  "transport_subtype":
  { /* hide:transport_subtype */
    "color": "#FF7F44",
    "code": "suburban",
    "title": "Пригородный поезд"
  },
  "express_type": null
}

Описание элементов JSON

Элемент JSON	Тип	Описание
`except_days`	Строка	Дни, в которые нитка не курсирует (даже если они входят в множество, описанное элементом `days`).
`arrival_date`	Строка	Дата прибытия на станцию, указанную в параметре `to`. Включается в ответ только если нитка не является интервальной.
`from`	Строка	Пункт отправления, указанный в параметре `from`.
`uid`	Строка (не более 100 символов)	Идентификатор нитки, принятый в Яндекс Расписаниях.
`title`	Строка	Название нитки, составленное из полных названий первой и последней станций следования.
`interval`	Объект	Информация о движении по интервальной нитке.
`departure_date`	Строка	Дата отправления со станции, указанной в параметре `from`. Включается в ответ только если нитка не является интервальной.
`start_time`	Строка	Время отправления с первой станции следования по местному времени станции. Включается в ответ только если нитка не является интервальной.
`number`	Строка	Номер рейса.
`short_title`	Строка	Название нитки, составленное из коротких названий первой и последней станций следования.
`days`	Строка	Дни курсирования нитки.
`to`	Строка	Пункт прибытия, указанный в параметре `to`.
`carrier`	Объект	Информация о перевозчике.
`transport_type`	Строка	Тип транспорта. Возможные значения: `plane` — самолет; `train` — поезд; `suburban` — электричка; `bus` — автобус; `water` — водный транспорт; `helicopter` — вертолет.
`stops`	Массив	Список станций следования.
`vehicle`	Строка	Название транспортного средства.
`start_date`	Строка	Дата отправления с первой станции следования.
`transport_subtype`	Объект	Информация о подтипе транспортного средства.
`express_type`	Строка	Признак экспресса или аэроэкспресса. Значение по умолчанию — `null`. Если тип транспорта — электричка (ключ `transport_type` возвращен со значением `suburban`), принимает одно из значений: `express` — экспресс-рейс; `aeroexpress` — рейс, курсирующий между городом и аэропортом.

Элементы объекта interval

Элемент JSON	Тип	Описание
`density`	Строка	Описание периодичности движения в свободной форме.
`end_time`	Строка	Дата и время окончания движения по нитке. Всегда указывается в часовом поясе станции отправления. Могут быть указаны в одном из двух форматов: `YYYY-MM-DD`, если в запросе не был передан параметр `date`. `YYYY-MM-DDTHH:MM:SS`, если параметр `date` был передан.
`begin_time`	Число	Дата и время начала движения по нитке. Всегда указывается в часовом поясе станции отправления. Могут быть указаны в одном из двух форматов: `YYYY-MM-DD`, если в запросе не был передан параметр `date`. `YYYY-MM-DDTHH:MM:SS`, если параметр `date` был передан.

Элементы объекта stops

Элемент JSON	Тип	Описание
`arrival`	Строка	Время прибытия, в формате ISO 8601 (YYYY-MM-DDThh:mm:ss±hh:mm). Если параметр `result_timezone` не был передан, указывается в часовом поясе станции.
`departure`	Строка	Время отправления, в формате ISO 8601 (YYYY-MM-DDThh:mm:ss±hh:mm). Если параметр `result_timezone` не был передан, указывается в часовом поясе станции.
`duration`	Число	Время в пути между станциями (в секундах).
`stop_time`	Число	Продолжительность остановки (в секундах).
`station`	Объект	Информация о станции следования.
`terminal`	Строка	Терминал аэропорта (например, «D»). Принимает значение `null`, если информации о терминале нет.
`platform`	Строка	Платформа или путь, с которого отправляется рейс (например, «3 путь»). Пустая строка значит, что информации о платформе или пути нет.

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

Элемент JSON	Тип	Описание
`codes`	Объект	Список кодов станции в других системах кодирования, поддерживаемый Яндекс Расписаниями.
`title`	Строка	Название станции.
`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`.
`popular_title`	Строка	Общепринятое название станции.
`short_title`	Строка	Короткое название станции.
`code`	Строка	Код станции в системе кодирования Яндекс Расписаний.
`type`	Строка	Вид станции. Для запроса расписания по станции возможно только одно значение — `station`.

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

Элемент JSON	Тип	Описание
`express`	Строка	Код станции в системе кодирования Экспресс-3.
`yandex`	Строка	Код станции в системе кодирования Яндекс Расписаний.
`esr`	Строка	Код станции в системе кодирования ЕСР.

Элементы объекта carrier

Элемент JSON	Тип	Описание
`code`	Число	Код перевозчика в системе кодирования Яндекс Расписаний.
`codes`	Объект	Список кодов перевозчика в других системах кодирования, поддерживаемый Яндекс Расписаниями.
`title`	Строка	Название перевозчика.

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

Элемент JSON	Тип	Описание
`icao`	Строка	Код перевозчика в системе кодирования ICAO.
`sirena`	Строка	Код перевозчика в системе кодирования Sirena.
`iata`	Строка	Код перевозчика в системе кодирования IATA.

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

Элемент JSON	Тип	Описание
`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`	Строка	Описание подтипа транспорта на естественном языке.

<response>
  <except_days>18 марта</except_days>
  <from>xsi:nil="true"</from>
  <uid>038AA_tis</uid>
  <start_date>2017-03-19</start_date>
  <title>Москва - Санкт-Петербург</title>
  <interval>
    <begin_time>2017-06-10T06:00:00</begin_time>
    <end_time>2017-06-10T22:30:00</end_time>
    <density>автобус раз в 10-15 минут</density>
  </interval>
  <start_time>22:41</start_time>
  <number>038А</number>
  <short_title>Москва - Санкт-Петербург</short_title>
  <days>ежедневно, кроме вс</days>
  <to>xsi:nil="true"</to>
  <carrier>
    <code{carrier}>112</code> 
    <title{carrier}>РЖД/ФПК</title>
    <codes{carrier}>
      <iata/>
      <icao/>
      <sirena/>     
    </codes>
  </carrier>
  <transport_type>train</transport_type>
  <stop>
    <arrival/>
    <duration>0.0</duration>
    <platform/>
    <terminal/>
    <departure>2014-02-20T00:44:00+03:00</departure>
    <stop_time/>
    <station>
      <code{station}>s2006004</code>
      <type>station</type>
      <codes{station}>
        <esr>060073</esr>
        <yandex>s2006004</yandex>
        <express>2006004</express>
      </codes>
      <title{station}>Москва (Ленинградский вокзал)</title>
      <short_title>М-Ленинградск</short_title>
      <popular_title>Ленинградский вокзал</popular_title>
    </station>
  </stop>
  <stop>
  ...
  </stop>
  ...
  <vehicle>xsi:nil="true"</vehicle>
  <transport_subtype>
    <color>#FF7F44</color>
    <code>suburban</code>
    <title>Пригородный поезд</title>
  </transport_subtype>
  <express_type>xsi:nil="true"</express_type>
</response>

Описание элементов XML

Элемент XML	Тип	Описание
`except_days`	Строка	Дни, в которые нитка не курсирует (даже если они входят в множество, описанное элементом `days`).
`arrival_date`	Строка	Дата прибытия на станцию, указанную в параметре `to`. Включается в ответ только если нитка не является интервальной.
`from`	Строка	Пункт отправления, указанный в параметре `from`.
`uid`	Строка (не более 100 символов)	Идентификатор нитки, принятый в Яндекс Расписаниях.
`interval`	Информация о движении по интервальной нитке.
`start_time`	Строка	Время отправления с первой станции следования по местному времени станции.
`number`	Строка	Номер рейса.
`stops`	Массив	Элемент, описывающий станцию следования.
`express_type`	Строка	Признак экспресса или аэроэкспресса. Значение по умолчанию — `null`. Если тип транспорта — электричка (ключ `transport_type` возвращен со значением `suburban`), принимает одно из значений: `express` — экспресс-рейс; `aeroexpress` — рейс, курсирующий между городом и аэропортом.
`title`	Строка	Название нитки, составленное из полных названий первой и последней станций следования.
`departure_date`	Строка	Дата отправления со станции, указанной в параметре `from`. Включается в ответ только если нитка не является интервальной.
`days`	Строка	Дни курсирования нитки.
`short_title`	Строка	Название нитки, составленное из коротких названий первой и последней станций следования.
`to`	Строка	Пункт прибытия, указанный в параметре `to`.
`carrier`	Информация о перевозчике.
`transport_type`	Строка	Тип транспорта. Возможные значения: `plane` — самолет; `train` — поезд; `suburban` — электричка; `bus` — автобус; `water` — водный транспорт; `helicopter` — вертолет.
`vehicle`	Строка	Название транспортного средства.

Элементы, вложенные в элемент interval

Элемент XML	Тип	Описание
`begin_time`	Число	Дата и время начала движения по нитке. Всегда указывается в часовом поясе станции отправления. Могут быть указаны в одном из двух форматов: `YYYY-MM-DD`, если в запросе не был передан параметр `date`. `YYYY-MM-DDTHH:MM:SS`, если параметр `date` был передан.
`end_time`		Дата и время окончания движения по нитке. Всегда указывается в часовом поясе станции отправления. Могут быть указаны в одном из двух форматов: `YYYY-MM-DD`, если в запросе не был передан параметр `date`. `YYYY-MM-DDTHH:MM:SS`, если параметр `date` был передан.
`density`	Строка	Описание периодичности движения в свободной форме.

Элементы, вложенные в элемент stop

Элемент XML	Тип	Описание
`arrival`	Строка	Время прибытия, в формате ISO 8601 (YYYY-MM-DDThh:mm:ss±hh:mm). Если параметр `result_timezone` не был передан, указывается в часовом поясе станции.
`duration`	Число	Время в пути между станциями (в секундах).
`station`		Элемент, содержащий информацию о станции следования.
`departure`	Строка	Время отправления со станции по местному времени станции.
`stop_time`	Число	Время остановки (в секундах).
`platform`	Строка	Платформа или путь, с которого отправляется рейс (например, «3 путь»). Пустая строка значит, что информации о платформе или пути нет.
`terminal`	Строка	Терминал аэропорта (например, «D»). Принимает значение `null`, если информации о терминале нет.

Элементы, вложенные в элемент station

Элемент XML	Тип	Описание
`codes`		Элемент, содержащий список кодов станции в других системах кодирования, поддерживаемый Яндекс Расписаниями.
`title`	Строка	Название станции.
`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`.
`popular_title`	Строка	Общепринятое название станции.
`short_title`	Строка	Короткое название станции.
`code`	Строка	Код станции в системе кодирования Яндекс Расписаний.
`type`	Строка	Вид станции. Для запроса расписания по станции возможно только одно значение — `station`.

Элементы, вложенные в элемент codes

Элемент XML	Тип	Описание
`express`	Строка	Код станции в системе кодирования Экспресс-3.
`yandex`	Строка	Код станции в системе кодирования Яндекс Расписаний.
`esr`	Строка	Код станции в системе кодирования ЕСР.

Элементы, вложенные в элемент carrier

Элемент XML	Тип	Описание
`code`	Число	Код перевозчика в системе кодирования Яндекс Расписаний.
`codes`		Элемент, содержащий список кодов перевозчика в других системах кодирования, поддерживаемый Яндекс Расписаниями.
`title`	Строка	Название перевозчика.

Элементы, вложенные в элемент codes

Элемент XML	Тип	Описание
`icao`	Строка	Код перевозчика в системе кодирования ICAO.
`sirena`	Строка	Код перевозчика в системе кодирования Sirena.
`iata`	Строка	Код перевозчика в системе кодирования IATA.

Список станций следования

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

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

Описание элементов JSON

Описание элементов XML

Станция

Нитка

Интервальная нитка

Была ли статья полезна?

Список станций следования

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

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

Описание элементов JSONОписание элементов JSON

Описание элементов XMLОписание элементов XML

СтанцияСтанцияСтанция

НиткаНиткаНитка

Интервальная ниткаИнтервальная ниткаИнтервальная нитка

Была ли статья полезна?

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

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

Описание элементов JSON

Описание элементов XML

Станция

Нитка

Интервальная нитка