Basic geocoding parameters

The Search & Geocoding API provides parameters that give you greater control over the geocoding configuration. Here’s some practical advice on how the parameters work and how to use them.

country

Limits searches to a specific country or countries. Specify one or more countries as comma-separated ISO 3166 alpha 2 country codes.

Example: When searching for places exclusively in Norway, you can effectively distinguish between Oslo, the capital of Norway, and Oslo in Minnesota, USA.

types

Filter results to include only a subset of available feature types. Multiple options can be comma-separated. See the PlaceType Values for accepted values.

Note that every country has a different hierarchical division system, making a universal approach challenging. MapTiler Geocoding defines an approximate global hierarchy that maps each country by best effort. Not every country has administrative areas present at every level.

autocomplete

Specifies whether to return autocomplete results (true) or not (false). When enabled, results include entries that start with the requested string, rather than only exact matches. For example, querying “India” might return both “India” and “Indiana” when autocomplete is enabled, but only “India” when disabled. The default behavior combines exact results with autocomplete.

When autocomplete is enabled, each user keystroke counts as one request to the Geocoding API. For example, searching for “coff” generates four separate API requests. To reduce total requests, configure your application to call the API only after a specific number of characters are typed.

fuzzyMatch

Determines whether the API should attempt approximate matching in addition to exact matching (true, default), or only exact matching (false). For example, with the default setting enabled, searching for “wahsington” might return “Washington, DC” despite the misspelling.

Setting both autocomplete and fuzzyMatch to false ensures results contain only exact matches without typo correction or partial name completion. For instance, if searching for “koln” with the language set to German, results will include “Köln” but exclude similar places like “Kolin” (in Czechia) or “Kola” (in Russia).

limit

Controls the maximum number of results to return. The default is 5 and the maximum supported value is 10.