# API Геокодера Яндекс Карт: GET /v1 — Геокодирование

Пример обратного геокодирования:

Постраничная выдача (объекты с 11-го по 15-й):

Структура ответа (сокращена):

| Параметр | Где | Тип | Обяз. | Описание |
|---|---|---|---|---|
| `apikey` | query | string | да | Ключ из Кабинета разработчика |
| `geocode` | query | string | да | Адрес (прямое геокодирование) или координаты (обратное) |
| `lang` | query | string | да | Язык ответа language_region: ru_RU, uk_UA, be_BY, en_RU, en_US, tr_TR |
| `sco` | query | string | нет | Порядок координат в geocode: longlat (по умолчанию) или latlong |
| `kind` | query | string | нет | Вид топонима при обратном геокодировании: house, street, metro, district, locality |
| `rspn` | query | boolean | нет | Ограничить поиск областью ll/spn или bbox: 0 — нет (по умолчанию), 1 — да |
| `ll` | query | string | нет | Долгота и широта центра области поиска |
| `spn` | query | string | нет | Протяжённость области поиска по долготе и широте |
| `bbox` | query | string | нет | Область поиска углами x1,y1~x2,y2; приоритетнее ll+spn |
| `format` | query | string | нет | Формат ответа: json |
| `results` | query | integer | нет | Максимум объектов, по умолчанию 10, не больше 50 |
| `skip` | query | integer | нет | Сколько объектов пропустить; должно делиться на results |
| `uri` | query | string | нет | ID объекта для получения доп. информации, вместо текста и координат |
| `signature` | query | string | нет | Подпись запроса |

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

```
https://geocode-maps.yandex.ru/v1/?apikey=YOUR_API_KEY&geocode=55.270141,25.193445&format=json
```

Пример ответа:

```json
https://geocode-maps.yandex.ru/v1/?apikey=YOUR_API_KEY&geocode=Дубай+Марина&results=5&skip=10&format=json
```

## Базовые URL

- Боевой: `https://geocode-maps.yandex.ru`

## Авторизация

Тип: API-ключ

Ключ из Кабинета разработчика передаётся в параметре `apikey`; активируется в течение 15 минут после получения. Для защиты ключа от кражи можно подписывать запросы параметром `signature`.

```
https://geocode-maps.yandex.ru/v1/?apikey=YOUR_API_KEY&geocode=бульвар+Мухаммед+Бин+Рашид+1&format=json
```

## Нюансы

- Координаты в ответе (`Point.pos`, `boundedBy.Envelope`) — в порядке «долгота широта», через пробел.
- `GeocoderMetaData.precision` показывает точность совпадения номера дома: `exact`, `number`, `near`, `range`, `street`, `other`.
- `Address.Components[]` — компоненты адреса парами `kind`/`name` от крупного к мелкому; поле `AddressDetails` устарело.
- `GeocoderResponseMetaData.fix` и `suggest` — исправление опечаток в запросе.
- Ограничение области (`rspn`, `ll`, `spn`, `bbox`) игнорируется, если в `geocode` переданы координаты.
- HTTP-метод в документации отдельно не указан — запрос задаётся URL с параметрами.

## Сценарии с этим методом

- [Получить координаты по адресу](https://mcp-everything.ru/integrations/yandex-geocoder/scenarios/poluchit-koordinaty-po-adresu.md)
- [Определить адрес по координатам](https://mcp-everything.ru/integrations/yandex-geocoder/scenarios/opredelit-adres-po-koordinatam.md)
- [Искать адрес только в своём городе](https://mcp-everything.ru/integrations/yandex-geocoder/scenarios/iskat-adres-tolko-v-svoem-gorode.md)

---

Если этого недостаточно — официальная документация: https://yandex.ru/maps-api/docs/geocoder-api/index.html
Вся интеграция одним документом: https://mcp-everything.ru/integrations/yandex-geocoder.md