Class

MKLocalSearchRequest

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

Declaration

@interface MKLocalSearchRequest : NSObject

Overview

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.

Topics

Initializing a Local Search Request

initWithCompletion:

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

Configuring the Search Parameters

naturalLanguageQuery

A string containing the desired search item.

region

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

Relationships

Inherits From

Conforms To

See Also

Creating a Search Request

initWithRequest:

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