Skip to content
Open Source search based on OpenStreetMap data
PHP TSQL C Gherkin PLpgSQL Python Other
Branch: master
Clone or download
lonvia Merge pull request #1557 from mtmail/document-boundingbox
documentation: add note what bounding box can be used for
Latest commit 6f2e767 Nov 13, 2019
Type Name Latest commit message Commit time
Failed to load latest commit information.
cmake Restructure script and website installation Dec 2, 2018
data-sources Typo - Wekipedia (Wikipedia) Oct 21, 2019
data make US postcode data to an optional download Jul 23, 2019
docs Merge pull request #1557 from mtmail/document-boundingbox Nov 13, 2019
lib Merge pull request #1555 from mtmail/setup-escape-shell-args Nov 6, 2019
module Update nominatim.c Feb 25, 2018
munin Add some comments to help use munin plugin, add over limit detection Jan 14, 2014
nominatim Work on setup/update scripts, unit tests, and documentation to enable… Jul 21, 2018
osm2pgsql @ 8d9087f update osm2pgsql (bound COPY buffers) Oct 22, 2019
settings add place=city_block/quarter to address hierarchy Oct 14, 2019
sql fix rank of postcode results Oct 19, 2019
test adapt tests to short_name demotion Oct 28, 2019
utils Merge pull request #1502 from mtmail/specialphrases-quotes Oct 22, 2019
vagrant Update CentOS instruction to postgresql 11 (default was 9.2) Nov 2, 2019
website HTML page with search form when /details.php called without params Oct 31, 2019
wikidata replace double-quoting with single quotes where applicable Oct 26, 2017
.gitignore move from autotools to cmake and update osm2pgsql Mar 12, 2016
.gitmodules update osm2pgsql to latest version Sep 29, 2012
.travis.yml travis-CI: use PHP 7.1 Apr 17, 2019
AUTHORS prepare release 3.2.0 Aug 26, 2018
CMakeLists.txt prepare for 3.4.0 release Oct 25, 2019 add a note about variable naming for PHP Jul 21, 2018
COPYING tabs-to-spaces Sep 4, 2016
ChangeLog prepare for 3.4.0 release Oct 25, 2019 Rectified a small spelling mistake Mar 14, 2019 replace database abstraction DB with PDO Mar 8, 2019
Vagrantfile copy of the Ubuntu18 vagrant setup but with nginx as webserver Oct 31, 2018
phpcs.xml add PHPCS Squiz.Arrays.ArrayDeclaration.KeyNotAligned rule May 7, 2018

Build Status


Nominatim (from the Latin, 'by name') is a tool to search OpenStreetMap data by name and address (geocoding) and to generate synthetic addresses of OSM points (reverse geocoding). An instance with up-to-date data can be found at Nominatim is also used as one of the sources for the Search box on the OpenStreetMap home page.


The documentation of the latest development version is in the docs/ subdirectory. A HTML version can be found at .


The latest stable release can be downloaded from There you can also find installation instructions for the release.

Detailed installation instructions for the development version can be found at as well.

A quick summary of the necessary steps:

  1. Compile Nominatim:

     mkdir build
     cd build
     cmake ..
  2. Get OSM data and import:

     ./build/utils/setup.php --osm-file <your planet file> --all
  3. Point your webserver to the ./build/website directory.


The source code is available under a GPLv2 license.


Contributions are welcome. For details see contribution guide.

Both bug reports and pull requests are welcome.

Mailing list

For questions you can join the geocoding mailing list, see

You can’t perform that action at this time.