Список станций следования
# Список станций следования
- [Синтаксис запроса](https://yandex.ru/dev/rasp/doc/ru/reference/list-stations-route#format)
- [Структура ответа](https://yandex.ru/dev/rasp/doc/ru/reference/list-stations-route#emails-detailed)
- [Станция](https://yandex.ru/dev/rasp/doc/ru/reference/list-stations-route#stanciya)
- [Нитка](https://yandex.ru/dev/rasp/doc/ru/reference/list-stations-route#nitka)
- [Интервальная нитка](https://yandex.ru/dev/rasp/doc/ru/reference/list-stations-route#intervalnaya-nitka)
Запрос позволяет получить список _станций_ следования _нитки_ по указанному идентификатору нитки, информацию о каждой нитке и о промежуточных станциях нитки.
Идентификатор нитки можно получить в ответах на запросы: [Расписание рейсов между станциями](https://yandex.ru/dev/rasp/doc/ru/reference/schedule-point-point), [Расписание рейсов по станции](https://yandex.ru/dev/rasp/doc/ru/reference/schedule-on-station).
## Синтаксис запроса
```
https://api.rasp.yandex-net.ru/v3.0/thread/ ?
apikey=<ключ>
& uid=<идентификатор нитки>
& [from=<код станции отправления>]
& [to=<код станции прибытия>]
& [format=<формат>]
& [lang=<язык>]
& [date=<дата>]
& [show_systems=<коды в ответе>]
```
Пример запроса:
```
https://api.rasp.yandex-net.ru/v3.0/thread/?apikey={ключ}&format=json&uid=038AA_tis&lang=ru_RU&show_systems=all
```
Входные параметры:
**Обязательные параметры**
| | |
| --- | --- |
| **Параметр** | **Описание** |
| `apikey` | [Ключ доступа](https://yandex.ru/dev/rasp/doc/ru/concepts/access) к API.
Параметр можно не передавать, если ключ доступа указан в заголовке `Authorization`, например:
```
Authorization: 1eb31582-941a-3ac8-a61f-041c344495ab
``` |
| `uid` | Идентификатор нитки в Яндекс Расписаниях.
Идентификатор нитки может меняться со временем. Поэтому перед каждым запросом станций нитки необходимо получать актуальный идентификатор запросом [расписания рейсов между станциями](https://yandex.ru/dev/rasp/doc/ru/reference/schedule-point-point) или [расписания рейсов по станции](https://yandex.ru/dev/rasp/doc/ru/reference/schedule-on-station). |
**Необязательные параметры**
| | |
| --- | --- |
| **Параметр** | **Описание** |
| `from` | Код станции отправления. Должен быть указан в [системе кодирования](https://yandex.ru/dev/rasp/doc/ru/concepts/coding-system).
При использовании системы кодирования Яндекс Расписаний в данном параметре также можно указать код населенного пункта.
Код населенного пункта или код станции можно получить из адресной строки, пользуясь Яндекс Расписаниями. Например, из адресной строки:
- «http://rasp.yandex.ru/station/9600213» — код станции «s9600213» (к числовому значению кода добавляется латинская буква «s»);
- «http://rasp.yandex.ru/city/146» — код населенного пункта «c146» (к числовому значению кода добавляется латинская буква «c»). |
| `to` | Код станции прибытия. Должен быть указан в [системе кодирования](https://yandex.ru/dev/rasp/doc/ru/concepts/coding-system).
При использовании системы кодирования Яндекс Расписаний в данном параметре также можно указать код населенного пункта.
Код населенного пункта или код станции можно получить из адресной строки, пользуясь Яндекс Расписаниями. Например, из адресной строки:
- «https://rasp.yandex.ru/station/9600213» — код станции «s9600213» («s» от сокращенного «station»).
- «https://rasp.yandex.ru/city/146» — код населенного пункта «c146» («c» от сокращенного «city»). |
| `format` | Формат ответа. Поддерживаемые значения:
- `json` (по умолчанию);
- `xml`. |
| `lang` | Язык возвращаемой информации, в формате <код языка>\_<код страны>. Поддерживаемые коды языка описаны стандартом [ISO 639](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2), коды стран — стандартом [ISO 3166](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2).
По умолчанию ответ возвращается для значения `ru_RU`.
Поддерживаемые коды языков:
- `ru` — русский;
- `uk` — украинский.
Поддерживаемые коды стран:
- `RU` — Россия;
- `UA` — Украина. |
| `date` | Дата, на которую необходимо получить список станций следования. Должна быть указана в формате, соответствующем стандарту [ISO 8601](https://ru.wikipedia.org/wiki/ISO_8601). Например, YYYY-MM-DD.
По умолчанию возвращается список станций следования на первую дату хождения нитки. |
| `show_systems` | [Cистеме кодирования](https://yandex.ru/dev/rasp/doc/ru/concepts/coding-system), в которой необходимо получить коды станций (в элементе ответа `codes`, вложенном в элемент `station`).
Возможные значения:
- `yandex` — система кодирования Яндекс Расписаний;
- `esr` — коды железнодорожных станций СНГ и стран Балтии из базы [ЕСР](https://ru.wikipedia.org/wiki/%D0%95%D0%B4%D0%B8%D0%BD%D0%B0%D1%8F_%D1%81%D0%B5%D1%82%D0%B5%D0%B2%D0%B0%D1%8F_%D1%80%D0%B0%D0%B7%D0%BC%D0%B5%D1%82%D0%BA%D0%B0);
- `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` | Строка | Номер [рейса](https://yandex.ru/dev/rasp/doc/ru/concepts/termin#schedule). |
| `short_title` | Строка | Название нитки, составленное из коротких названий первой и последней станций следования. |
| `days` | Строка | Дни курсирования нитки. |
| `to` | Строка | Пункт прибытия, указанный в параметре `to`. |
| `carrier` | Объект | Информация о [перевозчике](https://yandex.ru/dev/rasp/doc/ru/concepts/termin#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` | Объект | Список кодов станции в других [системах кодирования](https://yandex.ru/dev/rasp/doc/ru/concepts/coding-system), поддерживаемый Яндекс Расписаниями. |
| `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](http://www.express-3.ru/). |
| `yandex` | Строка | Код станции в системе кодирования Яндекс Расписаний. |
| `esr` | Строка | Код станции в системе кодирования [ЕСР](https://ru.wikipedia.org/wiki/%D0%95%D0%B4%D0%B8%D0%BD%D0%B0%D1%8F_%D1%81%D0%B5%D1%82%D0%B5%D0%B2%D0%B0%D1%8F_%D1%80%D0%B0%D0%B7%D0%BC%D0%B5%D1%82%D0%BA%D0%B0). |
**Элементы объекта**`carrier`
| | | |
| --- | --- | --- |
| **Элемент JSON** | **Тип** | **Описание** |
| `code` | Число | Код перевозчика в системе кодирования Яндекс Расписаний. |
| `codes` | Объект | Список кодов перевозчика в других системах кодирования, поддерживаемый Яндекс Расписаниями. |
| `title` | Строка | Название перевозчика. |
**Элементы объекта**`codes`
| | | |
| --- | --- | --- |
| **Элемент JSON** | **Тип** | **Описание** |
| `icao` | Строка | Код перевозчика в системе кодирования [ICAO](https://ru.wikipedia.org/wiki/%D0%9C%D0%B5%D0%B6%D0%B4%D1%83%D0%BD%D0%B0%D1%80%D0%BE%D0%B4%D0%BD%D0%B0%D1%8F_%D0%BE%D1%80%D0%B3%D0%B0%D0%BD%D0%B8%D0%B7%D0%B0%D1%86%D0%B8%D1%8F_%D0%B3%D1%80%D0%B0%D0%B6%D0%B4%D0%B0%D0%BD%D1%81%D0%BA%D0%BE%D0%B9_%D0%B0%D0%B2%D0%B8%D0%B0%D1%86%D0%B8%D0%B8). |
| `sirena` | Строка | Код перевозчика в системе кодирования [Sirena](http://ru.wikipedia.org/wiki/%D0%A1%D0%B8%D1%80%D0%B5%D0%BD%D0%B0_(%D1%81%D0%B5%D1%82%D1%8C)). |
| `iata` | Строка | Код перевозчика в системе кодирования [IATA](https://ru.wikipedia.org/wiki/%D0%9C%D0%B5%D0%B6%D0%B4%D1%83%D0%BD%D0%B0%D1%80%D0%BE%D0%B4%D0%BD%D0%B0%D1%8F_%D0%B0%D1%81%D1%81%D0%BE%D1%86%D0%B8%D0%B0%D1%86%D0%B8%D1%8F_%D0%B2%D0%BE%D0%B7%D0%B4%D1%83%D1%88%D0%BD%D0%BE%D0%B3%D0%BE_%D1%82%D1%80%D0%B0%D0%BD%D1%81%D0%BF%D0%BE%D1%80%D1%82%D0%B0). |
**Элементы объекта**`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` | Строка | Описание подтипа транспорта на естественном языке. |
```
18 марта
xsi:nil="true"
038AA_tis
2017-03-19
Москва - Санкт-Петербург
2017-06-10T06:00:00
2017-06-10T22:30:00
автобус раз в 10-15 минут
22:41
038А
Москва - Санкт-Петербург
ежедневно, кроме вс
xsi:nil="true"
112
РЖД/ФПК
train
0.0
2014-02-20T00:44:00+03:00
s2006004
station
060073
s2006004
2006004
Москва (Ленинградский вокзал)
М-Ленинградск
Ленинградский вокзал
...
...
xsi:nil="true"
#FF7F44
suburban
Пригородный поезд
xsi:nil="true"
```
#### Описание элементов 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](http://www.express-3.ru/). |
| `yandex` | Строка | Код станции в системе кодирования Яндекс Расписаний. |
| `esr` | Строка | Код станции в системе кодирования [ЕСР](https://ru.wikipedia.org/wiki/%D0%95%D0%B4%D0%B8%D0%BD%D0%B0%D1%8F_%D1%81%D0%B5%D1%82%D0%B5%D0%B2%D0%B0%D1%8F_%D1%80%D0%B0%D0%B7%D0%BC%D0%B5%D1%82%D0%BA%D0%B0). |
**Элементы, вложенные в элемент**`carrier`
| | | |
| --- | --- | --- |
| **Элемент XML** | **Тип** | **Описание** |
| `code` | Число | Код перевозчика в системе кодирования Яндекс Расписаний. |
| `codes` | | Элемент, содержащий список кодов перевозчика в других системах кодирования, поддерживаемый Яндекс Расписаниями. |
| `title` | Строка | Название перевозчика. |
**Элементы, вложенные в элемент**`codes`
| | | |
| --- | --- | --- |
| **Элемент XML** | **Тип** | **Описание** |
| `icao` | Строка | Код перевозчика в системе кодирования [ICAO](https://ru.wikipedia.org/wiki/%D0%9C%D0%B5%D0%B6%D0%B4%D1%83%D0%BD%D0%B0%D1%80%D0%BE%D0%B4%D0%BD%D0%B0%D1%8F_%D0%BE%D1%80%D0%B3%D0%B0%D0%BD%D0%B8%D0%B7%D0%B0%D1%86%D0%B8%D1%8F_%D0%B3%D1%80%D0%B0%D0%B6%D0%B4%D0%B0%D0%BD%D1%81%D0%BA%D0%BE%D0%B9_%D0%B0%D0%B2%D0%B8%D0%B0%D1%86%D0%B8%D0%B8). |
| `sirena` | Строка | Код перевозчика в системе кодирования [Sirena](http://ru.wikipedia.org/wiki/%D0%A1%D0%B8%D1%80%D0%B5%D0%BD%D0%B0_(%D1%81%D0%B5%D1%82%D1%8C)). |
| `iata` | Строка | Код перевозчика в системе кодирования [IATA](https://ru.wikipedia.org/wiki/%D0%9C%D0%B5%D0%B6%D0%B4%D1%83%D0%BD%D0%B0%D1%80%D0%BE%D0%B4%D0%BD%D0%B0%D1%8F_%D0%B0%D1%81%D1%81%D0%BE%D1%86%D0%B8%D0%B0%D1%86%D0%B8%D1%8F_%D0%B2%D0%BE%D0%B7%D0%B4%D1%83%D1%88%D0%BD%D0%BE%D0%B3%D0%BE_%D1%82%D1%80%D0%B0%D0%BD%D1%81%D0%BF%D0%BE%D1%80%D1%82%D0%B0). |
### Станция
Место отправления, прибытия или остановки транспортного средства. Например, автобусная остановка, автовокзал, аэропорт и т. п.
### Нитка
Маршрут и время движения транспортного средства от начальной точки движения до конечной, привязанный к определенной дате.
Каждому рейсу соответствует нитка или набор ниток, определенный для конкретного дня. Например, в будние дни рейс «Москва — Голицыно» может двигаться по ниткам: «Москва — Одинцово», «Одинцово — Голицыно». В выходные дни этот же рейс может двигаться по нитке «Москва — Голицыно».
### Интервальная нитка
Нитка, на остановках которой транспорт останавливается с определенной периодичностью, но без четкого расписания.
[Ключ доступа](https://yandex.ru/dev/rasp/doc/ru/concepts/access) к API.
Параметр можно не передавать, если ключ доступа указан в заголовке `Authorization`, например:
```
Authorization: 1eb31582-941a-3ac8-a61f-041c344495ab
```
Идентификатор нитки в Яндекс Расписаниях.
Идентификатор нитки может меняться со временем. Поэтому перед каждым запросом станций нитки необходимо получать актуальный идентификатор запросом [расписания рейсов между станциями](https://yandex.ru/dev/rasp/doc/ru/reference/schedule-point-point) или [расписания рейсов по станции](https://yandex.ru/dev/rasp/doc/ru/reference/schedule-on-station).
Код станции отправления. Должен быть указан в [системе кодирования](https://yandex.ru/dev/rasp/doc/ru/concepts/coding-system).
При использовании системы кодирования Яндекс Расписаний в данном параметре также можно указать код населенного пункта.
Код населенного пункта или код станции можно получить из адресной строки, пользуясь Яндекс Расписаниями. Например, из адресной строки:
- «http://rasp.yandex.ru/station/9600213» — код станции «s9600213» (к числовому значению кода добавляется латинская буква «s»);
- «http://rasp.yandex.ru/city/146» — код населенного пункта «c146» (к числовому значению кода добавляется латинская буква «c»).
Код станции прибытия. Должен быть указан в [системе кодирования](https://yandex.ru/dev/rasp/doc/ru/concepts/coding-system).
При использовании системы кодирования Яндекс Расписаний в данном параметре также можно указать код населенного пункта.
Код населенного пункта или код станции можно получить из адресной строки, пользуясь Яндекс Расписаниями. Например, из адресной строки:
- «https://rasp.yandex.ru/station/9600213» — код станции «s9600213» («s» от сокращенного «station»).
- «https://rasp.yandex.ru/city/146» — код населенного пункта «c146» («c» от сокращенного «city»).
Формат ответа. Поддерживаемые значения:
- `json` (по умолчанию);
- `xml`.
Язык возвращаемой информации, в формате <код языка>\_<код страны>. Поддерживаемые коды языка описаны стандартом [ISO 639](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2), коды стран — стандартом [ISO 3166](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2).
По умолчанию ответ возвращается для значения `ru_RU`.
Поддерживаемые коды языков:
- `ru` — русский;
- `uk` — украинский.
Поддерживаемые коды стран:
- `RU` — Россия;
- `UA` — Украина.
Дата, на которую необходимо получить список станций следования. Должна быть указана в формате, соответствующем стандарту [ISO 8601](https://ru.wikipedia.org/wiki/ISO_8601). Например, YYYY-MM-DD.
По умолчанию возвращается список станций следования на первую дату хождения нитки.
[Cистеме кодирования](https://yandex.ru/dev/rasp/doc/ru/concepts/coding-system), в которой необходимо получить коды станций (в элементе ответа `codes`, вложенном в элемент `station`).
Возможные значения:
- `yandex` — система кодирования Яндекс Расписаний;
- `esr` — коды железнодорожных станций СНГ и стран Балтии из базы [ЕСР](https://ru.wikipedia.org/wiki/%D0%95%D0%B4%D0%B8%D0%BD%D0%B0%D1%8F_%D1%81%D0%B5%D1%82%D0%B5%D0%B2%D0%B0%D1%8F_%D1%80%D0%B0%D0%B7%D0%BC%D0%B5%D1%82%D0%BA%D0%B0);
- `all` — коды всех поддерживаемых систем кодирования.
По умолчанию элемент `station` не содержит элемента `codes`.
**Тип**
Объект
**Описание**
Информация о станции отправления рейса.
**Тип**
Строка
**Описание**
Код пункта прибытия в системе кодирования Яндекс Расписаний.
**Тип**
Строка
**Описание**
Вид пункта отправления.
Возможные значения:
- `station` — станция;
- `settlement` — поселение.
**Тип**
Строка
**Описание**
Название пункта отправления.
**Тип**
Строка
**Описание**
Время прибытия, в формате ISO 8601 (YYYY-MM-DDThh:mm:ss±hh:mm).
Если параметр `result_timezone` не был передан, указывается в часовом поясе станции.
**Тип**
Строка
**Описание**
Тип отправляющегося транспортного средства.
Возможные значения:
- `plane` — самолет;
- `train` — поезд;
- `suburban` — электричка;
- `bus` — автобус;
- `water` — водный транспорт;
- `helicopter` — вертолет.
**Тип**
Объект
**Описание**
Код перевозчика в системе кодирования [ICAO](https://ru.wikipedia.org/wiki/%D0%9C%D0%B5%D0%B6%D0%B4%D1%83%D0%BD%D0%B0%D1%80%D0%BE%D0%B4%D0%BD%D0%B0%D1%8F_%D0%BE%D1%80%D0%B3%D0%B0%D0%BD%D0%B8%D0%B7%D0%B0%D1%86%D0%B8%D1%8F_%D0%B3%D1%80%D0%B0%D0%B6%D0%B4%D0%B0%D0%BD%D1%81%D0%BA%D0%BE%D0%B9_%D0%B0%D0%B2%D0%B8%D0%B0%D1%86%D0%B8%D0%B8).
**Тип**
Строка
**Описание**
Код перевозчика в системе кодирования [Sirena](http://ru.wikipedia.org/wiki/%D0%A1%D0%B8%D1%80%D0%B5%D0%BD%D0%B0_(%D1%81%D0%B5%D1%82%D1%8C)).
**Тип**
Строка
**Описание**
Код перевозчика в системе кодирования [IATA](https://ru.wikipedia.org/wiki/%D0%9C%D0%B5%D0%B6%D0%B4%D1%83%D0%BD%D0%B0%D1%80%D0%BE%D0%B4%D0%BD%D0%B0%D1%8F_%D0%B0%D1%81%D1%81%D0%BE%D1%86%D0%B8%D0%B0%D1%86%D0%B8%D1%8F_%D0%B2%D0%BE%D0%B7%D0%B4%D1%83%D1%88%D0%BD%D0%BE%D0%B3%D0%BE_%D1%82%D1%80%D0%B0%D0%BD%D1%81%D0%BF%D0%BE%D1%80%D1%82%D0%B0).
**Тип**
Объект
**Описание**
Информация о подтипе транспортного средства.
**Тип**
Строка
**Описание**
Основной цвет транспортного средства в шестнадцатеричном формате.
**Тип**
Строка
**Описание**
Название транспортного средства.
**Тип**
Строка
**Описание**
Признак экспресса или аэроэкспресса. Значение по умолчанию — `null`.
Если тип транспорта — электричка (ключ `transport_type` возвращен со значением `suburban`), принимает одно из значений:
- `express` — экспресс-рейс;
- `aeroexpress` — рейс, курсирующий между городом и аэропортом.
**Тип**
Строка
**Описание**
Время отправления, в формате ISO 8601 (YYYY-MM-DDThh:mm:ss±hh:mm).
Если параметр `result_timezone` не был передан, указывается в часовом поясе станции.
**Тип**
Строка
**Описание**
Дни, в которые нитка не курсирует (даже если они входят в множество, описанное элементом days).
**Тип**
Объект
**Описание**
Информация о перевозчике.
**Тип**
Строка
**Описание**
Платформа или путь, с которого отправляется рейс (например, «3 путь»).
Пустая строка значит, что информации о платформе или пути нет.
**Тип**
Строка
**Описание**
Дни, в которые нитка не курсирует (даже если они входят в множество, описанное элементом days).
**Тип**
Строка
**Описание**
Терминал аэропорта (например, «D»).
Принимает значение `null`, если информации о терминале нет.
**Тип**
Объект
**Описание**
Информация об указанной в запросе станции.
**Тип**
Строка
**Описание**
Код станции в системе кодирования Яндекс Расписаний.
**Тип**
Строка
**Описание**
Код станции в системе кодирования [ЕСР](https://ru.wikipedia.org/wiki/%D0%95%D0%B4%D0%B8%D0%BD%D0%B0%D1%8F_%D1%81%D0%B5%D1%82%D0%B5%D0%B2%D0%B0%D1%8F_%D1%80%D0%B0%D0%B7%D0%BC%D0%B5%D1%82%D0%BA%D0%B0).
**Тип**
Строка (не более 100 символов)
**Описание**
Идентификатор нитки, принятый в Яндекс Расписаниях.
**Тип**
Строка
**Описание**
Дата отправления с первой станции следования.
**Тип**
Объект
**Описание**
Информация о движении по интервальной нитке.
**Тип**
Число
**Описание**
Дата и время начала движения по нитке. Всегда указывается в часовом поясе станции отправления.
Могут быть указаны в одном из двух форматов:
- `YYYY-MM-DD`, если в запросе не был передан параметр `date`.
- `YYYY-MM-DDTHH:MM:SS`, если параметр `date` был передан.
**Тип**
Строка
**Описание**
Дата и время окончания движения по нитке. Всегда указывается в часовом поясе станции отправления.
Могут быть указаны в одном из двух форматов:
- `YYYY-MM-DD`, если в запросе не был передан параметр `date`.
- `YYYY-MM-DDTHH:MM:SS`, если параметр `date` был передан.
**Тип**
Строка
**Описание**
Описание периодичности движения в свободной форме.
**Тип**
Строка
**Описание**
Время отправления с первой станции следования по местному времени станции.
Включается в ответ только если нитка не является [интервальной](https://yandex.ru/dev/rasp/doc/ru/concepts/termin#intervalthread).
**Тип**
Строка
**Описание**
Название нитки, составленное из коротких названий первой и последней станций следования.
**Тип**
Строка
**Описание**
Пункт прибытия, указанный в параметре `to`.
**Тип**
Число
**Описание**
Время в пути между станциями (в секундах).
**Тип**
Число
**Описание**
Продолжительность остановки (в секундах).
**Тип**
Строка
**Описание**
Код станции в системе кодирования [Экспресс-3](http://www.express-3.ru/).
**Тип**
Строка
**Описание**
Общепринятое название станции.