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

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

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

Примечание.

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

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

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

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

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

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

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

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

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

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

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

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

Возможные форматы ответа: 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
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
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
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
express Строка Код станции в системе кодирования Экспресс-3.
yandex Строка Код станции в системе кодирования Яндекс.Расписаний.
esr Строка Код станции в системе кодирования ЕСР.
Элементы объекта carrier
code Число

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

codes Объект

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

title Строка Название перевозчика.
Элементы объекта 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 Строка

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