geo_search_open()

Open the geo_search service.

Synopsis:

#include <geo_search.h>

geo_search_error_t geo_search_open(geo_search_handle_t *handle)

Since:

BlackBerry 10.0.0

Arguments:

handle: A geo_search handle

Library:

libgeo_search (For the qcc command, use the -l geo_search option to link against this library)

Description:

Opens the geo_search service and provides the corresponding handle. Any number of geocode and reverse geocode searches can be made using this handle.

You can open the geo_search service and check for errors as follows:

 geo_search_handle_t handle;
 geo_search_error_t error = geo_search_open( &handle );
 if ( error == GEO_SEARCH_OK ) {
     // do searches

     // only need to call if geo_search_open() succeeded.
     geo_search_close( &handle );
 }

Returns:

GEO_SEARCH_OK if successful. On error, returns one of the GEO_SEARCH_ERROR_SERVER_* values.