Список ближайших станций

Запрос позволяет получить список станций, находящихся в указанном радиусе от указанной точки. Максимальное количество возвращаемых станций — 50.

Точка определяется географическими координатами (широтой и долготой) согласно WGS84.

Примечание.

Запрос следует отправлять по протоколу HTTPS.

  1. Синтаксис запроса
  2. Структура ответа

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

https://api.rasp.yandex.net/v3.0/nearest_stations/ ?
  apikey=<ключ> 
& lat=<широта>
& lng=<долгота>
& distance=<радиус охвата>
& [lang=<язык>]
& [offset=<сдвиг относительно первого рейса в ответе>]
& [limit=<ограничение на количество рейсов в ответе>]
& [station_types=<тип станции>]
& [transport_types=<тип транспортного средства>]
& [format=<формат>]

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

https://api.rasp.yandex.net/v3.0/nearest_stations/?apikey={ключ}&format=json&lat=50.440046&lng=40.4882367&distance=50&lang=ru_RU

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

Параметр Описание
Обязательные параметры
apikey

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

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

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

Широта согласно WGS84.

lng

Долгота согласно WGS84.

distance

Радиус, в котором следует искать станции, в километрах.

Необязательные параметры
lang

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

По умолчанию ответ возвращается для значения 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.

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

Ответ представляет собой список станций, находящихся в указанном радиусе от указанной точки с информацией по каждой станции.

{
  "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
total Число

Общее количество станций, удовлетворяющих условиям поиска.

limit Число

Ограничение на количество станций, которые Яндекс.Расписания возвращают в ответ на запрос. Ограничение можно задать в параметре limit.

Значение по умолчанию — 100.

offset Число

Смещение относительно первого результата поиска. Смещение можно задать в параметре offset.

Значение по умолчанию — 0.

Элементы объекта stations
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.

lng Число

Долгота согласно WGS84.

type Строка

Вид найденного пункта. Возможные значения:

  • station — станция;

  • settlement — поселение.

Элементы объекта type_choices
total Число

Общее количество станций, удовлетворяющих условиям поиска.

limit Число

Ограничение на количество станций, которые Яндекс.Расписания возвращают в ответ на запрос. Ограничение можно задать в параметре limit.

Значение по умолчанию — 100.

offset Число

Смещение относительно первого результата поиска. Смещение можно задать в параметре offset.

Значение по умолчанию — 0.