X-Git-Url: https://git.openstreetmap.org./nominatim.git/blobdiff_plain/0947b618085f7d46515a3ec06cab5ed818e8635f..d42e2e391f1e0ac252f8251561d984a72bd3b1ff:/settings/env.defaults diff --git a/settings/env.defaults b/settings/env.defaults index 0a7b60d1..c4739e78 100644 --- a/settings/env.defaults +++ b/settings/env.defaults @@ -5,7 +5,7 @@ # Database connection string. # Add host, port, user etc through additional semicolon-separated attributes. # e.g. ;host=...;port=...;user=...;password=... -# Changing this variable requires to run 'setup.php --setup-website'. +# Changing this variable requires to run 'nominatim refresh --website'. NOMINATIM_DATABASE_DSN="pgsql:dbname=nominatim" # Database web user. @@ -15,10 +15,16 @@ NOMINATIM_DATABASE_WEBUSER="www-data" # Directory where to find the PostgreSQL server module. # When empty the module is expected to be located in the 'module' subdirectory # in the project directory. -# Changing this value requires to run ./utils/setup --create-functions. +# Changing this value requires to run 'nominatim refresh --functions'. NOMINATIM_DATABASE_MODULE_PATH= -# Number of occurances of a word before it is considered frequent. +# Tokenizer used for normalizing and parsing queries and names. +# The tokenizer is set up during import and cannot be changed afterwards +# without a reimport. +# Currently available tokenizers: icu, legacy +NOMINATIM_TOKENIZER="icu" + +# Number of occurrences of a word before it is considered frequent. # Similar to the concept of stop words. Frequent partial words get ignored # or handled differently during search. # Changing this value requires a reimport. @@ -40,12 +46,18 @@ NOMINATIM_LANGUAGES= # Changing this value requires a reimport. NOMINATIM_TERM_NORMALIZATION=":: NFD (); [[:Nonspacing Mark:] [:Cf:]] >; :: lower (); [[:Punctuation:][:Space:]]+ > ' '; :: NFC ();" +# Configuration file for the tokenizer. +# The content depends on the tokenizer used. If left empty the default settings +# for the chosen tokenizer will be used. The configuration can only be set +# on import and not be changed afterwards. +NOMINATIM_TOKENIZER_CONFIG= + # Search in the Tiger house number data for the US. # Note: The tables must already exist or queries will throw errors. # Changing this value requires to run ./utils/setup --create-functions --setup-website. NOMINATIM_USE_US_TIGER_DATA=no -# Search in the auxilary housenumber table. +# Search in the auxiliary housenumber table. # Changing this value requires to run ./utils/setup --create-functions --setup-website. NOMINATIM_USE_AUX_LOCATION_DATA=no @@ -53,46 +65,40 @@ NOMINATIM_USE_AUX_LOCATION_DATA=no # The following settings allow to set a proxy to use when remotely downloading # data. Host and port are required. Login and password are optional. NOMINATIM_HTTP_PROXY=no -NOMINATIM_HTTP_PROXY_HOST=proxy.mydomain.com +NOMINATIM_HTTP_PROXY_HOST= NOMINATIM_HTTP_PROXY_PORT=3128 NOMINATIM_HTTP_PROXY_LOGIN= NOMINATIM_HTTP_PROXY_PASSWORD= +# Also set these standard environment variables. +# HTTP_PROXY="http://user:pass@10.10.1.10:1080" +# HTTPS_PROXY="http://user:pass@10.10.1.10:1080" # Location of the osm2pgsql binary. -# When empty, osm2pgsql is expected to reside in the osm2pgsql directory in -# the project directory. # EXPERT ONLY. You should usually use the supplied osm2pgsql. NOMINATIM_OSM2PGSQL_BINARY= -# Location of pyosmium-get-changes. -# Only needed when running updates. -NOMINATIM_PYOSMIUM_BINARY= - # Directory where to find US Tiger data files to import. -# Used with setup.php --import-tiger-data. When unset, the data is expected -# to be located under 'data/tiger' in the source tree. +# OBSOLETE: use `nominatim add-data --tiger-data ` to explicitly state +# the directory on import NOMINATIM_TIGER_DATA_PATH= # Directory where to find pre-computed Wikipedia importance files. -# When unset, the data is expected to be located in the 'data' directory -# in the source tree. +# When unset, the data is expected to be located in the project directory. NOMINATIM_WIKIPEDIA_DATA_PATH= # Configuration file for special phrase import. -# When unset, the internal default settings from 'settings/phrase_settings.php' -# are used. +# OBSOLETE: use `nominatim special-phrases --config ` or simply put +# a custom phrase-settings.json into your project directory. NOMINATIM_PHRASE_CONFIG= # Configuration file for rank assignments. -# When unset, the internal default settings from 'settings/address-levels.json' -# are used. -NOMINATIM_ADDRESS_LEVEL_CONFIG= +NOMINATIM_ADDRESS_LEVEL_CONFIG=address-levels.json # Configuration file for OSM data import. # This may either be the name of one of an internal style or point # to a file with a custom style. # Internal styles are: admin, street, address, full, extratags -NOMNIATIM_IMPORT_STYLE=extratags +NOMINATIM_IMPORT_STYLE=extratags # Location of the flatnode file used by osm2pgsql to store node locations. # When unset, osm2pgsql stores the location in the PostgreSQL database. This @@ -145,28 +151,28 @@ NOMINATIM_TABLESPACE_AUX_INDEX= # These are used to keep the database up to date. Per default it points to # the minutely updates for the main OSM database. There are other services # geared towards larger update intervals or data extracts. -# Changing this value requires to rerun 'update/php --init-updates'. +# Changing this value requires to rerun 'nominatim replication --init'. NOMINATIM_REPLICATION_URL="https://planet.openstreetmap.org/replication/minute" # Maximum amount of data to download per batch. # Size is in MB. NOMINATIM_REPLICATION_MAX_DIFF=50 -# Publication interval of the replication service. +# Publication interval of the replication service (in seconds). # Determines when Nominatim will attempt again to download again a new # update. The time is computed from the publication date of the last diff # downloaded. Setting this to a slightly higher value than the actual # publication interval avoids unnecessary rechecks. NOMINATIM_REPLICATION_UPDATE_INTERVAL=75 -# Wait time to recheck for a pending update. +# Wait time to recheck for a pending update (in seconds). # Time to wait after an expected update was not available on the server. NOMINATIM_REPLICATION_RECHECK_INTERVAL=60 ### API settings # # The following settings configure the API responses. You must rerun -# setup.php --setup-website after changing any of them. +# 'nominatim refresh --website' after changing any of them. # Send permissive CORS access headers. # When enabled, send CORS headers to allow access to everybody. @@ -182,7 +188,7 @@ NOMINATIM_MAPICON_URL= NOMINATIM_DEFAULT_LANGUAGE= # Enable a special batch query mode. -# This features is currently undocumented and potentially broken. +# This feature is currently undocumented and potentially broken. NOMINATIM_SEARCH_BATCH_MODE=no # Threshold for searches by name only. @@ -198,10 +204,26 @@ NOMINATIM_LOOKUP_MAX_COUNT=50 # Set to zero to disable polygon output. NOMINATIM_POLYGON_OUTPUT_MAX_TYPES=1 +# Offer backwards compatible PHP URLs. +# When running one of the Python enignes, they will add endpoint aliases +# under .php +NOMINATIM_SERVE_LEGACY_URLS=yes + +# Maximum number of connection a single API object can use. (Python API only) +# When running Nominatim as a server, then this is the maximum number +# of connections _per worker_. +NOMINATIM_API_POOL_SIZE=10 + +# Search elements just within countries +# If, despite not finding a point within the static grid of countries, it +# finds a geometry of a region, do not return the geometry. Return "Unable +# to geocode" instead. +NOMINATIM_SEARCH_WITHIN_COUNTRIES=False + ### Log settings # # The following options allow to enable logging of API requests. -# You must rerun setup.php --setup-website after changing any of them. +# You must rerun 'nominatim refresh --website' after changing any of them. # # Enable logging of requests into the DB. # The request will be logged into the new_query_log table. @@ -211,3 +233,7 @@ NOMINATIM_LOG_DB=no # Enable logging of requests into a file. # To enable logging set this setting to the file to log to. NOMINATIM_LOG_FILE= + +# Echo raw SQL from SQLAlchemy statements. +# Works only in command line/library use. +NOMINATIM_DEBUG_SQL=no