| Top | Description | Object Hierarchy | |
|
|
|
#include <geocode-glib/geocode-glib.h> struct GeocodeForward; struct GeocodeForwardClass; GeocodeForward * geocode_forward_new_for_string (const char *str); GeocodeForward * geocode_forward_new_for_params (GHashTable *params); void geocode_forward_set_answer_count (GeocodeForward *forward,guint count); void geocode_forward_search_async (GeocodeForward *forward,GCancellable *cancellable,GAsyncReadyCallback callback,gpointer user_data); GList * geocode_forward_search_finish (GeocodeForward *forward,GAsyncResult *res,GError **error); GList * geocode_forward_search (GeocodeForward *forward,GError **error);
struct GeocodeForward;
All the fields in the GeocodeForward structure are private and should never be accessed directly.
struct GeocodeForwardClass {
};
All the fields in the GeocodeForwardClass structure are private and should never be accessed directly.
GeocodeForward * geocode_forward_new_for_string (const char *str);
Creates a new GeocodeForward to perform forward geocoding with. The string is in free-form format.
|
a string containing a free-form description of the location |
Returns : |
a new GeocodeForward. Use g_object_unref() when done. |
GeocodeForward * geocode_forward_new_for_params (GHashTable *params);
Creates a new GeocodeForward to perform geocoding with. The GHashTable is in the format used by Telepathy, and documented on Telepathy's specification site.
See also: XEP-0080 specification.
|
a GHashTable with string keys, and GValue values. [transfer none][element-type utf8 GValue] |
Returns : |
a new GeocodeForward. Use g_object_unref() when done. |
void geocode_forward_set_answer_count (GeocodeForward *forward,guint count);
Sets the number of requested results to count.
|
a GeocodeForward representing a query |
|
the number of requested results |
void geocode_forward_search_async (GeocodeForward *forward,GCancellable *cancellable,GAsyncReadyCallback callback,gpointer user_data);
Asynchronously performs a forward geocoding
query using a web service. Use geocode_forward_search() to do the same
thing synchronously.
When the operation is finished, callback will be called. You can then call
geocode_forward_search_finish() to get the result of the operation.
|
a GeocodeForward representing a query |
|
optional GCancellable forward, NULL to ignore. |
|
a GAsyncReadyCallback to call when the request is satisfied |
|
the data to pass to callback function |
GList * geocode_forward_search_finish (GeocodeForward *forward,GAsyncResult *res,GError **error);
Finishes a forward geocoding operation. See geocode_forward_search_async().
|
a GeocodeForward representing a query |
|
a GAsyncResult. |
|
a GError. |
Returns : |
A list of
places or NULL in case of errors. Free the returned list with
g_list_free() when done. [element-type GeocodePlace][transfer container]
|
GList * geocode_forward_search (GeocodeForward *forward,GError **error);
Gets the result of a forward geocoding query using a web service.
|
a GeocodeForward representing a query |
|
a GError |
Returns : |
A list of
places or NULL in case of errors. Free the returned list with
g_list_free() when done. [element-type GeocodePlace][transfer container]
|