projsync(1)

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 | --verbose] [--dry-run] [--list-files]
19            [--no-version-filtering]
20
21

DESCRIPTION

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

EXAMPLES

121       1. Download all resource files
122
123          projsync --all
124
125       2. Download resource files covering specified point and attributing  to
126          an agency
127
128          projsync --source-id fr_ign --bbox 2,49,2,49
129

BUGS

134       A      list      of      known     bugs     can     be     found     at
135       https://github.com/OSGeo/PROJ/issues where new bug reports can be  sub‐
136       mitted  to.   Bugs  specific  to  resource files should be submitted to
137       https://github.com/OSGeo/PROJ-data/issues
138

HOME PAGE

140       https://proj.org/
141

AUTHOR

143       Even Rouault
144

COPYRIGHT

146       1983-2021
147
148
149
150
1518.2.1                             Jan 1, 2022                      PROJSYNC(1)