geomonitor_add()

Add a region to the list of monitored regions.

Synopsis:

#include <geomonitor.h>

geomonitor_error_t geomonitor_add(geomonitor_region_t region)

Since:

BlackBerry 10.2.0

Arguments:

region: The region to add to the list of monitored regions.

Library:

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

Description:

The region is stored and monitored until:

it is explicitly removed by the originate application,
the originating application is uninstalled,
the region expires, or
the originating application is running and has at least one initialized geomonitor service handle (in case region monitoring mode is set to GEOMONITOR_MONITORING_MODE_TRANSIENT).

The region is monitored from the time it is added to the list.

When you add a region to the list of monitored regions, this function makes a service request and blocks until the service responds.

Returns:

GEOMONITOR_OK if successful, an error from geomonitor_error_t otherwise.