| Top |
Functions
Types and Values
| struct | GeocodeLocation |
| struct | GeocodeLocationClass |
| enum | GeocodeLocationURIScheme |
| enum | GeocodeLocationCRS |
| #define | GEOCODE_LOCATION_ALTITUDE_UNKNOWN |
| #define | GEOCODE_LOCATION_ACCURACY_UNKNOWN |
| #define | GEOCODE_LOCATION_ACCURACY_STREET |
| #define | GEOCODE_LOCATION_ACCURACY_CITY |
| #define | GEOCODE_LOCATION_ACCURACY_REGION |
| #define | GEOCODE_LOCATION_ACCURACY_COUNTRY |
| #define | GEOCODE_LOCATION_ACCURACY_CONTINENT |
Object Hierarchy
GEnum
├── GeocodeLocationCRS
╰── GeocodeLocationURIScheme
GObject
╰── GeocodeLocation
Description
The GeocodeLocation instance represents a location on earth, with an optional description.
Functions
geocode_location_new ()
GeocodeLocation * geocode_location_new (gdouble latitude,gdouble longitude,gdouble accuracy);
Creates a new GeocodeLocation object.
geocode_location_new_with_description ()
GeocodeLocation * geocode_location_new_with_description (gdouble latitude,gdouble longitude,gdouble accuracy,const char *description);
Creates a new GeocodeLocation object.
geocode_location_set_from_uri ()
gboolean geocode_location_set_from_uri (GeocodeLocation *loc,const char *uri,GError **error);
Initialize a GeocodeLocation object with the given uri
.
geocode_location_to_uri ()
char * geocode_location_to_uri (GeocodeLocation *loc,GeocodeLocationURIScheme scheme);
Creates a URI representing loc
in the scheme specified in scheme
.
Returns
a URI representing the location. The returned string should be freed
with g_free() when no longer needed.
geocode_location_get_distance_from ()
double geocode_location_get_distance_from (GeocodeLocation *loca,GeocodeLocation *locb);
Calculates the distance in km, along the curvature of the Earth, between 2 locations. Note that altitude changes are not taken into account.
geocode_location_set_description ()
void geocode_location_set_description (GeocodeLocation *loc,const char *description);
Sets the description of loc
to description
.
geocode_location_get_description ()
const char *
geocode_location_get_description (GeocodeLocation *loc);
Gets the description of location loc
.
geocode_location_get_latitude ()
gdouble
geocode_location_get_latitude (GeocodeLocation *loc);
Gets the latitude of location loc
.
geocode_location_get_longitude ()
gdouble
geocode_location_get_longitude (GeocodeLocation *loc);
Gets the longitude of location loc
.
geocode_location_get_altitude ()
gdouble
geocode_location_get_altitude (GeocodeLocation *loc);
Gets the altitude of location loc
.
geocode_location_get_crs ()
GeocodeLocationCRS
geocode_location_get_crs (GeocodeLocation *loc);
Gets the Coordinate Reference System Identification of location loc
.
geocode_location_get_accuracy ()
gdouble
geocode_location_get_accuracy (GeocodeLocation *loc);
Gets the accuracy (in meters) of location loc
.
geocode_location_get_timestamp ()
guint64
geocode_location_get_timestamp (GeocodeLocation *loc);
Gets the timestamp (in seconds since Epoc) of location loc
.
Types and Values
struct GeocodeLocation
struct GeocodeLocation;
All the fields in the GeocodeLocation structure are private and should never be accessed directly.
struct GeocodeLocationClass
struct GeocodeLocationClass {
};
All the fields in the GeocodeLocationClass structure are private and should never be accessed directly.
GEOCODE_LOCATION_ALTITUDE_UNKNOWN
#define GEOCODE_LOCATION_ALTITUDE_UNKNOWN -G_MAXDOUBLE
Constant representing unknown altitude.
GEOCODE_LOCATION_ACCURACY_UNKNOWN
#define GEOCODE_LOCATION_ACCURACY_UNKNOWN -1
Constant representing unknown accuracy.
GEOCODE_LOCATION_ACCURACY_STREET
#define GEOCODE_LOCATION_ACCURACY_STREET 1000 /* 1 km */
Constant representing street-level accuracy.
GEOCODE_LOCATION_ACCURACY_CITY
#define GEOCODE_LOCATION_ACCURACY_CITY 15000 /* 15 km */
Constant representing city-level accuracy.
GEOCODE_LOCATION_ACCURACY_REGION
#define GEOCODE_LOCATION_ACCURACY_REGION 50000 /* 50 km */
Constant representing region-level accuracy.
GEOCODE_LOCATION_ACCURACY_COUNTRY
#define GEOCODE_LOCATION_ACCURACY_COUNTRY 300000 /* 300 km */
Constant representing country-level accuracy.
Property Details
The “accuracy” property
“accuracy” gdouble
The accuracy of this location in meters.
Flags: Read / Write
Allowed values: >= -1
Default value: -1
The “altitude” property
“altitude” gdouble
The altitude of this location in meters.
Flags: Read / Write
Default value: -1.79769e+308
The “crs” property
“crs” GeocodeLocationCRS
The Coordinate Reference System Identification of this location. Only the value 'wgs84' is currently valid.
Flags: Read / Write / Construct Only
Default value: GEOCODE_LOCATION_CRS_WGS84
The “description” property
“description” gchar *
The description of this location.
Flags: Read / Write
Default value: NULL
The “latitude” property
“latitude” gdouble
The latitude of this location in degrees.
Flags: Read / Write
Allowed values: [-90,90]
Default value: 0
The “longitude” property
“longitude” gdouble
The longitude of this location in degrees.
Flags: Read / Write
Allowed values: [-180,180]
Default value: 0
