> ## Documentation Index
> Fetch the complete documentation index at: https://villagesql.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Extensão vsql_address_standardizer para MySQL

> A extensão da comunidade vsql_address_standardizer interpreta endereços postais dos EUA em texto livre no MySQL, separando número da casa, rua, unidade, cidade, estado e ZIP.

Um endereço postal dos EUA chega como uma linha de texto livre, e quase todo
uso dele precisa das partes: o número da casa, a rua, a unidade, a cidade, o
estado, o CEP (ZIP). O `vsql_address_standardizer` separa essa linha em SQL e
normaliza o que encontra, de modo que `north` vira `N` e `new york` vira `NY`.
Ele foi inspirado no módulo contrib `address_standardizer` do PostgreSQL.

| | |
| - | - |
| **Mantenedor** | [Japheth Obala](https://github.com/jobala) |
| **Código-fonte e documentação** | [jobala/vsql-address-standardizer](https://github.com/jobala/vsql-address-standardizer) |
| **Licença** | GPL-2.0 |

> [!NOTE]
>
> Um terceiro escreve e mantém esta extensão. O VillageSQL não a compila, não a
> testa e não a distribui, e a descrição abaixo segue a documentação do próprio
> mantenedor. Leia essa documentação antes de depender dela.

## Instalar

Compile-o a partir do repositório com uma árvore de compilação do VillageSQL (`VillageSQL_BUILD_DIR`), copie o arquivo `.veb` para o `veb_dir` do servidor e, em seguida, instale-o:

```sql theme={null}
INSTALL EXTENSION vsql_address_standardizer;
```

## O que ela adiciona

| Função | Retorna | O que faz |
| - | - | - |
| `address_standardize(address)` | texto | O endereço inteiro, normalizado e reescrito em uma linha |
| `address_parse_json(address)` | texto | As partes como um objeto JSON. `house_number`, `street_name`, `street_suffix`, `city`, `state` e `zip` estão sempre presentes; `pre_directional`, `post_directional`, `unit_designator` e `unit_identifier` aparecem quando o endereço os tem |
| `address_field(address, name)` | texto | Uma única parte nomeada |

Ele trata somente endereços dos EUA.

## Veja também

* [Extensões disponíveis](https://villagesql.com/docs/pt-BR/extensions/catalog) — o catálogo completo
* [jobala/vsql-address-standardizer](https://github.com/jobala/vsql-address-standardizer) — código-fonte, exemplos e as limitações conhecidas


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.