| Top |
| GeocodeLocation * | geocode_location_new () |
| GeocodeLocation * | geocode_location_new_with_description () |
| gboolean | geocode_location_set_from_uri () |
| char * | geocode_location_to_uri () |
| double | geocode_location_get_distance_from () |
| void | geocode_location_set_description () |
| const char * | geocode_location_get_description () |
| gdouble | geocode_location_get_latitude () |
| gdouble | geocode_location_get_longitude () |
| gdouble | geocode_location_get_altitude () |
| GeocodeLocationCRS | geocode_location_get_crs () |
| gdouble | geocode_location_get_accuracy () |
| guint64 | geocode_location_get_timestamp () |
| gdouble | accuracy | Read / Write |
| gdouble | altitude | Read / Write |
| GeocodeLocationCRS | crs | Read / Write / Construct Only |
| gchar * | description | Read / Write |
| gdouble | latitude | Read / Write |
| gdouble | longitude | Read / Write |
| guint64 | timestamp | Read / Write / Construct Only |
| 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 |
GEnum ├── GeocodeLocationCRS ╰── GeocodeLocationURIScheme GObject ╰── GeocodeLocation
The GeocodeLocation instance represents a location on earth, with an optional description.
GeocodeLocation * geocode_location_new (gdouble latitude,gdouble longitude,gdouble accuracy);
Creates a new GeocodeLocation object.
GeocodeLocation * geocode_location_new_with_description (gdouble latitude,gdouble longitude,gdouble accuracy,const char *description);
Creates a new GeocodeLocation object.
gboolean geocode_location_set_from_uri (GeocodeLocation *loc,const char *uri,GError **error);
Initialize a GeocodeLocation object with the given uri
.
The URI should be in the geo scheme (RFC 5870) which in its simplest form looks like:
geo:latitude,longitude
An Android extension to set a description is also supported in the form of:
geo:0,0?q=latitude,longitude(description)
char * geocode_location_to_uri (GeocodeLocation *loc,GeocodeLocationURIScheme scheme);
Creates a URI representing loc
in the scheme specified in scheme
.
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.
void geocode_location_set_description (GeocodeLocation *loc,const char *description);
Sets the description of loc
to description
.
const char *
geocode_location_get_description (GeocodeLocation *loc);
Gets the description of location loc
.
gdouble
geocode_location_get_latitude (GeocodeLocation *loc);
Gets the latitude of location loc
.
gdouble
geocode_location_get_longitude (GeocodeLocation *loc);
Gets the longitude of location loc
.
gdouble
geocode_location_get_altitude (GeocodeLocation *loc);
Gets the altitude of location loc
.
GeocodeLocationCRS
geocode_location_get_crs (GeocodeLocation *loc);
Gets the Coordinate Reference System Identification of location loc
.
gdouble
geocode_location_get_accuracy (GeocodeLocation *loc);
Gets the accuracy (in meters) of location loc
.
guint64
geocode_location_get_timestamp (GeocodeLocation *loc);
Gets the timestamp (in seconds since Epoc) of location loc
.
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_ALTITUDE_UNKNOWN -G_MAXDOUBLE
Constant representing unknown altitude.
#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.
“accuracy” property “accuracy” gdouble
The accuracy of this location in meters.
Flags: Read / Write
Allowed values: >= -1
Default value: -1
“altitude” property “altitude” gdouble
The altitude of this location in meters.
Flags: Read / Write
Default value: -1.79769e+308
“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
“description” property “description” gchar *
The description of this location.
Flags: Read / Write
Default value: NULL
“latitude” property “latitude” gdouble
The latitude of this location in degrees.
Flags: Read / Write
Allowed values: [-90,90]
Default value: 0
“longitude” property “longitude” gdouble
The longitude of this location in degrees.
Flags: Read / Write
Allowed values: [-180,180]
Default value: 0
“timestamp” property “timestamp” guint64
A timestamp in seconds since
Epoch.A value of 0 (zero) will be interpreted as the current time.
Flags: Read / Write / Construct Only
Allowed values: <= G_MAXINT64
Default value: 0