<!--
{
  "availability" : [
    "iOS: 26.0.0 -",
    "iPadOS: 26.0.0 -",
    "macCatalyst: 26.0.0 -",
    "macOS: 26.0.0 -",
    "tvOS: 26.0.0 -",
    "visionOS: 26.0.0 -",
    "watchOS: 26.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "DataDetection",
  "identifier" : "/documentation/DataDetection/DataDetector/Match/SemanticDetails/PostalAddress",
  "metadataVersion" : "0.1.0",
  "role" : "Structure",
  "symbol" : {
    "kind" : "Structure",
    "modules" : [
      "DataDetection"
    ],
    "preciseIdentifier" : "s:13DataDetection0A8DetectorO5MatchV15SemanticDetailsO13PostalAddressV"
  },
  "title" : "DataDetector.Match.SemanticDetails.PostalAddress"
}
-->

# DataDetector.Match.SemanticDetails.PostalAddress

A match that the data detector determines represents a postal address.

```
struct PostalAddress
```

## Discussion

The data detector attempts to populate as much of the postal address as possible. The properties the detector supports include:

- [`fullAddress`](/documentation/DataDetection/DataDetector/Match/SemanticDetails/PostalAddress/fullAddress) contains the full string of the address and may contain more than just the sum of the individual components.
- [`street`](/documentation/DataDetection/DataDetector/Match/SemanticDetails/PostalAddress/street) may contain the street component of the address.
- [`city`](/documentation/DataDetection/DataDetector/Match/SemanticDetails/PostalAddress/city) may contain the city component of the address.
- [`state`](/documentation/DataDetection/DataDetector/Match/SemanticDetails/PostalAddress/state) may contain the state component of the address.
- [`postalCode`](/documentation/DataDetection/DataDetector/Match/SemanticDetails/PostalAddress/postalCode) may contain the postal code component of the address.
- [`region`](/documentation/DataDetection/DataDetector/Match/SemanticDetails/PostalAddress/region) may contain the region component of the address, for example, United States or France.
- [`regionCode`](/documentation/DataDetection/DataDetector/Match/SemanticDetails/PostalAddress/regionCode) may contain the ISO region code of the address.
- [`label`](/documentation/DataDetection/DataDetector/Match/SemanticDetails/PostalAddress/label) may contain a value suitable to populate a label when creating a contact.

## Topics

### Properties that detail parts of a postal address

[`let fullAddress: String`](/documentation/DataDetection/DataDetector/Match/SemanticDetails/PostalAddress/fullAddress)

A string that contains the full string of the address.

[`let street: String?`](/documentation/DataDetection/DataDetector/Match/SemanticDetails/PostalAddress/street)

An optional string that may contain the street component of the address.

[`let city: String?`](/documentation/DataDetection/DataDetector/Match/SemanticDetails/PostalAddress/city)

An optional string that may contain the city component of the address.

[`let state: String?`](/documentation/DataDetection/DataDetector/Match/SemanticDetails/PostalAddress/state)

An optional string that may contain the state component of the address.

[`let postalCode: String?`](/documentation/DataDetection/DataDetector/Match/SemanticDetails/PostalAddress/postalCode)

An optional string that may contain the postal code component of the address.

[`let region: String?`](/documentation/DataDetection/DataDetector/Match/SemanticDetails/PostalAddress/region)

An optional string that may contain the region component of the address.

[`let regionCode: Locale.Region?`](/documentation/DataDetection/DataDetector/Match/SemanticDetails/PostalAddress/regionCode)

An optional string that may contain the standard ISO 3166 region code of the address.

[`let label: String?`](/documentation/DataDetection/DataDetector/Match/SemanticDetails/PostalAddress/label)

An optional string that may contain a value suitable to populate a label when creating a contact.

## Relationships

### Conforms To

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

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

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

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

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

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

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

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

---

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)