Examples
Basic search by address
A request for “Mohammed Bin Rashid Boulevard 1”:
https://geocode-maps.yandex.ru/1.x/?apikey=YOUR_API_KEY&geocode=Mohammed+Bin+Rashid+Boulevard+1&lang=en_US&format=json
Basic search by coordinates
Request with the coordinates of the building located at “Mohammed Bin Rashid Boulevard 1”:
https://geocode-maps.yandex.ru/1.x/?apikey=YOUR_API_KEY&geocode=55.270141,25.193445&lang=en_US&format=json
A request with a spelling error
A request with the spelling error “Burj-Halifa”, corrected in the response:
https://geocode-maps.yandex.ru/1.x/?apikey=YOUR_API_KEY&geocode=Burj-Halifa&lang=en_US&format=json
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=Dubai+Marina&ll=25.080549,55.136670&spn=3.552069,2.400552&lang=en_US&format=json
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.
Request for “Dubai Marina” - first 5 results:
https://geocode-maps.yandex.ru/1.x/?apikey=YOUR_API_KEY&geocode=Dubai+Marina&results=5&lang=en_US&format=json
Request for “Dubai Marina” - 5 results, starting from the 11th:
https://geocode-maps.yandex.ru/1.x/?apikey=YOUR_API_KEY&geocode=Dubai+Marina&results=5&skip=10&lang=en_US&format=json
Request with the toponym type specified
A search for the metro station that is closest to the coordinates:
https://geocode-maps.yandex.ru/1.x/?apikey=YOUR_API_KEY&geocode=25.080549,55.136670&kind=metro&results=1&lang=en_US&format=json