Search for regions (added by the application) located within the area defined by the latitude, longitude, and radius values.
geomonitor_error_t geomonitor_search_regions_by_location(double lat, double lon, double radius, region_names_list_t *region_names_list)
The latitude of the center of the search area. This is a value (in degrees) in the range [-90.0, 90.0].
The longitude of the center of the search area. This is a value (in degrees) in the range [-180, 180.0].
The radius (in meters) of the search area.
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)
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.
This function makes a service request that blocks until the service responds.
Last modified: 2014-05-14