| 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, NULLto 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 NULLin case of errors. Free the returned list withg_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 NULLin case of errors. Free the returned list withg_list_free()when done. [element-type GeocodePlace][transfer container] |