use NominatimAPI in with context in CLI tool

[nominatim.git] / docs / customize / Special-Phrases.md

diff --git a/docs/customize/Special-Phrases.md b/docs/customize/Special-Phrases.md
index 0ba43911142d480f408acd311a954303c425a319..4824512bfba4fad38036649ba2e498747f02ce59 100644 (file)
--- a/docs/customize/Special-Phrases.md
+++ b/docs/customize/Special-Phrases.md
@@ -2,7 +2,7 @@
 
 ## Importing OSM user-maintained special phrases
 
 
 ## Importing OSM user-maintained special phrases
 

-As described in the [Import section](Import.md), it is possible to
+As described in the [Import section](../admin/Import.md), it is possible to

 import special phrases from the wiki with the following command:
 
 ```sh
 import special phrases from the wiki with the following command:
 
 ```sh


@@ -11,16 +11,31 @@ nominatim special-phrases --import-from-wiki
 
 ## Importing custom special phrases
 
 
 ## Importing custom special phrases
 

-But, it is also possible to import some phrases from a csv file. 
-To do so, you have access to the following command:
+Special phrases may also be imported from any custom CSV file. The file needs
+to have a header line, use comma as delimiter and define the following
+columns:
+
+ * **phrase**: the keyword to look for
+ * **class**: key of the main tag of the place to find
+   (see [principal tags in import style](Import-Styles.md#set_main_tags-principal-tags)
+ * **type**: value of the main tag
+ * **operator**: type of special phrase, may be one of:
+     * *in*: place is within the place defined by the search term (e.g. "_Hotels in_ Berlin")
+     * *near*: place is near the place defined by the search term (e.g. "_bus stops near_ Big Ben")
+     * *named*: special phrase is a classifier (e.g. "_hotel_ California")
+     * *-*: unspecified, can be any of the above
+
+If the file contains any other columns, then they are silently ignored
+
+To import the CSV file, use the following command:

 
 ```sh
 nominatim special-phrases --import-from-csv <csv file>
 ```
 
 Note that the two previous import commands will update the phrases from your database.
 
 ```sh
 nominatim special-phrases --import-from-csv <csv file>
 ```
 
 Note that the two previous import commands will update the phrases from your database.

-This means 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
+This means that if you import some phrases from a CSV file, only the phrases
+present in the CSV file will be kept in 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
 be removed.
 
 If you want to only add new phrases and not update the other ones you can add


@@ -30,5 +45,5 @@ the argument `--no-replace` to the import command. For example:
 nominatim special-phrases --import-from-csv <csv file> --no-replace
 ```
 
 nominatim special-phrases --import-from-csv <csv file> --no-replace
 ```
 

-This will add the phrases present in the csv file into the database without
+This will add the phrases present in the CSV file into the database without

 removing the other ones.
 removing the other ones.