The parameters to use when searching for points of interest on the map.


@interface MKLocalSearchRequest : NSObject


You create an MKLocalSearchRequest object when you want to search for map locations based on a natural language string. For example, if your interface allows the user to type in addresses, you would place the typed text in this object and pass it to an MKLocalSearch object to begin the search process. When specifying your search strings, include a map region to narrow the search results to the specified geographical area.

When creating an MKLocalSearchRequest object yourself, set the naturalLanguageQuery property to an appropriate search string, as in the following example:

MKLocalSearchRequest* request = [[MKLocalSearchRequest alloc] init];
request.naturalLanguageQuery = @"coffee";
// Set the region to an associated map view's region
request.region = myMapView.region;

If your app uses an MKLocalSearchCompleter object to implement auto-complete support for user-supplied search strings, initialize your search request using the search completion selected by the user. In that case, use the initWithCompletion: method to initialize your search request object instead of the init method. The completion object automatically provides the value for the naturalLanguageQuery property.


Initializing a Local Search Request

- initWithCompletion:

Initializes and returns a search request based on the specified search completion data.

Configuring the Search Parameters


A string containing the desired search item.


A map region that provides a hint as to where to search.


A filter that lists point of interest categories to include or exclude in search results.


The types of items to include in the search results.



Inherits From

Conforms To

See Also

Creating a Search Request

- initWithRequest:

Initializes and returns a search object configured with the specified parameters.


Options that indicate types of search results.