Examples

  1. Basic search by address
  2. Basic search by coordinates
  3. Search result in JSON format
  4. A request with the spelling error
  5. Search for objects in a specified area
  6. Restricting the number of results in the response
  7. Request with the specified type of toponym

Basic search by coordinates

https://geocode-maps.yandex.ru/1.x/?apikey=<Your API key>&geocode=37.611347,55.760241
Request with the coordinates of “Sultanahmet Camii Iç Yolları”:
https://geocode-maps.yandex.ru/1.x/?apikey=<Your API key>&geocode=28.975555,41.008074&lang=en-US

Search result in JSON format

A simple query with JSON output:
https://geocode-maps.yandex.ru/1.x/?apikey=<Your API key>&format=json&geocode=Sultanahmet+Camii+İç+Yolları&lang=en-US

A request with the spelling error

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

Search for objects 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/?apikey=<Your API key>&geocode=Yalova&ll=29.270485,40.65731&spn=2.5,2.5&lang=en-US

Restricting the number of results in the response

Some requests may match multiple objects. In the geocoder request, 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/?apikey=<Your API key>&geocode=Yalova&results=5&lang=en-US
A request for “Yalova” showing 2 results, starting from the 6th:
https://geocode-maps.yandex.ru/1.x/?apikey=<Your API key>&geocode=Yalova&results=2&skip=5&lang=en-US

Request with the specified type of toponym

https://geocode-maps.yandex.ru/1.x/?apikey=<Your API key>&geocode=37.611347,55.760241&kind=metro&results=1
A search for the metro station that is closest to the coordinates:
https://geocode-maps.yandex.ru/1.x/?apikey=<Your API key>&geocode=28.975555,41.008074&lang=en-US&kind=metro&results=1