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_equal ()

gboolean
geocode_location_equal (GeocodeLocation *a,
                        GeocodeLocation *b);

Compare two GeocodeLocation instances for equality. This compares all fields and only returns TRUE if the instances are exactly equal. For example, if both locations have the same physical coordinates, but one location has its “description” property set and the other does not, FALSE will be returned. Similarly, if both locations have the same “latitude”, “longitude” and “altitude”, but a different “accuracy” or “timestamp”, FALSE will be returned. Or if both locations have the same“latitude” and “longitude” but a different “altitude”, FALSE will be returned.

Both instances must be non-NULL.

Since: 3.23.1

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