<!--
{
  "availability" : [
    "MapKit JS: 5.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "MapKitJS",
  "identifier" : "/documentation/MapKitJS/Search",
  "metadataVersion" : "0.1.0",
  "role" : "Class",
  "symbol" : {
    "kind" : "Class",
    "modules" : [
      "MapKit JS"
    ],
    "preciseIdentifier" : "cl/mapkit.Search"
  },
  "title" : "Search"
}
-->

# Search

An object that retrieves map-based search results for a user-entered query.

```
class Search extends Service
```

## Overview

The search service lets you populate a map with results from a user-entered query, including information about businesses and other points of interest. MapKit JS handles this through a search object that makes network requests to the search service.

Supplying *search context* creates the most relevant results for a query. Context can include the user’s location, or a coordinate or region that you provide.

To use the search service, create an instance of a search object with the desired options. Use the search object to make search requests.

## Topics

### Creating a search

[`Search()`](/documentation/MapKitJS/Search/SearchConstructor)

Creates a search object with optional initial values that you provide.

[`SearchConstructorOptions`](/documentation/MapKitJS/SearchConstructorOptions)

Options you provide when you create a search object.

### Performing a search

[`search()`](/documentation/MapKitJS/Search/search)

Retrieves the results of a search query.

[`SearchDelegate`](/documentation/MapKitJS/SearchDelegate)

An object or callback function the framework calls when performing a search or an autocomplete request.

[`SearchOptions`](/documentation/MapKitJS/SearchOptions)

An object that contains options to adjust a search.

[`SearchResponse`](/documentation/MapKitJS/SearchResponse)

The result of a search, including the original search query, the bounding region, and a list of places that match the query.

### Performing a search autocomplete

[`autocomplete()`](/documentation/MapKitJS/Search/autocomplete)

Retrieves a list of autocomplete results for the specified search query.

[`SearchAutocompleteOptions`](/documentation/MapKitJS/SearchAutocompleteOptions)

Options you provide to constrain an autocomplete request.

[`SearchAutocompleteResponse`](/documentation/MapKitJS/SearchAutocompleteResponse)

An object containing the response from an autocomplete request.

[`SearchAutocompleteResult`](/documentation/MapKitJS/SearchAutocompleteResult)

The result of an autocomplete query, including display lines and a coordinate.

### Filtering a search

[`AddressFilter`](/documentation/MapKitJS/AddressFilter)

An object that filters which address options to include or exclude in search results.

### Deprecated

[`autocomplete()`](/documentation/MapKitJS/Search/autocomplete1)

Retrieves a list of autocomplete results for the specified search query.

[`cancel()`](/documentation/MapKitJS/Service/cancel)

Cancels a request using the provided request promise.

[`RegionPriority`](/documentation/MapKitJS/Search/RegionPriority-data.var)

A static property that allows you to access region priority enumeration.

[`search()`](/documentation/MapKitJS/Search/search1)

Retrieves the results of a search query.


---

Copyright &copy; 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)