trip-planner/docs/yandex-api-docs/schedule-point-to-point.md at 1513a9fb67718f2386847f349cbb3624cc476da0

Files

Vladimir Zagainov c78bf00f7a Initial docs

2026-08-13 18:26:15 +03:00

82 KiB

Raw Blame History

Расписание рейсов между станциями

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

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

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`	Ключ доступа к API. Параметр можно не передавать, если ключ доступа указан в заголовке `Authorization`, например: `<br>Authorization: 1eb31582-941a-3ac8-a61f-041c344495ab<br>`
`from`	Код станции отправления. Должен быть указан в системе кодирования. При использовании системы кодирования Яндекс Расписаний в данном параметре также можно указать код населенного пункта. Код населенного пункта или код станции можно получить из адресной строки, пользуясь Яндекс Расписаниями. Например, из адресной строки: - «http://rasp.yandex.ru/station/9600213» — код станции «s9600213» (к числовому значению кода добавляется латинская буква «s»); - «http://rasp.yandex.ru/city/146» — код населенного пункта «c146» (к числовому значению кода добавляется латинская буква «c»).
`to`	Код станции прибытия. Должен быть указан в системе кодирования. При использовании системы кодирования Яндекс Расписаний в данном параметре также можно указать код населенного пункта. Код населенного пункта или код станции можно получить из адресной строки, пользуясь Яндекс Расписаниями. Например, из адресной строки: - «https://rasp.yandex.ru/station/9600213» — код станции «s9600213» («s» от сокращенного «station»). - «https://rasp.yandex.ru/city/146» — код населенного пункта «c146» («c» от сокращенного «city»).

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


Параметр	Описание
`format`	Формат ответа. Поддерживаемые значения: - `json` (по умолчанию); - `xml`.
`lang`	Язык возвращаемой информации, в формате <код языка>_<код страны>. Поддерживаемые коды языка описаны стандартом ISO 639, коды стран — стандартом ISO 3166. По умолчанию ответ возвращается для значения `ru_RU`. Поддерживаемые коды языков: - `ru` — русский; - `uk` — украинский. Поддерживаемые коды стран: - `RU` — Россия; - `UA` — Украина.
`date`	Дата, на которую необходимо получить список рейсов. Должна быть указана в формате, соответствующем стандарту ISO 8601. Например, YYYY-MM-DD. Если в запросе указана конкретная дата, в выдаче будут показаны все будущие рейсы, в том числе с пересадками. Если запрос передан без даты, в выдаче будут показаны только прямые рейсы на все даты. В этом случае рейсы с пересадками не попадут в выдачу.
`transport_types`	Тип транспортного средства. Возможные значения: - `plane` — самолет; - `train` — поезд; - `suburban` — электричка; - `bus` — автобус; - `water` — морской транспорт; - `helicopter` — вертолет. По умолчанию возвращается список рейсов по всем типам транспортных средств.
`system`	Система кодирования, в которой указывается код станции отправления и код станции прибытия (параметры from, to) в запросе. Возможные значения: - `yandex` (значение по умолчанию) — система кодирования Яндекс Расписаний; - `iata` — коды Международной ассоциации воздушного транспорта; - `sirena` — коды в системах, построенных на базе сетей «Сирена»; - `express` — коды железнодорожных станций СНГ и стран Балтии из базы Экспресс-3; - `esr` — коды железнодорожных станций СНГ и стран Балтии из базы ЕСР. Параметр обязателен, если используется система кодирования, отличная от системы кодирования Яндекс Расписаний.
`show_systems`	Система кодирования, коды которой следует добавить к описанию станций в результатах поиска (элемент `codes`, вложенный в элементы `from` и `to`). Поддерживаемые значения: - `yandex` (значение по умолчанию) — система кодирования Яндекс Расписаний; - `esr` — коды железнодорожных станций СНГ и стран Балтии из базы ЕСР.
`offset`	Смещение относительно первого результата поиска. Например, если вам не нужны первые 10 результатов поиска, задайте для параметра значение «10». Значение по умолчанию — 0.
`limit`	Максимальное количество результатов поиска в ответе. Значение по умолчанию — 100.
`add_days_mask`	Признак, который указывает, что для каждой нитки в ответе следует вернуть календарь хождения — элемент `schedule`, вложенный в элемент `segments`. Поддерживаемые значения: - `false` — календарь возвращать не нужно (значение по умолчанию). - `true` — для каждой нитки следует вернуть календарь хождения.
`result_timezone`	Часовой пояс, для которого следует указывать даты и времена в ответе. Если параметр не передан, каждая дата и время в ответе будут указаны в часовом поясе соответствующей станции. Часовые пояса следует указывать с помощью идентификаторов базы данных tz. В английской Википедии приведен список идентификаторов из последней версии этой базы данных (в столбце «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": "Служба поддержки: </br> для звонков из России: 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": "Служба поддержки: </br> для звонков из России: 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`	Объект	Информация о нитке рейса.
`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`	Объект	Информация о нитке рейса.
`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 запроса информации о нитке с идентификатором, указанным в ключе `uid`. Перед отправкой этого запроса не забудьте указать ключ доступа к API.
`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.
`sirena`	Строка	Код перевозчика в системе кодирования Sirena.
`iata`	Строка	Код перевозчика в системе кодирования IATA.

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

