Geocoding API description

You can try the search system in your project right now!

The OSMNames open-source project provides raw place data in an easy-to-index form. The MapTiler team has developed a basic search system providing responses for queries in the form of structured JSON data.

Autocomplete REST API

Search for autocomplete


This endpoint returns 20 results matching the <query>.

Country specific search for autocomplete


This endpoint returns 20 results matching the <query> within a specific country, identified by the <country_code> (lowercase ISO 3166 Alpha-2 code).

The JavaScript Autocomplete component submitting AJAX queries to the server is open-source as well.

Nominatim compatible API

The open-source OSMNames SphinxSearch system comes with an (incomplete implementation) of the API compatible with Nominatim: to simplify migration of the existing web and mobile clients.

Autocomplete JavaScript component

You can easily create OSMNames autocomplete using the prepared JavaScript component:

    <script src=""></script>
    <link href="" rel="stylesheet" />
    <input autocomplete="off" id="search" type="text" />
      var autocomplete = new kt.OsmNamesAutocomplete(
          'search', '');

      autocomplete.registerCallback(function(item) {
        alert(JSON.stringify(item, ' ', 2));

Geocoding on-premises: install the API server on your computer

Please follow the tutorial in the Documentation section.

Project Partners

Do you need geocoding API or Maps API with SLA and commercial support? Try maps for developers by MapTiler.

OSMNames project is maintained by the OSM community, Geometa Lab HSR, and MapTiler.