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.
-
Copy the following code, paste it into your favorite text editor, and save it as a
.html
file.
-
Replace
YOUR_MAPTILER_API_KEY_HERE
with your own API key. Make sure to protect the key before publishing your map app! -
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 thestarting zoom
) to match your users’ needs. Additionally, you can change the map’s look (by updating thesource 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.
-
Include the geocoder component JavaScript and CSS files in the
<head>
of your HTML file. -
Add the geocoder control to the map.
-
Install the Geocoding control using npm.
-
Import the Geocoding control component and CSS in your mapping application.
-
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:
- Limit results by a drawn area (polygon)
- Limit results by a bounding box
- Limit results to a specific country
- Search for POIs (points of interest) near the user’s location
- Prioritize search results closer to a specific point
- Specify the search language
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:
- MapTiler SDK JS
- Step-by-step tutorial(this page)
- React component
- Svelte component
- Leaflet
- OpenLayers
- MapLibre GL JS
- Vanilla JS
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).