Initial docs
This commit is contained in:
623
docs/yandex-api-docs/stations-list.md
Normal file
623
docs/yandex-api-docs/stations-list.md
Normal file
@@ -0,0 +1,623 @@
|
||||
Список всех доступных станций
|
||||
|
||||
# Список всех доступных станций
|
||||
|
||||
- [Синтаксис запроса](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.<br>Параметр можно не передавать, если ключ доступа указан в заголовке `Authorization`, например:<br>```<br>Authorization: 1eb31582-941a-3ac8-a61f-041c344495ab<br>``` |
|
||||
|
||||
**Необязательные параметры**
|
||||
|
||||
| | |
|
||||
| --- | --- |
|
||||
| **Параметр** | **Описание** |
|
||||
| `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).<br>По умолчанию ответ возвращается для значения `ru_RU`.<br>Поддерживаемые коды языков:<br>- `ru` — русский;<br>- `uk` — украинский.<br>Поддерживаемые коды стран:<br>- `RU` — Россия;<br>- `UA` — Украина. |
|
||||
| `format` | Формат ответа. Поддерживаемые значения:<br>- `json` (по умолчанию);<br>- `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` | Строка | Направление движения поездов, на котором находится станция.<br>Значение пусто, если станция не железнодорожная. |
|
||||
| `codes` | Объект | Список кодов станции. |
|
||||
| `station_type` | Строка | Тип станции.<br>Возможные значения:<br>- `station` — станция;<br>- `platform` — платформа;<br>- `stop` — остановочный пункт;<br>- `checkpoint` — блок-пост;<br>- `post` — пост;<br>- `crossing` — разъезд;<br>- `overtaking_point` — обгонный пункт;<br>- `train_station` — вокзал;<br>- `airport` — аэропорт;<br>- `bus_station` — автовокзал;<br>- `bus_stop` — автобусная остановка;<br>- `unknown` — станция без типа;<br>- `port` — порт;<br>- `port_point` — портпункт;<br>- `wharf` — пристань;<br>- `river_port` — речной вокзал;<br>- `marine_station` — морской вокзал. |
|
||||
| `title` | Строка | Название станции. |
|
||||
| `longitude` | Число | Долгота станции. |
|
||||
| `transport_type` | Строка | Тип транспорта, следующего через станцию.<br>Возможные значения:<br>- `plane` — самолет;<br>- `train` — поезд;<br>- `suburban` — электричка;<br>- `bus` — автобус;<br>- `water` — морской транспорт;<br>- `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` | Строка | Код в системе кодирования Яндекс Расписаний. |
|
||||
|
||||
```
|
||||
<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` | Строка | Направление движения поездов, на котором находится станция.<br>Значение пусто, если станция не железнодорожная. |
|
||||
| `codes` | Объект | Список кодов станции. |
|
||||
| `station_type` | Объект | Тип станции.<br>Возможные значения:<br>- `station` — станция;<br>- `platform` — платформа;<br>- `stop` — остановочный пункт;<br>- `checkpoint` — блок-пост;<br>- `post` — пост;<br>- `crossing` — разъезд;<br>- `overtaking_point` — обгонный пункт;<br>- `train_station` — вокзал;<br>- `airport` — аэропорт;<br>- `bus_station` — автовокзал;<br>- `bus_stop` — автобусная остановка;<br>- `unknown` — станция без типа;<br>- `port` — порт;<br>- `port_point` — портпункт;<br>- `wharf` — пристань;<br>- `river_port` — речной вокзал;<br>- `marine_station` — морской вокзал. |
|
||||
| `title` | Объект | Название станции. |
|
||||
| `longitude` | Число | Долгота станции. |
|
||||
| `transport_type` | Объект | Тип транспорта, следующего через станцию.<br>Возможные значения:<br>- `plane` — самолет;<br>- `train` — поезд;<br>- `suburban` — электричка;<br>- `bus` — автобус;<br>- `water` — морской транспорт;<br>- `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).
|
||||
Reference in New Issue
Block a user