X-Git-Url: https://git.openstreetmap.org./nominatim.git/blobdiff_plain/3206bf59df0213d24bd3e11df7dd2abaebf89911..25318e8a69512c9543ca5c7fee57839d5b417cb0:/docs/admin/Import.md diff --git a/docs/admin/Import.md b/docs/admin/Import.md index 264b46f4..39c45a6e 100644 --- a/docs/admin/Import.md +++ b/docs/admin/Import.md @@ -40,7 +40,7 @@ all commands from the project directory. ### Configuration setup in `.env` -The Nominatim server can be customized via an `.env` configuration file in the +The Nominatim server can be customized via an `.env` configuration file in the project directory. This is a file in [dotenv](https://github.com/theskumar/python-dotenv) format which looks the same as variable settings in a standard shell environment. You can also set the same configuration via environment variables. All @@ -48,7 +48,7 @@ settings have a `NOMINATIM_` prefix to avoid conflicts with other environment variables. There are lots of configuration settings you can tweak. Have a look -at `settings/env.default` for a full list. Most should have a sensible default. +at `Nominatim/settings/env.default` for a full list. Most should have a sensible default. #### Flatnode files @@ -193,12 +193,15 @@ can be found in the development section. [Geofabrik](https://download.geofabrik.de). Download the data to import. Then issue the following command -from the **build directory** to start the import: +from the **project directory** to start the import: ```sh nominatim import --osm-file 2>&1 | tee setup.log ``` +The **project directory** is the one that you have set up at the beginning. +See [creating the project directory](Import#creating-the-project-directory). + ### Notes on full planet imports Even on a perfectly configured machine @@ -284,53 +287,5 @@ nominatim special-phrases --import-from-wiki Note that this command downloads the phrases from the wiki link above. You need internet access for the step. -You can also import some phrases from a csv file. -To do so, you have access to the following command: - -```sh -nominatim special-phrases --import-from-csv -``` - -Note that the 2 previous commands will update the phrases from your database. -This mean that if you import some phrases from a csv file, only the phrases -present in the csv file will be kept into the database. All other phrases will -be removed. - -If you want to only add new phrases and not update the other ones you can add -the argument `--no-replace` to the import command. For example: - -```sh -nominatim special-phrases --import-from-csv --no-replace -``` - -This will add the phrases present in the csv file into the database without -removing the other ones. - -## Installing Tiger housenumber data for the US - -Nominatim is able to use the official [TIGER](https://www.census.gov/geographies/mapping-files/time-series/geo/tiger-line-file.html) -address set to complement the OSM house number data in the US. You can add -TIGER data to your own Nominatim instance by following these steps. The -entire US adds about 10GB to your database. - - 1. Get preprocessed TIGER 2020 data: - - cd $PROJECT_DIR - wget https://nominatim.org/data/tiger2020-nominatim-preprocessed.tar.gz - - 2. Import the data into your Nominatim database: - - nominatim add-data --tiger-data tiger2020-nominatim-preprocessed.tar.gz - - 3. Enable use of the Tiger data in your `.env` by adding: - - echo NOMINATIM_USE_US_TIGER_DATA=yes >> .env - - 4. Apply the new settings: - - nominatim refresh --functions - - -See the [developer's guide](../develop/data-sources.md#us-census-tiger) for more -information on how the data got preprocessed. - +You can also import special phrases from a csv file, for more +information please read the [Customization chapter](Customization.md).