geocode-glib Reference Manual: GeocodeReverse

## GeocodeReverse GeocodeReverse — Geocode reverse geocoding object |

## Synopsis

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

    struct              GeocodeReverse;
    struct              GeocodeReverseClass;
    GeocodeReverse *    geocode_reverse_new_for_location    (GeocodeLocation *location);
    void                geocode_reverse_resolve_async       (GeocodeReverse *object,
                                                             GCancellable *cancellable,
                                                             GAsyncReadyCallback callback,
                                                             gpointer user_data);
    GeocodePlace *      geocode_reverse_resolve_finish      (GeocodeReverse *object,
                                                             GAsyncResult *res,
                                                             GError **error);
    GeocodePlace *      geocode_reverse_resolve             (GeocodeReverse *object,
                                                             GError **error);

## Object Hierarchy

      GObject
       +----GeocodeReverse

## Description

Contains functions for reverse geocoding using the OSM Nominatim APIs

## Details

### 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.

### 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.

`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.

`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()`.

`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.

`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]