--- metadata: - name: generator content: Diplodoc Platform v5.42.1 alternate: - https://yandex.ru/dev/rasp/doc/ru/reference/query-nearest-station.md --- > **Documentation Index:** Fetch the complete configuration index at https://yandex.ru/dev/rasp/doc/ru/llms.txt # Список ближайших станций Запрос позволяет получить список [станций](https://yandex.ru/dev/rasp/doc/ru/concepts/termin.md#station), находящихся в указанном радиусе от указанной точки. Максимальное количество возвращаемых станций — 50. Точка определяется географическими координатами (широтой и долготой) согласно [WGS84](http://ru.wikipedia.org/wiki/WGS_84). {% note info %} Мы не гарантируем доступность домена [api.rasp.yandex.net](../_includes/reference/schedule-point-point/id-schedule-point-point/api.rasp.yandex.net) по независимым от Яндекса причинам. Если ваша интеграция уже использует этот домен — рекомендуем переключиться на [api.rasp.yandex-net.ru](../_includes/reference/schedule-point-point/id-schedule-point-point/api.rasp.yandex-net.ru). Для этого в вызовах АПИ замените `api.rasp.yandex.net` на `api.rasp.yandex-net.ru`, других действий не требуется. Ключи доступа и тарифы остаются без изменений. {% endnote %} ## Синтаксис запроса {#format} ```no-highlight https://api.rasp.yandex-net.ru/v3.0/nearest_stations/ ? [apikey](*apikey)=<ключ> & [lat](*lat)=<широта> & [lng](*lng)=<долгота> & [distance](*distance)=<радиус охвата> & [[lang](*lang)=<язык>] & [[offset](*offset)=<сдвиг относительно первого рейса в ответе>] & [[limit](*limit)=<ограничение на количество рейсов в ответе>] & [[station_types](*station_types)=<тип станции>] & [[transport_types](*transport_types)=<тип транспортного средства>] & [[format](*format)=<формат>] ``` Пример запроса: ```no-highlight https://api.rasp.yandex-net.ru/v3.0/nearest_stations/?apikey={ключ}&format=json&lat=50.440046&lng=40.4882367&distance=50&lang=ru_RU ``` Входные параметры: **Обязательные параметры** #| || **Параметр** | **Описание** || || `apikey` | [Ключ доступа](https://yandex.ru/dev/rasp/doc/ru/concepts/access.md) к API. Параметр можно не передавать, если ключ доступа указан в заголовке `Authorization`, например: ```no-highlight Authorization: 1eb31582-941a-3ac8-a61f-041c344495ab ``` || || `lat` | Широта согласно [WGS84](http://ru.wikipedia.org/wiki/WGS_84). || || `lng` | Долгота согласно [WGS84](http://ru.wikipedia.org/wiki/WGS_84). || || `distance` | Радиус, в котором следует искать станции, в километрах. || |# **Необязательные параметры** #| || **Параметр** | **Описание** || || `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`. || || `station_types` | Типы запрашиваемых станций (несколько типов можно перечислить через запятую). Поддерживаемые значения: - `station` — станция; - `platform` — платформа; - `stop` — остановочный пункт; - `checkpoint` — блок-пост; - `post` — пост; - `crossing` — разъезд; - `overtaking_point` — обгонный пункт; - `train_station` — вокзал; - `airport` — аэропорт; - `bus_station` — автовокзал; - `bus_stop` — автобусная остановка; - `unknown` — станция без типа; - `port` — порт; - `port_point` — портпункт; - `wharf` — пристань; - `river_port` — речной вокзал; - `marine_station` — морской вокзал. || || `transport_types` | Типы транспортного средства, для которых нужно искать станции. Несколько типов одновременно можно указать через запятую, например, plane,train,bus. Поддерживаемые значения: - `plane` — самолет; - `train` — поезд; - `suburban` — электричка; - `bus` — автобус; - `sea` — морской транспорт; - `river` — речной транспорт; - `helicopter` — вертолет. || || `offset` | Смещение относительно первого результата поиска. Например, если вам не нужны первые 10 результатов поиска, задайте для параметра значение «10». Значение по умолчанию — 0. || || `limit` | Максимальное количество результатов поиска в ответе. Значение по умолчанию — 100. || |# ## Структура ответа {#emails-detailed} Ответ представляет собой список станций, находящихся в указанном радиусе от указанной точки с информацией по каждой станции. {% list tabs %} - Пример ответа в формате JSON ```javascript { "pagination": { "total": 35, "limit": 100, "offset": 0 }, "stations": [ { "distance": 24.74255931084455, "code": "s9637063", "station_type": "bus_station", "station_type_name": "автовокзал", "type_choices": { "schedule": { "desktop_url": "https://rasp.yandex.ru/station/9761931/schedule", "touch_url": "https://t.rasp.yandex.ru/station/9761931/schedule" } }, "title": "Павловск", "popular_title": "", "short_title": "", "transport_type": "bus", "lat": 50.4516962252837, "lng": 40.1392928134917, "type": "station" }, ... ] } ``` #### Описание элементов JSON #| || **Элемент JSON** | **Тип** | **Описание** || || `pagination` | Массив | Информация о постраничном выводе. || || `stations` | Массив | Список станций. || |# **Элементыобъекта** `pagination` #| || **Элемент JSON** | **Тип** | **Описание** || || `total` | Число | Общее количество станций, удовлетворяющих условиям поиска.|| || `limit` | Число | Ограничение на количество станций, которые Яндекс Расписания возвращают в ответ на запрос. Ограничение можно задать в параметре `limit`. Значение по умолчанию — 100.|| || `offset` | Число | Смещение относительно первого результата поиска. Смещение можно задать в параметре `offset`. Значение по умолчанию — 0. || |# **Элементыобъекта** `stations` #| || **Элемент JSON** | **Тип** | **Описание** || || `distance` | Число | Расстояние от указанной в запросе точки до полученной в ответе станции. || || `code` | Строка | Код станции в системе кодирования Яндекс Расписаний.|| || `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` — морской вокзал.|| || `station_type_name` | Строка | Название типа станции, зависит от языка ответа. Возможные значения на русском — в списке значений ключа `station_type`.|| || `type_choices` | Объект | Типы расписаний, доступные для станции. Каждый тип описывается в отдельном объекте, который содержит ссылки на мобильную и десктопную версию расписания. Доступные типы: - `schedule` — вид расписания по умолчанию; - `tablo` — табло аэропорта; - `train` — расписание железнодорожного вокзала; - `suburban` — расписание электричек; - `aeroex` — расписание аэроэкспрессов.|| || `title` | Строка | Название станции.|| || `popular_title` | Строка | Общепринятое название станции.|| || `short_title` | Строка | Короткое название станции.|| || `majority` | Строка | Целое число, определяющее относительную важность станции в транспортном сообщении региона, где 1 — высшая важность (например, главный вокзал города).|| || `transport_type` | Строка | Основной тип транспорта для данной станции. Возможные значения: - `plane` — самолет; - `train` — поезд; - `suburban` — электричка; - `bus` — автобус; - `water` — водный транспорт; - `helicopter` — вертолет.|| || `lat` | Число | Широта согласно [WGS84](http://ru.wikipedia.org/wiki/WGS_84).|| || `lng` | Число | Долгота согласно [WGS84](http://ru.wikipedia.org/wiki/WGS_84).|| || `type` | Строка | Вид найденного пункта. Возможные значения: - `station` — станция; - `settlement` — поселение. || |# **Элементыобъекта** `type_choices` #| || **Элемент JSON** | **Тип** | **Описание** || || `total` | Число | Общее количество станций, удовлетворяющих условиям поиска.|| || `limit` | Число | Ограничение на количество станций, которые Яндекс Расписания возвращают в ответ на запрос. Ограничение можно задать в параметре `limit`. Значение по умолчанию — 100.|| || `offset` | Число | Смещение относительно первого результата поиска. Смещение можно задать в параметре `offset`. Значение по умолчанию — 0. || |# - Пример ответа в формате XML ```xml <[pagination](*code-pagination)> <[total](*code-total)>35 <[limit](*code-limit)>100 <[offset](*code-offset)>0 <[station](*code-station)> <[distance](*code-distance)>15.8152773714 <[code](*code-code)>s9600215 <[title](*code-title)>Внуково <[type_choices](*code-type_choices)> https://rasp.yandex.ru/station/9600215/tablo https://t.rasp.yandex.ru/station/9600215/tablo https://rasp.yandex.ru/station/9600215/aeroex https://t.rasp.yandex.ru/station/9600215/aeroex <[station_type](*code-station_type)>аэропорт <[popular_title](*code-popular_title)> <[short_title](*code-short_title)> <[majority](*code-majority)>2 <[transport_type](*code-transport_type)>plane <[lat](*code-lat)>55.605817 <[lng](*code-lng)>37.288233 <[type](*code-type)>station <[station](*code-station)> ... ... ``` #### Описание элементов XML #| || **Элемент JSON** | **Тип** | **Описание** || || `pagination` | Объект | Информация о постраничном выводе найденных станций. || || `station` | Объект | Информация о найденной станции. || |# **Элементы, вложенные в** `stations` #| || **Элемент JSON** | **Тип** | **Описание** || || `distance` | Число | Расстояние от станции до точки с указанными в запросе координатами.|| || `code` | Строка | Код станции в системе кодирования Яндекс Расписаний.|| || `title` | Строка | Название станции.|| || `type_choices` | Строка | Типы расписаний, доступные для станции. Каждый тип описывается в отдельном объекте, который содержит ссылки на мобильную и десктопную версию расписания. Доступные типы: - `schedule` — вид расписания по умолчанию; - `tablo` — табло аэропорта; - `train` — расписание железнодорожного вокзала; - `suburban` — расписание электричек; - `aeroex` — расписание аэроэкспрессов.|| || `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` — морской вокзал.|| || `station_type_name` | Строка | Название типа станции, зависит от языка ответа. Возможные значения на русском — в списке значений ключа station_type.|| || `popular_title` | Строка | Общепринятое название станции. || || `short_title` | Строка | Короткое название станции.|| || `majority` | Строка | Целое число, определяющее относительную важность станции в транспортном сообщении региона, где 1 — высшая важность (например, главный вокзал города).|| || `transport_type` | Строка | Основной тип транспорта для данной станции. Возможные значения: - `plane` — самолет; - `train` — поезд; - `suburban` — электричка; - `bus` — автобус; - `water` — водный транспорт; - `helicopter` — вертолет.|| || `lat` | Число | Широта согласно [WGS84](http://ru.wikipedia.org/wiki/WGS_84). || || `lng` | Число | Долгота согласно [WGS84](http://ru.wikipedia.org/wiki/WGS_84). || || `type` | Строка | Вид найденного пункта. Возможные значения: - `station` — станция; - `settlement` — поселение. || |# {% endlist %} [*apikey]: [Ключ доступа](https://yandex.ru/dev/rasp/doc/ru/concepts/access.md) к API.   Параметр можно не передавать, если ключ доступа указан в заголовке `Authorization`, например:   ```no-highlight Authorization: 1eb31582-941a-3ac8-a61f-041c344495ab ``` [*lat]: Широта согласно [WGS84](http://ru.wikipedia.org/wiki/WGS_84). [*lng]: Долгота согласно [WGS84](http://ru.wikipedia.org/wiki/WGS_84). [*distance]: Радиус, в котором следует искать ближайший город, в километрах. [*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`. [*station_types]: Типы запрашиваемых станций (несколько типов можно перечислить через запятую).   Поддерживаемые значения:   - `station` — станция; - `platform` — платформа; - `stop` — остановочный пункт; - `checkpoint` — блок-пост; - `post` — пост; - `crossing` — разъезд; - `overtaking_point` — обгонный пункт; - `train_station` — вокзал; - `airport` — аэропорт; - `bus_station` — автовокзал; - `bus_stop` — автобусная остановка; - `unknown` — станция без типа; - `port` — порт; - `port_point` — портпункт; - `wharf` — пристань; - `river_port` — речной вокзал; - `marine_station` — морской вокзал. [*transport_types]: Типы транспортного средства, для которых нужно искать станции. Несколько типов одновременно можно указать через запятую, например, plane,train,bus.   Поддерживаемые значения:   - `plane` — самолет; - `train` — поезд; - `suburban` — электричка; - `bus` — автобус; - `sea` — морской транспорт; - `river` — речной транспорт; - `helicopter` — вертолет. [*offset]: Смещение относительно первого результата поиска. Например, если вам не нужны первые 10 результатов поиска, задайте для параметра значение «10».   Значение по умолчанию — 0. [*limit]: Максимальное количество результатов поиска в ответе.   Значение по умолчанию — 100. [*code-code]: **Тип**   Строка   **Описание**   Код пункта прибытия в системе кодирования Яндекс Расписаний. [*code-type]: **Тип**   Строка   **Описание**   Вид пункта отправления.   Возможные значения:   - `station` — станция;   - `settlement` — поселение. [*code-title]: **Тип**   Строка   **Описание**   Название пункта отправления. [*code-transport_type]: **Тип**   Строка   **Описание**   Тип отправляющегося транспортного средства.   Возможные значения:   - `plane` — самолет;   - `train` — поезд;   - `suburban` — электричка;   - `bus` — автобус;   - `water` — водный транспорт;   - `helicopter` — вертолет. [*code-station]: **Тип**   Объект   **Описание**   Информация об указанной в запросе станции. [*code-short_title]: **Тип**   Строка   **Описание**   Название нитки, составленное из коротких названий первой и последней станций следования. [*code-to]: **Тип**   Строка   **Описание**   Пункт прибытия, указанный в параметре `to`. [*code-popular_title]: **Тип**   Строка   **Описание**   Общепринятое название станции. [*code-pagination]: **Тип**   Массив   **Описание**   Информация о постраничном выводе. [*code-total]: **Тип**   Число   **Описание**   Общее количество станций, удовлетворяющих условиям поиска. [*code-limit]: **Тип**   Число   **Описание**   Ограничение на количество станций, которые Яндекс Расписания возвращают в ответ на запрос. Ограничение можно задать в параметре `limit`.   Значение по умолчанию — 100. [*code-offset]: **Тип**   Число   **Описание**   Смещение относительно первого результата поиска. Смещение можно задать в параметре `offset`.   Значение по умолчанию — 0. [*code-distance]: **Тип**   Число   **Описание**   Расстояние от указанной в запросе точки до полученной в ответе станции. [*code-type_choices]: **Тип**   Объект   **Описание**   Типы расписаний, доступные для станции. Каждый тип описывается в отдельном объекте, который содержит ссылки на мобильную и десктопную версию расписания.   Доступные типы:   - `schedule` — вид расписания по умолчанию;   - `tablo` — табло аэропорта;   - `train` — расписание железнодорожного вокзала;   - `suburban` — расписание электричек;   - `aeroex` — расписание аэроэкспрессов. [*code-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` — морской вокзал. [*code-majority]: **Тип**   Строка   **Описание**   Целое число, определяющее относительную важность станции в транспортном сообщении региона, где 1 — высшая важность (например, главный вокзал города). [*code-lat]: **Тип**   Число   **Описание**   Широта согласно [WGS84](http://ru.wikipedia.org/wiki/WGS_84). [*code-lng]: **Тип**   Число   **Описание**   Долгота согласно [WGS84](http://ru.wikipedia.org/wiki/WGS_84).