Gazetteer

The gazetteer object defines which gazetteer should be used for the current locale.

"gazetteer": {
"provider": "MAPBOX",
"placeholder": "e.g. London",
"datasets": [
{
"layer": "sprawls",
"table": "glx_cities_of_the_world",
"qterm": "name",
"label": "nameascii",
"leading_wildcard": true
}
]
}

The gazetteer can be set to use either third party provider and / or hosted datasets. Locations from hosted datasets will be selected while geolocations from 3rd party providers are shown as a marker on the map.

"provider": "MAPBOX"

The geolocation service to use (MAPBOX or GOOGLE). A corresponding KEY_*** is required in the environment settings in order to use a 3rd party service.

"placeholder": "e.g. London"

The placeholder to be shown in the gazetteer input.

"code": "GB"

The country code to limit the search on 3rd party geolocation services. Permited country codes are ISO 3166-1 alpha-2.

It is possible to further restrict the results by defining a bounds entry. The bounds value varies with the gazetteer provider used for the query.

Google bounds

"bounds": "location=51.75,-1.25&radius=4000"

Google requires the bounds to be defined as a latitutde, longitude coordinate pair and a radius in metres.

Mapbox bounds

"bounds": "bbox=-2,50,4,54"

‚Äč

Dataset gazetteer

An array of dataset gazetteers which are hit by the autocomplete search first. The 3rd party geolocation service is used once no results are returned from any of the dataset gazetteer entries.

"layer": "sprawls"

The layer key in the datasets array object must correspond to a layer defined in the locale's layers.

"table": "glx_cities_of_the_world"

The table to be used for the layer. This is required as layers may aggregate data from multiple table.

"qterm": "name"

The field to be queried for the search term. Will default to label.

"label": "nameascii"

The field which is searched for the autocomplete match. The label is also displayed in the results list.

"leading_wildcard": true

The ILIKE query will pre-fix the search term with a wild card. e.g. 'Man' will find 'Central Manchester' as well as 'Manchester Airport'.