manpagez: man pages & more
html files: geoclue
Home | html | info | man

GeoclueReverseGeocode

GeoclueReverseGeocode — Geoclue reverse geocode client API

Synopsis

#define             GEOCLUE_REVERSE_GEOCODE_INTERFACE_NAME
                    GeoclueReverseGeocode;
void                (*GeoclueReverseGeocodeCallback)    (GeoclueReverseGeocode *revgeocode,
                                                         GHashTable *details,
                                                         GeoclueAccuracy *accuracy,
                                                         GError *error,
                                                         gpointer userdata);
                    GeoclueReverseGeocodeClass;
GeoclueReverseGeocode * geoclue_reverse_geocode_new     (const char *service,
                                                         const char *path);
gboolean            geoclue_reverse_geocode_position_to_address
                                                        (GeoclueReverseGeocode *revgeocode,
                                                         double latitude,
                                                         double longitude,
                                                         GeoclueAccuracy *position_accuracy,
                                                         GHashTable **details,
                                                         GeoclueAccuracy **address_accuracy,
                                                         GError **error);
void                geoclue_reverse_geocode_position_to_address_async
                                                        (GeoclueReverseGeocode *revgeocode,
                                                         double latitude,
                                                         double longitude,
                                                         GeoclueAccuracy *accuracy,
                                                         GeoclueReverseGeocodeCallback callback,
                                                         gpointer userdata);

Object Hierarchy

  GObject
   +----GeoclueProvider
         +----GeoclueReverseGeocode

Description

GeoclueReverseGeocode contains reverse geocoding methods. It is part of the Geoclue public C client API which uses D-Bus to communicate with the actual provider.

After a GeoclueReverseGeocode is created with geoclue_reverse_geocode_new(), the geoclue_reverse_geocode_position_to_address() and geoclue_reverse_geocode_position_to_address_async() method can be used to obtain the address of a known position.

Details

GEOCLUE_REVERSE_GEOCODE_INTERFACE_NAME

#define GEOCLUE_REVERSE_GEOCODE_INTERFACE_NAME "org.freedesktop.Geoclue.ReverseGeocode"


GeoclueReverseGeocode

typedef struct _GeoclueReverseGeocode GeoclueReverseGeocode;


GeoclueReverseGeocodeCallback ()

void                (*GeoclueReverseGeocodeCallback)    (GeoclueReverseGeocode *revgeocode,
                                                         GHashTable *details,
                                                         GeoclueAccuracy *accuracy,
                                                         GError *error,
                                                         gpointer userdata);

Callback function for geoclue_reverse_geocode_position_to_address_async().

see geoclue-types.h for the hashtable keys used in details.

revgeocode :

A GeoclueReverseGeocode object

details :

Address details as GHashTable.

accuracy :

Accuracy of measurement as GeoclueAccuracy

error :

Error as Gerror (may be NULL)

userdata :

User data pointer set in geoclue_reverse_geocode_position_to_address_async()

GeoclueReverseGeocodeClass

typedef struct {
	GeoclueProviderClass provider_class;
} GeoclueReverseGeocodeClass;


geoclue_reverse_geocode_new ()

GeoclueReverseGeocode * geoclue_reverse_geocode_new     (const char *service,
                                                         const char *path);

Creates a GeoclueReverseGeocode with given D-Bus service name and path.

service :

D-Bus service name

path :

D-Bus path name

Returns :

Pointer to a new GeoclueReverseGeocode

geoclue_reverse_geocode_position_to_address ()

gboolean            geoclue_reverse_geocode_position_to_address
                                                        (GeoclueReverseGeocode *revgeocode,
                                                         double latitude,
                                                         double longitude,
                                                         GeoclueAccuracy *position_accuracy,
                                                         GHashTable **details,
                                                         GeoclueAccuracy **address_accuracy,
                                                         GError **error);

Obtains an address for the position defined by latitude and longitude. details is a GHashTable with the returned address data, see geoclue-types.h for the hashtable keys.

If the caller is not interested in some values, the pointers can be left NULL. If accuracy of the position is not known, an accuracy with GeoclueAccuracyLevel GEOCLUE_ACCURACY_DETAILED should be used.

latitude :

latitude in degrees

longitude :

longitude in degrees

position_accuracy :

Accuracy of the given latitude and longitude

details :

Pointer to returned GHashTable with address details or NULL

address_accuracy :

Pointer to accuracy of the returned address or NULL

error :

Pointer to returned Gerror or NULL

Returns :

TRUE if there is no error

geoclue_reverse_geocode_position_to_address_async ()

void                geoclue_reverse_geocode_position_to_address_async
                                                        (GeoclueReverseGeocode *revgeocode,
                                                         double latitude,
                                                         double longitude,
                                                         GeoclueAccuracy *accuracy,
                                                         GeoclueReverseGeocodeCallback callback,
                                                         gpointer userdata);

Function returns (essentially) immediately and calls callback when the reverse-geocoded address data is available or when D-Bus timeouts.

latitude :

Latitude in degrees

longitude :

Longitude in degrees

accuracy :

Accuracy of the given position as GeoclueAccuracy

callback :

A GeoclueAddressCallback function that should be called when return values are available

userdata :

pointer for user specified data
© manpagez.com 2000-2024
Individual documents may contain additional copyright information.