prg_geo_degrees_to_distances_convert()
Abstract
Converts a given distance on the Earth from degrees to linear units.
Syntax
prg_geo_degrees_to_distances_convert (longitude, latitude, long_degrees, lat_degrees, units, x_dist, y_dist)
| Argument | Type | Description |
|---|---|---|
longitude |
const double |
longitude of the first point (ignored) |
latitude |
const double |
latitude of the first point |
long_degrees |
const double |
longitudinal distance |
lat_degrees |
const double |
latitudinal distance |
units |
const PrgT_Distance_Units_Type |
type of units to convert to (one of the values in Table 3 Geo Package Symbolic Constants) |
x_dist |
double * |
area to hold the longitudinal distance expressed as linear units |
y_dist |
double * |
area to hold the latitudinal distance expressed as linear units |
Return Type
void
No return value.
Header
prg_geo.h
Details
For a given latitude, this function converts a distance given in longitudinal and latitudinal degrees to the corresponding x,y distance (in meters, kilometers, feet, or miles). This calculation accounts for the fact that the linear size of a longitudinal degree varies depending on latitude. Because this function does not deal with absolute positions, the longitude argument is not needed and is ignored.