| Top | Description | Object Hierarchy | Properties |  |  |  |  | 
#include <geocode-glib/geocode-glib.h> struct GeocodeLocation; struct GeocodeLocationClass; #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 GeocodeLocation * geocode_location_new (gdouble latitude,gdouble longitude,gdouble accuracy); GeocodeLocation * geocode_location_new_with_description (gdouble latitude,gdouble longitude,gdouble accuracy,const char *description); double geocode_location_get_distance_from (GeocodeLocation *loca,GeocodeLocation *locb); void geocode_location_set_description (GeocodeLocation *loc,const char *description); const char * geocode_location_get_description (GeocodeLocation *loc); gdouble geocode_location_get_latitude (GeocodeLocation *loc); gdouble geocode_location_get_longitude (GeocodeLocation *loc); gdouble geocode_location_get_accuracy (GeocodeLocation *loc); guint64 geocode_location_get_timestamp (GeocodeLocation *loc);
"accuracy" gdouble : Read / Write "description" gchar* : Read / Write "latitude" gdouble : Read / Write "longitude" gdouble : Read / Write "timestamp" guint64 : Read
The GeocodeLocation instance represents a location on earth, with an optional description.
struct GeocodeLocation;
All the fields in the GeocodeLocation structure are private and should never be accessed directly.
struct GeocodeLocationClass {
};
All the fields in the GeocodeLocationClass structure are private and should never be accessed directly.
#define GEOCODE_LOCATION_ACCURACY_UNKNOWN -1
Constant representing unknown accuracy.
#define GEOCODE_LOCATION_ACCURACY_STREET 1000 /* 1 km */
Constant representing street-level accuracy.
#define GEOCODE_LOCATION_ACCURACY_CITY 15000 /* 15 km */
Constant representing city-level accuracy.
#define GEOCODE_LOCATION_ACCURACY_REGION 50000 /* 50 km */
Constant representing region-level accuracy.
#define GEOCODE_LOCATION_ACCURACY_COUNTRY 300000 /* 300 km */
Constant representing country-level accuracy.
#define GEOCODE_LOCATION_ACCURACY_CONTINENT 3000000 /* 3000 km */
Constant representing continent-level accuracy.
GeocodeLocation * geocode_location_new (gdouble latitude,gdouble longitude,gdouble accuracy);
Creates a new GeocodeLocation object.
| 
 | a valid latitude | 
| 
 | a valid longitude | 
| 
 | accuracy of location in meters | 
| Returns : | a new GeocodeLocation object. Use g_object_unref()when done. | 
GeocodeLocation * geocode_location_new_with_description (gdouble latitude,gdouble longitude,gdouble accuracy,const char *description);
Creates a new GeocodeLocation object.
| 
 | a valid latitude | 
| 
 | a valid longitude | 
| 
 | accuracy of location in meters | 
| 
 | a description for the location | 
| Returns : | a new GeocodeLocation object. Use g_object_unref()when done. | 
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.
| 
 | a GeocodeLocation | 
| 
 | a GeocodeLocation | 
| Returns : | a distance in km. | 
void geocode_location_set_description (GeocodeLocation *loc,const char *description);
Sets the description of loc to description.
| 
 | a GeocodeLocation | 
| 
 | a description for the location | 
const char *        geocode_location_get_description    (GeocodeLocation *loc);
Gets the description of location loc.
| 
 | a GeocodeLocation | 
| Returns : | The description of location loc. | 
gdouble             geocode_location_get_latitude       (GeocodeLocation *loc);
Gets the latitude of location loc.
| 
 | a GeocodeLocation | 
| Returns : | The latitude of location loc. | 
gdouble             geocode_location_get_longitude      (GeocodeLocation *loc);
Gets the longitude of location loc.
| 
 | a GeocodeLocation | 
| Returns : | The longitude of location loc. | 
gdouble             geocode_location_get_accuracy       (GeocodeLocation *loc);
Gets the accuracy (in meters) of location loc.
| 
 | a GeocodeLocation | 
| Returns : | The accuracy of location loc. | 
guint64             geocode_location_get_timestamp      (GeocodeLocation *loc);
Gets the timestamp (in seconds since Epoc) of location loc.
| 
 | a GeocodeLocation | 
| Returns : | The timestamp of location loc. | 
"accuracy" property  "accuracy"                 gdouble               : Read / Write
The accuracy of this location in meters.
Allowed values: >= -1
Default value: -1
"description" property  "description"              gchar*                : Read / Write
The description of this location.
Default value: NULL
"latitude" property  "latitude"                 gdouble               : Read / Write
The latitude of this location in degrees.
Allowed values: [-90,90]
Default value: 0
"longitude" property  "longitude"                gdouble               : Read / Write
The longitude of this location in degrees.
Allowed values: [-180,180]
Default value: 0
"timestamp" property  "timestamp"                guint64               : Read
A timestamp in seconds since Epoch.
Allowed values: <= G_MAXINT64
Default value: 0