---
metadata:
  - name: generator
    content: Diplodoc Platform v5.42.1
alternate:
  - https://yandex.ru/dev/rasp/doc/ru/reference/stations-list.md
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.ru/dev/rasp/doc/ru/llms.txt

# Список всех доступных станций

Ресурс содержит полный список станций, информацию о которых предоставляют Яндекс Расписания. Список структурирован географически: ответ содержит список стран со вложенными списками регионов и населенных пунктов, в которых находятся станции.

Размер возвращаемого JSON-документа — около 40 МБ.

<!-- source: ru/_includes/reference/schedule-point-point/id-schedule-point-point/https.md -->
{% 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 %}
<!-- endsource: ru/_includes/reference/schedule-point-point/id-schedule-point-point/https.md -->


## Синтаксис запроса {#query}

```no-highlight
https://api.rasp.yandex-net.ru/v3.0/stations_list/ ?
  [apikey](*apikey)=<ключ>
[& [format](*format)=<формат>]
[& [lang](*lang)=<язык>]
```

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

```no-highlight
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.md) к API.

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

```no-highlight
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`. ||
|#



## Структура ответа {#emails-detailed}

Ответ оформлен в виде набора вложенных массивов: на верхнем уровне перечислены страны, в описании каждой страны — регионы, в каждом регионе — города, в каждом городе — станции.

Часть ответа в различных форматах показана в примерах.

{% list tabs %}

- Пример ответа в формате JSON

  ```javascript
  {
  "countries":
    [
      {
        "regions":
        [
          {
            "[settlements](*settlements)":
            [
              {
                "[title](*title)": "",
                "codes": {},
                "stations":
                [
                  {
                    "[direction](*direction)": "",
                    "codes":
                    {
                      "[yandex_code](*yandex_code)": "s9628674"
                    },
                    "station_type": "аэропорт",
                    "title": "Бермуды",
                    "longitude": -64.678703,
                    "transport_type": "Самолёт",
                    "latitude": 32.364041
                  }
                ]
            }
            ],
            "codes": {},
            "title": ""
          }
        ],
        "codes":
        {
          "yandex_code": "l21546"
        },
        "title": "Бермудские острова"
      },
      {
        "regions":
        [
          {
            "[settlements](*settlements)":
            [
              {
                "[title](*title)": "Банжул",
                "codes":
                {
                  "yandex_code": "c21012"
                },
                "stations":
                [
                  {
                    "[direction](*direction)": "",
                    "codes":
                    {
                      "[yandex_code](*yandex_code)": "s9628059"
                    },
                    "station_type": "аэропорт",
                    "title": "Юндум",
                    "longitude": -16.652222,
                    "transport_type": "Самолёт",
                    "latitude": 13.338056
                  }
                ]
              }
            ],
            "codes": {},
            "title": ""
          }
        ],
        "codes":
        {
          "yandex_code": "l21010"
        },
        "title": "Гамбия"
      }
      {
        "regions":
        [
          {
            "[settlements](*settlements)":
            [
              {
                "[title](*title)": "Новая Уситва",
                "codes":
                {
                  "yandex_code": "c54722"
                },
                "stations":
                [
                  {
                    "[direction](*direction)": "",
                    "codes":
                    {
                      "[yandex_code](*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` | Строка | Код в системе кодирования Яндекс Расписаний. ||
  |#


- Пример ответа в формате XML

  ```xml
  <response>
    <[country](*code-country)>
      <[title](*code-title-country)>Бермудские острова</title>
      <[codes](*code-codes)>
        <[yandex_code](*code-yandex_code)>l21546</yandex_code>
      </codes>
      <[region](*code-region)>
        <[title](*code-title-region)/>
        <[codes](*code-codes)/>
        <[settlement](*code-settlement)>
          <[title](*code-title-city)/>
          <[codes](*code-codes)/>
          <[station](*code-station)>
            <[title](*code-title-station)>Бермуды</title>
            <[longitude](*code-longitude)>-64.678703</longitude>
            <[latitude](*code-latitude)>32.364041</latitude>
            <[transport_type](*code-transport_type)>Самолёт</transport_type>
            <[station_type](*code-station_type)>аэропорт</station_type>
            <[codes](*code-codes)>
              <[yandex_code](*code-yandex_code)>s9628674</yandex_code>
            </codes>
          </station>
        </settlement>
      </region>
    </country>
    <[country](*code-country)>
      <[title](*code-title-country)>Гамбия</title>
      <[codes](*code-codes)>
        <[yandex_code](*code-yandex_code)>l21010</yandex_code>
      </codes>
      <[region](*code-region)>
        <[title](*code-title-region)/>
        <[codes](*code-codes)/>
        <[settlement](*code-settlement)>
          <[title](*code-title-city)>Банжул</title>
          <[codes](*code-codes)>
            <[yandex_code](*code-yandex_code)>c21012</yandex_code>
          </codes>
          <[station](*code-station)>
            <[title](*code-title-station)>Юндум</title>
            <[longitude](*code-longitude)>-16.652222</longitude>
            <[latitude](*code-latitude)>13.338056</latitude>
            <[transport_type](*code-transport_type)>Самолёт</transport_type>
            <[station_type](*code-station_type)>аэропорт</station_type>
            <[codes](*code-codes)>
              <[yandex_code](*code-yandex_code)>s9628059</yandex_code>
            </codes>
          </station>
        </settlement>
      </region>
    </country>
    <[country](*code-country)>
      <[title](*code-title-country)>Россия</title>
      <[codes](*code-codes)>
        <[yandex_code](*code-yandex_code)>l225</yandex_code>
      </codes>
      <[region](*code-region)>
        <[title](*code-title-region)>Псковская область</title>
        <codes>
          <[yandex_code](*code-yandex_code)>r10926</yandex_code>
        </codes>
        <[settlement](*code-settlement)>
          <[title](*code-title-city)>Новая Уситва</title>
          <codes>
            <[yandex_code](*code-yandex_code)>c54722</yandex_code>
          </codes>
          <[station](*code-station)>
            <[title](*code-title-station)>Новая Уситва</title>
            <[longitude](*code-longitude)>28.1280804652</longitude>
            <[latitude](*code-latitude)>57.4583284321</latitude>
            <[transport_type](*code-transport_type)>Автобус</transport_type>
            <[station_type](*code-station_type)>автобусная остановка</station_type>
            <[codes](*code-codes)>
              <[yandex_code](*code-yandex_code)>s9855938</yandex_code>
            </codes>
          </station>
          <[station](*code-station)>
            <[title](*code-title-station)>Касторная-Новая</title>
            <[longitude](*code-longitude)>38.123675</longitude>
            <[latitude](*code-latitude)>51.780828</latitude>
            <[transport_type](*code-transport_type)>Поезд</transport_type>
            <[station_type](*code-station_type)>станция</station_type>
            <[direction](*code-direction)>Елецкое</direction>
            <[codes](*code-codes)>
              <[esr_code](*code-esr_code)>595401</esr_code>
              <[yandex_code](*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` | Строка | Направление движения поездов, на котором находится станция.

  Значение пусто, если станция не железнодорожная. ||
  || `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). ||
  |#



{% endlist %}

<!--
      <section display-style="tab">
        <title>Пример ответа в формате JSON</title>
        <defblock code-lang="javascript" deflink="current">{
 &quot;countries&quot;:
  [
    {
      &quot;regions&quot;:
      [
        {/*hide:regions*/
          &quot;settlements&quot;:
          [
            {/*hide:settlements*/
              &quot;title&quot;: &quot;&quot;,
              &quot;codes&quot;: {},
              &quot;stations&quot;:
              [
                {/*hide:stations*/
                 &quot;direction&quot;: &quot;&quot;,
                  &quot;codes&quot;:
                  {/*hide:stations/codes*/
                    &quot;yandex_code&quot;: &quot;s9628674&quot;
                  },
                  &quot;station_type&quot;: &quot;аэропорт&quot;,
                  &quot;title&quot;: &quot;Бермуды&quot;,
                  &quot;longitude&quot;: -64.678703,
                  &quot;transport_type&quot;: &quot;Самолёт&quot;,
                  &quot;latitude&quot;: 32.364041
                }
              ]
           }
          ],
          &quot;codes&quot;: {},
          &quot;title&quot;: &quot;&quot;
        }
      ],
      &quot;codes&quot;:
      {/*hide:countries/codes*/
        &quot;yandex_code&quot;: &quot;l21546&quot;
      },
      &quot;title&quot;: &quot;Бермудские острова&quot;
    },
    {
      &quot;regions&quot;:
      [
        {/*hide:regions*/
          &quot;settlements&quot;:
          [
            {/*hide:settlements*/
              &quot;title&quot;: &quot;Банжул&quot;,
              &quot;codes&quot;:
              {/*hide:settlements/codes*/
                &quot;yandex_code&quot;: &quot;c21012&quot;
              },
              &quot;stations&quot;:
              [
                {/*hide:stations*/
                 &quot;direction&quot;: &quot;&quot;,
                  &quot;codes&quot;:
                  {
                    &quot;yandex_code&quot;: &quot;s9628059&quot;
                  },
                  &quot;station_type&quot;: &quot;аэропорт&quot;,
                  &quot;title&quot;: &quot;Юндум&quot;,
                  &quot;longitude&quot;: -16.652222,
                  &quot;transport_type&quot;: &quot;Самолёт&quot;,
                  &quot;latitude&quot;: 13.338056
                }
              ]
           }
          ],
          &quot;codes&quot;: {},
          &quot;title&quot;: &quot;&quot;
        }
      ],
      &quot;codes&quot;:
      {/*hide:countries/codes*/
        &quot;yandex_code&quot;: &quot;l21010&quot;
      },
      &quot;title&quot;: &quot;Гамбия&quot;
    },
    {
      &quot;regions&quot;:
      [
        {/*hide:regions*/
          &quot;settlements&quot;:
          [
            {/*hide:settlements*/
              &quot;title&quot;: &quot;Новая Уситва&quot;,
              &quot;codes&quot;:
              {/*hide:settlements/codes*/
                &quot;yandex_code&quot;: &quot;c54722&quot;
              },
              &quot;stations&quot;:
              [
                {/*hide:stations*/
                  &quot;direction&quot;: &quot;&quot;,
                  &quot;codes&quot;:
                  {
                    &quot;yandex_code&quot;: &quot;s9855938&quot;
                  },
                  &quot;station_type&quot;: &quot;автобусная остановка&quot;,
                  &quot;title&quot;: &quot;Новая Уситва&quot;,
                  &quot;longitude&quot;: 28.1280804651562,
                  &quot;transport_type&quot;: &quot;Автобус&quot;,
                  &quot;latitude&quot;: 57.4583284320784
                }
              ]
            },
            {
              &quot;title&quot;: &quot;Касторное&quot;,
              &quot;codes&quot;:
              {/*hide:settlements/codes*/
                &quot;yandex_code&quot;: &quot;c22754&quot;
              },
              &quot;stations&quot;:
              [
                {/*hide:stations*/
                  &quot;direction&quot;: &quot;Елецкое&quot;,
                  &quot;codes&quot;:
                  {
                    &quot;esr_code&quot;: &quot;595401&quot;,
                    &quot;yandex_code&quot;: &quot;s9605487&quot;
                  },
                  &quot;station_type&quot;: &quot;станция&quot;,
                  &quot;title&quot;: &quot;Касторная-Новая&quot;,
                  &quot;longitude&quot;: 38.123675,
                  &quot;transport_type&quot;: &quot;Поезд&quot;,
                  &quot;latitude&quot;: 51.780828
                }
              ]
           }
          ],
          &quot;codes&quot;:
          {/*hide:regions/codes*/
            &quot;yandex_code&quot;: &quot;r10705&quot;
          },
          &quot;title&quot;: &quot;Курская область&quot;
        }
      ],
      &quot;codes&quot;:
      {/*hide:countries/codes*/
        &quot;yandex_code&quot;: &quot;l225&quot;
      },
      &quot;title&quot;: &quot;Россия&quot;
    }
  ]
}</defblock>
        <deftable pgwide="1" id="input-data_5" exclude-from="html">
          <title>Описание элементов JSON</title>
          <tgroup cols="3">
            <colspec colname="Man1" colnum="1" colwidth="15*"/>
            <colspec colname="cgen1" colnum="2" colwidth="15*" popup="yes" class="- topic/colspec "/>
            <colspec colname="Man4" colnum="3" colwidth="60*" popup="yes"/>
            <thead>
              <row>
                <entry align="left">Элемент JSON</entry>
                <entry>Тип</entry>
                <entry align="left">Описание</entry>
              </row>
            </thead>
            <tbody>
              <row>
                <entry>
                  <parmdef>countries</parmdef>
                </entry>
                <entry>Массив</entry>
                <entry>
                  <p>Список стран.</p>
                </entry>
              </row>
            </tbody>
          </tgroup>
          <tgroup cols="3">
            <colspec colname="Man1" colnum="1" colwidth="15*"/>
            <colspec colname="cgen1" colnum="2" colwidth="15*" popup="yes" class="- topic/colspec "/>
            <colspec colname="Man4" colnum="3" colwidth="60*" popup="yes"/>
            <thead>
              <row>
                <entry nameend="Man4" namest="Man1">Элементы объекта <parmname translate="no">countries</parmname></entry>
              </row>
            </thead>
            <tbody>
              <row id="uid_137">
                <entry>
                  <parmdef>regions</parmdef>
                </entry>
                <entry>Массив</entry>
                <entry>
                  <p id="carrier-info-code">Список регионов страны.</p>
                </entry>
              </row>
              <row id="uid_159">
                <entry>
                  <parmdef>codes</parmdef>
                </entry>
                <entry>Объект</entry>
                <entry>
                  <p id="carrier-info-code_14">Коды страны. <ph id="yandex-code-only">На данный момент используется только система кодирования Яндекс Расписаний (<codeph>yandex_code</codeph>).</ph></p>
                </entry>
              </row>
              <row id="uid_160">
                <entry>
                  <parmdef>title</parmdef>
                </entry>
                <entry>Строка</entry>
                <entry>
                  <p id="carrier-info-code_15">Название страны.</p>
                </entry>
              </row>
            </tbody>
          </tgroup>
          <tgroup cols="3">
            <colspec colname="Man1" colnum="1" colwidth="15*"/>
            <colspec colname="cgen1" colnum="2" colwidth="15*" popup="yes" class="- topic/colspec "/>
            <colspec colname="Man4" colnum="3" colwidth="60*" popup="yes"/>
            <thead>
              <row>
                <entry nameend="Man4" namest="Man1">Элементы объекта <parmname translate="no">regions</parmname></entry>
              </row>
            </thead>
            <tbody>
              <row id="uid_141">
                <entry>
                  <parmdef>settlements</parmdef>
                </entry>
                <entry>Массив</entry>
                <entry>
                  <p id="carrier-info-code_1">Список населенных пунктов региона.</p>
                </entry>
              </row>
              <row id="uid_158">
                <entry>
                  <parmdef>codes</parmdef>
                </entry>
                <entry>Объект</entry>
                <entry>
                  <p id="carrier-info-code_13">Коды региона. <ph conref="#emails-detailed/yandex-code-only"/></p>
                </entry>
              </row>
              <row id="uid_157">
                <entry>
                  <parmdef>title</parmdef>
                </entry>
                <entry>Строка</entry>
                <entry>
                  <p id="carrier-info-code_12">Название региона.</p>
                </entry>
              </row>
            </tbody>
          </tgroup>
          <tgroup cols="3">
            <colspec colname="Man1" colnum="1" colwidth="15*"/>
            <colspec colname="cgen1" colnum="2" colwidth="15*" popup="yes" class="- topic/colspec "/>
            <colspec colname="Man4" colnum="3" colwidth="60*" popup="yes"/>
            <thead>
              <row>
                <entry nameend="Man4" namest="Man1">Элементы объекта <parmname translate="no">settlements</parmname></entry>
              </row>
            </thead>
            <tbody>
              <row id="uid_142">
                <entry>
                  <parmdef>title</parmdef>
                </entry>
                <entry>Строка</entry>
                <entry>
                  <p id="carrier-info-code_2">Название населенного пункта.</p>
                </entry>
              </row>
              <row id="uid_155">
                <entry>
                  <parmdef>codes</parmdef>
                </entry>
                <entry>Объект</entry>
                <entry>
                  <p id="carrier-info-code_10">Коды населенного пункта. <ph conref="#emails-detailed/yandex-code-only"/></p>
                </entry>
              </row>
              <row id="uid_156">
                <entry>
                  <parmdef>stations</parmdef>
                </entry>
                <entry>Объект</entry>
                <entry>
                  <p id="carrier-info-code_11">Список станций в населенном пункте.</p>
                </entry>
              </row>
            </tbody>
          </tgroup>
          <tgroup cols="3">
            <colspec colname="Man1" colnum="1" colwidth="15*"/>
            <colspec colname="cgen1" colnum="2" colwidth="15*" popup="yes" class="- topic/colspec "/>
            <colspec colname="Man4" colnum="3" colwidth="60*" popup="yes"/>
            <thead>
              <row>
                <entry nameend="Man4" namest="Man1">Элементы объекта <parmname translate="no">stations</parmname></entry>
              </row>
            </thead>
            <tbody>
              <row id="uid_143">
                <entry>
                  <parmdef>direction</parmdef>
                </entry>
                <entry>Строка</entry>
                <entry>
                  <p id="carrier-info-code_3">Направление движения поездов, на котором находится станция.</p>
                  <p id="carrier-info-code_16">Значение пусто, если станция не железнодорожная.</p>
                </entry>
              </row>
              <row id="uid_144">
                <entry>
                  <parmdef>codes</parmdef>
                </entry>
                <entry>Объект</entry>
                <entry>
                  <p id="carrier-info-code_4">Список кодов станции.</p>
                </entry>
              </row>
              <row id="uid_145">
                <entry>
                  <parmdef>station_type</parmdef>
                </entry>
                <entry>Строка</entry>
                <entry>
                  <p id="carrier-info-code_5">Тип станции.</p>
                  <p id="carrier-info-code_17">Возможные значения:</p>
                  <ul id="ul_xhm_pwg_hz_1" conref="schedule-point-point.xml#emails-detailed/segment-station-type">
                    <li/>
                  </ul>
                </entry>
              </row>
              <row id="uid_151">
                <entry>
                  <parmdef>title</parmdef>
                </entry>
                <entry>Строка</entry>
                <entry>
                  <p id="carrier-info-code_6">Название станции.</p>
                </entry>
              </row>
              <row id="uid_152">
                <entry>
                  <parmdef>longitude</parmdef>
                </entry>
                <entry>Число</entry>
                <entry>
                  <p id="carrier-info-code_7">Долгота станции.</p>
                </entry>
              </row>
              <row id="uid_153">
                <entry>
                  <parmdef>transport_type</parmdef>
                </entry>
                <entry>Строка</entry>
                <entry>
                  <p id="carrier-info-code_8">Тип транспорта, следующего через станцию.</p>
                  <p id="carrier-info-code_18">Возможные значения:</p>
                  <ul id="ul_vsn_mrr_bbb_1" conref="schedule-point-point.xml#format/transport-types">
                    <li/>
                  </ul>
                </entry>
              </row>
              <row id="uid_154">
                <entry>
                  <parmdef>latitude</parmdef>
                </entry>
                <entry>Число</entry>
                <entry>
                  <p id="carrier-info-code_9">Широта станции.</p>
                </entry>
              </row>
            </tbody>
          </tgroup>
          <tgroup cols="3">
            <colspec colname="Man1" colnum="1" colwidth="15*" colsep="1" rowsep="1"/>
            <colspec colname="cgen1" colnum="2" colwidth="15*" popup="yes" class="- topic/colspec " colsep="1" rowsep="1"/>
            <colspec colname="Man4" colnum="3" colwidth="60*" popup="yes" colsep="1" rowsep="1"/>
            <thead>
              <row>
                <entry nameend="Man4" namest="Man1">Элементы объекта <parmname translate="no">station/codes</parmname></entry>
              </row>
            </thead>
            <tbody>
              <row>
                <entry>
                  <parmdef>esr_code</parmdef>
                </entry>
                <entry>Строка</entry>
                <entry>
                  <p id="esr-code">Код железнодорожной станции в системе кодирования <xref href="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" scope="external">ЕСР</xref>.</p>
                </entry>
              </row>
              <row>
                <entry>
                  <parmdef>yandex_code</parmdef>
                </entry>
                <entry>Строка</entry>
                <entry>
                  <p id="yandex-code">Код станции в системе кодирования Яндекс Расписаний.</p>
                </entry>
              </row>
            </tbody>
          </tgroup>
        </deftable>
      </section>
      <section id="output_2" display-style="tab">
        <title>Пример ответа в формате XML</title>
        <defblock code-lang="xml" deflink="current">&lt;response&gt;
  &lt;country&gt;
    &lt;title&gt;Бермудские острова&lt;/title&gt;
    &lt;codes{country}&gt;
      &lt;yandex_code{country/codes}&gt;l21546&lt;/yandex_code&gt;
    &lt;/codes&gt;
    &lt;region&gt;
      &lt;title{region}/&gt;
      &lt;codes{region}/&gt;
      &lt;settlement&gt;
        &lt;title{settlement}/&gt;
        &lt;codes{settlement}/&gt;
        &lt;station&gt;
          &lt;title{station}&gt;Бермуды&lt;/title&gt;
          &lt;longitude&gt;-64.678703&lt;/longitude&gt;
          &lt;latitude&gt;32.364041&lt;/latitude&gt;
          &lt;transport_type&gt;Самолёт&lt;/transport_type&gt;
          &lt;station_type&gt;аэропорт&lt;/station_type&gt;
          &lt;codes{station}&gt;
            &lt;yandex_code&gt;s9628674&lt;/yandex_code&gt;
          &lt;/codes&gt;
        &lt;/station&gt;
      &lt;/settlement&gt;
    &lt;/region&gt;
  &lt;/country&gt;
  &lt;country&gt;
    &lt;title{country}&gt;Гамбия&lt;/title&gt;
    &lt;codes{country}&gt;
      &lt;yandex_code{country}&gt;l21010&lt;/yandex_code&gt;
    &lt;/codes&gt;
    &lt;region&gt;
      &lt;title{region}/&gt;
      &lt;codes{region}/&gt;
      &lt;settlement&gt;
        &lt;title{settlement}&gt;Банжул&lt;/title&gt;
        &lt;codes{settlement}&gt;
          &lt;yandex_code{settlement/codes}&gt;c21012&lt;/yandex_code&gt;
        &lt;/codes&gt;
        &lt;station&gt;
          &lt;title{station}&gt;Юндум&lt;/title&gt;
          &lt;longitude&gt;-16.652222&lt;/longitude&gt;
          &lt;latitude&gt;13.338056&lt;/latitude&gt;
          &lt;transport_type&gt;Самолёт&lt;/transport_type&gt;
          &lt;station_type&gt;аэропорт&lt;/station_type&gt;
          &lt;codes{station}&gt;
            &lt;yandex_code{station}&gt;s9628059&lt;/yandex_code&gt;
          &lt;/codes&gt;
        &lt;/station&gt;
      &lt;/settlement&gt;
    &lt;/region&gt;
  &lt;/country&gt;
  &lt;country&gt;
    &lt;title&gt;Россия&lt;/title&gt;
    &lt;codes&gt;
      &lt;yandex_code&gt;l225&lt;/yandex_code&gt;
    &lt;/codes&gt;
    &lt;region&gt;
      &lt;title{region}&gt;Псковская область&lt;/title&gt;
      &lt;codes{region}&gt;
        &lt;yandex_code{region/codes}&gt;r10926&lt;/yandex_code&gt;
      &lt;/codes&gt;
      &lt;settlement&gt;
        &lt;title{settlement}&gt;Новая Уситва&lt;/title&gt;
        &lt;codes{settlement}&gt;
          &lt;yandex_code{settlement/codes}&gt;c54722&lt;/yandex_code&gt;
        &lt;/codes&gt;
        &lt;station&gt;
          &lt;title{station}&gt;Новая Уситва&lt;/title&gt;
          &lt;longitude&gt;28.1280804652&lt;/longitude&gt;
          &lt;latitude&gt;57.4583284321&lt;/latitude&gt;
          &lt;transport_type&gt;Автобус&lt;/transport_type&gt;
          &lt;station_type&gt;автобусная остановка&lt;/station_type&gt;
          &lt;codes&gt;
            &lt;yandex_code&gt;s9855938&lt;/yandex_code&gt;
          &lt;/codes&gt;
        &lt;/station&gt;
        &lt;station&gt;
          &lt;title{station}&gt;Касторная-Новая&lt;/title&gt;
          &lt;longitude&gt;38.123675&lt;/longitude&gt;
          &lt;latitude&gt;51.780828&lt;/latitude&gt;
          &lt;transport_type&gt;Поезд&lt;/transport_type&gt;
          &lt;station_type&gt;станция&lt;/station_type&gt;
          &lt;direction&gt;Елецкое&lt;/direction&gt;
          &lt;codes{station}&gt;
            &lt;esr_code&gt;595401&lt;/esr_code&gt;
            &lt;yandex_code&gt;s9605487&lt;/yandex_code&gt;
          &lt;/codes&gt;
        &lt;/station&gt;
      &lt;/settlement&gt;
    &lt;/region&gt;
  &lt;/country&gt;
&lt;/response&gt;</defblock>
        <deftable pgwide="1" id="input-data_8" exclude-from="html">
          <title>Описание элементов XML</title>
          <tgroup cols="3">
            <colspec colname="Man1" colnum="1" colwidth="15*"/>
            <colspec colname="cgen1" colnum="2" colwidth="15*" popup="yes" class="- topic/colspec "/>
            <colspec colname="Man4" colnum="3" colwidth="60*" popup="yes"/>
            <thead>
              <row>
                <entry align="left">Элемент XML</entry>
                <entry>Тип</entry>
                <entry align="left">Описание</entry>
              </row>
            </thead>
            <tbody>
              <row>
                <entry>
                  <elemdef>country</elemdef>
                </entry>
                <entry/>
                <entry>
                  <p>Страна, с вложенными описаниями регионов.</p>
                </entry>
              </row>
            </tbody>
          </tgroup>
          <tgroup cols="3">
            <colspec colname="Man1" colnum="1" colwidth="15*"/>
            <colspec colname="cgen1" colnum="2" colwidth="15*" popup="yes" class="- topic/colspec "/>
            <colspec colname="Man4" colnum="3" colwidth="60*" popup="yes"/>
            <thead>
              <row>
                <entry nameend="Man4" namest="Man1">Элементы объекта <parmname translate="no">country</parmname></entry>
              </row>
            </thead>
            <tbody>
              <row id="uid_138">
                <entry>
                  <elemdef>region</elemdef>
                </entry>
                <entry>Массив</entry>
                <entry>
                  <p id="carrier-info-code_21">Один из регионов страны.</p>
                </entry>
              </row>
              <row id="uid_161">
                <entry>
                  <elemdef>codes</elemdef>
                </entry>
                <entry/>
                <entry>
                  <p id="carrier-info-code_22">Коды страны. <ph conref="#emails-detailed/yandex-code-only"/></p>
                </entry>
              </row>
              <row id="uid_162">
                <entry>
                  <elemdef>title</elemdef>
                </entry>
                <entry>Строка</entry>
                <entry>
                  <p id="carrier-info-code_23">Название страны.</p>
                </entry>
              </row>
            </tbody>
          </tgroup>
          <tgroup cols="3">
            <colspec colname="Man1" colnum="1" colwidth="15*"/>
            <colspec colname="cgen1" colnum="2" colwidth="15*" popup="yes" class="- topic/colspec "/>
            <colspec colname="Man4" colnum="3" colwidth="60*" popup="yes"/>
            <thead>
              <row>
                <entry nameend="Man4" namest="Man1">Элементы объекта <parmname translate="no">region</parmname></entry>
              </row>
            </thead>
            <tbody>
              <row id="uid_163">
                <entry>
                  <elemdef>settlement</elemdef>
                </entry>
                <entry/>
                <entry>
                  <p id="carrier-info-code_24">Один из населенных пунктов региона.</p>
                </entry>
              </row>
              <row id="uid_164">
                <entry>
                  <elemdef>codes</elemdef>
                </entry>
                <entry>Объект</entry>
                <entry>
                  <p id="carrier-info-code_25">Коды региона. <ph conref="#emails-detailed/yandex-code-only"/></p>
                </entry>
              </row>
              <row id="uid_165">
                <entry>
                  <elemdef>title</elemdef>
                </entry>
                <entry>Объект</entry>
                <entry>
                  <p id="carrier-info-code_26">Название региона.</p>
                </entry>
              </row>
            </tbody>
          </tgroup>
          <tgroup cols="3">
            <colspec colname="Man1" colnum="1" colwidth="15*"/>
            <colspec colname="cgen1" colnum="2" colwidth="15*" popup="yes" class="- topic/colspec "/>
            <colspec colname="Man4" colnum="3" colwidth="60*" popup="yes"/>
            <thead>
              <row>
                <entry nameend="Man4" namest="Man1">Элементы объекта <parmname translate="no">settlement</parmname></entry>
              </row>
            </thead>
            <tbody>
              <row id="uid_166">
                <entry>
                  <elemdef>title</elemdef>
                </entry>
                <entry>Объект</entry>
                <entry>
                  <p id="carrier-info-code_27">Название населенного пункта.</p>
                </entry>
              </row>
              <row id="uid_167">
                <entry>
                  <elemdef>codes</elemdef>
                </entry>
                <entry>Объект</entry>
                <entry>
                  <p id="carrier-info-code_28">Коды населенного пункта. <ph conref="#emails-detailed/yandex-code-only"/></p>
                </entry>
              </row>
              <row id="uid_169">
                <entry>
                  <elemdef>station</elemdef>
                </entry>
                <entry>Объект</entry>
                <entry>
                  <p id="carrier-info-code_29">Одна из станций в населенном пункте.</p>
                </entry>
              </row>
            </tbody>
          </tgroup>
          <tgroup cols="3">
            <colspec colname="Man1" colnum="1" colwidth="15*"/>
            <colspec colname="cgen1" colnum="2" colwidth="15*" popup="yes" class="- topic/colspec "/>
            <colspec colname="Man4" colnum="3" colwidth="60*" popup="yes"/>
            <thead>
              <row>
                <entry nameend="Man4" namest="Man1">Элементы объекта <parmname translate="no">station</parmname></entry>
              </row>
            </thead>
            <tbody>
              <row id="uid_170">
                <entry>
                  <elemdef>direction</elemdef>
                </entry>
                <entry>Строка</entry>
                <entry>
                  <p id="carrier-info-code_30">Направление движения поездов, на котором находится
                    станция.</p>
                  <p id="carrier-info-code_31">Значение пусто, если станция не железнодорожная.</p>
                </entry>
              </row>
              <row id="uid_171">
                <entry>
                  <elemdef>codes</elemdef>
                </entry>
                <entry>Объект</entry>
                <entry>
                  <p id="carrier-info-code_32">Список кодов станции.</p>
                </entry>
              </row>
              <row id="uid_172">
                <entry>
                  <elemdef>station_type</elemdef>
                </entry>
                <entry>Объект</entry>
                <entry>
                  <p id="carrier-info-code_33">Тип станции.</p>
                  <p id="carrier-info-code_34">Возможные значения:</p>
                  <ul id="ul_xhm_pwg_hz" conref="schedule-point-point.xml#emails-detailed/segment-station-type">
                    <li/>
                  </ul>
                </entry>
              </row>
              <row id="uid_173">
                <entry>
                  <elemdef>title</elemdef>
                </entry>
                <entry>Объект</entry>
                <entry>
                  <p id="carrier-info-code_36">Название станции.</p>
                </entry>
              </row>
              <row id="uid_174">
                <entry>
                  <elemdef>longitude</elemdef>
                </entry>
                <entry>Число</entry>
                <entry>
                  <p id="carrier-info-code_37">Долгота станции.</p>
                </entry>
              </row>
              <row id="uid_175">
                <entry>
                  <elemdef>transport_type</elemdef>
                </entry>
                <entry>Объект</entry>
                <entry>
                  <p id="carrier-info-code_38">Тип транспорта, следующего через станцию.</p>
                  <p id="carrier-info-code_39">Возможные значения:</p>
                  <ul id="ul_vsn_mrr_bbb" conref="schedule-point-point.xml#format/transport-types">
                    <li/>
                  </ul>
                </entry>
              </row>
              <row id="uid_176">
                <entry>
                  <elemdef>latitude</elemdef>
                </entry>
                <entry>Число</entry>
                <entry>
                  <p id="carrier-info-code_41">Широта станции.</p>
                </entry>
              </row>
            </tbody>
          </tgroup>
          <tgroup cols="3">
            <colspec colname="Man2" colnum="1" colwidth="15*"/>
            <colspec colname="cgen1" colnum="2" colwidth="15*" popup="yes" class="- topic/colspec "/>
            <colspec colname="Man4" colnum="3" colwidth="60*" popup="yes"/>
            <thead>
              <row>
                <entry nameend="Man4" namest="Man2">Элементы, вложенные в элемент <parmname translate="no">station/codes</parmname></entry>
              </row>
            </thead>
            <tbody>
              <row id="uid_133">
                <entry>
                  <elemdef translate="no">yandex_code</elemdef>
                </entry>
                <entry>Строка</entry>
                <entry>
                  <p conref="#emails-detailed/yandex-code"/>
                </entry>
              </row>
              <row id="uid_134">
                <entry>
                  <elemdef translate="no">esr_code</elemdef>
                </entry>
                <entry>Строка</entry>
                <entry>
                  <p conref="#emails-detailed/esr-code"/>
                </entry>
              </row>
            </tbody>
          </tgroup>
        </deftable>
      </section>-->

[*apikey]: [Ключ доступа](https://yandex.ru/dev/rasp/doc/ru/concepts/access.md) к API.
   
  Параметр можно не передавать, если ключ доступа указан в заголовке `Authorization`, например:
   
  ```no-highlight
  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`.

[*settlements]:
  **Тип**
   
  Массив
   
  **Описание**
   
  Список населенных пунктов региона

[*title]:
  **Тип**
   
  Строка
   
  **Описание**
   
  Название населенного пункта.

[*direction]:
  **Тип**
   
  Строка
   
  **Описание**
   
  Направление движения поездов, на котором находится станция.
   
  Значение пусто, если станция не железнодорожная.

[*yandex_code]:
  **Тип**
   
  Строка
   
  **Описание**
   
  Код в системе кодирования Яндекс Расписаний.

[*code-country]:
  **Тип**
 
 **Описание**
 
  Страна, с вложенными описаниями регионов.

[*code-codes]:
  **Тип**
 
  Объект
 
 **Описание**
 
  Коды страны. На данный момент используется только система кодирования Яндекс Расписаний (`yandex_code`).

[*code-title-country]:
  **Тип**
 
  Строка
 
 **Описание**
 
  Название страны.

[*code-title-region]:
  **Тип**
 
  Объект
 
 **Описание**
 
  Название региона.

[*code-title-city]:
  **Тип**
 
  Объект
 
 **Описание**
 
  Название населенного пункта.

[*code-title-station]:
  **Тип**
 
  Объект
 
 **Описание**
 
  Название станции.

[*code-yandex_code]:
  **Тип**
 
  Строка
 
 **Описание**
 
  Код в системе кодирования Яндекс Расписаний.

[*code-region]:
  **Тип**
 
  Массив
 
 **Описание**
 
  Один из регионов страны.

[*code-settlement]:
  **Тип**
 
 **Описание**
 
  Один из населенных пунктов региона.

[*code-station]:
  **Тип**
 
  Объект
 
 **Описание**
 
  Одна из станций в населенном пункте.

[*code-place]:
  Информация об отдельном типе билетов

[*code-longitude]:
  **Тип**
 
  Число
 
 **Описание**
 
  Долгота станции.

[*code-latitude]:
  **Тип**
 
  Число
 
 **Описание**
 
  Широта станции.

[*code-transport_type]:
  **Тип**
 
  Строка
 
 **Описание**
 
  Тип транспорта, следующего через станцию.
 
  Возможные значения:
 
  - `plane` — самолет;
 
  - `train` — поезд;
 
  - `suburban` — электричка;
 
  - `bus` — автобус;
 
  - `water` — морской транспорт;
 
  - `helicopter` — вертолет.

[*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-direction]:
  **Тип**
 
  Строка
 
 **Описание**
 
  Направление движения поездов, на котором находится станция.
 
  Значение пусто, если станция не железнодорожная.

[*code-esr_code]:
  **Тип**
 
  Строка
 
 **Описание**
 
  Код железнодорожной станции в системе кодирования [ЕСР](https://ru.wikipedia.org/wiki/Единая_сетевая_разметка).