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

# Ближайший город

Запрос позволяет получить информацию о ближайшем к указанной точке городе. Точка определяется географическими координатами (широтой и долготой) согласно [WGS84](http://ru.wikipedia.org/wiki/WGS_84). Поиск можно ограничить определенным радиусом (по умолчанию — 10 километров, но не больше 50).

<!-- 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 -->


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

```no-highlight
https://api.rasp.yandex-net.ru/v3.0/nearest_settlement/ ?
  [apikey](*apikey)=<ключ>
& [lat](*lat)=<широта>
& [lng](*lng)=<долгота>
& [[distance](*distance)=<радиус охвата>]
& [[lang](*lang)=<язык>]
& [[format](*format)=<формат>]
```

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

```no-highlight
https://api.rasp.yandex-net.ru/v3.0/nearest_settlement/?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`. ||
|#



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

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

{% list tabs %}

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

  ```javascript
  {
    "distance": 4.981302906703597,
    "code": "c22512",
    "title": "Пронск",
    "popular_title": "Пронск",
    "short_title": "Пронск",
    "lat": 54.106677,
    "lng": 39.601726,
    "type": "settlement"
  }
  ```

  #### Описание элементов JSON

  #|
  || **Элемент JSON** | **Тип** | **Описание** ||
  || `distance` | Число | Расстояние до найденного города, в километрах. ||
  || `code` | Строка | Код города в системе кодирования Яндекс Расписаний. ||
  || `title` | Строка | Название города. ||
  || `popular_title` | Строка | Общепринятое название города. ||
  || `short_title` | Строка | Краткое название города. ||
  || `lat` | Число | Широта, на которой находится город. ||
  || `lng` | Число | Долгота, на которой находится город. ||
  || `type` | Строка | Тип транспортного пункта:

  - `station` — станция;

  - `settlement` — поселение. ||
  |#



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

  ```xml
  <response>
      <[distance](*code-distance)>4.9813029067</distance>
      <[code](*code-code)>c22512</code>
      <[title](*code-title)>Пронск</title>
      <[lat](*code-lat)>54.106677</lat>
      <[lng](*code-lng)>39.601726</lng>
      <[type](*code-type)>settlement</type>
      <[popular_title](*code-popular_title)>Пронск</popular_title>
      <[short_title](*code-short_title)>Пронск</short_title>
  </response>
  ```

  #### Описание элементов XML

  #|
  || **Элемент XML** | **Тип** | **Описание** ||
  || `distance` | Число | Расстояние до найденного города, в километрах. ||
  || `code` | Строка | Код города в системе кодирования Яндекс Расписаний. ||
  || `title` | Строка | Название города. ||
  || `popular_title` | Строка | Общепринятое название города. ||
  || `short_title` | Строка | Краткое название города. ||
  || `lat` | Число | Широта, на которой находится город. ||
  || `lng` | Число | Долгота, на которой находится город. ||
  || `type` | Строка | Тип транспортного пункта:

  - `station` — станция;

  - `settlement` — поселение. ||
  |#



{% endlist %}


<!--
      <section display-style="tab">
        <title>Пример ответа в формате JSON</title>
        <defblock code-lang="javascript" deflink="current">{
  &quot;distance&quot;: 4.981302906703597,
  &quot;code&quot;: &quot;c22512&quot;,
  &quot;title&quot;: &quot;Пронск&quot;,
  &quot;popular_title&quot;: &quot;Пронск&quot;,
  &quot;short_title&quot;: &quot;Пронск&quot;,
  &quot;lat&quot;: 54.106677,
  &quot;lng&quot;: 39.601726,
  &quot;type&quot;: &quot;settlement&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>distance</parmdef>
                </entry>
                <entry>Число</entry>
                <entry>
                  <p>Расстояние до найденного города, в километрах.</p>
                </entry>
              </row>
              <row>
                <entry>
                  <parmdef>code</parmdef>
                </entry>
                <entry>Строка</entry>
                <entry>
                  <p>Код города в системе кодирования Яндекс Расписаний.</p>
                </entry>
              </row>
              <row>
                <entry>
                  <parmdef>title</parmdef>
                </entry>
                <entry>Строка</entry>
                <entry>
                  <p>Название города.</p>
                </entry>
              </row>
              <row>
                <entry>
                  <parmdef>popular_title</parmdef>
                </entry>
                <entry>Строка</entry>
                <entry>
                  <p>Общепринятое название города.</p>
                </entry>
              </row>
              <row>
                <entry>
                  <parmdef>short_title</parmdef>
                </entry>
                <entry>Строка</entry>
                <entry>
                  <p>Краткое название города.</p>
                </entry>
              </row>
              <row>
                <entry>
                  <parmdef>lat</parmdef>
                </entry>
                <entry>Число</entry>
                <entry>
                  <p>Широта, на которой находится город.</p>
                </entry>
              </row>
              <row>
                <entry>
                  <parmdef>lng</parmdef>
                </entry>
                <entry>Число</entry>
                <entry>
                  <p>Долгота, на которой находится город.</p>
                </entry>
              </row>
              <row>
                <entry>
                  <parmdef>type</parmdef>
                </entry>
                <entry>Строка</entry>
                <entry>
                  <p>Тип транспортного пункта:</p>
                  <ul conref="schedule-point-point.xml#emails-detailed/segment-type" id="ul_e1q_xdp_hz">
                    <li/>
                  </ul>
                </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;distance&gt;4.9813029067&lt;/distance&gt;
    &lt;code&gt;c22512&lt;/code&gt;
    &lt;title&gt;Пронск&lt;/title&gt;
    &lt;lat&gt;54.106677&lt;/lat&gt;
    &lt;lng&gt;39.601726&lt;/lng&gt;
    &lt;type&gt;settlement&lt;/type&gt;
    &lt;popular_title&gt;Пронск&lt;/popular_title&gt;
    &lt;short_title&gt;Пронск&lt;/short_title&gt;
&lt;/response&gt;</defblock>
        <deftable pgwide="1" id="deftable_azn_12p_hz" 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>distance</elemdef>
                </entry>
                <entry>Число</entry>
                <entry>
                  <p>Расстояние до найденного города, в километрах.</p>
                </entry>
              </row>
              <row>
                <entry>
                  <elemdef>code</elemdef>
                </entry>
                <entry>Строка</entry>
                <entry>
                  <p>Код города в системе кодирования Яндекс Расписаний.</p>
                </entry>
              </row>
              <row>
                <entry>
                  <elemdef>title</elemdef>
                </entry>
                <entry>Строка</entry>
                <entry>
                  <p>Название города.</p>
                </entry>
              </row>
              <row>
                <entry>
                  <elemdef>popular_title</elemdef>
                </entry>
                <entry>Строка</entry>
                <entry>
                  <p>Общепринятое название города.</p>
                </entry>
              </row>
              <row>
                <entry>
                  <elemdef>short_title</elemdef>
                </entry>
                <entry>Строка</entry>
                <entry>
                  <p>Краткое название города.</p>
                </entry>
              </row>
              <row>
                <entry>
                  <elemdef>lat</elemdef>
                </entry>
                <entry>Число</entry>
                <entry>
                  <p>Широта, на которой находится город.</p>
                </entry>
              </row>
              <row>
                <entry>
                  <elemdef>lng</elemdef>
                </entry>
                <entry>Число</entry>
                <entry>
                  <p>Долгота, на которой находится город.</p>
                </entry>
              </row>
              <row>
                <entry>
                  <elemdef>type</elemdef>
                </entry>
                <entry>Строка</entry>
                <entry>
                  <p>Тип транспортного пункта:</p>
                  <ul conref="schedule-point-point.xml#emails-detailed/segment-type" id="ul_bzn_12p_hz">
                    <li/>
                  </ul>
                </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
  ```

[*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`.

[*code-type]:
  **Тип**
 
  Строка
 
  **Описание**
 
  Тип транспортного пункта:
 
  - `station` — станция;
 
  - `settlement` — поселение.

[*code-lat]:
  **Тип**
 
  Число
 
  **Описание**
 
  Широта, на которой находится город.

[*code-lng]:
  **Тип**
 
  Число
 
  **Описание**
 
  Долгота, на которой находится город.

[*code-distance]:
  **Тип**
 
  Число
 
  **Описание**
 
  Расстояние до найденного города, в километрах.

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

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

[*code-popular_title]:
  **Тип**
 
  Строка
 
  **Описание**
 
  Общепринятое название города.

[*code-short_title]:
  **Тип**
 
  Строка
 
  **Описание**
 
  Краткое название города.