prg_geo_distances_to_degrees_convert()
Abstract
Converts a given distance on the Earth from linear units to degrees.
Syntax
prg_geo_distances_to_degrees_convert (longitude, latitude, x_dist, y_dist, units, long_degrees, lat_degrees)
| Argument | Type | Description |
|---|---|---|
longitude |
const double |
longitude of the first point (ignored) |
latitude |
const double |
latitude of the first point |
x_dist |
const double |
x distance |
y_dist |
const double |
y distance |
units |
const PrgT_Distance_Units_Type |
type of units to convert from (one of the values in Table 3 Geo Package Symbolic Constants) |
long_degrees |
double * |
area to hold x distance expressed as degrees of longitude |
lat_degrees |
double * |
area to hold y distance expressed as degrees of latitude |
Return Type
void
No return value.
Header
prg_geo.h
Details
For a given latitude, this function converts an x,y distance (in meters, kilometers, feet, or miles) to the corresponding longitudinal,latitudinal distance (in degrees). 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.