# ＊ 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="/files/yqWTVyVN2nXKxHIILuWt" 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**](/rdt/resources/use-cases/contextual-anonymization.md) 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="/files/90l0VFGPyemBY0ueihVb" 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="/pages/iu3NwC7VxmycXh5KoqqX"><strong>RandomLocationGenerator</strong></a></td><td>Create a realistic combination of address columns from random,  worldwide locations.</td><td><a href="/pages/iu3NwC7VxmycXh5KoqqX">/pages/iu3NwC7VxmycXh5KoqqX</a></td></tr><tr><td>＊ <a href="/pages/Z63dO5I30IZRLbOwr482"><strong>RegionalAnonymizer</strong></a></td><td>Anonymize precise addresses while preserving the overall regional information.</td><td><a href="/pages/Z63dO5I30IZRLbOwr482">/pages/Z63dO5I30IZRLbOwr482</a></td></tr><tr><td><a href="/pages/9QnYHT40028wrumuonUY"><strong>AnonymizedFaker</strong></a></td><td>Create anonymize columns without considering the context of the overall address.</td><td></td></tr></tbody></table>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.sdv.dev/rdt/transformers-glossary/deep-data-understanding/address.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
