aboutsummaryrefslogtreecommitdiff
path: root/docs/source/apps/cs2cs.rst
diff options
context:
space:
mode:
Diffstat (limited to 'docs/source/apps/cs2cs.rst')
-rw-r--r--docs/source/apps/cs2cs.rst29
1 files changed, 27 insertions, 2 deletions
diff --git a/docs/source/apps/cs2cs.rst b/docs/source/apps/cs2cs.rst
index e214a5c0..7fe570d9 100644
--- a/docs/source/apps/cs2cs.rst
+++ b/docs/source/apps/cs2cs.rst
@@ -11,11 +11,15 @@ cs2cs
Synopsis
********
- **cs2cs** [**-eEfIlrstvwW** [args]] [*+opt[=arg]* ...] [+to *+opt[=arg]* ...] file ...
+ **cs2cs** [**-eEfIlrstvwW** [args]]
+ [[--area name_or_code] | [--bbox west_long,south_lat,east_long,north_lat]]
+ [*+opt[=arg]* ...] [+to *+opt[=arg]* ...] file ...
or
- **cs2cs** [**-eEfIlrstvwW** [args]] {source_crs} {target_crs} file ...
+ **cs2cs** [**-eEfIlrstvwW** [args]] [--area name_or_code]
+ [[--area name_or_code] | [--bbox west_long,south_lat,east_long,north_lat]]
+ {source_crs} {target_crs} file ...
where {source_crs} or {target_crs} is one of the possibilities accepted
by :c:func:`proj_create`, provided it expresses a CRS
@@ -144,6 +148,27 @@ The following control parameters can appear in any order:
Causes a listing of cartographic control parameters tested for and used by
the program to be printed prior to input data.
+.. option:: --area name_or_code
+
+ .. versionadded:: 8.0.0
+
+ Specify an area of interest to restrict the results when researching
+ coordinate operations between 2 CRS. The area of interest can be specified either
+ as a name (e.g "Denmark - onshore") or a AUTHORITY:CODE (EPSG:3237)
+
+ This option is mutually exclusive with :option:`--bbox`.
+
+.. option:: --bbox west_long,south_lat,east_long,north_lat
+
+ .. versionadded:: 8.0.0
+
+ Specify an area of interest to restrict the results when researching
+ coordinate operations between 2 CRS. 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.
.. only:: man