diff options
| author | Kristian Evers <kristianevers@gmail.com> | 2021-03-10 20:08:13 +0100 |
|---|---|---|
| committer | Kristian Evers <kristianevers@gmail.com> | 2021-03-10 20:08:13 +0100 |
| commit | 77d6e671abcacfe129c2e5b1c30a2965e546d476 (patch) | |
| tree | d829e496669f83b31c3cfc335f10b84e9a8152c2 /docs/source | |
| parent | e6b20d968aa358e9863dd5939976368054a51715 (diff) | |
| download | PROJ-77d6e671abcacfe129c2e5b1c30a2965e546d476.tar.gz PROJ-77d6e671abcacfe129c2e5b1c30a2965e546d476.zip | |
Improve docs for geodesic distance functions in proj.h
Diffstat (limited to 'docs/source')
| -rw-r--r-- | docs/source/development/reference/functions.rst | 37 |
1 files changed, 35 insertions, 2 deletions
diff --git a/docs/source/development/reference/functions.rst b/docs/source/development/reference/functions.rst index d06179f3..edb61b08 100644 --- a/docs/source/development/reference/functions.rst +++ b/docs/source/development/reference/functions.rst @@ -623,7 +623,13 @@ Distances Calculate geodesic distance between two points in geodetic coordinates. The calculated distance is between the two points located on the ellipsoid. - :param P: Transformation object + The coordinates in :c:data:`a` and :c:data:`b` needs to be given as longitude + and latitude in radians. Note that the axis order of the :c:data:`P` object + is not taken into account in this function, so even though a CRS object comes + with axis ordering latitude/longitude coordinates used in this function should + be reordered as longitude/latitude. + + :param P: Transformation or CRS object :type P: const :c:type:`PJ` * :param PJ_COORD a: Coordinate of first point :param PJ_COORD b: Coordinate of second point @@ -635,7 +641,13 @@ Distances Similar to :c:func:`proj_lp_dist` but also takes the height above the ellipsoid into account. - :param P: Transformation object + The coordinates in :c:data:`a` and :c:data:`b` needs to be given as longitude + and latitude in radians. Note that the axis order of the :c:data:`P` object + is not taken into account in this function, so even though a CRS object comes + with axis ordering latitude/longitude coordinates used in this function should + be reordered as longitude/latitude. + + :param P: Transformation or CRS object :type P: const :c:type:`PJ` * :param PJ_COORD a: Coordinate of first point :param PJ_COORD b: Coordinate of second point @@ -657,6 +669,27 @@ Distances :param PJ_COORD b: Second coordinate :returns: `double` Distance between :c:data:`a` and :c:data:`b` in meters. +.. c:function:: PJ_COORD proj_geod(const PJ *P, PJ_COORD a, PJ_COORD b) + + Calculate the geodesic distance as well as forward and reverse azimuth + between two points on the ellipsoid. + + The coordinates in :c:data:`a` and :c:data:`b` needs to be given as longitude + and latitude in radians. Note that the axis order of the :c:data:`P` object + is not taken into account in this function, so even though a CRS object comes + with axis ordering latitude/longitude coordinates used in this function should + be reordered as longitude/latitude. + + :param P: Transformation or CRS object + :type P: const :c:type:`PJ` * + :param PJ_COORD a: Coordinate of first point + :param PJ_COORD b: Coordinate of second point + :returns: `PJ_COORD` where the first value is the distance between :c:data:`a` + and :c:data:`b` in meters, the second value is the forward azimuth + and the thir value is the reverse azimuth. The fourth coordinate + value is unused. + + Various ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ |