PROJ can be controlled by setting environment variables. Most users will
have a use for the
On UNIX systems environment variables can be set for a shell-session with:
$ export VAR="some variable"
or it can be set for just one command line call:
$ VAR="some variable" ./cmd
Environment variables on UNIX are usually removed with the
$ unset VAR
On windows systems environment variables can be set in the command line with:
> set VAR="some variable"
VAR will be available for the entire session, unless it is unset. This is
done by setting the variable with no content:
> set VAR=
Prior to PROJ 9.1, this environment variable was called
PROJ_LIB. This older name is still supported in PROJ 9.1 as a fallback, but support for it may be removed in future release.
The location of PROJ resource files.
Starting with PROJ 6, multiple directories can be specified. On Unix, they should be separated by the colon (:) character. on Windows, by the semi-colon (;) character.
PROJ is hardcoded to look for resource files in other locations as well, amongst those are the installation directory (usually
share/projunder the PROJ installation root) and the current folder.
You can also set the location of the resource files using
Changed in version 6.1.0: Starting with PROJ version 6.1.0, the paths set by
proj_context_set_search_paths() will have priority over the
PROJ_DATA to allow for multiple versions of PROJ
resource files on your system without conflicting.
New in version 8.1.0.
To set the path to one or several auxiliary SQLite3 databases of structure identical to the main
proj.dbdatabase and that can contain additional object (CRS, transformation, ...) definitions. If several paths are provided, they must be separated by the colon (:) character on Unix, and on Windows, by the semi-colon (;) character.
Set the debug level of PROJ.
The following levels are available: -
0: no message. -
1: error messages only (default). -
2: same as 1, with debug messages. -
3: same as 2, with verbose messages. -
4: same as 3, with very verbose messages.
Starting with PROJ 9.3,
ONcan be used as an alias for
OFFas an alias for
New in version 7.0.0.
If set to ON, enable the capability to use remote grids stored on CDN (Content Delivery Network) storage, when grids are not available locally. Alternatively, the
proj_context_set_enable_network()function can be used.
New in version 7.0.0.