Place search with Geocoding API

This tutorial shows how to search places using the MapTiler Geocoding API.

^{The map shows as a red dot the first search result for “Brno”.}

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 it’s up to you. You can start the map in a different place by modifying the starting position and starting zoom, and you can change the look of the map to any of our styles, or yours, by updating the style. See what’s available here.

4. Install the npm package.

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

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

7. Get the query string of the map URL.

8. Create the map layer where we will display the search results.

9. Check if the search parameter called q exists. If it exists, call the forward geocoding function with the value of the parameter q.

10. Show the results on the map and zoom in on the first result.

View complete source code on GitHub

Learn more

Check out the tutorials How to search places using the geocoder component and How to search places by coordinates (reverse geocoding).

Visit the MapTiler Geocoding API reference for all search options. Like for example specifying the language of the results, etc.

If you want to learn how to display the search results in a list, check out the Reverse Geocoding tutorial (point 6 onwards).