Top |
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.
geocode_reverse_set_backend ()
void geocode_reverse_set_backend (GeocodeReverse *object
,GeocodeBackend *backend
);
Specifies the backend to use in the reverse geocoding operation.
If none is given, the default GNOME Nominatim server is used.
Parameters
object |
a GeocodeReverse representing a query |
|
backend |
a GeocodeBackend, or |
[nullable] |
Since: 3.23.1
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, |
|
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()
.
Returns
A GeocodePlace instance, or NULL
in case of
errors. Free the returned instance with
when done. g_object_unref()
[transfer full]
geocode_reverse_resolve ()
GeocodePlace * geocode_reverse_resolve (GeocodeReverse *object
,GError **error
);
Gets the result of a reverse geocoding
query using the current backend (see geocode_reverse_set_backend()
). By
default the GNOME Nominatim server is used. See GeocodeBackend for more
information.
If no result could be found, a GEOCODE_ERROR_NOT_SUPPORTED
error will be
returned. This typically happens if the coordinates to geocode are in the
middle of the ocean.
Returns
A GeocodePlace instance, or NULL
in case of
errors. Free the returned instance with
when done. g_object_unref()
[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.