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