Scroll to navigation

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:

Defines the URL where to download the master files.geojson file and then the resource files. Defaults to the value set in proj.ini

Defines the filename for the master GeoJSON files that references resources. Defaults to ${endpoint}/files.geojson

Specifies that resource files must be downloaded in the user writable directory. This is the default.

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.

Directory into which resource files must be downloaded.

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.

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.

Restrict resource files to be downloaded to those whose source_id property contains the ID value. Specifying ? as ID will list all possible values.

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.

Restrict resource files to be downloaded to those whose name property contains the NAME value. Specifying ? as NAME will list all possible values.

Ask to download all files.

Exclude files which have world coverage.

Quiet mode

New in version 8.1.

Verbose mode (more than default)


Simulate the behavior of the tool without downloading resource files.

List file names, with the source_id and area_of_use properties.

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-2024, PROJ contributors

01 Mar 2024 9.4