Примеры

Поиск географических объектов

Поиск объекта по названию:

https://search-maps.yandex.ru/v1/?text=деревня Толстик&type=geo&lang=ru_RU&apikey=<API-ключ>

Поиск объекта по номеру дома:

https://search-maps.yandex.ru/v1/?text=Свободный, ул. Амурская, дом 18&type=geo&lang=ru_RU&apikey=<API-ключ>

Запрос с орфографической ошибкой «Масква». Ответ будет содержать исправленный вариант.

https://search-maps.yandex.ru/v1/?text=Масква&type=geo&lang=ru_RU&apikey=<API-ключ>

Поиск организаций

Поиск организации по названию:

https://search-maps.yandex.ru/v1/?text=Барашки&type=biz&lang=ru_RU&apikey=<API-ключ>

Поиск организации по номеру телефона:

https://search-maps.yandex.ru/v1/?text=+7(495)739-70-00&type=biz&lang=ru_RU&apikey=<API-ключ>

Поиск организаций по названию услуг:

https://search-maps.yandex.ru/v1/?text=стрижка,укладка&type=biz&lang=ru_RU&apikey=<API-ключ>

Поиск организации с указанием адреса:

https://search-maps.yandex.ru/v1/?text=Автосервис,Москва,ул. Смоленская&type=biz&lang=ru_RU&apikey=<API-ключ>

Поиск организаций по нескольким параметрам:

https://search-maps.yandex.ru/v1/?text=аптека,круглосуточно,оплата картой&type=biz&lang=ru_RU&apikey=<API-ключ>

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

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

https://search-maps.yandex.ru/v1/?text=деревня Пожарище&ll=40.17248,60.594641&spn=3.552069,2.400552&lang=ru_RU&apikey=<API-ключ>

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

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

Выдавать первые 5 результатов:

https://search-maps.yandex.ru/v1/?text=ул.Грибоедова&results=5&lang=ru_RU&apikey=<API-ключ>

Выдавать один результат начиная с третьего:

https://search-maps.yandex.ru/v1/?text=Красная площадь&results=1&skip=2&lang=ru_RU&apikey=<API-ключ>

Получение ответа в формате JSONP

Политика безопасности современных браузеров не позволяет веб-страницам загружать данные со сторонних серверов. Под сторонним подразумевается сервер, доменное имя которого отличается от доменного имени сервера, на котором находится страница. Если необходимо сформировать страницу, запрашивающую результаты геокодирования, следует воспользоваться технологией JSONP.

При использовании JSONP серверу, возвращающему данные, передается имя функции. Результат возвращается в виде объекта JSON, но в качестве параметра функции с указанным именем.

Чтобы получить результаты поиска в виде JSONP, необходимо присвоить параметру callback имя функции, которая будет обрабатывать возвращенные в формате JSON результаты. Например:

https://search-maps.yandex.ru/v1/?text=Москва, ул. Крылатские холмы&lang=ru_RU&apikey=<API-ключ>&callback=my_callback

Сервер вернет JSON-объект, обернутый в указанную функцию:

my_callback({
    "status":"success",
    "data": {
        "type":"FeatureCollection",
        "properties": {
            "ResponseMetaData": {
                "SearchRequest": {
                    "request":"Москва, ул. Крылатские холмы",
                    ...
                 }
             }
         }
    }
})