Расписание рейсов между станциями
# Расписание рейсов между станциями
- [Синтаксис запроса](https://yandex.ru/dev/rasp/doc/ru/reference/schedule-point-point#format)
- [Структура ответа](https://yandex.ru/dev/rasp/doc/ru/reference/schedule-point-point#emails-detailed)
Запрос позволяет получить список [рейсов](https://yandex.ru/dev/rasp/doc/ru/concepts/termin#schedule), следующих от указанной [станции](https://yandex.ru/dev/rasp/doc/ru/concepts/termin#station) отправления к указанной станции прибытия и информацию по каждому рейсу.
## Синтаксис запроса
```
https://api.rasp.yandex-net.ru/v3.0/search/ ?
from=<код станции отправления>
& to=<код станции прибытия>
& [format=<формат — XML или JSON>]
& [lang=<язык>]
& [apikey=<ключ>]
& [date=<дата>]
& [transport_types=<тип транспорта>]
& [system=<система кодирования параметров to и from>]
& [show_systems=<система кодирования для ответа>]
& [offset=<сдвиг относительно первого рейса в ответе>]
& [limit=<ограничение на количество рейсов в ответе>]
& [add_days_mask=<запрос календаря хождения рейсов>]
& [result_timezone=<часовой пояс>]
& [transfers=<признак запроса маршрутов с пересадками>]
```
Пример запроса:
```
https://api.rasp.yandex-net.ru/v3.0/search/?apikey={ключ}&format=json&from=c146&to=c213&lang=ru_RU&page=1&date=2015-09-02
```
Входные параметры:
**Обязательные параметры**
| | |
| --- | --- |
| **Параметр** | **Описание** |
| `apikey` | [Ключ доступа](https://yandex.ru/dev/rasp/doc/ru/concepts/access) к API.
Параметр можно не передавать, если ключ доступа указан в заголовке `Authorization`, например:
```
Authorization: 1eb31582-941a-3ac8-a61f-041c344495ab
``` |
| `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/List_of_ISO_639-1_codes), коды стран — стандартом [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.
Если в запросе указана конкретная дата, в выдаче будут показаны все будущие рейсы, в том числе с пересадками.
Если запрос передан без даты, в выдаче будут показаны только прямые рейсы на все даты. В этом случае рейсы с пересадками не попадут в выдачу. |
| `transport_types` | Тип транспортного средства. Возможные значения:
- `plane` — самолет;
- `train` — поезд;
- `suburban` — электричка;
- `bus` — автобус;
- `water` — морской транспорт;
- `helicopter` — вертолет.
По умолчанию возвращается список рейсов по всем типам транспортных средств. |
| `system` | [Система кодирования](https://yandex.ru/dev/rasp/doc/ru/concepts/coding-system), в которой указывается код станции отправления и код станции прибытия (параметры _from_, _to_) в запросе. Возможные значения:
- `yandex` (значение по умолчанию) — система кодирования Яндекс Расписаний;
- `iata` — [коды Международной ассоциации воздушного транспорта](https://ru.wikipedia.org/wiki/%D0%9A%D0%BE%D0%B4_%D0%98%D0%90%D0%A2%D0%90);
- `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));
- `express` — коды железнодорожных станций СНГ и стран Балтии из базы [Экспресс-3](http://www.express-3.ru/);
- `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).
Параметр обязателен, если используется система кодирования, отличная от системы кодирования Яндекс Расписаний. |
| `show_systems` | Система кодирования, коды которой следует добавить к описанию станций в результатах поиска (элемент `codes`, вложенный в элементы `from` и `to`).
Поддерживаемые значения:
- `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). |
| `offset` | Смещение относительно первого результата поиска. Например, если вам не нужны первые 10 результатов поиска, задайте для параметра значение «10».
Значение по умолчанию — 0. |
| `limit` | Максимальное количество результатов поиска в ответе.
Значение по умолчанию — 100. |
| `add_days_mask` | Признак, который указывает, что для каждой нитки в ответе следует вернуть календарь хождения — элемент `schedule`, вложенный в элемент `segments`.
Поддерживаемые значения:
- `false` — календарь возвращать не нужно (значение по умолчанию).
- `true` — для каждой нитки следует вернуть календарь хождения. |
| `result_timezone` | Часовой пояс, для которого следует указывать даты и времена в ответе. Если параметр не передан, каждая дата и время в ответе будут указаны в часовом поясе соответствующей станции.
Часовые пояса следует указывать с помощью идентификаторов [базы данных tz](https://ru.wikipedia.org/wiki/Tz_database). В английской Википедии приведен список идентификаторов из последней версии этой базы данных (в столбце «TZ» таблицы). |
| `transfers` | Признак, разрешающий добавить к результатам поиска маршруты с пересадками.
Поддерживаемые значения:
- `false` — в результатах поиска не должно быть маршрутов с пересадками (значение по умолчанию).
- `true` — найденные маршруты с пересадками следует добавить к результатам поиска. |
## Структура ответа
Ответ представляет собой список рейсов с информацией по каждому рейсу.
Количество рейсов, отображаемых на одной странице — не более 100\. Информация об общем количестве полученных рейсов указана в ответе в элементе `total` элемента `pagination`.
Возможные форматы ответа: JSON, XML.
Структура ответа в различных форматах показана в примерах.
Пример ответа в формате JSON
Пример ответа в формате XML
```
{
"pagination":
{
"total": 11,
"limit": 100,
"offset": 0
},
"interval_segments":
[\
{\
"from":\
{\
"code": "s9600396",\
"title": "Симферополь",\
"popular_title": "",\
"short_title": "",\
"transport_type": "plane",\
"type": "station",\
"station_type": "bus_stop",\
"station_type_name": "автобусная остановка"\
},\
"thread":\
{\
"uid": "SU-1827A_c26_agent",\
"title": "Симферополь - Москва",\
"interval":\
{\
"density": "автобус раз в 10-15 минут",\
"end_time": "2017-06-10T22:30:00",\
"begin_time": "2017-06-10T06:00:00"\
},\
"number": "SU 1827",\
"short_title": "Симферополь - Москва",\
"thread_method_link": "api.rasp.yandex-net.ru/v3.0/thread/?date=2017-01-02&uid=U6-8_1_c30_5",\
"carrier":\
{\
"code": 196,\
"contacts": "Служба поддержки: для звонков из России: 8-800 2000 000",\
"url": "http://example.com/",\
"logo_svg": null,\
"title": "Example Inc.",\
"phone": "",\
"codes":\
{\
"icao": null,\
"sirena": "У6",\
"iata": "U6"\
},\
"address": "Москва, ул. Тверская, 6",\
"logo": "//yastatic.net/rasp/media/data/company/logo/example.jpg",\
"email": "info@example.com"\
},\
"transport_type": "plane",\
"vehicle": "Airbus А321",\
"transport_subtype":\
{\
"color": "#FF7F44",\
"code": "suburban",\
"title": "Пригородный поезд"\
},\
"express_type": null\
},\
"departure_platform": "",\
"stops": "",\
"departure_terminal": null,\
"to":\
{\
"code": "s9600213",\
"title": "Шереметьево",\
"popular_title": "",\
"short_title": "",\
"transport_type": "plane",\
"type": "station",\
"station_type": "bus_stop",\
"station_type_name": "автобусная остановка"\
},\
"has_transfers": false,\
"tickets_info":\
{\
"et_marker": false,\
"places":\
[\
{\
"currency": "RUB",\
"price":\
{\
"cents": 0,\
"whole": 4863\
},\
"name": "эконом"\
}\
]\
},\
"duration": 8100,\
"arrival_terminal": "D",\
"start_date": "2017-01-02",\
"arrival_platform": ""\
},\
{\
"from":\
...\
}\
],
"segments":
[\
{\
"arrival": "2017-03-28 10:15:00",\
"from":\
{\
"code": "s9600396",\
"title": "Симферополь",\
"popular_title": "",\
"short_title": "",\
"transport_type": "plane",\
"station_type": "bus_stop",\
"station_type_name": "автобусная остановка",\
"type": "station"\
},\
"thread":\
{\
"uid": "SU-1827A_c26_agent",\
"title": "Симферополь - Москва",\
"number": "SU 1827",\
"short_title": "Симферополь - Москва",\
"thread_method_link": "api.rasp.yandex-net.ru/v3.0/thread/?date=2017-01-02&uid=U6-8_1_c30_5",\
"carrier":\
{\
"code": 196,\
"contacts": "Служба поддержки: для звонков из России: 8-800 2000 000",\
"url": "http://example.com/",\
"logo_svg": null,\
"title": "Example Inc.",\
"phone": "",\
"codes":\
{\
"icao": null,\
"sirena": "У6",\
"iata": "U6"\
},\
"address": "Москва, ул. Тверская, 6",\
"logo": "//yastatic.net/rasp/media/data/company/logo/example.jpg",\
"email": "info@example.com"\
},\
"transport_type": "plane",\
"vehicle": "Airbus А321",\
"transport_subtype":\
{\
"color": "#FF7F44",\
"code": "suburban",\
"title": "Пригородный поезд"\
},\
"express_type": null\
},\
"departure_platform": "",\
"departure": "2017-03-28T06:00:00+03:00",\
"stops": "",\
"departure_terminal": null,\
"to":\
{\
"code": "s9600213",\
"title": "Шереметьево",\
"popular_title": "",\
"short_title": "",\
"transport_type": "plane",\
"station_type": "bus_stop",\
"station_type_name": "автобусная остановка"\
"type": "station"\
},\
"has_transfers": false,\
"tickets_info":\
{\
"et_marker": false,\
"places":\
[\
{\
"currency": "RUB",\
"price":\
{\
"cents": 0,\
"whole": 4863\
},\
"name": "эконом"\
}\
]\
},\
"duration": 8100,\
"arrival_terminal": "D",\
"start_date": "2017-01-02",\
"arrival_platform": ""\
},\
{\
"arrival":"2014-03-28T10:15:00+03:00",\
...\
}\
],
"search":
{
"date":"2017-01-02",
"to":
{
"code":"c213",
"type":"settlement",
"popular_title":"Москва",
"short_title":"Москва",
"title":"Москва"
},
"from":
{
"code":"c146",
"type":"settlement",
"popular_title":"Симферополь",
"short_title":"Симферополь",
"title":"Симферополь"
}
}
}
```
#### Описание элементов JSON
| | | |
| --- | --- | --- |
| **Элемент JSON** | **Тип** | **Описание** |
| `pagination` | Объект | Информация о постраничном выводе найденных рейсов. |
| `interval_segments` | Массив | Список интервальных рейсов, движение по которым идет регулярно, но без определенного расписания. |
| `segments` | Массив | Список найденных рейсов. |
| `search` | Объект | Указанная в запросе дата, пункт отправления и пункт прибытия. |
**Элементы объекта**`pagination`
| | | |
| --- | --- | --- |
| **Элемент JSON** | **Тип** | **Описание** |
| `total` | Число | Общее количество рейсов, удовлетворяющих условиям поиска. |
| `limit` | Число | Ограничение на количество рейсов, которые Яндекс Расписания возвращают в ответ на запрос (заданное в параметре `limit`).
Значение по умолчанию — 100. |
| `offset` | Число | Смещение относительно первого результата поиска, заданное в параметре `offset`.
Значение по умолчанию — 0. |
**Элементы объекта**`interval_segments`
| | | |
| --- | --- | --- |
| **Элемент JSON** | **Тип** | **Описание** |
| `from` | Объект | Информация о станции отправления рейса. |
| `thread` | Объект | Информация о [нитке](https://yandex.ru/dev/rasp/doc/ru/concepts/termin#termin/thread) рейса. |
| `departure_platform` | Строка | Номер платформы станции отправления.
Принимает значение `null`, если номер платформы не указан. |
| `stops` | Строка (не более 1000 символов) | Станции следования рейса, на которых совершается остановка. Описывается в свободной форме. Например: значение `везде` значит, что остановка совершается на всех станциях следования.
Пустая строка значит, что по пути следования остановок нет. |
| `departure_terminal` | Строка | Название терминала станции отправления.
Принимает значение `null`, если название терминала не указано. |
| `to` | Объект | Информация о станции прибытия рейса. |
| `has_transfers` | Булевый | Признак наличия пересадок по ходу рейса. |
| `tickets_info` | Объект | Информация о доступных типах билетов и их цене. |
| `duration` | Число | Продолжительность рейса (в секундах). |
| `arrival_terminal` | Строка | Название терминала станции прибытия.
Принимает значение `null`, если название терминала не указано. |
| `start_date` | Строка | Дата отправления рейса. |
| `arrival_platform` | Строка | Номер платформы станции прибытия.
Строка возвращается пустой, если номер платформы не указан. |
**Элементы объекта**`segments`
| | | |
| --- | --- | --- |
| **Элемент JSON** | **Тип** | **Описание** |
| `arrival` | Строка | Время прибытия, в формате ISO 8601 (YYYY-MM-DDThh:mm:ss±hh:mm).
Если параметр `result_timezone` не был передан, указывается в часовом поясе станции. |
| `from` | Объект | Информация о станции отправления рейса. |
| `thread` | Объект | Информация о [нитке](https://yandex.ru/dev/rasp/doc/ru/concepts/termin#termin/thread) рейса. |
| `departure_platform` | Строка | Номер платформы станции отправления.
Принимает значение `null`, если номер платформы не указан. |
| `departure` | Строка | Время отправления, в формате ISO 8601 (YYYY-MM-DDThh:mm:ss±hh:mm).
Если параметр `result_timezone` не был передан, указывается в часовом поясе станции. |
| `stops` | Строка (не более 1000 символов) | Станции следования рейса, на которых совершается остановка. Описывается в свободной форме. Например: значение `везде` значит, что остановка совершается на всех станциях следования.
Пустая строка значит, что по пути следования остановок нет. |
| `departure_terminal` | Строка | Название терминала станции отправления.
Принимает значение `null`, если название терминала не указано. |
| `to` | Объект | Информация о станции прибытия рейса. |
| `has_transfers` | Булевый | Признак наличия пересадок по ходу рейса. |
| `tickets_info` | Объект | Информация о доступных типах билетов и их цене. |
| `duration` | Число | Продолжительность рейса (в секундах). |
| `arrival_terminal` | Строка | Название терминала станции прибытия.
Принимает значение `null`, если название терминала не указано. |
| `start_date` | Строка | Дата отправления рейса. |
| `arrival_platform` | Строка | Номер платформы станции прибытия.
Строка возвращается пустой, если номер платформы не указан. |
**Элементы объекта**`segments/from`
| | | |
| --- | --- | --- |
| **Элемент JSON** | **Тип** | **Описание** |
| `code` | Строка | Код пункта отправления в системе кодирования Яндекс Расписаний. |
| `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` | Строка | Короткое название пункта отправления. |
| `transport_type` | Строка | Тип отправляющегося транспортного средства.
Возможные значения:
- `plane` — самолет;
- `train` — поезд;
- `suburban` — электричка;
- `bus` — автобус;
- `water` — водный транспорт;
- `helicopter` — вертолет. |
| `type` | Строка | Вид пункта отправления.
Возможные значения:
- `station` — станция;
- `settlement` — поселение. |
**Элементы объекта**`thread`
| | | |
| --- | --- | --- |
| **Элемент JSON** | **Тип** | **Описание** |
| `uid` | Строка (не более 100 символов) | Идентификатор нитки, принятый в Яндекс Расписаниях. |
| `title` | Строка | Название нитки. Составляется из полных названий первой и последней станций следования. |
| `interval` | Объект | Информация о движении по интервальной нитке. |
| `number` | Строка | Номер рейса. |
| `short_title` | Строка | Короткое название нитки. Составляется из коротких названий первой и последней станций следования. |
| `thread_method_link` | Строка | URL запроса [информации о нитке](https://yandex.ru/dev/rasp/doc/ru/reference/list-stations-route) с идентификатором, указанным в ключе `uid`.
Перед отправкой этого запроса не забудьте указать [ключ доступа к API](https://yandex.ru/dev/rasp/doc/ru/concepts/access). |
| `carrier` | Объект | Информация о [перевозчике](https://yandex.ru/dev/rasp/doc/ru/concepts/termin#termin/carrier). |
| `transport_type` | Строка | Тип транспорта. Возможные значения:
- `plane` — самолет;
- `train` — поезд;
- `suburban` — электричка;
- `bus` — автобус;
- `water` — водный транспорт;
- `helicopter` — вертолет. |
| `vehicle` | Строка | Название транспортного средства. |
| `transport_subtype` | Объект | Информация о подтипе транспортного средства. |
| `express_type` | Строка | Признак экспресса или аэроэкспресса. Значение по умолчанию — `null`.
Если тип транспорта — электричка (ключ `transport_type` возвращен со значением `suburban`), принимает одно из значений:
- `express` — экспресс-рейс;
- `aeroexpress` — рейс, курсирующий между городом и аэропортом. |
**Элементы объекта**`segments/to`
| | | |
| --- | --- | --- |
| **Элемент JSON** | **Тип** | **Описание** |
| `code` | Строка | Код станции прибытия в системе кодирования Яндекс Расписаний. |
| `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` | Строка | Короткое название станции прибытия. |
| `transport_type` | Строка | Тип прибывающего транспортного средства. Возможные значения:
- `plane` — самолет;
- `train` — поезд;
- `suburban` — электричка;
- `bus` — автобус;
- `water` — водный транспорт;
- `helicopter` — вертолет. |
| `type` | Строка | Вид пункта назначения.
Возможные значения:
- `station` — станция;
- `settlement` — поселение. |
**Элементы объекта**`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` был передан. |
**Элементы объекта**`tickets_info`
| | | |
| --- | --- | --- |
| **Элемент JSON** | **Тип** | **Описание** |
| `et_marker` | Булевый | Признак возможности купить электронный билет.
Возможные значения:
- `true` — есть возможность купить электронный билет;
- `false` — электронный билет купить нельзя. |
| `places` | Массив | Доступные типы и цена билетов. |
**Элементы объекта**`places`
| | | |
| --- | --- | --- |
| **Элемент JSON** | **Тип** | **Описание** |
| `currency` | Строка | Идентификатор валюты, в которой указана цена. |
| `price` | Объект | Цена билета. |
| `name` | Строка | Название типа билета (например, «эконом»). |
**Элементы объекта**`price`
| | | |
| --- | --- | --- |
| **Элемент JSON** | **Тип** | **Описание** |
| `cents` | Число | Целое число дополнительных единиц валюты (например, копеек или центов). |
| `whole` | Число | Целое число основных единиц валюты (например, рублей). |
**Элементы объекта**`carrier`
| | | |
| --- | --- | --- |
| **Элемент JSON** | **Тип** | **Описание** |
| `code` | Число | Код перевозчика в системе кодирования Яндекс Расписаний. |
| `contacts` | Строка | Контактная информация, в свободной форме. |
| `url` | Строка | Ссылка на сайт перевозчика. |
| `logo_svg` | Строка | Ссылка на используемый Яндексом логотип перевозчика в формате SVG. |
| `title` | Строка | Название перевозчика. |
| `phone` | Строка | Контактный номер телефона перевозчика. |
| `codes` | Объект | Список кодов перевозчика в других системах кодирования, поддерживаемых Яндекс Расписаниями. |
| `address` | Строка | Юридический адрес перевозчика. |
| `logo` | Строка | Ссылка на используемый Яндексом логотип перевозчика в растровом формате. |
| `email` | Строка | Электронный почтовый адрес перевозчика. |
**Элементы объекта**`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` | Строка | Описание подтипа транспорта на естественном языке. |
**Элементы объекта**`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). |
**Элементы объекта**`search`
| | | |
| --- | --- | --- |
| **Элемент JSON** | **Тип** | **Описание** |
| `date` | Строка | Дата, на которую получен список рейсов, в формате «YYYY-MM-DD». |
| `to` | Объект | Информация об указанном в запросе пункте прибытия. |
| `from` | Объект | Информация об указанном в запросе пункте отправления. |
**Элементы объекта**`search/from`
| | | |
| --- | --- | --- |
| **Элемент JSON** | **Тип** | **Описание** |
| `code` | Строка | Код пункта отправления в системе кодирования Яндекс Расписаний. |
| `type` | Строка | Вид пункта отправления.
Возможные значения:
- `station` — станция;
- `settlement` — поселение. |
| `popular_title` | Строка | Общепринятое название пункта отправления. |
| `short_title` | Строка | Короткое название пункта отправления. |
| `title` | Строка | Название пункта отправления. |
**Элементы объекта**`search/to`
| | | |
| --- | --- | --- |
| **Элемент JSON** | **Тип** | **Описание** |
| `code` | Строка | Код пункта прибытия в системе кодирования Яндекс Расписаний. |
| `type` | Строка | Вид пункта назначения.
Возможные значения:
- `station` — станция;
- `settlement` — поселение. |
| `popular_title` | Строка | Общепринятое название пункта прибытия. |
| `short_title` | Строка | Короткое название пункта прибытия. |
| `title` | Строка | Название пункта прибытия. |
```
162
100
0
2015-09-02
c213
settlement
Москва
Москва
Москва
c146
settlement
Симферополь
Симферополь
Симферополь
2017-03-28T10:15:00+03:00
false
RUB
50
61
xsi:nil="true"
8100.0
D
s9600396
Симферополь
plane
аэропорт
station
api.rasp.yandex-net.ru/v3.0/thread/?date=2017-01-14&uid=6336_0_9601458_g17_4
26
Example Inc.
http://example.com/
//yastatic.net/rasp/media/data/company/svg/example.svg
Круглосуточная служба поддержки пассажиров: для звонков из России: 8-800 0000 000 (звонок по РФ бесплатный)
xsi:nil="true"
СУ
SU
г. Екатеринбург, пер. Утренний, 1г
//yastatic.net/rasp/media/data/company/logo/example.png
train
SU-1827A_c26_agent
Симферополь - Москва
#FF7F44
suburban
Пригородный поезд
Airbus А320
SU 1827
Симферополь - Москва
xsi:nil="true"
2017-03-28T06:00:00+03:00
кроме: Баковка, Трёхгорка, Немчиновка, Тестовская
2017-01-14
<[to](to)>
s9600213
Шереметьево
plane
аэропорт
station
false
xsi:nil="true"
```
#### Описание элементов XML
| | | |
| --- | --- | --- |
| **Элемент XML** | **Тип** | **Описание** |
| `pagination` | | Информация о постраничном выводе найденных рейсов. |
| `search` | | Указанная в запросе дата, пункт отправления и пункт прибытия. |
| `segment` | | Информация об отдельном рейсе. |
**Элементы, вложенные в элемент**`pagination`
| | | |
| --- | --- | --- |
| **Элемент XML** | **Тип** | **Описание** |
| `total` | Число | Общее количество рейсов, удовлетворяющих условиям поиска. |
| `limit` | Число | Ограничение на количество рейсов, которые Яндекс Расписания возвращают в ответ на запрос (заданное в параметре `limit`). |
| `offset` | Число | Смещение относительно первого результата поиска, заданное в параметре `offset`. |
**Элементы, вложенные в элемент**`search`
| | | |
| --- | --- | --- |
| **Элемент XML** | **Тип** | **Описание** |
| `date` | Строка | Дата, на которую получен список рейсов, в формате «YYYY-MM-DD». |
| `to` | | Информация об указанном в запросе пункте прибытия. |
| `from` | | Информация об указанном в запросе пункте отправления. |
**Элементы, вложенные в элемент**`segment`
| | | |
| --- | --- | --- |
| **Элемент XML** | **Тип** | **Описание** |
| `arrival` | Строка | Время прибытия, в формате ISO 8601 (YYYY-MM-DDThh:mm:ss±hh:mm).
Если параметр `result_timezone` не был передан, указывается в часовом поясе станции. |
| `tickets_info` | | Информация о доступных типах билетов и их цене. |
| `duration` | Число | Продолжительность рейса (в секундах). |
| `arrival_terminal` | Строка | Название терминала станции прибытия.
Принимает значение `xsi:nil="true"`, если название терминала не указано. |
| `arrival_platform` | Число | Номер платформы станции прибытия.
Пустой элемент означает, что номер платформы не указан. |
| `from` | | Информация о станции отправления рейса. |
| `thread` | | Информация о [нитке](https://yandex.ru/dev/rasp/doc/ru/concepts/termin.dita#termin/thread) рейса. |
| `departure_platform` | Число | Номер платформы станции отправления.
Пустой элемент означает, что номер платформы не указан. |
| `departure` | Строка | Время отправления, в формате ISO 8601 (YYYY-MM-DDThh:mm:ss±hh:mm).
Если параметр `result_timezone` не был передан, указывается в часовом поясе станции. |
| `stops` | Строка (не более 1000 символов) | Станции следования рейса, на которых совершается остановка. Описывается в свободной форме. Например: значение `везде` значит, что остановка совершается на всех станциях следования.
Пустой элемент означает, что станций следования, на которых совершается остановка, нет. |
| `start_date` | Строка | Дата отправления рейса. |
| `to` | | Информация о станции прибытия рейса. |
| `has_transfers` | | Признак наличия пересадок по ходу рейса. |
| `departure_terminal` | Строка | Название терминала станции отправления.
Принимает значение `xsi:nil="true"`, если название терминала не указано. |
**Элементы, вложенные в элемент**`search/to`
| | | |
| --- | --- | --- |
| **Элемент XML** | **Тип** | **Описание** |
| `code` | Строка | Код пункта прибытия в системе кодирования Яндекс Расписаний. |
| `type` | Строка | Вид пункта назначения.
Возможные значения:
- `station` — станция;
- `settlement` — поселение. |
| `popular_type` | Строка | Общепринятое название пункта прибытия. |
| `short_title` | Строка | Короткое название пункта прибытия. |
| `title` | Строка | Название пункта прибытия. |
**Элементы, вложенные в элемент**`search/from`
| | | |
| --- | --- | --- |
| **Элемент XML** | **Тип** | **Описание** |
| `code` | Строка | Код пункта отправления в системе кодирования Яндекс Расписаний. |
| `type` | Строка | Вид пункта отправления.
Возможные значения:
- `station` — станция;
- `settlement` — поселение. |
| `popular_title` | Строка | Общепринятое название пункта отправления. |
| `short_title` | Строка | Короткое название пункта отправления. |
| `title` | Строка | Название пункта отправления. |
**Элементы, вложенные в элемент**`tickets_info`
| | | |
| --- | --- | --- |
| **Элемент XML** | **Тип** | **Описание** |
| `et_marker` | Булевый | Код пункта отправления в системе кодирования Яндекс Расписаний. |
| `place` | | Информация об отдельном типе билетов. |
**Элементы, вложенные в элемент**`place`
| | | |
| --- | --- | --- |
| **Элемент XML** | **Тип** | **Описание** |
| `currency` | Строка | Идентификатор валюты, в которой указана цена. |
| `price` | | Цена билета. |
| `name` | Строка | Название типа билета (например, «эконом»). |
**Элементы, вложенные в элемент**`price`
| | | |
| --- | --- | --- |
| **Элемент XML** | **Тип** | **Описание** |
| `cents` | Число | Целое число дополнительных единиц валюты (например, копеек или центов). |
| `whole` | Число | Целое число основных единиц валюты (например, рублей). |
**Элементы, вложенные в элемент**`segment/from`
| | | |
| --- | --- | --- |
| **Элемент XML** | **Тип** | **Описание** |
| `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` | Строка | Название пункта отправления. |
| `short_title` | Строка | Короткое название пункта отправления. |
| `popular_title` | Строка | Общепринятое название пункта отправления. |
| `transport_type` | Строка | Тип отправляющегося транспортного средства.
Возможные значения:
- `plane` — самолет;
- `train` — поезд;
- `suburban` — электричка;
- `bus` — автобус;
- `water` — водный транспорт;
- `helicopter` — вертолет. |
| `type` | Строка | Вид пункта отправления.
Возможные значения:
- `station` — станция;
- `settlement` — поселение. |
**Элементы, вложенные в элемент**`thread`
| | | |
| --- | --- | --- |
| **Элемент XML** | **Тип** | **Описание** |
| `thread_method_link` | | URL запроса [информации о нитке](https://yandex.ru/dev/rasp/doc/ru/reference/list-stations-route) с идентификатором, указанным в ключе `uid`.
Перед отправкой этого запроса не забудьте указать [ключ доступа к API](https://yandex.ru/dev/rasp/doc/ru/concepts/access). |
| `carrier` | | Информация о [перевозчике](https://yandex.ru/dev/rasp/doc/ru/concepts/termin#termin/carrier). |
| `transport_type` | Строка | Тип транспорта. Возможные значения:
- `plane` — самолет;
- `train` — поезд;
- `suburban` — электричка;
- `bus` — автобус;
- `water` — водный транспорт;
- `helicopter` — вертолет. |
| `uid` | Строка (не более 100 символов) | Идентификатор нитки, принятый в Яндекс Расписаниях. |
| `title` | Строка | Название нитки. Составляется из полных названий первой и последней станций следования. |
| `transport_subtype` | | Информация о подтипе транспортного средства. |
| `vehicle` | Строка | Название транспортного средства. |
| `number` | Строка | Номер рейса. |
| `short_title` | Строка | Короткое название нитки. Составляется из коротких названий первой и последней станций следования. |
| `express_type` | Строка | Признак экспресса или аэроэкспресса. Значение по умолчанию — `xsi:nil="true"`.
Если тип транспорта — электричка (элемент `transport_type` возвращен со значением `suburban`), принимает одно из значений:
- `express` — экспресс-рейс;
- `aeroexpress` — рейс, курсирующий между городом и аэропортом. |
**Элементы, вложенные в элемент**`segment/to`
| | | |
| --- | --- | --- |
| **Элемент XML** | **Тип** | **Описание** |
| `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` | Строка | Короткое название станции прибытия. |
| `transport_type` | Строка | Тип прибывающего транспортного средства. Возможные значения:
- `plane` — самолет;
- `train` — поезд;
- `suburban` — электричка;
- `bus` — автобус;
- `water` — водный транспорт;
- `helicopter` — вертолет. |
| `type` | Строка | Вид пункта назначения.
Возможные значения:
- `station` — станция;
- `settlement` — поселение. |
**Элементы, вложенные в элемент**`carrier`
| | | |
| --- | --- | --- |
| **Элемент XML** | **Тип** | **Описание** |
| `code` | Число | Код перевозчика в системе кодирования Яндекс Расписаний. |
| `title` | Строка | Название перевозчика. |
| `url` | Строка | Ссылка на сайт перевозчика. |
| `logo_svg` | Строка | Ссылка на используемый Яндексом логотип перевозчика в формате SVG. |
| `contacts` | Строка | Контактная информация, в свободной форме. |
| `phone` | Строка | Контактный номер телефона перевозчика. |
| `codes` | | Список кодов перевозчика в других системах кодирования, поддерживаемых Яндекс Расписаниями. |
| `address` | Строка | Юридический адрес перевозчика. |
| `logo` | Строка | Ссылка на используемый Яндексом логотип перевозчика в растровом формате. |
| `email` | Строка | Электронный почтовый адрес перевозчика. |
**Элементы, вложенные в элемент**`transport_subtype`
| | | |
| --- | --- | --- |
| **Элемент XML** | **Тип** | **Описание** |
| `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` | Строка | Описание подтипа транспорта на естественном языке. |
**Элементы, вложенные в**`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/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/List_of_ISO_639-1_codes), коды стран — стандартом [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.
Если в запросе указана конкретная дата, в выдаче будут показаны все будущие рейсы, в том числе с пересадками.
Если запрос передан без даты, в выдаче будут показаны только прямые рейсы на все даты. В этом случае рейсы с пересадками не попадут в выдачу.
Тип транспортного средства. Возможные значения:
- `plane` — самолет;
- `train` — поезд;
- `suburban` — электричка;
- `bus` — автобус;
- `water` — морской транспорт;
- `helicopter` — вертолет.
По умолчанию возвращается список рейсов по всем типам транспортных средств.
[Система кодирования](https://yandex.ru/dev/rasp/doc/ru/concepts/coding-system), в которой указывается код станции отправления и код станции прибытия (параметры `from`, `to`) в запросе. Возможные значения:
- `yandex` (значение по умолчанию) — система кодирования Яндекс Расписаний;
- `iata` — [коды Международной ассоциации воздушного транспорта](https://ru.wikipedia.org/wiki/%D0%9A%D0%BE%D0%B4_%D0%98%D0%90%D0%A2%D0%90);
- `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));
- `express` — коды железнодорожных станций СНГ и стран Балтии из базы [Экспресс-3](http://www.express-3.ru/);
- `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).
Параметр обязателен, если используется система кодирования, отличная от системы кодирования Яндекс Расписаний.
Система кодирования, коды которой следует добавить к описанию станций в результатах поиска (элемент codes, вложенный в элементы from и to).
Поддерживаемые значения:
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).
Смещение относительно первого результата поиска. Например, если вам не нужны первые 10 результатов поиска, задайте для параметра значение «10».
Значение по умолчанию — 0.
Максимальное количество результатов поиска в ответе.
Значение по умолчанию — 100.
Признак, который указывает, что для каждой нитки в ответе следует вернуть календарь хождения — элемент `schedule`, вложенный в элемент `segments`.
Поддерживаемые значения:
- `false` — календарь возвращать не нужно (значение по умолчанию).
- `true` — для каждой нитки следует вернуть календарь хождения.
Часовой пояс, для которого следует указывать даты и времена в ответе. Если параметр не передан, каждая дата и время в ответе будут указаны в часовом поясе соответствующей станции.
Часовые пояса следует указывать с помощью идентификаторов [базы данных tz](https://ru.wikipedia.org/wiki/Tz_database). В английской Википедии приведен список идентификаторов из последней версии этой базы данных (в столбце «TZ» таблицы).
Признак, разрешающий добавить к результатам поиска маршруты с пересадками.
Поддерживаемые значения:
- `false` — в результатах поиска не должно быть маршрутов с пересадками (значение по умолчанию).
- `true` — найденные маршруты с пересадками следует добавить к результатам поиска.
**Тип**
Объект
**Описание**
Информация о станции отправления рейса.
**Тип**
Строка
**Описание**
Код пункта прибытия в системе кодирования Яндекс Расписаний.
**Тип**
Объект
**Описание**
Информация о постраничном выводе найденных рейсов.
**Тип**
Число
**Описание**
Общее количество рейсов, удовлетворяющих условиям поиска.
**Тип**
Число
**Описание**
Ограничение на количество рейсов, которые Яндекс Расписания возвращают в ответ на запрос (заданное в параметре `limit`).
Значение по умолчанию — 100.
**Тип**
Число
**Описание**
Смещение относительно первого результата поиска, заданное в параметре `offset`.
Значение по умолчанию — 0.
**Тип**
Объект
**Описание**
Указанная в запросе дата, пункт отправления и пункт прибытия.
**Тип**
Строка
**Описание**
Дата, на которую получен список рейсов, в формате «YYYY-MM-DD».
**Тип**
Объект
**Описание**
Информация о станции прибытия рейса.
**Тип**
Строка
**Описание**
Вид пункта отправления.
Возможные значения:
- `station` — станция;
- `settlement` — поселение.
**Тип**
Строка
**Описание**
Общепринятое название пункта отправления.
**Тип**
Строка
**Описание**
Короткое название пункта отправления.
**Тип**
Строка
**Описание**
Название пункта отправления.
Информация об отдельном рейсе.
**Тип**
Строка
**Описание**
Время прибытия, в формате ISO 8601 (YYYY-MM-DDThh:mm:ss±hh:mm).
Если параметр `result_timezone` не был передан, указывается в часовом поясе станции.
**Тип**
Объект
**Описание**
Информация о доступных типах билетов и их цене.
**Тип**
Булевый
**Описание**
ИПризнак возможности купить электронный билет.
Возможные значения:
- true — есть возможность купить электронный билет;
- false — электронный билет купить нельзя.
Информация об отдельном типе билетов
**Тип**
Строка
**Описание**
Идентификатор валюты, в которой указана цена.
**Тип**
Объект
**Описание**
Цена билета.
**Тип**
Число
**Описание**
Целое число дополнительных единиц валюты (например, копеек или центов).
**Тип**
Число
**Описание**
Целое число основных единиц валюты (например, рублей).
**Тип**
Строка
**Описание**
Название типа билета (например, «эконом»).
**Тип**
Число
**Описание**
Продолжительность рейса (в секундах).
**Тип**
Строка
**Описание**
Название терминала станции прибытия.
Принимает значение `null`, если название терминала не указано.
**Тип**
Строка
**Описание**
Номер платформы станции прибытия.
Строка возвращается пустой, если номер платформы не указан.
**Тип**
Строка
**Описание**
Тип отправляющегося транспортного средства.
Возможные значения:
- `plane` — самолет;
- `train` — поезд;
- `suburban` — электричка;
- `bus` — автобус;
- `water` — водный транспорт;
- `helicopter` — вертолет.
**Тип**
Строка
**Описание**
Название типа пункта отправления, зависит от языка ответа. Возможные значения на русском — в списке значений ключа `station_type`.
**Тип**
Объект
**Описание**
Информация о [нитке](https://yandex.ru/dev/rasp/doc/ru/concepts/termin#intervalthread) рейса.
URL запроса [информации о нитке](https://yandex.ru/dev/rasp/doc/ru/reference/list-stations-route) с идентификатором, указанным в ключе `uid`.
Перед отправкой этого запроса не забудьте указать [ключ доступа к API](https://yandex.ru/dev/rasp/doc/ru/concepts/access).
**Тип**
Объект
**Описание**
Информация о [перевозчике](https://yandex.ru/dev/rasp/doc/ru/concepts/termin#carrier).
**Тип**
Строка
**Описание**
Ссылка на сайт перевозчика.
**Тип**
Строка
**Описание**
Ссылка на используемый Яндексом логотип перевозчика в формате SVG.
**Тип**
Строка
**Описание**
Контактная информация, в свободной форме.
**Тип**
Строка
**Описание**
Контактный номер телефона перевозчика.
**Тип**
Объект
**Описание**
Список кодов перевозчика в других системах кодирования, поддерживаемых Яндекс Расписаниями.
**Тип**
Объект
**Описание**
Код перевозчика в системе кодирования [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).
**Тип**
Строка
**Описание**
Юридический адрес перевозчика.
**Тип**
Строка
**Описание**
Ссылка на используемый Яндексом логотип перевозчика в растровом формате.
**Тип**
Строка
**Описание**
Электронный почтовый адрес перевозчика.
**Тип**
Строка (не более 100 символов)
**Описание**
Идентификатор нитки, принятый в Яндекс Расписаниях.
**Тип**
Объект
**Описание**
Информация о подтипе транспортного средства.
**Тип**
Строка
**Описание**
Основной цвет транспортного средства в шестнадцатеричном формате.
**Тип**
Строка
**Описание**
Название транспортного средства.
**Тип**
Строка
**Описание**
Номер рейса.
**Тип**
Строка
**Описание**
Признак экспресса или аэроэкспресса. Значение по умолчанию — `null`.
Если тип транспорта — электричка (ключ `transport_type` возвращен со значением `suburban`), принимает одно из значений:
- `express` — экспресс-рейс;
- `aeroexpress` — рейс, курсирующий между городом и аэропортом.
**Тип**
Строка
**Описание**
Номер платформы станции отправления.
Принимает значение `null`, если номер платформы не указан.
**Тип**
Строка
**Описание**
Время отправления, в формате ISO 8601 (YYYY-MM-DDThh:mm:ss±hh:mm).
Если параметр `result_timezone` не был передан, указывается в часовом поясе станции.
**Тип**
Строка (не более 1000 символов)
**Описание**
Станции следования рейса, на которых совершается остановка. Описывается в свободной форме. Например: значение `везде` значит, что остановка совершается на всех станциях следования.
Пустая строка значит, что по пути следования остановок нет.
**Тип**
Строка
**Описание**
Дата отправления рейса.
**Тип**
Булевый
**Описание**
Признак наличия пересадок по ходу рейса.
**Тип**
Строка
**Описание**
Название терминала станции отправления.
Принимает значение `null`, если название терминала не указано.