Список всех доступных станций

Ресурс содержит полный список станций, информацию о которых предоставляют Яндекс Расписания. Список структурирован географически: ответ содержит список стран со вложенными списками регионов и населенных пунктов, в которых находятся станции.

Размер возвращаемого JSON-документа — около 40 МБ.

Примечание

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

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

https://api.rasp.yandex.net/v3.0/stations_list/ ?
  apikey=<ключ>
[& format=<формат>]
[& lang=<язык>]

Пример запроса:

https://api.rasp.yandex.net/v3.0/stations_list/?apikey={ключ}&lang=ru_RU&format=json

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

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

Параметр

Описание

apikey

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

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

Authorization: 1eb31582-941a-3ac8-a61f-041c344495ab

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

Параметр

Описание

lang

Язык возвращаемой информации, в формате <код языка>_<код страны>. Поддерживаемые коды языка описаны стандартом ISO 639, коды стран — стандартом ISO 3166.

По умолчанию ответ возвращается для значения ru_RU.

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

  • ru — русский;
  • uk — украинский.

Поддерживаемые коды стран:

  • RU — Россия;
  • UA — Украина.

format

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

  • json (по умолчанию);
  • xml.

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

Ответ оформлен в виде набора вложенных массивов: на верхнем уровне перечислены страны, в описании каждой страны — регионы, в каждом регионе — города, в каждом городе — станции.

Часть ответа в различных форматах показана в примерах.

{
"countries":
  [
    {
      "regions":
      [
        {
          "settlements":
          [
            {
              "title": "",
              "codes": {},
              "stations":
              [
                {
                  "direction": "",
                  "codes":
                  {
                    "yandex_code": "s9628674"
                  },
                  "station_type": "аэропорт",
                  "title": "Бермуды",
                  "longitude": -64.678703,
                  "transport_type": "Самолёт",
                  "latitude": 32.364041
                }
              ]
          }
          ],
          "codes": {},
          "title": ""
        }
      ],
      "codes":
      {
        "yandex_code": "l21546"
      },
      "title": "Бермудские острова"
    },
    { 
      "regions":
      [
        {
          "settlements":
          [
            {
              "title": "Банжул",
              "codes":
              {
                "yandex_code": "c21012"
              },
              "stations":
              [
                {
                  "direction": "",
                  "codes":
                  {
                    "yandex_code": "s9628059"
                  },
                  "station_type": "аэропорт",
                  "title": "Юндум",
                  "longitude": -16.652222,
                  "transport_type": "Самолёт",
                  "latitude": 13.338056
                }
              ]
            }
          ],
          "codes": {},
          "title": ""
        }
      ],
      "codes":
      {
        "yandex_code": "l21010"
      },
      "title": "Гамбия"
    }
    {
      "regions":
      [
        {
          "settlements":
          [
            {
              "title": "Новая Уситва",
              "codes":
              {
                "yandex_code": "c54722"
              },
              "stations":
              [
                {
                  "direction": "",
                  "codes":
                  {
                    "yandex_code": "s9855938"
                  },
                  "station_type": "автобусная остановка",
                  "title": "Новая Уситва",
                  "longitude": 28.1280804651562,
                  "transport_type": "Автобус",
                  "latitude": 57.4583284320784
                }
              ]
            },
            {
              "title": "Касторное",
              "codes":
              {
                "yandex_code": "c22754"
              },
              "stations":
              [
                {
                  "direction": "Елецкое",
                  "codes":
                  {
                    "esr_code": "595401",
                    "yandex_code": "s9605487"
                  },
                  "station_type": "станция",
                  "title": "Касторная-Новая",
                  "longitude": 38.123675,
                  "transport_type": "Поезд",
                  "latitude": 51.780828
                }
              ]
            }
          ],
          "codes":
          {
            "yandex_code": "r10705"
          },
          "title": "Курская область"
        }
      ],
      "codes":
      {
        "yandex_code": "l225"
      },
      "title": "Россия"
    }
  ]
}

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

Элемент JSON

Тип

Описание

countries

Массив

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

Элементыобъекта countries

Элемент JSON

Тип

Описание

regions

Массив

Список регионов страны.

codes

Объект

Коды страны. На данный момент используется только система кодирования Яндекс Расписаний (yandex_code).

title

Строка

Название страны.

Элементыобъекта regions

Элемент JSON

Тип

Описание

settlements

Массив

Список населенных пунктов региона.

codes

Объект

Коды региона. На данный момент используется только система кодирования Яндекс Расписаний (yandex_code).

title

Строка

Название региона.

Элементыобъекта settlements

Элемент JSON

Тип

Описание

title

Строка

