![]() |
![]() |
![]() |
geocode-glib Reference Manual | ![]() |
---|---|---|---|---|
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 / Construct Only "description" gchar* : Read / Write "latitude" gdouble : Read / Write / Construct Only "longitude" gdouble : Read / Write / Construct Only "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_CONTINENT 3000000 /* 3000 km */
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 description for the location |
const char * geocode_location_get_description (GeocodeLocation *loc
);
"accuracy"
property "accuracy" gdouble : Read / Write / Construct Only
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 / Construct Only
The latitude of this location in degrees.
Allowed values: [-90,90]
Default value: 0
"longitude"
property "longitude" gdouble : Read / Write / Construct Only
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