Geocoding control how to search places

This tutorial shows how to search for places using the Geocoding control. The Geocoding control component facilitates the use of the MapTiler Geocoding API.

The geocoding control is designed for effortless integration into React and Svelte applications. With just a single line of code, you can incorporate a reliable all-in-one place and address search box into your applications.

  1. Copy the following code, paste it into your favorite text editor, and save it as a .html file.

  1. Install the npm package.

  2. Include the CSS file.

    If you have a bundler that can handle CSS, you can import the CSS or include it with a <link> in the head of the document via the CDN

  3. Include the following code in your JavaScript file (Example: app.js).

  1. Replace YOUR_MAPTILER_API_KEY_HERE with your own API key. Make sure to protect the key before publishing your map app!

  2. The next is up to you. You can center your map wherever you desire (modifying the starting position) and set an appropriate zoom level (modifying the starting zoom) to match your users’ needs. Additionally, you can change the map’s look (by updating the source URL); choose from a range of visually appealing map styles from our extensive MapTiler standard maps, or create your own to truly differentiate your application.

  1. Include the geocoder component JavaScript and CSS files in the <head> of your HTML file.
  2. Add the geocoder control to the map.
  1. Install the Geocoding control using npm.
  2. Import the Geocoding control component and CSS in your mapping application.
  3. Add the geocoder control to the map.

Configuration

The code on this page helps you build a map with a default search box. To configure the search, see these code examples and tutorials:

Geocoding on-prem with MapTiler Server

You can utilize the geocoding capabilities within your on-prem installation of MapTiler Server. This feature allows you to search for addresses and locations without an internet connection. Please take a look at the MapTiler Server API documentation for a comprehensive understanding of all the available options the Geocoding API provides.

Other libraries

See code examples of how to use the Geocoding control with different map libraries and Javascript frameworks:

Learn more

Check the MapTiler Geocoding control API reference for all search options. For example specifying the language of the results, etc.

Do you want to see how the geocoder component is made? Check the MapTiler Geocoding control repository. You can also use it as inspiration to create your component.

Discover the process of integrating the geocoding control feature into your React (Geocoding React component repository) or Svelte (Geocoding Svelte component) applications. Additionally, you have the option to use the VanillaJS version to customize it for any of your applications.

Are you currently using a different map library? No worries! Learn how to incorporate the geocoding control functionality with Leaflet (Leaflet Geocoding control), OpenLayers (OpenLayers Geocoding control), or MapLibre GL JS (MapLibre GL JS Geocoding control).

Place search with Geocoding API

Geocoding API

Example

This tutorial shows how to search places using the MapTiler Geocoding API.
How to search places by coordinates (reverse geocoding)

Reverse geocoding

Example

This tutorial shows how to search places by coordinates (reverse geocoding).
Geocoding search results closer to specific point

Geocoding search results by proximity to a specific point

Example

Geocoding control search results closer to the specific geographical point, results near the provided point are ranked higher.
Geocoding search results to specified country(ies)

Geocoding search results to specified country(ies)

Example

Geocoding control limit search results to specified country(ies).
An extension of MapLibre GL JS