<response>
  <pagination>
    <total>162</total>
    <limit>100</limit>
    <offset>0</offset>
  </pagination>
  <search>
    <date>2015-09-02</date>
    <to>
      <code>c213</code>
      <type>settlement</type>
      <popular_title>Москва</popular_title>
      <short_title>Москва</short_title>
      <title>Москва</title>
    </to>
    <from>
      <code>c146</code>
      <type>settlement</type>
      <popular_title>Симферополь</popular_title>
      <short_title>Симферополь</short_title>
      <title>Симферополь</title>
    </from>
  </search>
  <segment>
    <arrival>2017-03-28T10:15:00+03:00</arrival>
    <tickets_info>
      <et_marker>false</et_marker>
      <place>
        <currency>RUB</currency>
        <price>
          <cents>50</cents>
          <whole>61</whole>
        </price>
        <name>xsi:nil="true"</name>
      </place>
    </tickets_info>
    <duration>8100.0</duration>
    <arrival_terminal>D</arrival_terminal>
    <arrival_platform/>
    <from>
      <code>s9600396</code>
      <title>Симферополь</title>
      <short_title/>
      <popular_title/>
      <transport_type>plane</transport_type>
      <station_type_name>аэропорт</station_type_name>
      <type>station</type>
    </from>
    <thread>
      <thread_method_link>api.rasp.yandex-net.ru/v3.0/thread/?date=2017-01-14&uid=6336_0_9601458_g17_4</thread_method_link>
      <carrier>
        <code>26</code>
        <title>Example Inc.</title>
        <url>http://example.com/</url>
        <logo_svg>//yastatic.net/rasp/media/data/company/svg/example.svg</logo_svg>
        <contacts>Круглосуточная служба поддержки пассажиров: для звонков из России: 8-800 0000 000 (звонок по РФ бесплатный)</contacts>
        <phone/>
        <codes>
          <icao>xsi:nil="true"</icao>
          <sirena>СУ</sirena>
          <iata>SU</iata>
        </codes>
        <address>г. Екатеринбург, пер. Утренний, 1г</address>
        <logo>//yastatic.net/rasp/media/data/company/logo/example.png</logo>
        <email/>
      </carrier>
      <transport_type>train</transport_type>
      <uid>SU-1827A_c26_agent</uid>
      <title>Симферополь - Москва</title>
      <transport_subtype>
        <color>#FF7F44</color>
        <code>suburban</code>
        <title>Пригородный поезд</title>
      </transport_subtype>
      <vehicle>Airbus А320</vehicle>
      <number>SU 1827</number>
      <short_title>Симферополь - Москва</short_title>
      <express_type>xsi:nil="true"</express_type>
    </thread>
    <departure_platform/>
    <departure>2017-03-28T06:00:00+03:00</departure>
    <stops>кроме: Баковка, Трёхгорка, Немчиновка, Тестовская</stops>
    <start_date>2017-01-14</start_date>
    <[to](to)>
      <code>s9600213</code>
      <title>Шереметьево</title>
      <popular_title/>
      <short_title/>
      <transport_type>plane</transport_type>
      <station_type_name>аэропорт</station_type_name>
      <type>station</type>
    </to>
    <has_transfers>false</has_transfers>
    <departure_terminal>xsi:nil="true"</departure_terminal>
  </segment>
</response>

