geo_search_boundary

The boundary defines the level of specificity desired for a reverse geocoding search.

Synopsis:

#include <geo_search.h>

typedef enum {
      GEO_SEARCH_BOUNDARY_NONE = 0   
      GEO_SEARCH_BOUNDARY_ADDRESS = 1   
      GEO_SEARCH_BOUNDARY_COUNTRY = 2   
      GEO_SEARCH_BOUNDARY_PROVINCE = 3   
      GEO_SEARCH_BOUNDARY_CITY = 4   
      GEO_SEARCH_BOUNDARY_POSTAL = 5   
      GEO_SEARCH_BOUNDARY_MCC = 6   
      GEO_SEARCH_BOUNDARY_TIMEZONE = 7   
} geo_search_boundary_t;

Since:

BlackBerry 10.0.0

Data:

GEO_SEARCH_BOUNDARY_NONE: Represents an invalid search boundary.; It is applicable only for geo_search_boundary_next() and geo_search_boundary_valid().

GEO_SEARCH_BOUNDARY_ADDRESS: Specifies that the address nearest to the geographic point is to be searched for.

GEO_SEARCH_BOUNDARY_COUNTRY: Specifies that the country containing the geographic point is to be searched for.

GEO_SEARCH_BOUNDARY_PROVINCE: Specifies that the state or province containing the geographic point is to be searched for.

GEO_SEARCH_BOUNDARY_CITY: Specifies that the city containing the geographic point is to be searched for.

GEO_SEARCH_BOUNDARY_POSTAL: Specifies that the postal code corresponding to the geographic point is to be searched for.

GEO_SEARCH_BOUNDARY_MCC: Specifies that the mobile country code coresponding to the geographic point is to be searched for.

GEO_SEARCH_BOUNDARY_TIMEZONE: Specifies that the time zone coresponding to the geographic point is to be searched for.

Library:

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

Description:

For reverse geocoding, the desired location may be the nearest street address or simply the city within which the geographic coordinate lies. Use the boundary to indicate this level of specificity.

Note that for less specific boundaries, such as city and country, the search results may be cached. This means that network access may not be required for subsequent reverse geocoding searches, for neighbouring geographic coordinates.