Examples

Basic search by name

A request for “Sultanahmet Camii İç Yolları”: https://geocode-maps.yandex.ru/1.x/?geocode=Sultanahmet+Camii+İç+Yolları&lang=en-US.

The same request, but for getting results in JSON: https://geocode-maps.yandex.ru/1.x/?format=json&geocode=Sultanahmet + Camii+Iç+Yolları&lang=en-US.

A request for “Cinci Meydanı Sokak, Küçük Ayasofya, Eminönü,İstanbul,Türkiye”: https://geocode-maps.yandex.ru/1.x/?geocode=Cinci+Meydanı+Sokak,Küçük+Ayasofya,Eminönü,İstanbul,Türkiye&lang=en-US.

A request for “Yalova”: https://geocode-maps.yandex.ru/1.x/?geocode=Yalova&lang=en-US.

A request with the spelling error “Stanbul”, corrected in the response: https://geocode-maps.yandex.ru/1.x/?geocode=Stanbul&lang=en-US.

Search for places in a specified area

If the request specifies the search area, the results will show objects that are closest to this area first. For example: https://geocode-maps.yandex.ru/1.x/?geocode=Yalova&ll=29.270485,40.65731&spn=2.5,2.5&lang=en-US.

Restricting the number of results in the response

Some queries may match multiple objects. In the request for the geocoder, the desired amount of objects to output can be specified, as well as the number of the first one of them.

A request for “Yalova”, first 5 results: https://geocode-maps.yandex.ru/1.x/?geocode=Yalova&results=1&lang=en-US.

A request for “Yalova” showing 2 results, starting from the 6th: https://geocode-maps.yandex.ru/1.x/?geocode=Yalova&results=2&skip=5&lang=en-US.