Mrixs/trip-planner
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
1513a9fb67718f2386847f349cbb3624cc476da0
trip-planner/docs/yandex-api-docs/stations-list.md
Vladimir Zagainov c78bf00f7a Initial docs
2026-08-13 18:26:15 +03:00

22 KiB
Raw Blame History

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

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

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

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

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

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

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

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

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

Обязательные параметры
Параметр Описание
apikey Ключ доступа к API.
Параметр можно не передавать, если ключ доступа указан в заголовке Authorization, например:
<br>Authorization: 1eb31582-941a-3ac8-a61f-041c344495ab<br>

Необязательные параметры
Параметр Описание
lang Язык возвращаемой информации, в формате <код языка>_<код страны>. Поддерживаемые коды языка описаны стандартом ISO 639, коды стран — стандартом ISO 3166.
По умолчанию ответ возвращается для значения ru_RU.
Поддерживаемые коды языков:
- ru — русский;
- uk — украинский.
Поддерживаемые коды стран:
- RU — Россия;
- UA — Украина.
format Формат ответа. Поддерживаемые значения:
- json (по умолчанию);
- xml.

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

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

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

Пример ответа в формате 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 Строка Код железнодорожной станции в системе кодирования ЕСР.

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

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

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

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

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

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

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

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

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

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

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

Тип

Массив

Описание

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

Тип

Строка

Описание

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

Тип

Строка

Описание

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

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

Тип

Строка

Описание

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

Тип

Описание

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

Тип

Объект

Описание

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

Тип

Строка

Описание

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

Тип

Объект

Описание

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

Тип

Объект

Описание

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

Тип

Объект

Описание

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

Тип

Строка

Описание

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

Тип

Массив

Описание

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

Тип

Описание

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

Тип

Объект

Описание

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

Тип

Число

Описание

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

Тип

Число

Описание

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

Тип

Строка

Описание

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

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

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

Тип

Строка

Описание

Тип станции.

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

  • station — станция;
  • platform — платформа;
  • stop — остановочный пункт;
  • checkpoint — блок-пост;
  • post — пост;
  • crossing — разъезд;
  • overtaking_point — обгонный пункт;
  • train_station — вокзал;
  • airport — аэропорт;
  • bus_station — автовокзал;
  • bus_stop — автобусная остановка;
  • unknown — станция без типа;
  • port — порт;
  • port_point — портпункт;
  • wharf — пристань;
  • river_port — речной вокзал;
  • marine_station — морской вокзал.

Тип

Строка

Описание

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

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

Тип

Строка

Описание

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

Reference in New Issue View Git Blame Copy Permalink