projsync(1) PROJ projsync(1)
NAME
projsync - Downloading tool of resource files
SYNOPSIS
projsync
[--endpoint URL]
[--local-geojson-file FILENAME]
([--user-writable-directory] | [--system-directory] | [--target-dir DIRNAME])
[--bbox west_long,south_lat,east_long,north_lat]
[--spatial-test contains|intersects]
[--source-id ID] [--area-of-use NAME]
[--file NAME]
[--all] [--exclude-world-coverage]
[--quiet | --verbose] [--dry-run] [--list-files]
[--no-version-filtering]
DESCRIPTION
projsync is a program that downloads remote resource files into a local
directory. This is an alternative to downloading a proj-data-X.Y.Z
archive file, or using the on-demand networking capabilities of PROJ.
The following control parameters can appear in any order:
--endpoint URL
Defines the URL where to download the master files.geojson file
and then the resource files. Defaults to the value set in proj.ini
--local-geojson-file FILENAME
Defines the filename for the master GeoJSON files that references
resources. Defaults to ${endpoint}/files.geojson
--user-writable-directory
Specifies that resource files must be downloaded in the user
writable directory. This is the default.
--system-directory
Specifies that resource files must be downloaded in the
${installation_prefix}/share/proj directory. The user launching
projsync should make sure it has writing rights in that directory.
--target-dir DIRNAME
Directory into which resource files must be downloaded.
--bbox west_long,south_lat,east_long,north_lat
Specify an area of interest to restrict the resources to download.
The area of interest is specified as a bounding box with
geographic coordinates, expressed in degrees in a unspecified
geographic CRS. west_long and east_long should be in the
[-180,180] range, and south_lat and north_lat in the [-90,90].
west_long is generally lower than east_long, except in the case
where the area of interest crosses the antimeridian.
--spatial-test contains|intersects
Specify how the extent of the resource files are compared to the
area of use specified explicitly with --bbox. By default, any
resource files whose extent intersects the value specified by
--bbox will be selected. If using the contains strategy, only
resource files whose extent is contained in the value specified by
--bbox will be selected.
--source-id ID
Restrict resource files to be downloaded to those whose source_id
property contains the ID value. Specifying ? as ID will list all
possible values.
--area-of-use NAME
Restrict resource files to be downloaded to those whose
area_of_use property contains the NAME value. Specifying ? as NAME
will list all possible values.
--file NAME
Restrict resource files to be downloaded to those whose name
property contains the NAME value. Specifying ? as NAME will list
all possible values.
--all Ask to download all files.
--exclude-world-coverage
Exclude files which have world coverage.
-q / --quiet
Quiet mode
--verbose
New in version 8.1.
Verbose mode (more than default)
--dry-run
Simulate the behavior of the tool without downloading resource
files.
--list-files
List file names, with the source_id and area_of_use properties.
--no-version-filtering
New in version 8.1.
By default, projsync only downloads files that are compatible of
the PROJ_DATA.VERSION metadata of proj.db, taking into account the
version_added and version_removed properties of entries in
files.geojson. When specifying this switch, all files referenced
in files.geojson will be candidate (combined with other filters).
At least one of --list-files, --file, --source-id, --area-of-use,
--bbox or --all must be specified.
Options --file, --source-id, --area-of-use and --bbox are combined with
a AND logic.
EXAMPLES
1. Download all resource files
projsync --all
2. Download resource files covering specified point and attributed to an
agency
projsync --source-id fr_ign --bbox 2,49,2,49
SEE ALSO
cs2cs(1), cct(1), geod(1), gie(1), proj(1), projinfo(1)
BUGS
A list of known bugs can be found at https://github.com/OSGeo/PROJ/issues
where new bug reports can be submitted to. Bugs specific to resource
files should be submitted to https://github.com/OSGeo/PROJ-data/issues
HOME PAGE
https://proj.org/
AUTHOR
Even Rouault
COPYRIGHT
1983-2023
9.2.0 March 1, 2023 projsync(1)
proj 9.2.0 - Generated Fri Mar 10 16:40:05 CST 2023