.. | ||
extra_src/nominatim_db | ||
scripts | ||
COPYING | ||
data | ||
lib-sql | ||
pyproject.toml | ||
README.md | ||
settings | ||
src |
Nominatim - DB Backend
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.