1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
|
.. _projsync:
================================================================================
projsync
================================================================================
.. Index:: projsync
.. only:: html
.. versionadded:: 7.0.0
Tool for synchronizing PROJ datum and transformation support data.
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
***********
:program:`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 :ref:`networking capabilities <network>` of PROJ.
The following control parameters can appear in any order:
.. program:: projsync
.. option:: --endpoint URL
Defines the URL where to download the master ``files.geojson`` file and then
the resource files. Defaults to the value set in :ref:`proj-ini`
.. option:: --local-geojson-file FILENAME
Defines the filename for the master GeoJSON files that references resources.
Defaults to ${endpoint}/files.geojson
.. option:: --user-writable-directory
Specifies that resource files must be downloaded in the
:ref:`user writable directory <user_writable_directory>`. This is the default.
.. option:: --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.
.. option:: --target-dir DIRNAME
Directory into which resource files must be downloaded.
.. option:: --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.
.. option:: --spatial-test contains|intersects
Specify how the extent of the resource files
are compared to the area of use specified explicitly with :option:`--bbox`.
By default, any resource files whose extent intersects the value specified
by :option:`--bbox` will be selected.
If using the ``contains`` strategy, only resource files whose extent is
contained in the value specified by :option:`--bbox` will be selected.
.. option:: --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.
.. option:: --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.
.. option:: --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.
.. option:: --all
Ask to download all files.
.. option:: --exclude-world-coverage
Exclude files which have world coverage.
.. option:: -q / --quiet
Quiet mode
.. option:: --dry-run
Simulate the behavior of the tool without downloading resource files.
.. option:: --list-files
List file names, with the source_id and area_of_use properties.
At least one of :option:`--list-files`, :option:`--file`, :option:`--source-id`,
:option:`--area-of-use`, :option:`--bbox` or :option:`--all` must be specified.
Options :option:`--file`, :option:`--source-id`, :option:`--area-of-use` and
:option:`--bbox` are combined with a AND logic.
Examples
********
1. Download all resource files
.. code-block:: console
projsync --all
2. Download resource files covering specified point and attributing to an agency
.. code-block:: console
projsync --source-id fr_ign --bbox 2,49,2,49
.. only:: man
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 submitted to.
Bugs specific to resource files should be submitted to
https://github.com/OSGeo/PROJ-data/issues
Home page
*********
https://proj.org/
|
