Список всех доступных станций
Ресурс содержит полный список станций, информацию о которых предоставляют Яндекс Расписания. Список структурирован географически: ответ содержит список стран со вложенными списками регионов и населенных пунктов, в которых находятся станции.
Размер возвращаемого 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
Входные параметры:
Обязательные параметры
Параметр |
Описание |
|
Ключ доступа к API. Параметр можно не передавать, если ключ доступа указан в заголовке
|
Необязательные параметры
Параметр |
Описание |
|
Язык возвращаемой информации, в формате <код языка>_<код страны>. Поддерживаемые коды языка описаны стандартом ISO 639, коды стран — стандартом ISO 3166. По умолчанию ответ возвращается для значения Поддерживаемые коды языков:
Поддерживаемые коды стран:
|
|
Формат ответа. Поддерживаемые значения:
|
Структура ответа
Ответ оформлен в виде набора вложенных массивов: на верхнем уровне перечислены страны, в описании каждой страны — регионы, в каждом регионе — города, в каждом городе — станции.
Часть ответа в различных форматах показана в примерах.
{
"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
Элемент JSON |
Тип |
Описание |
|
Массив |
Список регионов страны. |
|
Объект |
Коды страны. На данный момент используется только система кодирования Яндекс Расписаний ( |
|
Строка |
Название страны. |
Элементыобъекта regions
Элемент JSON |
Тип |
Описание |
|
Массив |
Список населенных пунктов региона. |
|
Объект |
Коды региона. На данный момент используется только система кодирования Яндекс Расписаний ( |
|
Строка |
Название региона. |
Элементыобъекта settlements
Элемент JSON |
Тип |
Описание |
|
Строка |
Название населенного пункта. |
|
Объект |
Коды населенного пункта. На данный момент используется только система кодирования Яндекс Расписаний ( |
|
Объект |
Список станций в населенном пункте. |
Элементыобъекта stations
Элемент JSON |
Тип |
Описание |
|
Строка |
Направление движения поездов, на котором находится станция. Значение пусто, если станция не железнодорожная. |
|
Объект |
Список кодов станции. |
|
Строка |
Тип станции. Возможные значения:
|
|
Строка |
Название станции. |
|
Число |
Долгота станции. |
|
Строка |
Тип транспорта, следующего через станцию. Возможные значения:
|
|
Число |
Широта станции. |
Элементыобъекта station/codes
Элемент JSON |
Тип |
Описание |
|
Строка |
Код железнодорожной станции в системе кодирования ЕСР. |
|
Строка |
Код в системе кодирования Яндекс Расписаний. |
<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
Элемент XML |
Тип |
Описание |
|
Массив |
Один из регионов страны. |
|
Коды страны. На данный момент используется только система кодирования Яндекс Расписаний ( |
|
|
Строка |
Название страны. |
Элементыобъекта region
Элемент XML |
Тип |
Описание |
|
Один из населенных пунктов региона. |
|
|
Объект |
Коды региона. На данный момент используется только система кодирования Яндекс Расписаний ( |
|
Объект |
Название региона. |
Элементыобъекта settlement
Элемент XML |
Тип |
Описание |
|
Объект |
Название населенного пункта. |
|
Объект |
Коды населенного пункта. На данный момент используется только система кодирования Яндекс Расписаний ( |
|
Объект |
Одна из станций в населенном пункте. |
Элементыобъекта station
Элемент XML |
Тип |
Описание |
|
Строка |
Направление движения поездов, на котором находится станция. Значение пусто, если станция не железнодорожная. |
|
Объект |
Список кодов станции. |
|
Объект |
Тип станции. Возможные значения:
|
|
Объект |
Название станции. |
|
Число |
Долгота станции. |
|
Объект |
Тип транспорта, следующего через станцию. Возможные значения:
|
|
Число |
Широта станции. |
Элементы, вложенные в элемент station/codes
Элемент XML |
Тип |
Описание |
|
Строка |
Код в системе кодирования Яндекс Расписаний. |
|
Строка |
Код железнодорожной станции в системе кодирования ЕСР. |
Ключ доступа к 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
— морской вокзал.
Тип
Строка
Описание
Направление движения поездов, на котором находится станция.
Значение пусто, если станция не железнодорожная.
Тип
Строка
Описание
Код железнодорожной станции в системе кодирования ЕСР.