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

9.4                               01 Mar 2024                      PROJSYNC(1)