Примеры

Простой поиск по названию

Запрос «Царь-колокол»: http://psearch-maps.yandex.ru/1.x/?text=Царь-колокол&key=API-ключ.

Этот же запрос, но для выдачи результатов в формате JSON: http://psearch-maps.yandex.ru/1.x/?format=json&text=Царь-колокол&key=API-ключ.

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

Если в запросе указать область поиска (параметр spn), то первыми будут выведены объекты, наиболее близкие к этой области. Например, чтобы найти улицу Ленина, находящуюся в г. Таганрог, можно выполнить следующий запрос: http://psearch-maps.yandex.ru/1.x/?text=улица Ленина&ll=38.919626,47.211477&spn=1.0,1.0&key=API-ключ.

Первый результат выдачи соответствует улице Ленина г. Таганрог, остальные отсортированы по расстоянию от центра области поиска и степени соответствия тексту запроса.

Если необходимо найти только те объекты, которые находятся в заданной области, следует использовать параметр rspn: http://psearch-maps.yandex.ru/1.x/?text=Красная площадь&ll=38.919626,47.211477&spn=0.1,0.1&rspn=1&key=API-ключ.

Выбор результатов поиска

Некоторым запросам может соответствовать большое количество найденных объектов. HTTP-запрос позволяет сформировать выборку результатов поиска. Для этого предназначены следующие параметры:

• results — максимальное количество выводимых результатов;
• skip — количество результатов (начиная с первого), которое необходимо пропустить.

Запрос «техникум», первые 5 результатов: http://psearch-maps.yandex.ru/1.x/?text=техникум&results=5&key=API-ключ.

Запрос «институт», 7 результатов, начиная с 23-го: http://psearch-maps.yandex.ru/1.x/?text=институт&results=7&skip=23&key=API-ключ.