Название населенного пункта.

codes

Объект

Коды населенного пункта. На данный момент используется только система кодирования Яндекс Расписаний (yandex_code).

stations

Объект

Список станций в населенном пункте.

Элементыобъекта stations

Элемент JSON

Тип

Описание

direction

Строка

Направление движения поездов, на котором находится станция.

Значение пусто, если станция не железнодорожная.

codes

Объект

Список кодов станции.

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 — морской вокзал.

title

Строка

Название станции.

longitude

Число

Долгота станции.

transport_type

Строка

Тип транспорта, следующего через станцию.

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

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

latitude

Число

Широта станции.

Элементыобъекта station/codes

Элемент JSON

Тип

Описание

esr_code

Строка

Код железнодорожной станции в системе кодирования ЕСР.

yandex_code

Строка

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

<response>
  <country>
    <title>Бермудские острова</title>
    <codes>
      <yandex_code>l21546</yandex_code>
    </codes>
    <region>
      <title/>
      <codes/>
      <settlement>
        <title/>
        <codes/>
        <station>
          <title>Бермуды</title>
          <longitude>-64.678703</longitude>
          <latitude>32.364041</latitude>
          <transport_type>Самолёт</transport_type>
          <station_type>аэропорт</station_type>
          <codes>
            <yandex_code>s9628674</yandex_code>
          </codes>
        </station>
      </settlement>
    </region>
  </country>
  <country>
    <title>Гамбия</title>
    <codes>
      <yandex_code>l21010</yandex_code>
    </codes>
    <region>
      <title/>
      <codes/>
      <settlement>
        <title>Банжул</title>
        <codes>
          <yandex_code>c21012</yandex_code>
        </codes>
        <station>
          <title>Юндум</title>
          <longitude>-16.652222</longitude>
          <latitude>13.338056</latitude>
          <transport_type>Самолёт</transport_type>
          <station_type>аэропорт</station_type>
          <codes>
            <yandex_code>s9628059</yandex_code>
          </codes>
        </station>
      </settlement>
    </region>
  </country>
  <country>
    <title>Россия</title>
    <codes>
      <yandex_code>l225</yandex_code>
    </codes>
    <region>
      <title>Псковская область</title>
      <codes>
        <yandex_code>r10926</yandex_code>
      </codes>
      <settlement>
        <title>Новая Уситва</title>
        <codes>
          <yandex_code>c54722</yandex_code>
        </codes>
        <station>
          <title>Новая Уситва</title>
          <longitude>28.1280804652</longitude>
          <latitude>57.4583284321</latitude>
          <transport_type>Автобус</transport_type>
          <station_type>автобусная остановка</station_type>
          <codes>
            <yandex_code>s9855938</yandex_code>
          </codes>
        </station>
        <station>
          <title>Касторная-Новая</title>
          <longitude>38.123675</longitude>
          <latitude>51.780828</latitude>
          <transport_type>Поезд</transport_type>
          <station_type>станция</station_type>
          <direction>Елецкое</direction>
          <codes>
            <esr_code>595401</esr_code>
            <yandex_code>s9605487</yandex_code>
          </codes>
        </station>
      </settlement>
    </region>
  </country>
</response>

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

Элемент XML

Тип

Описание

country

Страна, с вложенными описаниями регионов.

Элементыобъекта country

Элемент XML

Тип

Описание

region

Массив

Один из регионов страны.

codes

Коды страны. На данный момент используется только система кодирования Яндекс Расписаний (yandex_code).

title

Строка

Название страны.

Элементыобъекта region

Элемент XML

Тип

Описание

settlement

Один из населенных пунктов региона.

codes

Объект

Коды региона. На данный момент используется только система кодирования Яндекс Расписаний (yandex_code).

title

Объект

Название региона.

Элементыобъекта settlement

Элемент XML

Тип

Описание

title

Объект

Название населенного пункта.

codes

Объект

Коды населенного пункта. На данный момент используется только система кодирования Яндекс Расписаний (yandex_code).

station

Объект

Одна из станций в населенном пункте.

Элементыобъекта station

Элемент XML

Тип

Описание

direction

Строка

Направление движения поездов, на котором находится станция.

Значение пусто, если станция не железнодорожная.

codes

Объект

Список кодов станции.

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 — морской вокзал.

title

Объект

Название станции.

longitude

Число

Долгота станции.

transport_type

Объект

Тип транспорта, следующего через станцию.

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

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

latitude

Число

Широта станции.

Элементы, вложенные в элемент station/codes

Элемент XML

Тип

Описание

yandex_code

Строка

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

esr_code

Строка

Код железнодорожной станции в системе кодирования ЕСР.