Nominatim is a tool to search OpenStreetMap data by name and address (geocoding) and to generate synthetic addresses of OSM points (reverse geocoding).

This module implements the database backend for Nominatim and the command-line tool for importing and maintaining the database.

Installation

Prerequisites

Nominatim requires osm2pgsql (>=1.8) for reading OSM data and PostgreSQL to store the data.

On Ubuntu (>=23.04) and Debian (using backports), you can install them with:

sudo apt-get install osm2pgsql postgresql-postgis

Installation from pypi

To install Nominatim from pypi, run:

pip install nominatim-db

Quick start

First create a project directory for your new Nominatim database, which is the space for additional configuration and customization:

mkdir planet-project

Download an appropriate data extract, for example from Geofabrik and import the file:

nominatim import --osm-file <downlaoded-osm-data.pbf>

You will need to install the 'nominatim-api' package to query the database.

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

License

The source code is available under a GPLv3 license.