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 .

The URI should be in the geo scheme (RFC 5870) which in its simplest form looks like:

An Android extension to set a description is also supported in the form of:

geocode_location_to_uri ()

char *
geocode_location_to_uri (GeocodeLocation *loc,
                         GeocodeLocationURIScheme scheme);

Creates a URI representing loc in the scheme specified in scheme .

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 the Epoch) of location loc . See “timestamp”.

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.

enum GeocodeLocationURIScheme

The URI scheme for this location.

enum GeocodeLocationCRS

Coordinate Reference System Identification for a location.

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.

GEOCODE_LOCATION_ACCURACY_CONTINENT

#define GEOCODE_LOCATION_ACCURACY_CONTINENT 3000000 /* 3000 km */

Constant representing continent-level accuracy.

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

The “timestamp” property

  “timestamp”                guint64

A timestamp in seconds since

giving when the location was resolved from an address.

A value of 0 (zero) will be interpreted as the current time.

Flags: Read / Write / Construct Only

Allowed values: <= G_MAXINT64

Default value: 0