How to search places using OpenLayers geocoding control

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

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

  2. Replace YOUR_MAPTILER_API_KEY_HERE with your actual MapTiler API key.

  3. 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.

  4. Include the geocoder component JavaScript and CSS files in the <head> of your HTML file.

  5. Instantiate the geocoding control and add it to the map.

  6. Create the GeocodingControl CSS style. Add the GeocodingControl style to your stylesheet.

How to position the geocoding control

To position the geocoding control effectively on your map interface, you’ll need to utilize the CSS class .ol-search. This class provides the flexibility to place the control precisely where you want it within your map layout. Similar to other map control elements, the positioning requires the use of position: absolute; declaration in your CSS, followed by specific positioning.

For example, to achieve placement in the bottom right corner of the map, you can implement the appropriate CSS positioning values. This approach ensures the geocoding control remains fixed in your desired location while maintaining proper functionality and user accessibility.

Learn more

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

Do you want to see how the geocoding component works and its options? Check the MapTiler Geocoding control repository.

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