# ＊ Address

{% hint style="info" %}
**＊SDV Enterprise Feature.** This feature is available to our licensed users and is not currently in our public library. For more information, visit our page to [Explore SDV](https://docs.sdv.dev/sdv/explore/sdv-enterprise/compare-features).
{% endhint %}

Address data represents physical locations around the world, for example an office or personal mailing address. Addresses are usually structured, requiring several columns.

Addresses are also a type of PII data. A key consideration is that **you do not want the precise address locations of your dataset to leak** such as the exact street address and building number. However, you may want to **create realistic, broader regions** such as the city, postal code or country.

<figure><img src="https://2225246359-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVGX92M819eIp0rMg5elc%2Fuploads%2FiqdBFzMpSC5VCtScbuwU%2FAddress%20Graphic.png?alt=media&#x26;token=7a762a70-ac1d-4bc8-9940-67d804ca3866" alt=""><figcaption></figcaption></figure>

## Key Features

:earth\_americas: Create random, **realistic regions from anywhere in the world**. When you do this, the combinations of all your address columns will make sense when put together. For example a city, state, country combination such as `Boston, Massachusetts, USA`.

:unlock: You can also use the the [**Contextual Anonymization**](https://docs.sdv.dev/rdt/resources/use-cases/contextual-anonymization) technique on addresses. Preserve the real regions from your data while **anonymizing precise locations only**, such as the street address and building number.

## Supported sdtypes

An address comprises of multiple columns, each with specific concept such as a city.

<figure><img src="https://2225246359-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVGX92M819eIp0rMg5elc%2Fuploads%2F8XZmAvXPkfcHMSll3l0Y%2Frdt_transformers-glossary-deep-data-understanding-address_June%2002%202025.png?alt=media&#x26;token=014737d3-40d9-4efa-b36d-ab9c435e0e2e" alt=""><figcaption></figcaption></figure>

Below are the supported sdtypes. You can supply one or more of these in combination to form an address.

<table><thead><tr><th width="246">sdtype</th><th>Definition</th></tr></thead><tbody><tr><td><code>country_code</code></td><td>A 2-character ISO country code such as <code>"US"</code> or <code>"BE"</code>. For a full list of ISO country codes, view the<a href="https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2"> ISO guide</a>.</td></tr><tr><td><code>administrative_unit</code>, <code>state</code></td><td>The full name of the broader regions in a country. In some countries, these are called states. The general name of the term is administrative unit. For example <code>"Massachusetts"</code> or <code>"California"</code>.</td></tr><tr><td><code>state_abbr</code></td><td>The shortened abbreviation for the administrative unit. These are determined by the country. For example Massachusetts is <code>"MA"</code> and California is <code>"CA"</code>.</td></tr><tr><td><code>city</code></td><td>The full name of the city, for example <code>"Boston"</code> or <code>"San Francisco"</code>.</td></tr><tr><td><code>postcode</code></td><td>The internationally-recognized, 5-digit postal service code such as <code>"02116"</code> or <code>"94103"</code>.</td></tr><tr><td><code>street_address</code></td><td>The building number and street such as <code>"229 Berkeley St"</code> or <code>"77 Massachusetts Ave"</code>.</td></tr><tr><td><code>secondary_address</code></td><td>An optional, second line of the address that further specifies the unit or apartment number. For example <code>"Apt #4"</code> or <code>"Building 204"</code>.</td></tr></tbody></table>

## Browse Transformers

<table data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td>＊ <a href="address/randomlocationgenerator"><strong>RandomLocationGenerator</strong></a></td><td>Create a realistic combination of address columns from random,  worldwide locations.</td><td><a href="address/randomlocationgenerator">randomlocationgenerator</a></td></tr><tr><td>＊ <a href="address/regionalanonymizer"><strong>RegionalAnonymizer</strong></a></td><td>Anonymize precise addresses while preserving the overall regional information.</td><td><a href="address/regionalanonymizer">regionalanonymizer</a></td></tr><tr><td><a href="../generic-pii-anonymization/anonymizedfaker"><strong>AnonymizedFaker</strong></a></td><td>Create anonymize columns without considering the context of the overall address.</td><td></td></tr></tbody></table>