The problemtoo many places in the world share the same name. As a result you get back too many results, and it's hard too know which result is the one you want.
The solutionYou can to restrict results to only certain countries or a specific region. You can do this by using the
countrycodeparameter too limit results to acountry (or set of countries) or the
boundsparameter to restrict the results to a specific bounding box.
ExampleLet's imagine you send us a forward geocoding request for "London". We can't know if you mean "London, England" or "London, Ontario, Canada", or one of the many other places in the world named London, so we return all of them. But if you know you only want the place in Canada Instead of
Explanation and relevant documentationThe
countrycodeparameter restricts results to a specific country or set of countries, you can set a comma separated list of countrycodes The
boundsparameter limits results to a specific bounding box. We have built a small, map-based tool to easily visualize bounds values. In the OpenCage API Reference you can find all the details of the optional countrycode parameter and bounds parameter.