This article provides an overview of the latest (January 2023) developments and updates in the MapTiler Geocoding API. Make sure, you check the Geocoding API article first.
What is new in MapTiler Geocoding
The latest version of Maptiler Geocoding now includes several new parameters, giving developers greater control and power in their geocoding searches. These parameters include.
types
- filter results to include only a subset (one or more) of the available feature types. See the type hierarchy below for allowed values. Multiple options can be comma-separated.autocomplete
- Specify whether to return autocomplete results (true
) or not (false
). When autocomplete is enabled, results will be included that start with the requested string, rather than just responses that match it exactly. For example, a queryIndia
might return bothIndia
andIndiana
with autocomplete enabled, but onlyIndia
if it’s disabled. The default is to combine exact results autocomplete.
When autocomplete is enabled, each user keystroke counts as one request to the Geocoding API. For example, a search for "coff" would be reflected as four separate Geocoding API requests. To reduce the total requests sent, you can configure your application to only call the Geocoding API after a specific number of characters are typed.fuzzyMatch
- specify whether the Geocoding API should attempt approximate, as well as exact matching when performing searches (true
, default), or whether it should opt out of this behavior and only attempt exact matching (false
). For example, the default setting might returnWashington, DC
for a query ofwahsington
, even though the query was misspelled.country
- limits searches to a specific country. One or more countries specified as comma-separated values ISO 3166 alpha 2 country codes.limit
- controls the maximum number of results to return. The default is5
and the max support is10
.
Practical usage:
country
: You may want to search for places exclusively in Norway. This way you can effectively exclude Oslo - the capital of Norway, from other Oslo - located in Minnesota, USA.autocomplete
andfuzzyMatch
: Setting parametersautocomplete
andfuzzyMatch
tofalse
will ensure that the result will contain only results exactly matching your query without trying to treat your input as possible with a typo or as a start of a complete place name. For example, if your search query is "koln" and the language is set to German, then the result will include Köln but won't include places like Kolin (in Czechia) or Kola (in Russia).types
:
Because every country in the world has a different way of hierarchical division, it is not possible to design a universal one that fits every country. Maptiler Geocoding tries to approach this by defining an approximate global hierarchy where it maps every country by best effort. Not every country has administrative areas present at every level.
We have defined following hierarchy:
country
- the countryregion
- the first level of division within the countrysubregion
- the second level of division within the countrycounty
- the third level of division within the countryjoint_municipality
- a group of municipalitiesjoint_submunicipality
- a group of sub municipalitiesmunicipality
- a municipalitymunicipal_district
- a district within a municipalitylocality
- a localityneighbourhood
- a neighborhoodplace
- a place, such as a municipality, hamlet, isolated dwelling, square, etc. Also serves as a fallback for places that cannot be categorized into higher levels of hierarchy.postal_code
- postal codeaddress
- street and address
In the near future, Maptiler Geocoding plans to include country-specific localized hierarchy names in the geocoding response.
Comments
0 comments
Please sign in to leave a comment.