---
description: Примеры кода для запросов прямого или обратного геокодирования и для других указанных поисковых запросов с использованием Geocoder API.
---
> **Documentation Index:** Fetch the complete configuration index at https://dev-geocode.docs-viewer.yandex.ru/ru/llms.txt


# Примеры

## Простой поиск по адресу {#search}

Запрос «бульвар Мухаммед Бин Рашид 1»:

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

## Простой поиск по координатам {#coordinates}

Запрос с координатами дома по адресу «бульвар Мухаммед Бин Рашид 1»:

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

## Запрос с опечаткой {#error}

Запрос с орфографической ошибкой «Бурж-Халифа», исправление опечатки в ответе:

```http
https://geocode-maps.yandex.ru/v1/?apikey=YOUR_API_KEY&geocode=Бурж-Халифа&format=json
```

## Поиск объектов в заданной области {#area}

Если в запросе указать область поиска, то первыми будут выведены объекты, наиболее близкие к этой области, например:

```http
https://geocode-maps.yandex.ru/v1/?apikey=YOUR_API_KEY&geocode=Дубай+Марина&ll=25.080549,55.136670&spn=3.552069,2.400552&format=json
```

## Ограничение числа результатов в ответе {#limit}

Некоторым запросам может соответствовать несколько объектов. В запросе к геокодеру можно указать желаемое количество объектов в выдаче и номер начального из них.

Запрос «Дубай Марина», первые 5 результатов:

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

Запрос «Дубай Марина», 5 результатов начиная с 11-го:

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

## Запрос с указанным типом топонима {#type}

Поиск ближайшей к координатам станции метро:

```http
https://geocode-maps.yandex.ru/v1/?apikey=YOUR_API_KEY&geocode=25.080549,55.136670&kind=metro&results=1&format=json
```