1PROJSYNC(1)                          PROJ                          PROJSYNC(1)
2
3
4

NAME

6       projsync - Downloading tool of resource files
7

SYNOPSIS

9          projsync
10            [--endpoint URL]
11            [--local-geojson-file FILENAME]
12            ([--user-writable-directory] | [--system-directory] | [--target-dir DIRNAME])
13            [--bbox west_long,south_lat,east_long,north_lat]
14            [--spatial-test contains|intersects]
15            [--source-id ID] [--area-of-use NAME]
16            [--file NAME]
17            [--all] [--exclude-world-coverage]
18            [--quiet] [--dry-run] [--list-files]
19
20

DESCRIPTION

22       projsync is a program that downloads remote resource files into a local
23       directory. This is an alternative to downloading a proj-data-X.Y.Z  ar‐
24       chive file, or using the on-demand networking capabilities of PROJ.
25
26       The following control parameters can appear in any order:
27
28       --endpoint URL
29              Defines  the URL where to download the master files.geojson file
30              and then the resource  files.  Defaults  to  the  value  set  in
31              proj-ini
32
33       --local-geojson-file FILENAME
34              Defines  the  filename  for the master GeoJSON files that refer‐
35              ences resources.  Defaults to ${endpoint}/files.geojson
36
37       --user-writable-directory
38              Specifies that resource files must be  downloaded  in  the  user
39              writable directory. This is the default.
40
41       --system-directory
42              Specifies  that  resource  files must be downloaded in the ${in‐
43              stallation_prefix}/share/proj directory. The user launching pro‐
44              jsync should make sure it has writing rights in that directory.
45
46       --target-dir DIRNAME
47              Directory into which resource files must be downloaded.
48
49       --bbox west_long,south_lat,east_long,north_lat
50              Specify  an  area of interest to restrict the resources to down‐
51              load.  The area of interest is specified as a bounding box  with
52              geographic  coordinates,  expressed  in degrees in a unspecified
53              geographic CRS.   west_long  and  east_long  should  be  in  the
54              [-180,180]  range,  and south_lat and north_lat in the [-90,90].
55              west_long is generally lower than east_long, except in the  case
56              where the area of interest crosses the antimeridian.
57
58       --spatial-test contains|intersects
59              Specify how the extent of the resource files are compared to the
60              area of use specified explicitly with --bbox.  By  default,  any
61              resource  files  whose  extent intersects the value specified by
62              --bbox will be selected.  If using the contains  strategy,  only
63              resource  files whose extent is contained in the value specified
64              by --bbox will be selected.
65
66       --source-id ID
67              Restrict  resource  files  to  be  downloaded  to  those   whose
68              source_id  property  contains  the  ID value. Specifying ? as ID
69              will list all possible values.
70
71       --area-of-use NAME
72              Restrict  resource  files  to  be  downloaded  to  those   whose
73              area_of_use  property  contains  the NAME value. Specifying ? as
74              NAME will list all possible values.
75
76       --file NAME
77              Restrict resource files to be downloaded  to  those  whose  name
78              property contains the NAME value. Specifying ? as NAME will list
79              all possible values.
80
81       --all  Ask to download all files.
82
83       --exclude-world-coverage
84              Exclude files which have world coverage.
85
86       -q / --quiet
87              Quiet mode
88
89       --dry-run
90              Simulate the behavior of the tool without  downloading  resource
91              files.
92
93       --list-files
94              List file names, with the source_id and area_of_use properties.
95
96       At  least  one  of  --list-files,  --file,  --source-id, --area-of-use,
97       --bbox or  --all must be specified.
98
99       Options --file,  --source-id, --area-of-use  and  --bbox  are  combined
100       with a AND logic.
101

EXAMPLES

103       1. Download all resource files
104
105          projsync --all
106
107       2. Download  resource files covering specified point and attributing to
108          an agency
109
110          projsync --source-id fr_ign --bbox 2,49,2,49
111

SEE ALSO

113       cs2cs(1), cct(1), geod(1), gie(1), proj(1), projinfo(1)
114

BUGS

116       A     list     of     know     bugs      can      be      found      at
117       https://github.com/OSGeo/PROJ/issues  where new bug reports can be sub‐
118       mitted to.  Bugs specific to resource  files  should  be  submitted  to
119       https://github.com/OSGeo/PROJ-data/issues
120

HOME PAGE

122       https://proj.org/
123

AUTHOR

125       Even Rouault
126

128       1983-2020
129
130
131
132
1337.2.1                            Dec 25, 2020                      PROJSYNC(1)
Impressum