Список станций следования
Запрос позволяет получить список станций следования нитки по указанному идентификатору нитки, информацию о каждой нитке и о промежуточных станциях нитки.
Идентификатор нитки можно получить в ответах на запросы: Расписание рейсов между станциями, Расписание рейсов по станции.
Примечание
Запрос следует отправлять по протоколу 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
Входные параметры:
Обязательные параметры
Параметр |
Описание |
|
Ключ доступа к API. Параметр можно не передавать, если ключ доступа указан в заголовке
|
|
Идентификатор нитки в Яндекс Расписаниях. Идентификатор нитки может меняться со временем. Поэтому перед каждым запросом станций нитки необходимо получать актуальный идентификатор запросом расписания рейсов между станциями или расписания рейсов по станции. |
Необязательные параметры
Параметр |
Описание |
|
Код станции отправления. Должен быть указан в системе кодирования. При использовании системы кодирования Яндекс Расписаний в данном параметре также можно указать код населенного пункта. Код населенного пункта или код станции можно получить из адресной строки, пользуясь Яндекс Расписаниями. Например, из адресной строки:
|
|
Код станции прибытия. Должен быть указан в системе кодирования. При использовании системы кодирования Яндекс Расписаний в данном параметре также можно указать код населенного пункта. Код населенного пункта или код станции можно получить из адресной строки, пользуясь Яндекс Расписаниями. Например, из адресной строки:
|
|
Формат ответа. Поддерживаемые значения:
|
|
Язык возвращаемой информации, в формате <код языка>_<код страны>. Поддерживаемые коды языка описаны стандартом ISO 639, коды стран — стандартом ISO 3166. По умолчанию ответ возвращается для значения Поддерживаемые коды языков:
Поддерживаемые коды стран:
|
|
Дата, на которую необходимо получить список станций следования. Должна быть указана в формате, соответствующем стандарту ISO 8601. Например, YYYY-MM-DD. По умолчанию возвращается список станций следования на первую дату хождения нитки. |
|
Cистеме кодирования, в которой необходимо получить коды станций (в элементе ответа Возможные значения:
По умолчанию элемент |
Структура ответа
Ответ представляет собой список станций следования нитки. Содержит подробную информацию о нитке, о всех промежуточных станциях нитки.
Возможные форматы ответа: 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 |
Тип |
Описание |
|
Строка |
Дни, в которые нитка не курсирует (даже если они входят в множество, описанное элементом |
|
Строка |
Дата прибытия на станцию, указанную в параметре Включается в ответ только если нитка не является интервальной. |
|
Строка |
Пункт отправления, указанный в параметре |
|
Строка (не более 100 символов) |
Идентификатор нитки, принятый в Яндекс Расписаниях. |
|
Строка |
Название нитки, составленное из полных названий первой и последней станций следования. |
|
Объект |
Информация о движении по интервальной нитке. |
|
Строка |
Дата отправления со станции, указанной в параметре Включается в ответ только если нитка не является интервальной. |
|
Строка |
Время отправления с первой станции следования по местному времени станции. Включается в ответ только если нитка не является интервальной. |
|
Строка |
Номер рейса. |
|
Строка |
Название нитки, составленное из коротких названий первой и последней станций следования. |
|
Строка |
Дни курсирования нитки. |
|
Строка |
Пункт прибытия, указанный в параметре |
|
Объект |
Информация о перевозчике. |
|
Строка |
Тип транспорта. Возможные значения:
|
|
Массив |
Список станций следования. |
|
Строка |
Название транспортного средства. |
|
Строка |
Дата отправления с первой станции следования. |
|
Объект |
Информация о подтипе транспортного средства. |
|
Строка |
Признак экспресса или аэроэкспресса. Значение по умолчанию — Если тип транспорта — электричка (ключ
|
Элементы объекта interval
Элемент JSON |
Тип |
Описание |
|
Строка |
Описание периодичности движения в свободной форме. |
|
Строка |
Дата и время окончания движения по нитке. Всегда указывается в часовом поясе станции отправления. Могут быть указаны в одном из двух форматов:
|
|
Число |
Дата и время начала движения по нитке. Всегда указывается в часовом поясе станции отправления. Могут быть указаны в одном из двух форматов:
|
Элементы объекта stops
Элемент JSON |
Тип |
Описание |
|
Строка |
Время прибытия, в формате ISO 8601 (YYYY-MM-DDThh:mm:ss±hh:mm). Если параметр |
|
Строка |
Время отправления, в формате ISO 8601 (YYYY-MM-DDThh:mm:ss±hh:mm). Если параметр |
|
Число |
Время в пути между станциями (в секундах). |
|
Число |
Продолжительность остановки (в секундах). |
|
Объект |
Информация о станции следования. |
|
Строка |
Терминал аэропорта (например, «D»). Принимает значение |
|
Строка |
Платформа или путь, с которого отправляется рейс (например, «3 путь»). Пустая строка значит, что информации о платформе или пути нет. |
Элементы объекта station
Элемент JSON |
Тип |
Описание |
|
Объект |
Список кодов станции в других системах кодирования, поддерживаемый Яндекс Расписаниями. |
|
Строка |
Название станции. |
|
Строка |
Тип станции.
|
|
Строка |
Название типа станции, зависит от языка ответа. Возможные значения на русском — в списке значений ключа |
|
Строка |
Общепринятое название станции. |
|
Строка |
Короткое название станции. |
|
Строка |
Код станции в системе кодирования Яндекс Расписаний. |
|
Строка |
Вид станции. Для запроса расписания по станции возможно только одно значение — |
Элементы объекта codes
Элемент JSON |
Тип |
Описание |
|
Строка |
Код станции в системе кодирования Экспресс-3. |
|
Строка |
Код станции в системе кодирования Яндекс Расписаний. |
|
Строка |
Код станции в системе кодирования ЕСР. |
Элементы объекта carrier
Элемент JSON |
Тип |
Описание |
|
Число |
Код перевозчика в системе кодирования Яндекс Расписаний. |
|
Объект |
Список кодов перевозчика в других системах кодирования, поддерживаемый Яндекс Расписаниями. |
|
Строка |
Название перевозчика. |
Элементы объекта codes
Элемент JSON |
Тип |
Описание |
|
Строка |
Код перевозчика в системе кодирования ICAO. |
|
Строка |
Код перевозчика в системе кодирования Sirena. |
|
Строка |
Код перевозчика в системе кодирования IATA. |
Элементы объекта transport_subtype
Элемент JSON |
Тип |
Описание |
|
Строка |
Основной цвет транспортного средства в шестнадцатеричном формате. |
|
Строка |
Код подтипа транспорта для типа, указанного в элементе Другие возможные значения:
|
|
Строка |
Описание подтипа транспорта на естественном языке. |
<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 |
Тип |
Описание |
|
Строка |
Дни, в которые нитка не курсирует (даже если они входят в множество, описанное элементом |
|
Строка |
Дата прибытия на станцию, указанную в параметре Включается в ответ только если нитка не является интервальной. |
|
Строка |
Пункт отправления, указанный в параметре |
|
Строка (не более 100 символов) |
Идентификатор нитки, принятый в Яндекс Расписаниях. |
|
Информация о движении по интервальной нитке. |
|
|
Строка |
Время отправления с первой станции следования по местному времени станции. |
|
Строка |
Номер рейса. |
|
Массив |
Элемент, описывающий станцию следования. |
|
Строка |
Признак экспресса или аэроэкспресса. Значение по умолчанию — Если тип транспорта — электричка (ключ
|
|
Строка |
Название нитки, составленное из полных названий первой и последней станций следования. |
|
Строка |
Дата отправления со станции, указанной в параметре Включается в ответ только если нитка не является интервальной. |
|
Строка |
Дни курсирования нитки. |
|
Строка |
Название нитки, составленное из коротких названий первой и последней станций следования. |
|
Строка |
Пункт прибытия, указанный в параметре |
|
Информация о перевозчике. |
|
|
Строка |
Тип транспорта. Возможные значения:
|
|
Строка |
Название транспортного средства. |
Элементы, вложенные в элемент interval
Элемент XML |
Тип |
Описание |
|
Число |
Дата и время начала движения по нитке. Всегда указывается в часовом поясе станции отправления. Могут быть указаны в одном из двух форматов:
|
|
Дата и время окончания движения по нитке. Всегда указывается в часовом поясе станции отправления. Могут быть указаны в одном из двух форматов:
|
|
|
Строка |
Описание периодичности движения в свободной форме. |
Элементы, вложенные в элемент stop
Элемент XML |
Тип |
Описание |
|
Строка |
Время прибытия, в формате ISO 8601 (YYYY-MM-DDThh:mm:ss±hh:mm). Если параметр |
|
Число |
Время в пути между станциями (в секундах). |
|
Элемент, содержащий информацию о станции следования. |
|
|
Строка |
Время отправления со станции по местному времени станции. |
|
Число |
Время остановки (в секундах). |
|
Строка |
Платформа или путь, с которого отправляется рейс (например, «3 путь»). Пустая строка значит, что информации о платформе или пути нет. |
|
Строка |
Терминал аэропорта (например, «D»). Принимает значение |
Элементы, вложенные в элемент station
Элемент XML |
Тип |
Описание |
|
Элемент, содержащий список кодов станции в других системах кодирования, поддерживаемый Яндекс Расписаниями. |
|
|
Строка |
Название станции. |
|
Строка |
Тип станции:
|
|
Строка |
Название типа станции, зависит от языка ответа. Возможные значения на русском — в списке значений элемента |
|
Строка |
Общепринятое название станции. |
|
Строка |
Короткое название станции. |
|
Строка |
Код станции в системе кодирования Яндекс Расписаний. |
|
Строка |
Вид станции. Для запроса расписания по станции возможно только одно значение — |
Элементы, вложенные в элемент codes
Элемент XML |
Тип |
Описание |
|
Строка |
Код станции в системе кодирования Экспресс-3. |
|
Строка |
Код станции в системе кодирования Яндекс Расписаний. |
|
Строка |
Код станции в системе кодирования ЕСР. |
Элементы, вложенные в элемент carrier
Элемент XML |
Тип |
Описание |
|
Число |
Код перевозчика в системе кодирования Яндекс Расписаний. |
|
Элемент, содержащий список кодов перевозчика в других системах кодирования, поддерживаемый Яндекс Расписаниями. |
|
|
Строка |
Название перевозчика. |
Элементы, вложенные в элемент codes
Элемент XML |
Тип |
Описание |
|
Строка |
Код перевозчика в системе кодирования ICAO. |
|
Строка |
Код перевозчика в системе кодирования Sirena. |
|
Строка |
Код перевозчика в системе кодирования IATA. |
Станция
Место отправления, прибытия или остановки транспортного средства. Например, автобусная остановка, автовокзал, аэропорт и т. п.
Нитка
Маршрут и время движения транспортного средства от начальной точки движения до конечной, привязанный к определенной дате.
Каждому рейсу соответствует нитка или набор ниток, определенный для конкретного дня. Например, в будние дни рейс «Москва — Голицыно» может двигаться по ниткам: «Москва — Одинцово», «Одинцово — Голицыно». В выходные дни этот же рейс может двигаться по нитке «Москва — Голицыно».
Интервальная нитка
Нитка, на остановках которой транспорт останавливается с определенной периодичностью, но без четкого расписания.
Ключ доступа к API.
Параметр можно не передавать, если ключ доступа указан в заголовке Authorization
, например:
Authorization: 1eb31582-941a-3ac8-a61f-041c344495ab
Идентификатор нитки в Яндекс Расписаниях.
Идентификатор нитки может меняться со временем. Поэтому перед каждым запросом станций нитки необходимо получать актуальный идентификатор запросом расписания рейсов между станциями или расписания рейсов по станции.
Код станции отправления. Должен быть указан в системе кодирования.
При использовании системы кодирования Яндекс Расписаний в данном параметре также можно указать код населенного пункта.
Код населенного пункта или код станции можно получить из адресной строки, пользуясь Яндекс Расписаниями. Например, из адресной строки:
- «http://rasp.yandex.ru/station/9600213» — код станции «s9600213» (к числовому значению кода добавляется латинская буква «s»);
- «http://rasp.yandex.ru/city/146» — код населенного пункта «c146» (к числовому значению кода добавляется латинская буква «c»).
Код станции прибытия. Должен быть указан в системе кодирования.
При использовании системы кодирования Яндекс Расписаний в данном параметре также можно указать код населенного пункта.
Код населенного пункта или код станции можно получить из адресной строки, пользуясь Яндекс Расписаниями. Например, из адресной строки:
- «https://rasp.yandex.ru/station/9600213» — код станции «s9600213» («s» от сокращенного «station»).
- «https://rasp.yandex.ru/city/146» — код населенного пункта «c146» («c» от сокращенного «city»).
Формат ответа. Поддерживаемые значения:
json
(по умолчанию);xml
.
Язык возвращаемой информации, в формате <код языка>_<код страны>. Поддерживаемые коды языка описаны стандартом ISO 639, коды стран — стандартом ISO 3166.
По умолчанию ответ возвращается для значения ru_RU
.
Поддерживаемые коды языков:
ru
— русский;uk
— украинский.
Поддерживаемые коды стран:RU
— Россия;UA
— Украина.
Дата, на которую необходимо получить список станций следования. Должна быть указана в формате, соответствующем стандарту ISO 8601. Например, YYYY-MM-DD.
По умолчанию возвращается список станций следования на первую дату хождения нитки.
Cистеме кодирования, в которой необходимо получить коды станций (в элементе ответа codes
, вложенном в элемент station
).
Возможные значения:
yandex
— система кодирования Яндекс Расписаний;esr
— коды железнодорожных станций СНГ и стран Балтии из базы ЕСР;all
— коды всех поддерживаемых систем кодирования.
По умолчанию элементstation
не содержит элементаcodes
.
Тип
Объект
Описание
Информация о станции отправления рейса.
Тип
Строка
Описание
Код пункта прибытия в системе кодирования Яндекс Расписаний.
Тип
Строка
Описание
Вид пункта отправления.
Возможные значения:
station
— станция;settlement
— поселение.
Тип
Строка
Описание
Название пункта отправления.
Тип
Строка
Описание
Время прибытия, в формате ISO 8601 (YYYY-MM-DDThh:mm:ss±hh:mm).
Если параметр result_timezone
не был передан, указывается в часовом поясе станции.
Тип
Строка
Описание
Тип отправляющегося транспортного средства.
Возможные значения:
plane
— самолет;train
— поезд;suburban
— электричка;bus
— автобус;water
— водный транспорт;helicopter
— вертолет.
Тип
Объект
Описание
Код перевозчика в системе кодирования ICAO.
Тип
Строка
Описание
Код перевозчика в системе кодирования Sirena.
Тип
Строка
Описание
Код перевозчика в системе кодирования IATA.
Тип
Объект
Описание
Информация о подтипе транспортного средства.
Тип
Строка
Описание
Основной цвет транспортного средства в шестнадцатеричном формате.
Тип
Строка
Описание
Название транспортного средства.
Тип
Строка
Описание
Признак экспресса или аэроэкспресса. Значение по умолчанию — null
.
Если тип транспорта — электричка (ключ transport_type
возвращен со значением suburban
), принимает одно из значений:
express
— экспресс-рейс;aeroexpress
— рейс, курсирующий между городом и аэропортом.
Тип
Строка
Описание
Время отправления, в формате ISO 8601 (YYYY-MM-DDThh:mm:ss±hh:mm).
Если параметр result_timezone
не был передан, указывается в часовом поясе станции.
Тип
Строка
Описание
Дни, в которые нитка не курсирует (даже если они входят в множество, описанное элементом days).
Тип
Объект
Описание
Информация о перевозчике.
Тип
Строка
Описание
Платформа или путь, с которого отправляется рейс (например, «3 путь»).
Пустая строка значит, что информации о платформе или пути нет.
Тип
Строка
Описание
Дни, в которые нитка не курсирует (даже если они входят в множество, описанное элементом days).
Тип
Строка
Описание
Терминал аэропорта (например, «D»).
Принимает значение null
, если информации о терминале нет.
Тип
Объект
Описание
Информация об указанной в запросе станции.
Тип
Строка
Описание
Код станции в системе кодирования Яндекс Расписаний.
Тип
Строка
Описание
Код станции в системе кодирования ЕСР.
Тип
Строка (не более 100 символов)
Описание
Идентификатор нитки, принятый в Яндекс Расписаниях.
Тип
Строка
Описание
Дата отправления с первой станции следования.
Тип
Объект
Описание
Информация о движении по интервальной нитке.
Тип
Число
Описание
Дата и время начала движения по нитке. Всегда указывается в часовом поясе станции отправления.
Могут быть указаны в одном из двух форматов:
YYYY-MM-DD
, если в запросе не был передан параметрdate
.YYYY-MM-DDTHH:MM:SS
, если параметрdate
был передан.
Тип
Строка
Описание
Дата и время окончания движения по нитке. Всегда указывается в часовом поясе станции отправления.
Могут быть указаны в одном из двух форматов:
YYYY-MM-DD
, если в запросе не был передан параметрdate
.YYYY-MM-DDTHH:MM:SS
, если параметрdate
был передан.
Тип
Строка
Описание
Описание периодичности движения в свободной форме.
Тип
Строка
Описание
Время отправления с первой станции следования по местному времени станции.
Включается в ответ только если нитка не является интервальной.
Тип
Строка
Описание
Название нитки, составленное из коротких названий первой и последней станций следования.
Тип
Строка
Описание
Пункт прибытия, указанный в параметре to
.
Тип
Число
Описание
Время в пути между станциями (в секундах).
Тип
Число
Описание
Продолжительность остановки (в секундах).
Тип
Строка
Описание
Код станции в системе кодирования Экспресс-3.
Тип
Строка
Описание
Название нитки, составленное из коротких названий первой и последней станций следования.
Тип
Строка
Описание
Общепринятое название станции.