Список всех доступных станций # Список всех доступных станций - [Синтаксис запроса](https://yandex.ru/dev/rasp/doc/ru/reference/stations-list#query) - [Структура ответа](https://yandex.ru/dev/rasp/doc/ru/reference/stations-list#emails-detailed) Ресурс содержит полный список станций, информацию о которых предоставляют Яндекс Расписания. Список структурирован географически: ответ содержит список стран со вложенными списками регионов и населенных пунктов, в которых находятся станции. Размер возвращаемого 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` | [Ключ доступа](https://yandex.ru/dev/rasp/doc/ru/concepts/access) к API.
Параметр можно не передавать, если ключ доступа указан в заголовке `Authorization`, например:
```
Authorization: 1eb31582-941a-3ac8-a61f-041c344495ab
``` | **Необязательные параметры** | | | | --- | --- | | **Параметр** | **Описание** | | `lang` | Язык возвращаемой информации, в формате <код языка>\_<код страны>. Поддерживаемые коды языка описаны стандартом [ISO 639](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2), коды стран — стандартом [ISO 3166](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2).
По умолчанию ответ возвращается для значения `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` | Строка | Код железнодорожной станции в системе кодирования [ЕСР](https://ru.wikipedia.org/wiki/%C5%E4%E8%ED%E0%FF_%F1%E5%F2%E5%E2%E0%FF_%F0%E0%E7%EC%E5%F2%EA%E0). | | `yandex_code` | Строка | Код в системе кодирования Яндекс Расписаний. | ``` Бермудские острова l21546 <codes/> <settlement> <title/> <codes/> <station> <title>Бермуды -64.678703 32.364041 Самолёт аэропорт s9628674 Гамбия l21010 <codes/> <settlement> <title>Банжул c21012 Юндум -16.652222 13.338056 Самолёт аэропорт s9628059 Россия l225 Псковская область r10926 Новая Уситва c54722 Новая Уситва 28.1280804652 57.4583284321 Автобус автобусная остановка s9855938 Касторная-Новая 38.123675 51.780828 Поезд станция Елецкое 595401 s9605487 ``` #### Описание элементов 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` | Строка | Код железнодорожной станции в системе кодирования [ЕСР](https://ru.wikipedia.org/wiki/%C5%E4%E8%ED%E0%FF_%F1%E5%F2%E5%E2%E0%FF_%F0%E0%E7%EC%E5%F2%EA%E0). | [Ключ доступа](https://yandex.ru/dev/rasp/doc/ru/concepts/access) к API. Параметр можно не передавать, если ключ доступа указан в заголовке `Authorization`, например: ``` Authorization: 1eb31582-941a-3ac8-a61f-041c344495ab ``` Язык возвращаемой информации, в формате <код языка>\_<код страны>. Поддерживаемые коды языка описаны стандартом [ISO 639](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2), коды стран — стандартом [ISO 3166](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2). По умолчанию ответ возвращается для значения `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` — морской вокзал. **Тип** Строка **Описание** Направление движения поездов, на котором находится станция. Значение пусто, если станция не железнодорожная. **Тип** Строка **Описание** Код железнодорожной станции в системе кодирования [ЕСР](https://ru.wikipedia.org/wiki/%D0%95%D0%B4%D0%B8%D0%BD%D0%B0%D1%8F_%D1%81%D0%B5%D1%82%D0%B5%D0%B2%D0%B0%D1%8F_%D1%80%D0%B0%D0%B7%D0%BC%D0%B5%D1%82%D0%BA%D0%B0).