You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Sarah Hoffmann de45152028
Merge pull request #1692 from mtmail/tests-for-HasSetAny
22 hours ago
cmake Restructure script and website installation 1 year ago
data make US postcode data to an optional download 7 months ago
data-sources wikipedia: wget didnt download, skip index generation 1 week ago
docs update cMake build documentation 3 weeks ago
lib unit tests for ParameterParser::hasSetAny 2 days ago
module Update nominatim.c 2 years ago
munin Add some comments to help use munin plugin, add over limit detection 6 years ago
nominatim nominatim.py: use async in connect() function 1 week ago
osm2pgsql @ cb7655a4ff update osm2pgsql (gazetteer output tests) 1 month ago
settings remove special handling of rail 1 month ago
sql improve parenting for large areas with rank 30 2 days ago
test unit tests for ParameterParser::hasSetAny 2 days ago
utils add structured search to command-line query tool 2 days ago
vagrant psycopg 2.6 is now usable on ubuntu 16 1 week ago
website details: also look for interpolations when way id is given 1 week ago
.gitignore move from autotools to cmake and update osm2pgsql 4 years ago
.gitmodules update osm2pgsql to latest version 7 years ago
.travis.yml Travis: documentation suggests we need to add postgresql-client package pre-startup 2 days ago
AUTHORS prepare release 3.2.0 1 year ago
CMakeLists.txt update cMake build documentation 3 weeks ago
CONTRIBUTING.md update minimum required RAM to 64GB 2 months ago
COPYING tabs-to-spaces 3 years ago
ChangeLog prepare for 3.4.0 release 3 months ago
README.md Mention FAQ / troubleshooting page in README 2 months ago
VAGRANT.md replace database abstraction DB with PDO 11 months ago
Vagrantfile Vagrant setup for CentOS 8 2 weeks ago
phpcs.xml add PHPCS Squiz.Arrays.ArrayDeclaration.KeyNotAligned rule 1 year ago

README.md

Build Status

Nominatim

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 https://nominatim.openstreetmap.org. Nominatim is also used as one of the sources for the Search box on the OpenStreetMap home page.

Documentation

The documentation of the latest development version is in the docs/ subdirectory. A HTML version can be found at https://nominatim.org/release-docs/develop/ .

Installation

Nominatim is a complex piece of software and runs in a complex environment. Installing and running Nominatim is something for experienced system administrators only who can do some trouble-shooting themselves. We are sorry, but we can not provide installation support. We are all doing this in our free time and there is just so much of that time to go around. Do not open issues in our bug tracker if you need help. You can ask questions on the mailing list (see below) or on help.openstreetmap.org.

The latest stable release can be downloaded from https://nominatim.org. There you can also find installation instructions for the release, as well as an extensive Troubleshooting/FAQ section.

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

A quick summary of the necessary steps:

  1. Compile Nominatim:

     mkdir build
     cd build
     cmake ..
     make
    
  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.

License

The source code is available under a GPLv2 license.

Contributing

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 https://lists.openstreetmap.org/listinfo/geocoding