geomonitor_search_nearby_regions()

#include <geomonitor.h>
 

geomonitor_error_t geomonitor_search_nearby_regions(double radius, region_names_list_t *region_names_list)

Since:

BlackBerry 10.2.0

Arguments:

radius

The radius (in meters) of the search area.

region_names_list

The list of region names found. This parameter must be initialized to NULL when passed to this function. The calling code takes ownership of the list and must release it using geomonitor_region_names_list_destroy().

Library:

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

Description:

The list of region names is sorted by proximity to the current location. The search area is bounded by the given radius. The number of the regions found is capped and regions located furthest from the current location are not returned.

If the current location is unavailable, this function returns GEOMONITOR_CURRENT_LOCATION_NOT_AVAILABLE.

This function makes a service request that blocks until the service responds.

Returns:

GEOMONITOR_OK if successful, an error from geomonitor_error_t otherwise.