Описание элементов 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`		Информация о нитке рейса.
`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 запроса информации о нитке с идентификатором, указанным в ключе `uid`. Перед отправкой этого запроса не забудьте указать ключ доступа к API.
`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.
`sirena`	Строка	Код перевозчика в системе кодирования Sirena.
`iata`	Строка	Код перевозчика в системе кодирования 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.

Если в запросе указана конкретная дата, в выдаче будут показаны все будущие рейсы, в том числе с пересадками.

Если запрос передан без даты, в выдаче будут показаны только прямые рейсы на все даты. В этом случае рейсы с пересадками не попадут в выдачу.

Тип транспортного средства. Возможные значения:

plane — самолет;
train — поезд;
suburban — электричка;
bus — автобус;
water — морской транспорт;
helicopter — вертолет.

По умолчанию возвращается список рейсов по всем типам транспортных средств.

Система кодирования, в которой указывается код станции отправления и код станции прибытия (параметры from, to) в запросе. Возможные значения:

yandex (значение по умолчанию) — система кодирования Яндекс Расписаний;
iata — коды Международной ассоциации воздушного транспорта;
sirena — коды в системах, построенных на базе сетей «Сирена»;
express — коды железнодорожных станций СНГ и стран Балтии из базы Экспресс-3;
esr — коды железнодорожных станций СНГ и стран Балтии из базы ЕСР.

Параметр обязателен, если используется система кодирования, отличная от системы кодирования Яндекс Расписаний.

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

Поддерживаемые значения:

yandex (значение по умолчанию) — система кодирования Яндекс Расписаний;

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

Смещение относительно первого результата поиска. Например, если вам не нужны первые 10 результатов поиска, задайте для параметра значение «10».

Значение по умолчанию — 0.

Максимальное количество результатов поиска в ответе.

Значение по умолчанию — 100.

Признак, который указывает, что для каждой нитки в ответе следует вернуть календарь хождения — элемент schedule, вложенный в элемент segments.

Поддерживаемые значения:

false — календарь возвращать не нужно (значение по умолчанию).
true — для каждой нитки следует вернуть календарь хождения.

Часовой пояс, для которого следует указывать даты и времена в ответе. Если параметр не передан, каждая дата и время в ответе будут указаны в часовом поясе соответствующей станции.

Часовые пояса следует указывать с помощью идентификаторов базы данных tz. В английской Википедии приведен список идентификаторов из последней версии этой базы данных (в столбце «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.

Тип

Объект

Описание

Информация о нитке рейса.

URL запроса информации о нитке с идентификатором, указанным в ключе uid.

Перед отправкой этого запроса не забудьте указать ключ доступа к API.

Тип

Объект

Описание

Информация о перевозчике.

Тип

Строка

Описание

Ссылка на сайт перевозчика.

Тип

Строка

Описание

Ссылка на используемый Яндексом логотип перевозчика в формате SVG.

Тип

Строка

Описание

Контактная информация, в свободной форме.

Тип

Строка

Описание

Контактный номер телефона перевозчика.

Тип

Объект

Описание

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

Тип

Объект

Описание

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

Тип

Строка

Описание

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

Тип

Строка

Описание

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

Тип

Строка

Описание

Юридический адрес перевозчика.

Тип

Строка

Описание

Ссылка на используемый Яндексом логотип перевозчика в растровом формате.

Тип

Строка

Описание

Электронный почтовый адрес перевозчика.

Тип

Строка (не более 100 символов)

Описание

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

Тип

Объект

Описание

Информация о подтипе транспортного средства.

Тип

Строка

Описание

Основной цвет транспортного средства в шестнадцатеричном формате.

Тип

Строка

Описание

Название транспортного средства.

Тип

Строка

Описание

Номер рейса.

Тип

Строка

Описание

Признак экспресса или аэроэкспресса. Значение по умолчанию — null.

Если тип транспорта — электричка (ключ transport_type возвращен со значением suburban), принимает одно из значений:

express — экспресс-рейс;
aeroexpress — рейс, курсирующий между городом и аэропортом.

Тип

Строка

Описание

Номер платформы станции отправления.

Принимает значение null, если номер платформы не указан.

Тип

Строка

Описание

Время отправления, в формате ISO 8601 (YYYY-MM-DDThh:mm:ss±hh:mm).

Если параметр result_timezone не был передан, указывается в часовом поясе станции.

Тип

Строка (не более 1000 символов)

Описание

Станции следования рейса, на которых совершается остановка. Описывается в свободной форме. Например: значение везде значит, что остановка совершается на всех станциях следования.

Пустая строка значит, что по пути следования остановок нет.

Тип

Строка

Описание

Дата отправления рейса.

Тип

Булевый

Описание

Признак наличия пересадок по ходу рейса.

Тип

Строка

Описание

Название терминала станции отправления.

Принимает значение null, если название терминала не указано.

82 KiB Raw Blame History Unescape Escape

Расписание рейсов между станциями

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

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

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

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

82 KiB

Raw Blame History