Examples

Basic search by name

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

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

The request “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.

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

A request with a spelling mistake “Stanbul”, and the correction of the typo in the response: https://geocode-maps.yandex.ru/1.x/?geocode=Stanbul&lang=en-US.

Search for places in a specified area

If a region to search in is specified in the request, then the first results shown will be those objects that are closest to this region, 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.

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

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