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
|
.TH LIBTELLURIAN_DISTANCE 3 libtellurian
.SH NAME
libtellurian_distance \- Calculate distance between two locations
.SH SYNPOSIS
.ni
#include <libtellurian.h>
double libtellurian_distance(double \fIlatitude1\fP, double \fIlongitude1\fP,
double \fIlatitude2\fP, double \fIlongitude2\fP,
double *\fIazimuth1_out\fP, double *\fIazimuth2_out\fP);
double libtellurian_distance_radians(double \fIlatitude1\fP, double \fIlongitude1\fP,
double \fIlatitude2\fP, double \fIlongitude2\fP,
double *\fIazimuth1_out\fP, double *\fIazimuth2_out\fP);
void libtellurian_azimuth(double \fIlatitude1\fP, double \fIlongitude1\fP,
double \fIlatitude2\fP, double \fIlongitude2\fP,
double *\fIazimuth1_out\fP, double *\fIazimuth2_out\fP);
void libtellurian_azimuth_radians(double \fIlatitude1\fP, double \fIlongitude1\fP,
double \fIlatitude2\fP, double \fIlongitude2\fP,
double *\fIazimuth1_out\fP, double *\fIazimuth2_out\fP);
.fi
.PP
Link with
.I -ltellurian
.IR -lm .
.SH DESCRIPTION
The
.BR libtellurian_distance ()
function models the Earth as an oblate
spheroid and calculates a good approximate
distance between two locations
.RI ( latitude1 ", " longitude1 )
and
.RI ( latitude2 ", " longitude2 ),
along the ellipsoid.
.PP
The coordinates shall be specified according
to GPS and in degrees.
.PP
At negligible cost, the function can also
calculate the forward azimuths. The forward
azimuth for the first point will be calculated
and stored, in degrees, in
.I *azimuth1_out
unless
.I azimuth1_out
is
.IR NULL ,
and the forward azimuth for the second point
will be calculated and stored, in degress, in
.I *azimuth2_out
unless
.I azimuth2_out
is
.IR NULL .
.PP
The
.BR libtellurian_distance_radians ()
function is identical to the
.BR libtellurian_distance ()
function except that
.IR latitude1 ,
.IR longitude1 ,
.IR latitude2 ,
and
.I longitude2
shall be specified in radians, and
.I *azimuth1_out
and
.I *azimuth2_out
will be in radians.
.PP
The
.BR libtellurian_azimuth ()
and
.BR libtellurian_azimuth_radians ()
functions are identical to the
.BR libtellurian_distance ()
and
.BR libtellurian_distance_radians ()
functions, respectively, except that do not
calculate the distance between the points,
they only calculate the azimuths.
.SH RETURN VALUE
The
.BR libtellurian_distance ()
and
.BR libtellurian_distance_radians ()
functions return the distance, along the Earth's
surface, between the two points measured in
meters.
.PP
The
.BR libtellurian_azimuth ()
and
.BR libtellurian_azimuth_radians ()
functions do not return any value.
.SH ERRORS
None.
.SH SEE ALSO
.BR libtellurian (7),
.BR libtellurian_coarse_distance (3)
|
