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

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

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

Примечание.

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

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

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

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
regions Массив

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

codes Объект

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

title Строка

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

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

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

title Строка

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

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

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

stations Объект

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

Элементы объекта stations
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