--- title: "MaptilerGeocoderElement | Geocoding | JavaScript maps SDK" description: "Documentation for Search and Geocoding control" --- > For AI agents: a documentation index is available at [/llms.txt](https://docs.maptiler.com/llms.txt). Markdown versions of all pages are available by appending .md to any URL. # Class MaptilerGeocoderElement #### Hierarchy - LitElement - MaptilerGeocoderElement #### Implements - [MaptilerGeocoderOptions](https://docs.maptiler.com/sdk-js/modules/geocoding/api/api-reference/types/MaptilerGeocoderOptions/) - Defined in [src/geocoder/geocoder.ts:23](https://github.com/maptiler/maptiler-geocoding-control/blob/7abb332debfe243d5d21e0823dd92a94259b6d8e/src/geocoder/geocoder.ts#L23) ##### Index ### Other[](#other) [constructor](#constructor) [adjustUrl?](#adjusturl) [apiKey?](#apikey) [apiUrl?](#apiurl) [bbox?](#bbox) [clearButtonTitle?](#clearbuttontitle) [clearListOnPick](#clearlistonpick) [clearOnBlur](#clearonblur) [collapsed](#collapsed) [country?](#country) [debounceSearch?](#debouncesearch) [enableReverse?](#enablereverse) [errorMessage?](#errormessage) [excludeTypes](#excludetypes) [exhaustiveReverseGeocoding](#exhaustivereversegeocoding) [fetchFullGeometryOnPick](#fetchfullgeometryonpick) [fetchParameters?](#fetchparameters) [filter?](#filter) [fuzzyMatch?](#fuzzymatch) [iconsBaseUrl?](#iconsbaseurl) [keepListOpen](#keeplistopen) [language?](#language) [limit?](#limit) [minLength?](#minlength) [noResultsMessage?](#noresultsmessage) [openListOnTop](#openlistontop) [placeholder?](#placeholder) [proximity?](#proximity) [reverseActive](#reverseactive) [reverseButtonTitle?](#reversebuttontitle) [reverseGeocodingExcludeTypes?](#reversegeocodingexcludetypes) [reverseGeocodingLimit?](#reversegeocodinglimit) [reverseGeocodingTypes?](#reversegeocodingtypes) [selectFirst?](#selectfirst) [showPlaceType?](#showplacetype) [showResultsWhileTyping?](#showresultswhiletyping) [types?](#types) [worldview?](#worldview) [addEventListener](#addeventlistener) [blur](#blur) [clearList](#clearlist) [focus](#focus) [removeEventListener](#removeeventlistener) [setOptions](#setoptions) [setQuery](#setquery) [submitQuery](#submitquery) ### rendering[](#rendering) [render](#render) ### updates[](#updates) [willUpdate](#willupdate) ## Other[](#other-1) ### constructor[](#constructor) - new MaptilerGeocoderElement(): MaptilerGeocoderElement[](#constructormaptilergeocoderelement) #### Returns MaptilerGeocoderElement Inherited from LitElement.constructor - Defined in node\_modules/@lit/reactive-element/reactive-element.d.ts:527 ### `Optional`adjustUrl[](#adjusturl) adjustUrl?: (url: URL) \=> void Callback function to adjust the geocoding URL before fetching. #### Type Declaration - - (url: URL): void - #### Parameters - url: URL [URL](https://developer.mozilla.org/en-US/docs/Web/API/URL) parameter that can be modified. Default: Empty function. #### Returns void Implementation of MaptilerGeocoderOptions.adjustUrl - Defined in [src/geocoder/geocoder.ts:29](https://github.com/maptiler/maptiler-geocoding-control/blob/7abb332debfe243d5d21e0823dd92a94259b6d8e/src/geocoder/geocoder.ts#L29) ### `Optional`apiKey[](#apikey) apiKey?: string MapTiler API key. Implementation of MaptilerGeocoderOptions.apiKey - Defined in [src/geocoder/geocoder.ts:30](https://github.com/maptiler/maptiler-geocoding-control/blob/7abb332debfe243d5d21e0823dd92a94259b6d8e/src/geocoder/geocoder.ts#L30) ### `Optional`apiUrl[](#apiurl) apiUrl?: string Geocoding API URL. Default: MapTiler Geocoding API URL. Implementation of MaptilerGeocoderOptions.apiUrl - Defined in [src/geocoder/geocoder.ts:31](https://github.com/maptiler/maptiler-geocoding-control/blob/7abb332debfe243d5d21e0823dd92a94259b6d8e/src/geocoder/geocoder.ts#L31) ### `Optional`bbox[](#bbox) bbox?: [BBox](https://docs.maptiler.com/sdk-js/modules/geocoding/api/api-reference/types/BBox/) Bounding box in the format `[minX, minY, maxX, maxY]` to limit search results. Default: `undefined`. Implementation of MaptilerGeocoderOptions.bbox - Defined in [src/geocoder/geocoder.ts:32](https://github.com/maptiler/maptiler-geocoding-control/blob/7abb332debfe243d5d21e0823dd92a94259b6d8e/src/geocoder/geocoder.ts#L32) ### `Optional`clearButtonTitle[](#clearbuttontitle) clearButtonTitle?: string Title of the clear button. Default: `"clear"`. Implementation of MaptilerGeocoderOptions.clearButtonTitle - Defined in [src/geocoder/geocoder.ts:33](https://github.com/maptiler/maptiler-geocoding-control/blob/7abb332debfe243d5d21e0823dd92a94259b6d8e/src/geocoder/geocoder.ts#L33) ### clearListOnPick[](#clearlistonpick) clearListOnPick: boolean = false Clears the result list after picking an item. Prevents redisplaying the list when the input box is focused. Default: `false`. Implementation of MaptilerGeocoderOptions.clearListOnPick - Defined in [src/geocoder/geocoder.ts:34](https://github.com/maptiler/maptiler-geocoding-control/blob/7abb332debfe243d5d21e0823dd92a94259b6d8e/src/geocoder/geocoder.ts#L34) ### clearOnBlur[](#clearonblur) clearOnBlur: boolean = false Clears the input value when it loses focus. Default: `false`. Implementation of MaptilerGeocoderOptions.clearOnBlur - Defined in [src/geocoder/geocoder.ts:35](https://github.com/maptiler/maptiler-geocoding-control/blob/7abb332debfe243d5d21e0823dd92a94259b6d8e/src/geocoder/geocoder.ts#L35) ### collapsed[](#collapsed) collapsed: boolean = false Collapses the geocoder control until hovered or focused. Default: `false`. Implementation of MaptilerGeocoderOptions.collapsed - Defined in [src/geocoder/geocoder.ts:36](https://github.com/maptiler/maptiler-geocoding-control/blob/7abb332debfe243d5d21e0823dd92a94259b6d8e/src/geocoder/geocoder.ts#L36) ### `Optional`country[](#country) country?: string | string\[\] Limits search to the specified country or countries. Default: `undefined` (all countries). Implementation of MaptilerGeocoderOptions.country - Defined in [src/geocoder/geocoder.ts:37](https://github.com/maptiler/maptiler-geocoding-control/blob/7abb332debfe243d5d21e0823dd92a94259b6d8e/src/geocoder/geocoder.ts#L37) ### `Optional`debounceSearch[](#debouncesearch) debounceSearch?: number Time delay (in milliseconds) before querying the server after typing in the input box. Useful for reducing the number of API calls. Default: `200`. Implementation of MaptilerGeocoderOptions.debounceSearch - Defined in [src/geocoder/geocoder.ts:38](https://github.com/maptiler/maptiler-geocoding-control/blob/7abb332debfe243d5d21e0823dd92a94259b6d8e/src/geocoder/geocoder.ts#L38) ### `Optional`enableReverse[](#enablereverse) enableReverse?: [EnableReverse](https://docs.maptiler.com/sdk-js/modules/geocoding/api/api-reference/types/EnableReverse/) Enables reverse geocoding: - `"button"`: Enables reverse geocoding button. - `"always"`: Reverse geocoding is always active. Default: `"never"`. Implementation of MaptilerGeocoderOptions.enableReverse - Defined in [src/geocoder/geocoder.ts:39](https://github.com/maptiler/maptiler-geocoding-control/blob/7abb332debfe243d5d21e0823dd92a94259b6d8e/src/geocoder/geocoder.ts#L39) ### `Optional`errorMessage[](#errormessage) errorMessage?: string Custom error message. Default: `"Something went wrong…"`. Implementation of MaptilerGeocoderOptions.errorMessage - Defined in [src/geocoder/geocoder.ts:40](https://github.com/maptiler/maptiler-geocoding-control/blob/7abb332debfe243d5d21e0823dd92a94259b6d8e/src/geocoder/geocoder.ts#L40) ### excludeTypes[](#excludetypes) excludeTypes: boolean = false Includes all available types except those listed in the `types` option. See `reverseGeocodingExcludeTypes` for reverse geocoding exclusion. Default: `false`. Implementation of MaptilerGeocoderOptions.excludeTypes - Defined in [src/geocoder/geocoder.ts:41](https://github.com/maptiler/maptiler-geocoding-control/blob/7abb332debfe243d5d21e0823dd92a94259b6d8e/src/geocoder/geocoder.ts#L41) ### exhaustiveReverseGeocoding[](#exhaustivereversegeocoding) exhaustiveReverseGeocoding: boolean = false Uses the `limit` option value for reverse geocoding even if the `types` option has multiple elements. Works only if enabled on the server. Default: `false`. Implementation of MaptilerGeocoderOptions.exhaustiveReverseGeocoding - Defined in [src/geocoder/geocoder.ts:42](https://github.com/maptiler/maptiler-geocoding-control/blob/7abb332debfe243d5d21e0823dd92a94259b6d8e/src/geocoder/geocoder.ts#L42) ### fetchFullGeometryOnPick[](#fetchfullgeometryonpick) fetchFullGeometryOnPick: boolean = false Enables fetching the full geometry (polygon etc.) instead of just a point on a picked feature. Default: `false`. Implementation of MaptilerGeocoderOptions.fetchFullGeometryOnPick - Defined in [src/geocoder/geocoder.ts:43](https://github.com/maptiler/maptiler-geocoding-control/blob/7abb332debfe243d5d21e0823dd92a94259b6d8e/src/geocoder/geocoder.ts#L43) ### `Optional`fetchParameters[](#fetchparameters) fetchParameters?: RequestInit Additional parameters for fetch requests. Default: `undefined`. Implementation of MaptilerGeocoderOptions.fetchParameters - Defined in [src/geocoder/geocoder.ts:44](https://github.com/maptiler/maptiler-geocoding-control/blob/7abb332debfe243d5d21e0823dd92a94259b6d8e/src/geocoder/geocoder.ts#L44) ### `Optional`filter[](#filter) filter?: (feature: [Feature](https://docs.maptiler.com/sdk-js/modules/geocoding/api/api-reference/types/Feature/)) \=> boolean Callback function to filter results from the Geocoding API response. The function should return `true` to keep an item, or `false` to exclude it. Default: A function that always returns `true`. Implementation of MaptilerGeocoderOptions.filter - Defined in [src/geocoder/geocoder.ts:45](https://github.com/maptiler/maptiler-geocoding-control/blob/7abb332debfe243d5d21e0823dd92a94259b6d8e/src/geocoder/geocoder.ts#L45) ### `Optional`fuzzyMatch[](#fuzzymatch) fuzzyMatch?: boolean Enables fuzzy search. Default: `true`. Implementation of MaptilerGeocoderOptions.fuzzyMatch - Defined in [src/geocoder/geocoder.ts:46](https://github.com/maptiler/maptiler-geocoding-control/blob/7abb332debfe243d5d21e0823dd92a94259b6d8e/src/geocoder/geocoder.ts#L46) ### `Optional`iconsBaseUrl[](#iconsbaseurl) iconsBaseUrl?: string Base URL for POI icons. Default: `"https://cdn.maptiler.com/maptiler-geocoding-control/v${version}/icons/"` Implementation of MaptilerGeocoderOptions.iconsBaseUrl - Defined in [src/geocoder/geocoder.ts:47](https://github.com/maptiler/maptiler-geocoding-control/blob/7abb332debfe243d5d21e0823dd92a94259b6d8e/src/geocoder/geocoder.ts#L47) ### keepListOpen[](#keeplistopen) keepListOpen: boolean = false Keeps the result list open even if the control is unfocused. Default: `false`. Implementation of MaptilerGeocoderOptions.keepListOpen - Defined in [src/geocoder/geocoder.ts:48](https://github.com/maptiler/maptiler-geocoding-control/blob/7abb332debfe243d5d21e0823dd92a94259b6d8e/src/geocoder/geocoder.ts#L48) ### `Optional`language[](#language) language?: string | string\[\] | null Language for response text and query weighting. Accepts IETF language tags. Set to `null` or an empty string to disable language-specific searching. Default: `undefined` (uses the browser's language settings). Implementation of MaptilerGeocoderOptions.language - Defined in [src/geocoder/geocoder.ts:49](https://github.com/maptiler/maptiler-geocoding-control/blob/7abb332debfe243d5d21e0823dd92a94259b6d8e/src/geocoder/geocoder.ts#L49) ### `Optional`limit[](#limit) limit?: number Maximum number of results to display. See `reverseGeocodingLimit` for reverse geocoding limits. Default: `5`. Implementation of MaptilerGeocoderOptions.limit - Defined in [src/geocoder/geocoder.ts:50](https://github.com/maptiler/maptiler-geocoding-control/blob/7abb332debfe243d5d21e0823dd92a94259b6d8e/src/geocoder/geocoder.ts#L50) ### `Optional`minLength[](#minlength) minLength?: number Minimum number of characters required to start a search. Default: `2`. Implementation of MaptilerGeocoderOptions.minLength - Defined in [src/geocoder/geocoder.ts:51](https://github.com/maptiler/maptiler-geocoding-control/blob/7abb332debfe243d5d21e0823dd92a94259b6d8e/src/geocoder/geocoder.ts#L51) ### `Optional`noResultsMessage[](#noresultsmessage) noResultsMessage?: string Custom message for when no results are found. Default: ```typescript "Oops! Looks like you're trying to predict something that's not quite right. We can't seem to find what you're looking for. Maybe try double-checking your spelling or try a different search term. Keep on typing - we'll do our best to get you where you need to go!" ``` Implementation of MaptilerGeocoderOptions.noResultsMessage - Defined in [src/geocoder/geocoder.ts:52](https://github.com/maptiler/maptiler-geocoding-control/blob/7abb332debfe243d5d21e0823dd92a94259b6d8e/src/geocoder/geocoder.ts#L52) ### openListOnTop[](#openlistontop) openListOnTop: boolean = false Opens the result list above the query input instead of below. Used when mounted at the bottom of a map. Default: `false`. Implementation of MaptilerGeocoderOptions.openListOnTop - Defined in [src/geocoder/geocoder.ts:53](https://github.com/maptiler/maptiler-geocoding-control/blob/7abb332debfe243d5d21e0823dd92a94259b6d8e/src/geocoder/geocoder.ts#L53) ### `Optional`placeholder[](#placeholder) placeholder?: string Custom placeholder for the input box. Default: `"Search"`. Implementation of MaptilerGeocoderOptions.placeholder - Defined in [src/geocoder/geocoder.ts:54](https://github.com/maptiler/maptiler-geocoding-control/blob/7abb332debfe243d5d21e0823dd92a94259b6d8e/src/geocoder/geocoder.ts#L54) ### `Optional`proximity[](#proximity) proximity?: [ProximityRule](https://docs.maptiler.com/sdk-js/modules/geocoding/api/api-reference/types/ProximityRule/)\[\] | null Prioritizes search results closer to a proximity point. The first matching rule in the array is used. Set to `null` to disable proximity. Default: `[ { type: "server-geolocation" } ]`. Implementation of MaptilerGeocoderOptions.proximity - Defined in [src/geocoder/geocoder.ts:55](https://github.com/maptiler/maptiler-geocoding-control/blob/7abb332debfe243d5d21e0823dd92a94259b6d8e/src/geocoder/geocoder.ts#L55) ### reverseActive[](#reverseactive) reverseActive: boolean = false Activates reverse geocoding. Default: `false`. Implementation of MaptilerGeocoderOptions.reverseActive - Defined in [src/geocoder/geocoder.ts:56](https://github.com/maptiler/maptiler-geocoding-control/blob/7abb332debfe243d5d21e0823dd92a94259b6d8e/src/geocoder/geocoder.ts#L56) ### `Optional`reverseButtonTitle[](#reversebuttontitle) reverseButtonTitle?: string Title of the reverse geocoding toggle button. Default: `"toggle reverse geocoding"`. Implementation of MaptilerGeocoderOptions.reverseButtonTitle - Defined in [src/geocoder/geocoder.ts:57](https://github.com/maptiler/maptiler-geocoding-control/blob/7abb332debfe243d5d21e0823dd92a94259b6d8e/src/geocoder/geocoder.ts#L57) ### `Optional`reverseGeocodingExcludeTypes[](#reversegeocodingexcludetypes) reverseGeocodingExcludeTypes?: boolean Excludes types for reverse geocoding. Default: Same as `excludeTypes`. Implementation of MaptilerGeocoderOptions.reverseGeocodingExcludeTypes - Defined in [src/geocoder/geocoder.ts:58](https://github.com/maptiler/maptiler-geocoding-control/blob/7abb332debfe243d5d21e0823dd92a94259b6d8e/src/geocoder/geocoder.ts#L58) ### `Optional`reverseGeocodingLimit[](#reversegeocodinglimit) reverseGeocodingLimit?: number Limits results for reverse geocoding. Applied only if value is 1 or effective types contain a single value. See also `reverseGeocodingTypes` option. Default: The value of the `limit` option if set. If effective types contain a single value, the default is `1`. In all other cases, this option is not used. Implementation of MaptilerGeocoderOptions.reverseGeocodingLimit - Defined in [src/geocoder/geocoder.ts:59](https://github.com/maptiler/maptiler-geocoding-control/blob/7abb332debfe243d5d21e0823dd92a94259b6d8e/src/geocoder/geocoder.ts#L59) ### `Optional`reverseGeocodingTypes[](#reversegeocodingtypes) reverseGeocodingTypes?: [TypeRule](https://docs.maptiler.com/sdk-js/modules/geocoding/api/api-reference/types/TypeRule/)\[\] Specifies types for reverse geocoding. If effective types are multiple values, the `limit`/`reverseGeocodingLimit` option is ignored. See also `reverseGeocodingLimit` option. Default: Same as `types`. Implementation of MaptilerGeocoderOptions.reverseGeocodingTypes - Defined in [src/geocoder/geocoder.ts:60](https://github.com/maptiler/maptiler-geocoding-control/blob/7abb332debfe243d5d21e0823dd92a94259b6d8e/src/geocoder/geocoder.ts#L60) ### `Optional`selectFirst[](#selectfirst) selectFirst?: boolean Automatically selects the first feature in the result list. Default: `true`. Implementation of MaptilerGeocoderOptions.selectFirst - Defined in [src/geocoder/geocoder.ts:61](https://github.com/maptiler/maptiler-geocoding-control/blob/7abb332debfe243d5d21e0823dd92a94259b6d8e/src/geocoder/geocoder.ts#L61) ### `Optional`showPlaceType[](#showplacetype) showPlaceType?: [ShowPlaceType](https://docs.maptiler.com/sdk-js/modules/geocoding/api/api-reference/types/ShowPlaceType/) Indicates when to show place/POI types in the dropdown: - `"never"`: Hide the type. - `"always"`: Always show the type. - `"if-needed"`: Show the type only if it cannot be determined from the icon. Default: `"if-needed"`. Implementation of MaptilerGeocoderOptions.showPlaceType - Defined in [src/geocoder/geocoder.ts:62](https://github.com/maptiler/maptiler-geocoding-control/blob/7abb332debfe243d5d21e0823dd92a94259b6d8e/src/geocoder/geocoder.ts#L62) ### `Optional`showResultsWhileTyping[](#showresultswhiletyping) showResultsWhileTyping?: boolean Displays results while typing: - `false`: Search occurs only on pressing the Enter key. - `true`: Search begins when the input meets the `minLength` requirement. Default: `true`. Implementation of MaptilerGeocoderOptions.showResultsWhileTyping - Defined in [src/geocoder/geocoder.ts:63](https://github.com/maptiler/maptiler-geocoding-control/blob/7abb332debfe243d5d21e0823dd92a94259b6d8e/src/geocoder/geocoder.ts#L63) ### `Optional`types[](#types) types?: [TypeRule](https://docs.maptiler.com/sdk-js/modules/geocoding/api/api-reference/types/TypeRule/)\[\] Types to query, either as an array or `[minZoom, maxZoom, type]` format. `minZoom` is inclusive, `maxZoom` is exclusive, and either can be `null` or `undefined` for unbounded values. See `reverseGeocodingTypes` option for reverse geocoding types. Default: `undefined` (uses server default feature types). Implementation of MaptilerGeocoderOptions.types - Defined in [src/geocoder/geocoder.ts:64](https://github.com/maptiler/maptiler-geocoding-control/blob/7abb332debfe243d5d21e0823dd92a94259b6d8e/src/geocoder/geocoder.ts#L64) ### `Optional`worldview[](#worldview) worldview?: [Worldview](https://docs.maptiler.com/sdk-js/modules/geocoding/api/api-reference/types/Worldview/) Some of the geographical boundaries and names are disputed. When worldview option is selected, the Geocoding API responses will be aligned with the borders and names recognized by the selected country. This affects filtering by country, the context returned with the given feature and also some of the labels (e.g., Gulf of Mexico vs. Gulf of America). Available options: - `"ch"`: Use the worldview of Switzerland - `"us"`: Use the worldview of US - `"auto"`: Automatically determine the worldview by the location of the client - `undefined`: Do not use any particular worldview (disputed areas are returned without country information, countries with disputed borders are returned without full geometry) Default: `undefined` (no worldview). Implementation of MaptilerGeocoderOptions.worldview - Defined in [src/geocoder/geocoder.ts:65](https://github.com/maptiler/maptiler-geocoding-control/blob/7abb332debfe243d5d21e0823dd92a94259b6d8e/src/geocoder/geocoder.ts#L65) ### addEventListener[](#addeventlistener) - addEventListener<[E](#addeventlistenere) extends keyof [MaptilerGeocoderEventNameMap](https://docs.maptiler.com/sdk-js/modules/geocoding/api/api-reference/types/MaptilerGeocoderEventNameMap/)\>(     type: [E](#addeventlistenere),     listener: (         this: HTMLElement,         e: [MaptilerGeocoderEventNameMap](https://docs.maptiler.com/sdk-js/modules/geocoding/api/api-reference/types/MaptilerGeocoderEventNameMap/)\[[E](#addeventlistenere)\],     ) \=> unknown,     options?: boolean | AddEventListenerOptions, ): void[](#addeventlistener-1) #### Type Parameters - E extends keyof [MaptilerGeocoderEventNameMap](https://docs.maptiler.com/sdk-js/modules/geocoding/api/api-reference/types/MaptilerGeocoderEventNameMap/) #### Parameters - type: [E](#addeventlistenere) - listener: (this: HTMLElement, e: [MaptilerGeocoderEventNameMap](https://docs.maptiler.com/sdk-js/modules/geocoding/api/api-reference/types/MaptilerGeocoderEventNameMap/)\[[E](#addeventlistenere)\]) \=> unknown - `Optional`options: boolean | AddEventListenerOptions #### Returns void Overrides LitElement.addEventListener - Defined in [src/geocoder/geocoder.ts:174](https://github.com/maptiler/maptiler-geocoding-control/blob/7abb332debfe243d5d21e0823dd92a94259b6d8e/src/geocoder/geocoder.ts#L174) ### blur[](#blur) - blur(): void[](#blur-1) Blur the search input box. #### Returns void Overrides LitElement.blur - Defined in [src/geocoder/geocoder.ts:170](https://github.com/maptiler/maptiler-geocoding-control/blob/7abb332debfe243d5d21e0823dd92a94259b6d8e/src/geocoder/geocoder.ts#L170) ### clearList[](#clearlist) - clearList(): void[](#clearlist-1) Clear search result list. #### Returns void - Defined in [src/geocoder/geocoder.ts:152](https://github.com/maptiler/maptiler-geocoding-control/blob/7abb332debfe243d5d21e0823dd92a94259b6d8e/src/geocoder/geocoder.ts#L152) ### focus[](#focus) - focus(options?: FocusOptions): void[](#focus-1) Focus the search input box. #### Parameters - `Optional`options: FocusOptions [FocusOptions](https://developer.mozilla.org/en-US/docs/Web/API/HTMLElement/focus#options) #### Returns void Overrides LitElement.focus - Defined in [src/geocoder/geocoder.ts:163](https://github.com/maptiler/maptiler-geocoding-control/blob/7abb332debfe243d5d21e0823dd92a94259b6d8e/src/geocoder/geocoder.ts#L163) ### removeEventListener[](#removeeventlistener) - removeEventListener<[E](#removeeventlistenere) extends keyof [MaptilerGeocoderEventNameMap](https://docs.maptiler.com/sdk-js/modules/geocoding/api/api-reference/types/MaptilerGeocoderEventNameMap/)\>(     type: [E](#removeeventlistenere),     listener: (         this: HTMLElement,         e: [MaptilerGeocoderEventNameMap](https://docs.maptiler.com/sdk-js/modules/geocoding/api/api-reference/types/MaptilerGeocoderEventNameMap/)\[[E](#removeeventlistenere)\],     ) \=> unknown,     options?: boolean | EventListenerOptions, ): void[](#removeeventlistener-1) #### Type Parameters - E extends keyof [MaptilerGeocoderEventNameMap](https://docs.maptiler.com/sdk-js/modules/geocoding/api/api-reference/types/MaptilerGeocoderEventNameMap/) #### Parameters - type: [E](#removeeventlistenere) - listener: (this: HTMLElement, e: [MaptilerGeocoderEventNameMap](https://docs.maptiler.com/sdk-js/modules/geocoding/api/api-reference/types/MaptilerGeocoderEventNameMap/)\[[E](#removeeventlistenere)\]) \=> unknown - `Optional`options: boolean | EventListenerOptions #### Returns void Overrides LitElement.removeEventListener - Defined in [src/geocoder/geocoder.ts:183](https://github.com/maptiler/maptiler-geocoding-control/blob/7abb332debfe243d5d21e0823dd92a94259b6d8e/src/geocoder/geocoder.ts#L183) ### setOptions[](#setoptions) - setOptions(options: Partial<[MaptilerGeocoderOptions](https://docs.maptiler.com/sdk-js/modules/geocoding/api/api-reference/types/MaptilerGeocoderOptions/)\>): void[](#setoptions-1) Set the options of this instance. #### Parameters - options: Partial<[MaptilerGeocoderOptions](https://docs.maptiler.com/sdk-js/modules/geocoding/api/api-reference/types/MaptilerGeocoderOptions/)\> options to set #### Returns void - Defined in [src/geocoder/geocoder.ts:121](https://github.com/maptiler/maptiler-geocoding-control/blob/7abb332debfe243d5d21e0823dd92a94259b6d8e/src/geocoder/geocoder.ts#L121) ### setQuery[](#setquery) - setQuery(value: string): void[](#setquery-1) Set the content of search input box. #### Parameters - value: string text to set #### Returns void - Defined in [src/geocoder/geocoder.ts:135](https://github.com/maptiler/maptiler-geocoding-control/blob/7abb332debfe243d5d21e0823dd92a94259b6d8e/src/geocoder/geocoder.ts#L135) ### submitQuery[](#submitquery) - submitQuery(value: string): void[](#submitquery-1) Set the content of search input box and immediately submit it. #### Parameters - value: string text to set and submit #### Returns void - Defined in [src/geocoder/geocoder.ts:145](https://github.com/maptiler/maptiler-geocoding-control/blob/7abb332debfe243d5d21e0823dd92a94259b6d8e/src/geocoder/geocoder.ts#L145) ## rendering[](#rendering-1) ### render[](#render) - render(): TemplateResult<1\>[](#render-1) Invoked on each update to perform rendering tasks. This method may return any value renderable by lit-html's `ChildPart` - typically a `TemplateResult`. Setting properties inside this method will _not_ trigger the element to update. #### Returns TemplateResult<1\> Overrides LitElement.render - Defined in [src/geocoder/geocoder.ts:655](https://github.com/maptiler/maptiler-geocoding-control/blob/7abb332debfe243d5d21e0823dd92a94259b6d8e/src/geocoder/geocoder.ts#L655) ## updates[](#updates-1) ### willUpdate[](#willupdate) - willUpdate(changedProperties: Map): void[](#willupdate-1) Invoked before `update()` to compute values needed during the update. Implement `willUpdate` to compute property values that depend on other properties and are used in the rest of the update process. ```typescript willUpdate(changedProperties) { // only need to check changed properties for an expensive computation. if (changedProperties.has('firstName') || changedProperties.has('lastName')) { this.sha = computeSHA(`${this.firstName} ${this.lastName}`); } } render() { return html`SHA: ${this.sha}`; } ``` #### Parameters - changedProperties: Map #### Returns void Overrides LitElement.willUpdate - Defined in [src/geocoder/geocoder.ts:576](https://github.com/maptiler/maptiler-geocoding-control/blob/7abb332debfe243d5d21e0823dd92a94259b6d8e/src/geocoder/geocoder.ts#L576)