Примеры
Простой поиск по адресу
Запрос «Тверская 6»:
https://geocode-maps.yandex.ru/1.x/?apikey=YOUR_API_KEY&geocode=Тверская+6&format=json
Простой поиск по координатам
Запрос с координатами дома по адресу «Тверская 6»:
https://geocode-maps.yandex.ru/1.x/?apikey=YOUR_API_KEY&geocode=37.611347,55.760241&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=37.618920,55.756994&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=37.611347,55.760241&kind=metro&results=1&format=json