Примеры

  1. Простой поиск по адресу
  2. Простой поиск по координатам
  3. Результат поиска в формате JSON
  4. Запрос с опечаткой
  5. Поиск объектов в заданной области
  6. Ограничение числа результатов в ответе
  7. Запрос с указанным типом топонима

Простой поиск по координатам

Запрос с координатами дома по адреса «Тверская 6»:

https://geocode-maps.yandex.ru/1.x/?apikey=<Ваш API-ключ>&geocode=37.611347,55.760241

Результат поиска в формате JSON

Простой запрос с выдачей результатов в формате JSON:
https://geocode-maps.yandex.ru/1.x/?apikey=<Ваш API-ключ>&format=json&geocode=Тверская+6

Запрос с опечаткой

Запрос с орфографической ошибкой «Масква», исправление опечатки в ответе:
https://geocode-maps.yandex.ru/1.x/?apikey=<Ваш API-ключ>&geocode=Масква

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

Если в запросе указать область поиска, то первыми будут выведены объекты, наиболее близкие к этой области, например:
https://geocode-maps.yandex.ru/1.x/?apikey=<Ваш API-ключ>&geocode=Ивановка&ll=37.618920,55.756994&spn=3.552069,2.400552

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

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

Запрос «Ивановка», первые 5 результатов:
http://geocode-maps.yandex.ru/1.x/?apikey=<Ваш API-ключ>&geocode=Ивановка&results=5
Запрос «Ивановка», 5 результатов, начиная с 43-го:
http://geocode-maps.yandex.ru/1.x/?apikey=<Ваш API-ключ>&geocode=Ивановка&results=5&skip=42

Запрос с указанным типом топонима

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

https://geocode-maps.yandex.ru/1.x/?apikey=<Ваш API-ключ>&geocode=37.611347,55.760241&kind=metro&results=1