GeocodeReverse

GeocodeReverse — Geocode reverse geocoding object

Types and Values

Object Hierarchy

    GObject
    ╰── GeocodeReverse

Includes

#include <geocode-glib/geocode-glib.h>

Description

Contains functions for reverse geocoding using the

OSM Nominatim APIs

Functions

geocode_reverse_new_for_location ()

GeocodeReverse *
geocode_reverse_new_for_location (GeocodeLocation *location);

Creates a new GeocodeReverse to perform reverse geocoding with. Use geocode_reverse_resolve_async() to perform the resolution.

Parameters

location

a GeocodeLocation object

 

Returns

a new GeocodeReverse. Use g_object_unref() when done.


geocode_reverse_resolve_async ()

void
geocode_reverse_resolve_async (GeocodeReverse *object,
                               GCancellable *cancellable,
                               GAsyncReadyCallback callback,
                               gpointer user_data);

Asynchronously gets the result of a reverse geocoding query using a web service. Use geocode_reverse_resolve() to do the same thing synchronously.

When the operation is finished, callback will be called. You can then call geocode_reverse_resolve_finish() to get the result of the operation.

Parameters

object

a GeocodeReverse representing a query

 

cancellable

optional GCancellable object, NULL to ignore.

 

callback

a GAsyncReadyCallback to call when the request is satisfied

 

user_data

the data to pass to callback function

 

geocode_reverse_resolve_finish ()

GeocodePlace *
geocode_reverse_resolve_finish (GeocodeReverse *object,
                                GAsyncResult *res,
                                GError **error);

Finishes a reverse geocoding operation. See geocode_reverse_resolve_async().

Parameters

object

a GeocodeReverse representing a query

 

res

a GAsyncResult.

 

error

a GError.

 

Returns

A GeocodePlace instance, or NULL in case of errors. Free the returned instance with g_object_unref() when done.

[transfer full]


geocode_reverse_resolve ()

GeocodePlace *
geocode_reverse_resolve (GeocodeReverse *object,
                         GError **error);

Gets the result of a reverse geocoding query using a web service.

Parameters

object

a GeocodeReverse representing a query

 

error

a GError

 

Returns

A GeocodePlace instance, or NULL in case of errors. Free the returned instance with g_object_unref() when done.

[transfer full]

Types and Values

struct GeocodeReverse

struct GeocodeReverse;

All the fields in the GeocodeReverse structure are private and should never be accessed directly.


struct GeocodeReverseClass

struct GeocodeReverseClass {
};

All the fields in the GeocodeReverseClass structure are private and should never be accessed directly.