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

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

Примечание.

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

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

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

https://api.rasp.yandex.net/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/v3.0/search/?apikey={ключ}&format=json&from=c146&to=c213&lang=ru_RU&page=1&date=2015-09-02

Входные параметры:

Параметр Описание
Обязательные параметры
apikey

Ключ доступа к API.

Параметр можно не передавать, если ключ доступа указан в заголовке Authorization, например:

Authorization: 1eb31582-941a-3ac8-a61f-041c344495ab
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) в запросе. Возможные значения:

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

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.

Структура ответа в различных форматах показана в примерах.

{
  "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/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/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
total Число

Общее количество рейсов, удовлетворяющих условиям поиска.

limit Число

Ограничение на количество рейсов, которые Яндекс.Расписания возвращают в ответ на запрос (заданное в параметре limit).

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

offset Число

Смещение относительно первого результата поиска, заданное в параметре offset.

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

Элементы объекта interval_segments
from Объект

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

thread Объект

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

departure_platform Строка

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

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

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

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

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

departure_terminal Строка

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

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

to Объект

Информация о станции прибытия рейса.

has_transfers Булевый

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

tickets_info Объект

Информация о доступных типах билетов и их цене.

duration Число

Продолжительность рейса (в секундах).

arrival_terminal Строка

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

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

start_date Строка

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

arrival_platform Строка

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

Строка возвращается пустой, если номер платформы не указан.

Элементы объекта segments
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
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
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
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
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
et_marker Булевый

Признак возможности купить электронный билет.

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

  • true — есть возможность купить электронный билет;

  • false — электронный билет купить нельзя.

places Массив

Доступные типы и цена билетов.

Элементы объекта places
currency Строка

Идентификатор валюты, в которой указана цена.

price Объект

Цена билета.

name Строка

Название типа билета (например, «эконом»).

Элементы объекта price
cents Число

Целое число дополнительных единиц валюты (например, копеек или центов).

whole Число

Целое число основных единиц валюты (например, рублей).

Элементы объекта carrier
code Число

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

contacts Строка

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

url Строка

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

logo_svg Строка

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

title Строка

Название перевозчика.

phone Строка

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

codes Объект

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

address Строка

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

logo Строка
email Строка

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

Элементы объекта transport_subtype
color Строка

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

code Строка

Код подтипа транспорта для типа, указанного в элементе transport_type. Подтип может совпадать с типом (например, для обычной электрички указывается тип suburban и подтип suburban).

Другие возможные значения:

  • helicopter — вертолет (для типа plane);

  • rex — экспресс РЭКС (для типа suburban);

  • sputnik«Спутник» (для типа suburban);

  • skiarrow«Лыжная стрела» (для типа suburban);

  • shezh«Снежинка» (для типа suburban);

  • skirus«Лыжня России» (для типа suburban);

  • city — городская электричка (для типа suburban);

  • kalina«Калина красная» (для типа suburban);

  • vostok«Восток» (для типа suburban);

  • prostoryaltaya«Просторы Алтая» (для типа suburban);

  • 14vag — состав из 14 вагонов (для типа suburban);

  • last«Ласточка» (для типа suburban);

  • exprdal — экспресс с билетами на конкретные места (для типа suburban);

  • volzhex«Волжский экспресс» (для типа suburban);

  • stdplus — электрички типа «стандарт плюс» (для типа suburban);

  • express — экспресс (для типа suburban);

  • skor — ускоренный поезд (для типа suburban);

  • fiztekh — Физтех.Электричка (для типа suburban);

  • vag6 — состав из 6 вагонов (для типа suburban);

  • river— речной транспорт (для типа water);

  • sea — морской транспорт (для типа water).

title Строка

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

Элементы объекта codes
icao Строка

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

sirena Строка

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

iata Строка

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

Элементы объекта search
date Строка

Дата, на которую получен список рейсов, в формате «YYYY-MM-DD».

to Объект

Информация об указанном в запросе пункте прибытия.

from Объект

Информация об указанном в запросе пункте отправления.

Элементы объекта search/from
code Строка

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

type Строка

Вид пункта отправления.

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

  • station — станция;

  • settlement — поселение.

popular_title Строка
short_title Строка

Короткое название пункта отправления.

title Строка

Название пункта отправления.

Элементы объекта search/to
code Строка

Код пункта прибытия в системе кодирования Яндекс.Расписаний.

type Строка

Вид пункта назначения.

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

  • station — станция;

  • settlement — поселение.

popular_title Строка
short_title Строка

Короткое название пункта прибытия.

title Строка

Название пункта прибытия.