geomonitor_search_regions_by_location()

Search for regions (added by the application) located within the area defined by the latitude, longitude, and radius values.

Synopsis:

#include <geomonitor.h>
 
geomonitor_error_t geomonitor_search_regions_by_location(double lat, double lon, double radius, region_names_list_t *region_names_list)

Since:

BlackBerry 10.2.0

Arguments:

lat

The latitude of the center of the search area. This is a value (in degrees) in the range [-90.0, 90.0].

lon

The longitude of the center of the search area. This is a value (in degrees) in the range [-180, 180.0].

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.

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

Returns:

GEOMONITOR_OK if successful, an error from geomonitor_error_t otherwise.

Last modified: 2014-05-14



Got questions about leaving a comment? Get answers from our Disqus FAQ.

comments powered by Disqus