<!--
{
  "availability" : [
    "iOS: 18.0.0 -",
    "iPadOS: 18.0.0 -",
    "macCatalyst: 18.0.0 -",
    "macOS: 15.0.0 -",
    "tvOS: 18.0.0 -",
    "visionOS: 2.0.0 -",
    "watchOS: 11.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "MapKit",
  "identifier" : "/documentation/MapKit/MKAddressFilter",
  "metadataVersion" : "0.1.0",
  "role" : "Class",
  "symbol" : {
    "kind" : "Class",
    "modules" : [
      "MapKit"
    ],
    "preciseIdentifier" : "c:objc(cs)MKAddressFilter"
  },
  "title" : "MKAddressFilter"
}
-->

# MKAddressFilter

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

```
class MKAddressFilter
```

## Overview

Use this object to filter search results by criteria, such as country, region, and municipality. See [`MKAddressFilter.Options`](/documentation/MapKit/MKAddressFilter/Options) for more information.

## Topics

### Creating a filter

[`-  initExcludingOptions:`](/documentation/MapKit/MKAddressFilter/init(excluding:))

Creates an address filter with options for excluding results in a search.

[`-  initIncludingOptions:`](/documentation/MapKit/MKAddressFilter/init(including:))

Creates an address filter with options for including results in a search.

### Filtering results

[`Options`](/documentation/MapKit/MKAddressFilter/Options)

A structure that contains options for filtering results in a search.

[`filterExcludingAll`](/documentation/MapKit/MKAddressFilter/excludingAll)

A list of categories to exclude from a search.

[`filterIncludingAll`](/documentation/MapKit/MKAddressFilter/includingAll)

A list of categories to include in a search.

[`-  excludesOptions:`](/documentation/MapKit/MKAddressFilter/excludes(_:))

Indicates whether options are excluded from filtering.

[`-  includesOptions:`](/documentation/MapKit/MKAddressFilter/includes(_:))

Indicates whether options are included for filtering.

## Relationships

### Conforms To

[`CustomStringConvertible`](/documentation/Swift/CustomStringConvertible)

[`NSSecureCoding`](/documentation/Foundation/NSSecureCoding)

[`CustomDebugStringConvertible`](/documentation/Swift/CustomDebugStringConvertible)

[`CVarArg`](/documentation/Swift/CVarArg)

[`NSCoding`](/documentation/Foundation/NSCoding)

[`Equatable`](/documentation/Swift/Equatable)

[`NSCopying`](/documentation/Foundation/NSCopying)

[`NSObjectProtocol`](/documentation/ObjectiveC/NSObjectProtocol)

[`Hashable`](/documentation/Swift/Hashable)

### Inherits From

[`NSObject-swift.class`](/documentation/ObjectiveC/NSObject-swift.class)

---

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)