manpagez: man pages & more
man projsync(1)
Home | html | info | man
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] [--dry-run] [--list-files]



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  ar-
       chive 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 refer-
              ences 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 direc-
              tory.

       --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  down-
              load.   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

       --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.

       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 attributing 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     know     bugs      can      be      found      at
       https://github.com/OSGeo/PROJ/issues  where new bug reports can be sub-
       mitted 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-2020



7.1.1                             Sep 1, 2020                      projsync(1)

proj 7.1.1 - Generated Thu Sep 3 16:19:27 CDT 2020
© manpagez.com 2000-2021
Individual documents may contain additional copyright information.