FBPlacePickerViewController
This class is no longer available in the most recent version of the SDK.
A more recent version of this class is available. Check out the latest version.

The FBPlacePickerViewController class creates a controller object that manages the user interface for displaying and selecting nearby places.

Discussion:

When the FBPlacePickerViewController view loads it creates a UITableView object where the places near a given location will be displayed. You can access this view through the tableView property.

The place data can be pre-fetched and cached prior to using the view controller. The cache is setup using an FBCacheDescriptor object that can trigger the data fetch. Any place data requests will first check the cache and use that data. If the place picker is being displayed cached data will initially be shown before a fresh copy is retrieved.

The delegate property may be set to an object that conforms to the FBPlacePickerDelegate protocol. The delegate object will receive updates related to place selection and data changes. The delegate can also be used to filter the places to display in the picker.

Inherits from:FBGraphObjectPickerViewController
Declared in:FBPlacePickerViewController.h
Properties
locationCoordinate

The coordinates to use for place discovery.

@property (nonatomic) CLLocationCoordinate2D locationCoordinate;
radiusInMeters

The radius to use for place discovery.

@property (nonatomic) NSInteger radiusInMeters;
resultsLimit

The maximum number of places to fetch.

@property (nonatomic) NSInteger resultsLimit;
searchText

The search words used to narrow down the results returned.

@property (nonatomic, copy) NSString *searchText;
selection

The place that is currently selected in the view. This is nil if nothing is selected.

@property (nonatomic, retain, readonly) id<FBGraphPlace> selection;
Class Methods
cacheDescriptorWithLocationCoordinate:radiusInMeters:searchText:resultsLimit:fieldsForRequest:

Creates a cache descriptor with additional fields and a profile ID for use with the FBPlacePickerViewController object.

ParameterDescription
locationCoordinate

The coordinates to use for place discovery.

radiusInMeters

The radius to use for place discovery.

searchText

The search words used to narrow down the results returned.

resultsLimit

The maximum number of places to fetch.

fieldsForRequest

Addtional fields to fetch when making the Graph API call to get place data.

+ (FBCacheDescriptor *)
cacheDescriptorWithLocationCoordinate
CLLocationCoordinate
D
locationCoordinate
radiusInMeters: (NSInteger)radiusInMeters
searchText: (NSString *)searchText
resultsLimit: (NSInteger)resultsLimit
fieldsForRequest: (NSSet *)fieldsForRequest;
Discussion:

An FBCacheDescriptor object may be used to pre-fetch data before it is used by the view controller. It may also be used to configure the FBPlacePickerViewController object.

Instance Methods
configureUsingCachedDescriptor:

Configures the properties used in the caching data queries.

ParameterDescription
cacheDescriptor

The containing the cache query properties.

- (void) configureUsingCachedDescriptor:(FBCacheDescriptor *)cacheDescriptor;
Discussion:

Cache descriptors are used to fetch and cache the data used by the view controller. If the view controller finds a cached copy of the data, it will first display the cached content then fetch a fresh copy from the server.