How to search for a place within a country
The SearchText API enables you limit search results to within one or more
countries. This feature useful for searching in border areas or smaller countries that
neighbour each other.
One way to use the SearchText API is to let end users do a free-text search and an application set's bias position. These bias positions can be a device position, IP position, or a map‘s view port center. Additionally, end users can provide the city name or place and the application can bias results based on geo-coordinates.
Potential use cases
-
Limit the search results to within a country for an area that has a nearby international border.
-
Filter results to withing multiple countries.
Examples
In this example, the bias position is near the USA and Canada border.
Without specifying IncludeCountries": ["CAN"], the API would
return results from both Canada and the USA.