projsync - Downloading tool of resource files

NAME  SYNOPSIS  DESCRIPTION  EXAMPLES  SEE ALSO  BUGS  HOME PAGE  AUTHOR  COPYRIGHT 

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


Updated 2024-01-29 - jenkler.se | uex.se