Примеры
Простой поиск по адресу
Запрос «бульвар Мухаммед Бин Рашид 1»:
https://geocode-maps.yandex.ru/1.x/?apikey=YOUR_API_KEY&geocode=бульвар+Мухаммед+Бин+Рашид+1&format=json
Простой поиск по координатам
Запрос с координатами дома по адресу «бульвар Мухаммед Бин Рашид 1»:
https://geocode-maps.yandex.ru/1.x/?apikey=YOUR_API_KEY&geocode=25.197300,55.274243&format=json
Запрос с опечаткой
Запрос с орфографической ошибкой «Бурж-Халифа», исправление опечатки в ответе:
https://geocode-maps.yandex.ru/1.x/?apikey=YOUR_API_KEY&geocode=Бурж-Халифа&format=json
Поиск объектов в заданной области
Если в запросе указать область поиска, то первыми будут выведены объекты, наиболее близкие к этой области, например:
https://geocode-maps.yandex.ru/1.x/?apikey=YOUR_API_KEY&geocode=Дубай+Марина&ll=25.080549,55.136670&spn=3.552069,2.400552&format=json
Ограничение числа результатов в ответе
Некоторым запросам может соответствовать несколько объектов. В запросе к геокодеру можно указать желаемое количество объектов в выдаче и номер начального из них.
Запрос «Дубай Марина», первые 5 результатов:
https://geocode-maps.yandex.ru/1.x/?apikey=YOUR_API_KEY&geocode=Дубай+Марина&results=5&format=json
Запрос «Дубай Марина», 5 результатов начиная с 11-го:
https://geocode-maps.yandex.ru/1.x/?apikey=YOUR_API_KEY&geocode=Дубай+Марина&results=5&skip=10&format=json
Запрос с указанным типом топонима
Поиск ближайшей к координатам станции метро:
https://geocode-maps.yandex.ru/1.x/?apikey=YOUR_API_KEY&geocode=25.080549,55.136670&kind=metro&results=1&format=json